태그를 지정할 수 있는 API Gateway 리소스

태그는 Amazon API Gateway V2 API의 다음과 같은 HTTP API 또는 WebSocket API 리소스에 설정될 수 있습니다.

또한 태그는 Amazon API Gateway V1 API의 다음과 같은 REST API 리소스에 설정될 수 있습니다.

다른 리소스에는 태그를 직접 설정할 수 없습니다. 그러나 Amazon API Gateway V1 API에서는 하위 리소스가 상위 리소스에 설정된 태그를 상속합니다. 예:

태그 상속은 속성 기반 액세스 제어에만 적용됩니다. 예를 들어 상속된 태그를 사용하여 AWS Cost Explorer의 비용을 모니터링할 수 없습니다. 비용 할당에 태그를 사용하려면 Stage 리소스와 같은 하위 리소스에 태그를 생성하는 것이 좋습니다.

API Gateway는 리소스에 대해 GetTags 호출 시 상속된 태그를 반환하지 않습니다.

Amazon API Gateway V1 API의 태그 상속

이전에는 단계에만 태그를 설정할 수 있었습니다. 이제는 다른 리소스에도 태그를 설정할 수 있으므로 Stage에서 다음 두 가지 방법으로 태그를 수신할 수 있습니다.

단계가 두 방법으로 태그를 수신하는 경우 단계에 직접 설정된 태그가 우선합니다. 예를 들어, 단계가 상위 REST API에서 다음 태그를 상속하는 경우 다음과 같습니다.


{
	'foo': 'bar',
	'x':'y'
}

단계에 다음 태그가 직접 설정되어 있는 경우 다음과 같습니다.


{
	'foo': 'bar2',
	'hello': 'world'
}

단계에 다음 값과 함께 다음 태그가 포함됩니다.


{
	'foo': 'bar2',
	'hello': 'world'
	'x':'y'
}

다음 제한 및 사용 규칙은 API Gateway 리소스와 함께 태그를 사용할 때 적용합니다.

각 리소스는 최대 50개의 태그를 보유할 수 있습니다.
각 리소스에 대해 각 태그 키는 고유하며 하나의 값만 가질 수 있습니다.
태그 키의 최대 길이는 UTF-8 형식의 유니코드 문자 128자입니다.
태그 값의 최대 길이는 UTF-8 형식의 유니코드 문자 256자입니다.
키와 값에 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자, 공백 및 . : + = @ _ / -(하이픈) 문자도 있습니다. Amazon EC2 리소스는 모든 문자를 허용합니다.
태그 키와 값은 대/소문자를 구분합니다. 태그를 대문자로 사용하는 전략을 세우고 이러한 전략을 모든 리소스 유형에 대해 일관되게 구현하는 것이 가장 좋습니다. 예컨대, Costcenter, costcenter 또는 CostCenter를 사용할지 결정하고 모든 태그에 대해 동일한 규칙을 사용합니다. 대/소문자가 일치하지 않는 유사한 태그를 사용하지 마십시오.
aws: 접두사는 AWS가 사용하도록 예약되어 있으므로 태그에 사용할 수 없습니다. 이 접두사가 지정된 태그 키나 값은 편집하거나 삭제할 수 없습니다. 이 접두사가 지정된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

태그 지정

속성 기반 액세스 제어