本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Amazon API Gateway Management 的操作、资源和条件键
亚马逊 API 网关管理(服务前缀: apigateway) 提供以下特定服务的操作、资源、操作和条件密钥,用于 IAM 权限策略。
参考:
主题
亚马逊 API 网关管理定义的 API 操作
下表将 API 操作映射到它们授权的 IAM 操作。仅列出具有给定 API 和操作静态值的条件密钥;有关每个操作支持的全套条件密钥,请参阅 操作表。
| 操作 | IAM 操作 | 条件键 | 可能的值 | 访问级别 |
|---|---|---|---|---|
|
CreateApiKey |
写入 |
|||
写入 |
||||
|
CreateAuthorizer |
写入 |
|||
iam:PassedToService |
apigateway.amazonaws.com |
写入 |
||
|
CreateBasePathMapping |
写入 |
|||
|
CreateDeployment |
写入 |
|||
|
CreateDocumentationPart |
写入 |
|||
|
CreateDocumentationVersion |
写入 |
|||
|
CreateDomainName |
权限管理,写入 |
|||
写入 |
||||
写入 |
||||
权限管理,写入 |
||||
|
CreateDomainNameAccessAssociation |
权限管理,写入 |
|||
写入 |
||||
写入 |
||||
|
CreateModel |
写入 |
|||
|
CreateRequestValidator |
写入 |
|||
|
CreateResource |
写入 |
|||
|
CreateRestApi |
写入 |
|||
写入 |
||||
权限管理,写入 |
||||
|
CreateStage |
写入 |
|||
写入 |
||||
|
CreateUsagePlan |
写入 |
|||
写入 |
||||
|
CreateUsagePlanKey |
写入 |
|||
|
CreateVpcLink |
写入 |
|||
写入 |
||||
|
DeleteApiKey |
写入 |
|||
|
DeleteAuthorizer |
写入 |
|||
|
DeleteBasePathMapping |
写入 |
|||
|
DeleteClientCertificate |
写入 |
|||
|
DeleteDeployment |
写入 |
|||
|
DeleteDocumentationPart |
写入 |
|||
|
DeleteDocumentationVersion |
写入 |
|||
|
DeleteDomainName |
写入 |
|||
权限管理,写入 |
||||
|
DeleteDomainNameAccessAssociation |
写入 |
|||
|
DeleteGatewayResponse |
写入 |
|||
|
DeleteIntegration |
写入 |
|||
|
DeleteIntegrationResponse |
写入 |
|||
|
DeleteMethod |
写入 |
|||
|
DeleteMethodResponse |
写入 |
|||
|
DeleteModel |
写入 |
|||
|
DeleteRequestValidator |
写入 |
|||
|
DeleteResource |
写入 |
|||
|
DeleteRestApi |
写入 |
|||
|
DeleteStage |
写入 |
|||
|
DeleteUsagePlan |
写入 |
|||
|
DeleteUsagePlanKey |
写入 |
|||
|
DeleteVpcLink |
写入 |
|||
|
FlushStageAuthorizersCache |
写入 |
|||
|
FlushStageCache |
写入 |
|||
|
GenerateClientCertificate |
写入 |
|||
写入 |
||||
|
GetAccount |
读取 |
|||
|
GetApiKey |
读取 |
|||
|
GetApiKeys |
读取 |
|||
|
GetAuthorizer |
读取 |
|||
|
GetAuthorizers |
读取 |
|||
|
GetBasePathMapping |
读取 |
|||
|
GetBasePathMappings |
读取 |
|||
|
GetClientCertificate |
读取 |
|||
|
GetClientCertificates |
读取 |
|||
|
GetDeployment |
读取 |
|||
|
GetDeployments |
读取 |
|||
|
GetDocumentationPart |
读取 |
|||
|
GetDocumentationParts |
读取 |
|||
|
GetDocumentationVersion |
读取 |
|||
|
GetDocumentationVersions |
读取 |
|||
|
GetDomainName |
读取 |
|||
|
GetDomainNameAccessAssociations |
读取 |
|||
|
GetDomainNames |
读取 |
|||
|
GetExport |
读取 |
|||
|
GetGatewayResponse |
读取 |
|||
|
GetGatewayResponses |
读取 |
|||
|
GetIntegration |
读取 |
|||
|
GetIntegrationResponse |
读取 |
|||
|
GetMethod |
读取 |
|||
|
GetMethodResponse |
读取 |
|||
|
GetModel |
读取 |
|||
|
GetModelTemplate |
读取 |
|||
|
GetModels |
读取 |
|||
|
GetRequestValidator |
读取 |
|||
|
GetRequestValidators |
读取 |
|||
|
GetResource |
读取 |
|||
|
GetResources |
读取 |
|||
|
GetRestApi |
读取 |
|||
|
GetRestApis |
读取 |
|||
|
GetSdk |
读取 |
|||
|
GetSdkType |
读取 |
|||
|
GetSdkTypes |
读取 |
|||
|
GetStage |
读取 |
|||
|
GetStages |
读取 |
|||
|
GetTags |
读取 |
|||
|
GetUsage |
读取 |
|||
|
GetUsagePlan |
读取 |
|||
|
GetUsagePlanKey |
读取 |
|||
|
GetUsagePlanKeys |
读取 |
|||
|
GetUsagePlans |
读取 |
|||
|
GetVpcLink |
读取 |
|||
|
GetVpcLinks |
读取 |
|||
|
ImportApiKeys |
写入 |
|||
|
ImportDocumentationParts |
写入 |
|||
|
ImportRestApi |
写入 |
|||
权限管理,写入 |
||||
iam:PassedToService |
apigateway.amazonaws.com |
写入 |
||
|
PutGatewayResponse |
写入 |
|||
|
PutIntegration |
写入 |
|||
iam:PassedToService |
apigateway.amazonaws.com |
写入 |
||
|
PutIntegrationResponse |
写入 |
|||
|
PutMethod |
写入 |
|||
|
PutMethodResponse |
写入 |
|||
|
PutRestApi |
写入 |
|||
权限管理,写入 |
||||
iam:PassedToService |
apigateway.amazonaws.com |
写入 |
||
|
RejectDomainNameAccessAssociation |
权限管理,写入 |
|||
|
TagResource |
写入 |
|||
写入 |
||||
写入 |
||||
|
TestInvokeAuthorizer |
写入 |
|||
|
TestInvokeMethod |
写入 |
|||
|
UntagResource |
写入 |
|||
写入 |
||||
|
UpdateAccount |
写入 |
|||
iam:PassedToService |
apigateway.amazonaws.com |
写入 |
||
|
UpdateApiKey |
写入 |
|||
|
UpdateAuthorizer |
写入 |
|||
iam:PassedToService |
apigateway.amazonaws.com |
写入 |
||
|
UpdateBasePathMapping |
写入 |
|||
|
UpdateClientCertificate |
写入 |
|||
|
UpdateDeployment |
写入 |
|||
|
UpdateDocumentationPart |
写入 |
|||
|
UpdateDocumentationVersion |
写入 |
|||
|
UpdateDomainName |
权限管理,写入 |
|||
写入 |
||||
权限管理,写入 |
||||
权限管理,写入 |
||||
权限管理,写入 |
||||
|
UpdateGatewayResponse |
写入 |
|||
|
UpdateIntegration |
写入 |
|||
iam:PassedToService |
apigateway.amazonaws.com |
写入 |
||
|
UpdateIntegrationResponse |
写入 |
|||
|
UpdateMethod |
写入 |
|||
|
UpdateMethodResponse |
写入 |
|||
|
UpdateModel |
写入 |
|||
|
UpdateRequestValidator |
写入 |
|||
|
UpdateResource |
写入 |
|||
|
UpdateRestApi |
写入 |
|||
权限管理,写入 |
||||
|
UpdateStage |
写入 |
|||
|
UpdateUsage |
写入 |
|||
|
UpdateUsagePlan |
写入 |
|||
|
UpdateVpcLink |
写入 |
Amazon API Gateway Management 定义的操作
您可以在 IAM 策略语句的 Action 元素中指定以下操作。对于每个操作,该表列出了该操作支持的资源类型和条件键。可以使用策略授予在 Amazon中执行操作的权限。您在策略中使用一项操作时,通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下,单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。
Amazon API Gateway Management 定义的资源类型
以下资源类型是由该服务定义的,可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。
| 资源类型 | ARN | 条件键 |
|---|---|---|
arn:${Partition}:apigateway:${Region}::/account |
||
arn:${Partition}:apigateway:${Region}::/apikeys/${ApiKeyId} |
||
arn:${Partition}:apigateway:${Region}::/apikeys |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/authorizers/${AuthorizerId}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/authorizers/${AuthorizerId} |
apigateway:Request/AuthorizerType |
|
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/authorizers, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/authorizers |
||
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/basepathmappings/${BasePath} |
||
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/basepathmappings |
||
arn:${Partition}:apigateway:${Region}::/clientcertificates/${ClientCertificateId} |
||
arn:${Partition}:apigateway:${Region}::/clientcertificates |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/deployments/${DeploymentId}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/deployments/${DeploymentId} |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/deployments, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/deployments |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/parts/${DocumentationPartId} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/parts |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/versions/${DocumentationVersionId} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/versions |
||
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/RoutingMode |
|
arn:${Partition}:apigateway:${Region}:${Account}:/domainnameaccessassociations/domainname/${DomainName}/${SourceType}/${SourceId} |
||
arn:${Partition}:apigateway:${Region}:${Account}:/domainnameaccessassociations |
apigateway:Request/AccessAssociationSource |
|
arn:${Partition}:apigateway:${Region}::/domainnames |
apigateway:Request/EndpointType apigateway:Request/MtlsTrustStoreUri apigateway:Request/MtlsTrustStoreVersion apigateway:Request/SecurityPolicy |
|
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/gatewayresponses/${ResponseType} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/gatewayresponses |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations/${IntegrationId}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/integration |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations/${IntegrationId}/integrationresponses/${IntegrationResponseId}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/integration/responses/${StatusCode} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType} |
apigateway:Request/ApiKeyRequired apigateway:Request/RouteAuthorizationType apigateway:Resource/ApiKeyRequired |
|
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/responses/${StatusCode} |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/models/${ModelId}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/models/${ModelName} |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/models, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/models |
||
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}+${DomainIdentifier}/basepathmappings/${BasePath} |
||
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}+${DomainIdentifier}/basepathmappings |
||
arn:${Partition}:apigateway:${Region}:${Account}:/domainnames/${DomainName}+${DomainIdentifier} |
apigateway:Request/EndpointType apigateway:Resource/EndpointType |
|
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/requestvalidators/${RequestValidatorId} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/requestvalidators |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId} |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources |
||
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId} |
apigateway:Request/ApiKeyRequired apigateway:Request/AuthorizerType apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType apigateway:Request/RouteAuthorizationType apigateway:Request/SecurityPolicy apigateway:Resource/ApiKeyRequired apigateway:Resource/AuthorizerType apigateway:Resource/DisableExecuteApiEndpoint apigateway:Resource/EndpointType apigateway:Resource/RouteAuthorizationType |
|
arn:${Partition}:apigateway:${Region}::/restapis |
apigateway:Request/ApiKeyRequired apigateway:Request/AuthorizerType apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType apigateway:Request/RouteAuthorizationType |
|
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/stages/${StageName}/sdks/${SdkType} |
||
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages/${StageName}, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/stages/${StageName} |
apigateway:Request/AccessLoggingDestination apigateway:Request/AccessLoggingFormat apigateway:Resource/AccessLoggingDestination |
|
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages, arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/stages |
apigateway:Request/AccessLoggingDestination |
|
arn:${Partition}:apigateway:${Region}::/tags/${UrlEncodedResourceARN} |
||
arn:${Partition}:apigateway:${Region}::/restapis/models/${ModelName}/template |
||
arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId} |
||
arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId}/keys/${Id} |
||
arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId}/keys |
||
arn:${Partition}:apigateway:${Region}::/usageplans |
||
arn:${Partition}:apigateway:${Region}::/vpclinks/${VpcLinkId} |
||
arn:${Partition}:apigateway:${Region}::/vpclinks |
Amazon API Gateway Management 的条件键
Amazon API Gateway Management 定义以下可以在 IAM policy 的 Condition 元素中使用的条件键。
| 条件键 | 描述 | 类型 |
|---|---|---|
按访问关联源筛选访问权限。期间可用 CreateDomainNameAccessAssociation 手术 |
String |
|
按访问日志目标筛选访问权限。期间可用 CreateStage 和 UpdateStage 运营 |
String |
|
按访问日志格式筛选访问权限。期间可用 CreateStage 和 UpdateStage 运营 |
String |
|
按是否需要 API 密钥筛选访问权限。期间可用 CreateMethod 和 PutMethod 操作。在导入和重新导入期间也可作为集合使用 |
ArrayOfBool |
|
按 API 名称筛选访问权限。期间可用 CreateRestApi 和 UpdateRestApi 运营 |
String |
|
按请求中的授权者类型筛选访问权限,例如 TOKEN、REQUEST、JWT。期间可用 CreateAuthorizer 和 UpdateAuthorizer。也可在导入和重新导入期间作为 ArrayOfString |
ArrayOfString |
|
按默认 execute-api 终端节点的状态筛选访问权限。期间可用 CreateRestApi 和 DeleteRestApi 运营 |
Bool |
|
按域名 ARN 筛选访问权限。期间可用 CreateDomainNameAccessAssociation 手术 |
ARN |
|
按终端节点类型筛选访问权限。期间可用 CreateDomainName, UpdateDomainName, CreateRestApi,以及 UpdateRestApi 运营 |
ArrayOfString |
|
按用于双向 TLS 身份验证的 truststore 的 URI 筛选访问权限。期间可用 CreateDomainName 和 UpdateDomainName 运营 |
String |
|
按用于双向 TLS 身份验证的 truststore 的版本筛选访问权限。期间可用 CreateDomainName 和 UpdateDomainName 运营 |
String |
|
按授权类型筛选访问权限,例如 NONE、AWS_IAM、CUSTOM、JWT、COGNITO_USER_POOLS。期间可用 CreateMethod 和 PutMethod 操作在导入期间也可作为集合使用 |
ArrayOfString |
|
按域名的路由模式筛选访问权限。期间可用 CreateDomainName 和 UpdateDomainName 运营 |
String |
|
按 TLS 版本筛选访问权限。期间可用 CreateDomain 和 UpdateDomain 运营 |
ArrayOfString |
|
按您尝试创建的部署的阶段名称筛选访问权限。期间可用 CreateDeployment 手术 |
String |
|
按当前 Stage 资源的访问日志目标筛选访问权限。期间可用 UpdateStage 和 DeleteStage 运营 |
String |
|
按当前 Stage 资源的访问日志格式筛选访问权限。期间可用 UpdateStage 和 DeleteStage 运营 |
String |
|
按现有 Method 资源是否需要 API 密钥筛选访问权限。期间可用 PutMethod 和 DeleteMethod 操作。在重新导入期间也可作为集合使用 |
ArrayOfBool |
|
按现有 API 名称筛选访问权限 RestApi 资源。期间可用 UpdateRestApi 和 DeleteRestApi 运营 |
String |
|
按授权者的当前类型筛选访问权限,例如 TOKEN、REQUEST、JWT。期间可用 UpdateAuthorizer 和 DeleteAuthorizer 操作。在重新导入期间也可作为 ArrayOfString |
ArrayOfString |
|
按当前的默认 execute-API 端点的状态筛选访问权限 RestApi 资源。期间可用 UpdateRestApi 和 DeleteRestApi 运营 |
Bool |
|
按终端节点类型筛选访问权限。期间可用 UpdateDomainName, DeleteDomainName, UpdateRestApi,以及 DeleteRestApi 运营 |
ArrayOfString |
|
按用于双向 TLS 身份验证的 truststore 的 URI 筛选访问权限。期间可用 UpdateDomainName 和 DeleteDomainName 运营 |
String |
|
按用于双向 TLS 身份验证的 truststore 的版本筛选访问权限。期间可用 UpdateDomainName 和 DeleteDomainName 运营 |
String |
|
按现有 Method 资源的授权类型筛选访问权限,例如 NONE、AWS_IAM、CUSTOM、JWT、COGNITO_USER_POOLS。期间可用 PutMethod 和 DeleteMethod 操作。在重新导入期间也可作为集合使用 |
ArrayOfString |
|
按域名的路由模式筛选访问权限。期间可用 UpdateDomainName 和 DeleteDomainName 运营 |
String |
|
按 TLS 版本筛选访问权限。期间可用 UpdateDomain 和 DeleteDomain 运营 |
ArrayOfString |
|
按请求中的标签键值对筛选访问 |
String |
|
按附加到资源的标签筛选访问 |
String |
|
按请求中的标签键筛选访问权限 |
ArrayOfString |