Amazon API Gateway Management에 사용되는 작업, 리소스 및 조건 키

Amazon API Gateway Management(서비스 접두사: apigateway)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.

참조:

이 서비스를 구성하는 방법을 알아봅니다.
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.

주제

Amazon API Gateway Management에서 정의한 작업
Amazon API Gateway Management에서 정의한 리소스 유형
Amazon API Gateway Management에 사용되는 조건 키

Amazon API Gateway Management에서 정의한 작업

IAM 정책 설명의 Action 요소에서 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.

작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.

작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.

참고

리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.

다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.

작업	설명	액세스 레벨	리소스 유형(*필수)	조건 키
AddCertificateToDomain	상호 TLS 인증을 위한 인증서를 도메인 이름에 추가할 수 있는 권한을 부여합니다. 이는 MTL의 민감한 특성으로 인해 DomainName 리소스를 관리하기 위한 추가적인 권한 부여 제어입니다.	권한 관리	DomainName
AddCertificateToDomain		권한 관리	DomainNames
DELETE	특정 리소스를 삭제할 수 있는 권한을 부여합니다.	Write	ApiKey
			Authorizer
			BasePathMapping
			ClientCertificate
			Deployment
			DocumentationPart
			DocumentationVersion
			DomainName
			GatewayResponse
			Integration
			IntegrationResponse
			Method
			MethodResponse
			Model
			RequestValidator
			Resource
			RestApi
			Stage
			Tags
			Template
			UsagePlan
			UsagePlanKey
			VpcLink
				aws:RequestTag/${TagKey} aws:TagKeys
GET	특정 리소스를 읽을 수 있는 권한을 부여합니다.	Read	Account
			ApiKey
			ApiKeys
			Authorizer
			Authorizers
			BasePathMapping
			BasePathMappings
			ClientCertificate
			ClientCertificates
			Deployment
			Deployments
			DocumentationPart
			DocumentationParts
			DocumentationVersion
			DocumentationVersions
			DomainName
			DomainNames
			GatewayResponse
			GatewayResponses
			Integration
			IntegrationResponse
			Method
			MethodResponse
			Model
			Models
			RequestValidator
			RequestValidators
			Resource
			Resources
			RestApi
			RestApis
			Sdk
			Stage
			Stages
			Tags
			UsagePlan
			UsagePlanKey
			UsagePlanKeys
			UsagePlans
			VpcLink
			VpcLinks
PATCH	특정 리소스를 업데이트할 수 있는 권한을 부여합니다.	Write	Account
			ApiKey
			Authorizer
			BasePathMapping
			ClientCertificate
			Deployment
			DocumentationPart
			DocumentationVersion
			DomainName
			GatewayResponse
			Integration
			IntegrationResponse
			Method
			MethodResponse
			Model
			RequestValidator
			Resource
			RestApi
			Stage
			Template
			UsagePlan
			UsagePlanKey
			VpcLink
				aws:RequestTag/${TagKey} aws:TagKeys
POST	특정 리소스를 생성할 수 있는 권한을 부여합니다.	Write	ApiKeys
			Authorizers
			BasePathMappings
			ClientCertificates
			Deployments
			DocumentationParts
			DocumentationVersions
			DomainNames
			GatewayResponses
			IntegrationResponse
			MethodResponse
			Models
			RequestValidators
			Resources
			RestApis
			Stages
			UsagePlanKeys
			UsagePlans
			VpcLinks
				aws:RequestTag/${TagKey} aws:TagKeys
PUT	특정 리소스를 업데이트할 수 있는 권한을 부여합니다.	Write	DocumentationPart
			GatewayResponse
			IntegrationResponse
			MethodResponse
			RestApi
			Tags
				aws:RequestTag/${TagKey} aws:TagKeys
RemoveCertificateFromDomain	상호 TLS 인증을 위한 인증서를 도메인 이름에서 제거할 수 있는 권한을 부여합니다. 이는 MTL의 민감한 특성으로 인해 DomainName 리소스를 관리하기 위한 추가적인 권한 부여 제어입니다.	권한 관리	DomainName
RemoveCertificateFromDomain		권한 관리	DomainNames
SetWebACL	WAF 액세스 제어 목록(ACL)을 설정하는 권한을 부여합니다. 이는 WebAcl의 민감한 특성으로 인해 Stage 리소스를 관리하기 위한 추가적인 권한 부여 제어입니다.	권한 관리	Stage
SetWebACL		권한 관리	Stages
UpdateRestApiPolicy	API에 대한 IAM 리소스 정책을 관리할 수 있는 권한을 부여합니다. 이는 리소스 정책의 민감한 특성으로 인해 API를 관리하기 위한 추가적인 권한 부여 제어입니다.	권한 관리	RestApi
UpdateRestApiPolicy		권한 관리	RestApis

