AWS Location Service tag validation regex does not match documentation

Question

I'm noticing an issue in some of my AWS accounts. The exact same request to create a place index succeeded in one account but is now failing in another. The failure is due to a tag key not matching the expected pattern, but the pattern reported in the error message does not match the restrictions mentioned in the Location Service API documentation (here) as well as the CloudFormation resource schema (here)

Here's the error message I get:

❯ aws location create-place-index --index-name test --data-source Esri --tags '{ "@foo-bar/hello-world": "test" }'

An error occurred (ValidationException) when calling the CreatePlaceIndex operation: 'Tags.@foo-bar/hello-world' must match regex ^[a-zA-Z+-=._:/]+$

The Location Service documentation's tag restrictions seem to align with AWS's general ones (here), but that pattern seems to not reflect this.

Here's the error message I get:
```
❯ aws location create-place-index --index-name test --data-source Esri --tags '{ "@foo-bar/hello-world": "test" }'

An error occurred (ValidationException) when calling the CreatePlaceIndex operation: 'Tags.@foo-bar/hello-world' must match regex ^[a-zA-Z+-=._:/]+$
```
The Location Service documentation's tag restrictions seem to align with AWS's general ones ([here](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html#tag-conventions)), but that pattern seems to not reflect this.

Vi Nguyen · Answer

Thanks for raising the concern. I'm with Amazon Location.

There seems to be a discrepancy between the [documentation for the Location Service API](https://docs.aws.amazon.com/location/latest/APIReference/API_CreatePlaceIndex.html#location-CreatePlaceIndex-request-Tags) and [the CloudFormation resource schema documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-location-placeindex-tag.html). The accurate pattern for the tag key is *^[a-zA-Z+-=._:/]+$*, and it excludes the '@' character.

Both the Location Service API documentation and the error message correctly indicate the expected pattern. We will address this by updating the CloudFormation resource schema to align with the expected pattern.

AWS Location Service tag validation regex does not match documentation

Relevant content