Amazon API Gateway Management에서 정의한 리소스 유형

이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 수 있는 조건 키를 정의할 수도 있습니다. 이러한 키는 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 대한 자세한 내용은 리소스 유형 테이블을 참조하세요.

리소스 유형	ARN	조건 키
Account	`arn:${Partition}:apigateway:${Region}::/account`
ApiKey	`arn:${Partition}:apigateway:${Region}::/apikeys/${ApiKeyId}`	aws:ResourceTag/${TagKey}
ApiKeys	`arn:${Partition}:apigateway:${Region}::/apikeys`	aws:ResourceTag/${TagKey}
Authorizer	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/authorizers/${AuthorizerId}`	apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Resource/AuthorizerType apigateway:Resource/AuthorizerUri aws:ResourceTag/${TagKey}
Authorizers	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/authorizers`	apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri aws:ResourceTag/${TagKey}
BasePathMapping	`arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/basepathmappings/${BasePath}`	aws:ResourceTag/${TagKey}
BasePathMappings	`arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/basepathmappings`	aws:ResourceTag/${TagKey}
ClientCertificate	`arn:${Partition}:apigateway:${Region}::/clientcertificates/${ClientCertificateId}`	aws:ResourceTag/${TagKey}
ClientCertificates	`arn:${Partition}:apigateway:${Region}::/clientcertificates`	aws:ResourceTag/${TagKey}
Deployment	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/deployments/${DeploymentId}`	aws:ResourceTag/${TagKey}
Deployments	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/deployments`	apigateway:Request/StageName
DocumentationPart	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/parts/${DocumentationPartId}`	aws:ResourceTag/${TagKey}
DocumentationParts	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/parts`	aws:ResourceTag/${TagKey}
DocumentationVersion	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/versions/${DocumentationVersionId}`
DocumentationVersions	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/versions`
DomainName	`arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}`	apigateway:Request/EndpointType apigateway:Request/MtlsTrustStoreUri apigateway:Request/MtlsTrustStoreVersion apigateway:Request/SecurityPolicy apigateway:Resource/EndpointType apigateway:Resource/MtlsTrustStoreUri apigateway:Resource/MtlsTrustStoreVersion apigateway:Resource/SecurityPolicy aws:ResourceTag/${TagKey}
DomainNames	`arn:${Partition}:apigateway:${Region}::/domainnames`	apigateway:Request/EndpointType apigateway:Request/MtlsTrustStoreUri apigateway:Request/MtlsTrustStoreVersion apigateway:Request/SecurityPolicy aws:ResourceTag/${TagKey}
GatewayResponse	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/gatewayresponses/${ResponseType}`	aws:ResourceTag/${TagKey}
GatewayResponses	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/gatewayresponses`	aws:ResourceTag/${TagKey}
Integration	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/integration`	aws:ResourceTag/${TagKey}
IntegrationResponse	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/integration/responses/${StatusCode}`
Method	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}`	apigateway:Request/ApiKeyRequired apigateway:Request/RouteAuthorizationType apigateway:Resource/ApiKeyRequired apigateway:Resource/RouteAuthorizationType aws:ResourceTag/${TagKey}
MethodResponse	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/responses/${StatusCode}`
Model	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/models/${ModelName}`	aws:ResourceTag/${TagKey}
Models	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/models`	aws:ResourceTag/${TagKey}
RequestValidator	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/requestvalidators/${RequestValidatorId}`
RequestValidators	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/requestvalidators`
Resource	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}`	aws:ResourceTag/${TagKey}
Resources	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources`	aws:ResourceTag/${TagKey}
RestApi	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}`	apigateway:Request/ApiKeyRequired apigateway:Request/ApiName apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType apigateway:Request/RouteAuthorizationType apigateway:Resource/ApiKeyRequired apigateway:Resource/ApiName apigateway:Resource/AuthorizerType apigateway:Resource/AuthorizerUri apigateway:Resource/DisableExecuteApiEndpoint apigateway:Resource/EndpointType apigateway:Resource/RouteAuthorizationType aws:ResourceTag/${TagKey}
RestApis	`arn:${Partition}:apigateway:${Region}::/restapis`	apigateway:Request/ApiKeyRequired apigateway:Request/ApiName apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType apigateway:Request/RouteAuthorizationType aws:ResourceTag/${TagKey}
Sdk	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/stages/${StageName}/sdks/${SdkType}`
Stage	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/stages/${StageName}`	apigateway:Request/AccessLoggingDestination apigateway:Request/AccessLoggingFormat apigateway:Resource/AccessLoggingDestination apigateway:Resource/AccessLoggingFormat aws:ResourceTag/${TagKey}
Stages	`arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/stages`	apigateway:Request/AccessLoggingDestination apigateway:Request/AccessLoggingFormat aws:ResourceTag/${TagKey}
Template	`arn:${Partition}:apigateway:${Region}::/restapis/models/${ModelName}/template`
UsagePlan	`arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId}`	aws:ResourceTag/${TagKey}
UsagePlans	`arn:${Partition}:apigateway:${Region}::/usageplans`	aws:ResourceTag/${TagKey}
UsagePlanKey	`arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId}/keys/${Id}`
UsagePlanKeys	`arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId}/keys`
VpcLink	`arn:${Partition}:apigateway:${Region}::/vpclinks/${VpcLinkId}`	aws:ResourceTag/${TagKey}
VpcLinks	`arn:${Partition}:apigateway:${Region}::/vpclinks`	aws:ResourceTag/${TagKey}
Tags	`arn:${Partition}:apigateway:${Region}::/tags/${UrlEncodedResourceARN}`

Amazon API Gateway Management에 사용되는 조건 키

Amazon API Gateway Management는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.

모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.

조건 키	설명	Type
apigateway:Request/AccessLoggingDestination	액세스 로그 대상을 기준으로 액세스를 필터링합니다. CreateStage 및 UpdateStage 작업 중에 사용 가능합니다.	문자열
apigateway:Request/AccessLoggingFormat	액세스 로그 형식을 기준으로 액세스를 필터링합니다. CreateStage 및 UpdateStage 작업 중에 사용 가능합니다.	문자열
apigateway:Request/ApiKeyRequired	API 키가 필요한지 여부를 기준으로 액세스를 필터링합니다. CreateMethod 및 PutMethod 작업 중에 사용 가능합니다. 가져오기 및 다시 가져오기 중에 컬렉션으로 사용할 수도 있습니다.	ArrayOfBool
apigateway:Request/ApiName	API 이름별로 액세스를 필터링합니다. CreateRestApi 및 UpdateRestApi 업데이트 작업 중에 사용 가능합니다.	문자열
apigateway:Request/AuthorizerType	요청의 권한 부여 유형(예: TOKEN, REQUEST, JWT) 별로 액세스를 필터링합니다. CreateAuthorizer 및 UpdateAuthorizer 중에 사용 가능합니다. ArraYOfString으로 가져오기 및 다시 가져오기 중에도 사용할 수 있습니다.	ArrayOfString
apigateway:Request/AuthorizerUri	Lambda 권한 부여 함수의 URI별로 액세스를 필터링합니다. CreateAuthorizer 및 UpdateAuthorizer 중에 사용 가능합니다. ArraYOfString으로 가져오기 및 다시 가져오기 중에도 사용할 수 있습니다.	ArrayOfString
apigateway:Request/DisableExecuteApiEndpoint	기본 execute-api 엔드포인트의 상태를 기준으로 액세스를 필터링합니다. CreateRestApi 및 DeleteRestApi 작업 중에 사용 가능합니다.	Bool
apigateway:Request/EndpointType	엔드포인트 유형을 기준으로 액세스를 필터링합니다. CreateDomainName, UpdateDomainName, CreateRestApi 및 UpdateRestApi 작업 중에 사용 가능합니다.	ArrayOfString
apigateway:Request/MtlsTrustStoreUri	상호 TLS 인증에 사용되는 트러스트 스토어의 URI를 기준으로 액세스를 필터링합니다. CreateDomainName 및 UpdateDomainName 작업 중에 사용 가능합니다.	문자열
apigateway:Request/MtlsTrustStoreVersion	상호 TLS 인증에 사용되는 트러스트 스토어의 버전을 기준으로 액세스를 필터링합니다. CreateDomainName 및 UpdateDomainName 작업 중에 사용 가능합니다.	문자열
apigateway:Request/RouteAuthorizationType	권한 부여 유형(예: NONE, AWS_IAM, CUSTOM, JWT, COGNITO_USER_풀)별로 액세스를 필터링합니다. CreateMethod 및 PutMethod 작업 중에 사용 가능합니다. 가져오기 중에 컬렉션으로 사용할 수도 있습니다.	ArrayOfString
apigateway:Request/SecurityPolicy	TLS 버전을 기준으로 액세스를 필터링합니다. CreateDomain 및 UpdateDomain 작업 중에 사용 가능합니다.	ArrayOfString
apigateway:Request/StageName	생성하려는 배포의 단계 이름을 기준으로 액세스를 필터링합니다. CreateDeployment 작업 중에 사용 가능합니다.	문자열
apigateway:Resource/AccessLoggingDestination	현재 Stage 리소스의 액세스 로그 대상을 기준으로 액세스를 필터링합니다. UpdateStage 및 DeleteStage 작업 중에 사용 가능합니다.	문자열
apigateway:Resource/AccessLoggingFormat	현재 Stage 리소스의 액세스 로그 형식을 기준으로 액세스를 필터링합니다. UpdateStage 및 DeleteStage 작업 중에 사용 가능합니다.	문자열
apigateway:Resource/ApiKeyRequired	기존 Method 리소스에 API 키가 필요한지 여부를 기준으로 액세스를 필터링합니다. PutMethod 및 DeleteMethod 작업 중에 사용 가능합니다. 다시 가져오기 중에 컬렉션으로도 사용할 수 있습니다.	ArrayOfBool
apigateway:Resource/ApiName	기존 RestAPI 리소스의 API 이름을 기준으로 액세스를 필터링합니다. UpdateRestApi 및 DeleteRestApi 작업 중에 사용 가능합니다.	문자열
apigateway:Resource/AuthorizerType	현재 권한 부여 유형(예: TOKEN, REQUEST, JWT)을 기준으로 액세스를 필터링합니다. UpdateAuthorizer 및 DeleteAuthorizer 작업 중에 사용 가능합니다. ArrayOfString으로 다시 가져오기 중에도 사용할 수 있습니다.	ArrayOfString
apigateway:Resource/AuthorizerUri	Lambda 권한 부여 함수의 URI별로 액세스를 필터링합니다. UpdateAuthorizer 및 DeleteAuthorizer 작업 중에 사용 가능합니다. ArrayOfString으로 다시 가져오기 중에도 사용할 수 있습니다.	ArrayOfString
apigateway:Resource/DisableExecuteApiEndpoint	현재 RestAPI 리소스의 기본 execute-api 엔드포인트 상태를 기준으로 액세스를 필터링합니다. UpdateRestApi 및 DeleteRestApi 작업 중에 사용 가능합니다.	Bool
apigateway:Resource/EndpointType	엔드포인트 유형을 기준으로 액세스를 필터링합니다. UpdateDomainName, DeleteDomainName, UpdateRestApi 및 DeleteRestApi 작업 중에 사용 가능합니다.	ArrayOfString
apigateway:Resource/MtlsTrustStoreUri	상호 TLS 인증에 사용되는 트러스트 스토어의 URI를 기준으로 액세스를 필터링합니다. UpdateDomainName 및 DeleteDomainName 작업 중에 사용 가능합니다.	문자열
apigateway:Resource/MtlsTrustStoreVersion	상호 TLS 인증에 사용되는 트러스트 스토어의 버전을 기준으로 액세스를 필터링합니다. UpdateDomainName 및 DeleteDomainName 작업 중에 사용 가능합니다.	문자열
apigateway:Resource/RouteAuthorizationType	기존 메소드 리소스의 권한 부여 유형 (예: NONE, AWS_IAM, CUSTOM, JWT, COGNITO_USER_POOLS)별로 액세스를 필터링합니다. PutMethod 및 DeleteMethod 작업 중에 사용 가능합니다. 다시 가져오기 중에 컬렉션으로도 사용할 수 있습니다.	ArrayOfString
apigateway:Resource/SecurityPolicy	TLS 버전을 기준으로 액세스를 필터링합니다. UpdateDomain 및 DeleteDomain 작업 중에 사용 가능합니다.	ArrayOfString
aws:RequestTag/${TagKey}	요청의 태그 키-값 페어를 기준으로 액세스를 필터링합니다.	문자열
aws:ResourceTag/${TagKey}	리소스에 연결된 태그를 기준으로 액세스를 필터링합니다.	문자열
aws:TagKeys	요청의 태그 키로 기준으로 액세스를 필터링합니다.	ArrayOfString

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

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

문서 규칙