Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Acciones, recursos y claves de condición para la administración de Amazon API Gateway
Amazon API Gateway Management (prefijo de servicio: apigateway) proporciona las siguientes claves de operaciones, recursos, acciones y condiciones específicas del servicio para usarlas en las políticas de permisos de IAM.
Referencias:
-
Obtenga información para configurar este servicio.
-
Vea una lista de las operaciones de API disponibles para este servicio.
-
Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos de IAM.
-
Vea el referencia de autorización de servicio programático
para este servicio.
Temas
Operaciones de API definidas por Amazon API Gateway Management
La siguiente tabla asigna las operaciones de la API a las acciones de IAM que autorizan. Solo se muestran las claves de condición que tienen valores estáticos para la API y la acción determinadas; para ver el conjunto completo de claves de condición que admite cada acción, consulta la Tabla de acciones.
| Operación | Acción de IAM | Clave de condición | Valores posibles | Nivel de acceso |
|---|---|---|---|---|
|
CreateApiKey |
Escritura |
|||
Escritura |
||||
|
CreateAuthorizer |
Escritura |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Escritura |
||
|
CreateBasePathMapping |
Escritura |
|||
|
CreateDeployment |
Escritura |
|||
|
CreateDocumentationPart |
Escritura |
|||
|
CreateDocumentationVersion |
Escritura |
|||
|
CreateDomainName |
Gestión de permisos, Write |
|||
Escritura |
||||
Escritura |
||||
Gestión de permisos, Write |
||||
|
CreateDomainNameAccessAssociation |
Gestión de permisos, Write |
|||
Escritura |
||||
Escritura |
||||
|
CreateModel |
Escritura |
|||
|
CreateRequestValidator |
Escritura |
|||
|
CreateResource |
Escritura |
|||
|
CreateRestApi |
Escritura |
|||
Escritura |
||||
Gestión de permisos, Write |
||||
|
CreateStage |
Escritura |
|||
Escritura |
||||
|
CreateUsagePlan |
Escritura |
|||
Escritura |
||||
|
CreateUsagePlanKey |
Escritura |
|||
|
CreateVpcLink |
Escritura |
|||
Escritura |
||||
|
DeleteApiKey |
Escritura |
|||
|
DeleteAuthorizer |
Escritura |
|||
|
DeleteBasePathMapping |
Escritura |
|||
|
DeleteClientCertificate |
Escritura |
|||
|
DeleteDeployment |
Escritura |
|||
|
DeleteDocumentationPart |
Escritura |
|||
|
DeleteDocumentationVersion |
Escritura |
|||
|
DeleteDomainName |
Escritura |
|||
Gestión de permisos, Write |
||||
|
DeleteDomainNameAccessAssociation |
Escritura |
|||
|
DeleteGatewayResponse |
Escritura |
|||
|
DeleteIntegration |
Escritura |
|||
|
DeleteIntegrationResponse |
Escritura |
|||
|
DeleteMethod |
Escritura |
|||
|
DeleteMethodResponse |
Escritura |
|||
|
DeleteModel |
Escritura |
|||
|
DeleteRequestValidator |
Escritura |
|||
|
DeleteResource |
Escritura |
|||
|
DeleteRestApi |
Escritura |
|||
|
DeleteStage |
Escritura |
|||
|
DeleteUsagePlan |
Escritura |
|||
|
DeleteUsagePlanKey |
Escritura |
|||
|
DeleteVpcLink |
Escritura |
|||
|
FlushStageAuthorizersCache |
Escritura |
|||
|
FlushStageCache |
Escritura |
|||
|
GenerateClientCertificate |
Escritura |
|||
Escritura |
||||
|
GetAccount |
Lectura |
|||
|
GetApiKey |
Lectura |
|||
|
GetApiKeys |
Lectura |
|||
|
GetAuthorizer |
Lectura |
|||
|
GetAuthorizers |
Lectura |
|||
|
GetBasePathMapping |
Lectura |
|||
|
GetBasePathMappings |
Lectura |
|||
|
GetClientCertificate |
Lectura |
|||
|
GetClientCertificates |
Lectura |
|||
|
GetDeployment |
Lectura |
|||
|
GetDeployments |
Lectura |
|||
|
GetDocumentationPart |
Lectura |
|||
|
GetDocumentationParts |
Lectura |
|||
|
GetDocumentationVersion |
Lectura |
|||
|
GetDocumentationVersions |
Lectura |
|||
|
GetDomainName |
Lectura |
|||
|
GetDomainNameAccessAssociations |
Lectura |
|||
|
GetDomainNames |
Lectura |
|||
|
GetExport |
Lectura |
|||
|
GetGatewayResponse |
Lectura |
|||
|
GetGatewayResponses |
Lectura |
|||
|
GetIntegration |
Lectura |
|||
|
GetIntegrationResponse |
Lectura |
|||
|
GetMethod |
Lectura |
|||
|
GetMethodResponse |
Lectura |
|||
|
GetModel |
Lectura |
|||
|
GetModelTemplate |
Lectura |
|||
|
GetModels |
Lectura |
|||
|
GetRequestValidator |
Lectura |
|||
|
GetRequestValidators |
Lectura |
|||
|
GetResource |
Lectura |
|||
|
GetResources |
Lectura |
|||
|
GetRestApi |
Lectura |
|||
|
GetRestApis |
Lectura |
|||
|
GetSdk |
Lectura |
|||
|
GetSdkType |
Lectura |
|||
|
GetSdkTypes |
Lectura |
|||
|
GetStage |
Lectura |
|||
|
GetStages |
Lectura |
|||
|
GetTags |
Lectura |
|||
|
GetUsage |
Lectura |
|||
|
GetUsagePlan |
Lectura |
|||
|
GetUsagePlanKey |
Lectura |
|||
|
GetUsagePlanKeys |
Lectura |
|||
|
GetUsagePlans |
Lectura |
|||
|
GetVpcLink |
Lectura |
|||
|
GetVpcLinks |
Lectura |
|||
|
ImportApiKeys |
Escritura |
|||
|
ImportDocumentationParts |
Escritura |
|||
|
ImportRestApi |
Escritura |
|||
Gestión de permisos, Write |
||||
iam:PassedToService |
apigateway.amazonaws.com |
Escritura |
||
|
PutGatewayResponse |
Escritura |
|||
|
PutIntegration |
Escritura |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Escritura |
||
|
PutIntegrationResponse |
Escritura |
|||
|
PutMethod |
Escritura |
|||
|
PutMethodResponse |
Escritura |
|||
|
PutRestApi |
Escritura |
|||
Gestión de permisos, Write |
||||
iam:PassedToService |
apigateway.amazonaws.com |
Escritura |
||
|
RejectDomainNameAccessAssociation |
Gestión de permisos, Write |
|||
|
TagResource |
Escritura |
|||
Escritura |
||||
Escritura |
||||
|
TestInvokeAuthorizer |
Escritura |
|||
|
TestInvokeMethod |
Escritura |
|||
|
UntagResource |
Escritura |
|||
Escritura |
||||
|
UpdateAccount |
Escritura |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Escritura |
||
|
UpdateApiKey |
Escritura |
|||
|
UpdateAuthorizer |
Escritura |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Escritura |
||
|
UpdateBasePathMapping |
Escritura |
|||
|
UpdateClientCertificate |
Escritura |
|||
|
UpdateDeployment |
Escritura |
|||
|
UpdateDocumentationPart |
Escritura |
|||
|
UpdateDocumentationVersion |
Escritura |
|||
|
UpdateDomainName |
Gestión de permisos, Write |
|||
Escritura |
||||
Gestión de permisos, Write |
||||
Gestión de permisos, Write |
||||
Gestión de permisos, Write |
||||
|
UpdateGatewayResponse |
Escritura |
|||
|
UpdateIntegration |
Escritura |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Escritura |
||
|
UpdateIntegrationResponse |
Escritura |
|||
|
UpdateMethod |
Escritura |
|||
|
UpdateMethodResponse |
Escritura |
|||
|
UpdateModel |
Escritura |
|||
|
UpdateRequestValidator |
Escritura |
|||
|
UpdateResource |
Escritura |
|||
|
UpdateRestApi |
Escritura |
|||
Gestión de permisos, Write |
||||
|
UpdateStage |
Escritura |
|||
|
UpdateUsage |
Escritura |
|||
|
UpdateUsagePlan |
Escritura |
|||
|
UpdateVpcLink |
Escritura |
Acciones definidas por la administración de Amazon API Gateway
Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Para cada acción, la tabla muestra los tipos de recursos y las claves de condición que admite esa acción. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.
Tipos de recursos definidos por la administración de Amazon API Gateway
Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM.
| Tipos de recurso | ARN | Claves de condición |
|---|---|---|
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 |
Claves de condición para la administración de Amazon API Gateway
La administración de Amazon API Gateway define las siguientes claves de condición que pueden usarse en el elemento Condition de una política de IAM.
| Claves de condición | Descripción | Tipo |
|---|---|---|
Filtra el acceso por fuente de asociación de acceso. Disponible durante el CreateDomainNameAccessAssociation operación |
String |
|
Filtra el acceso por destino del registro de acceso. Disponible durante el CreateStage y UpdateStage operaciones |
String |
|
Filtra el acceso por formato de registro de acceso. Disponible durante el CreateStage y UpdateStage operaciones |
String |
|
Filtra el acceso en función de si una clave de API es necesaria o no. Disponible durante el CreateMethod y PutMethod operaciones. También disponible como colección durante la importación y reimportación |
ArrayOfBool |
|
Filtra el acceso por nombre de API. Disponible durante el CreateRestApi y UpdateRestApi operaciones |
String |
|
Filtra el acceso por tipo de autorizador en la solicitud; por ejemplo, TOKEN, REQUEST, JWT. Disponible durante CreateAuthorizer y UpdateAuthorizer. También está disponible durante la importación y la reimportación como ArrayOfString |
ArrayOfString |
|
Filtra el acceso por estado del punto de enlace ejecute-api predeterminado. Disponible durante CreateRestApi y DeleteRestApi operaciones |
Bool |
|
Filtra el acceso por ARN del nombre de dominio. Disponible durante el CreateDomainNameAccessAssociation operación |
ARN |
|
Filtra el acceso por tipo de punto de enlace. Disponible durante el CreateDomainName, UpdateDomainName, CreateRestApi, y UpdateRestApi operaciones |
ArrayOfString |
|
Filtra el acceso por URI del almacén de confianza utilizado para la autenticación TLS mutua. Disponible durante el CreateDomainName y UpdateDomainName operaciones |
String |
|
Filtra el acceso por versión del almacén de confianza utilizado para la autenticación TLS mutua. Disponible durante el CreateDomainName y UpdateDomainName operaciones |
String |
|
Filtra el acceso por tipo de autorización; por ejemplo, NONE, AWS_IAM, CUSTOM, JWT, COGNITO_USER_POOLS. Disponible durante el CreateMethod y PutMethod las operaciones también están disponibles como colección durante la importación |
ArrayOfString |
|
Filtra el acceso por modo de enrutamiento del nombre de dominio. Disponible durante el CreateDomainName y UpdateDomainName operaciones |
String |
|
Filtra el acceso por versión TLS. Disponible durante el CreateDomain y UpdateDomain operaciones |
ArrayOfString |
|
Filtra el acceso por nombre de etapa de la implementación que intenta crear. Disponible durante el CreateDeployment operación |
String |
|
Filtra el acceso por destino del registro de acceso del recurso Stage actual. Disponible durante el UpdateStage y DeleteStage operaciones |
String |
|
Filtra el acceso por formato del registro de acceso del recurso Stage actual. Disponible durante el UpdateStage y DeleteStage operaciones |
String |
|
Filtra el acceso en función de si se requiere o no una clave de API para el recurso Method existente. Disponible durante el PutMethod y DeleteMethod operaciones. También disponible como colección durante la reimportación |
ArrayOfBool |
|
Filtra el acceso por nombre de API de la existente RestApi recurso. Disponible durante UpdateRestApi y DeleteRestApi operaciones |
String |
|
Filtra el acceso por el tipo de autorizador actual; por ejemplo, TOKEN, REQUEST, JWT. Disponible durante UpdateAuthorizer y DeleteAuthorizer operaciones. También está disponible durante la reimportación como ArrayOfString |
ArrayOfString |
|
Filtra el acceso según el estado del punto final de ejecución de la API predeterminado del actual RestApi recurso. Disponible durante UpdateRestApi y DeleteRestApi operaciones |
Bool |
|
Filtra el acceso por tipo de punto de enlace. Disponible durante el UpdateDomainName, DeleteDomainName, UpdateRestApi, y DeleteRestApi operaciones |
ArrayOfString |
|
Filtra el acceso por URI del almacén de confianza utilizado para la autenticación TLS mutua. Disponible durante UpdateDomainName y DeleteDomainName operaciones |
String |
|
Filtra el acceso por versión del almacén de confianza utilizado para la autenticación TLS mutua. Disponible durante UpdateDomainName y DeleteDomainName operaciones |
String |
|
Filtra el acceso por tipo de autorización del recurso Method existente; por ejemplo, NONE, AWS_IAM, CUSTOM, JWT, COGNITO_USER_POOLS. Disponible durante el PutMethod y DeleteMethod operaciones. También disponible como colección durante la reimportación |
ArrayOfString |
|
Filtra el acceso por modo de enrutamiento del nombre de dominio. Disponible durante el UpdateDomainName y DeleteDomainName operaciones |
String |
|
Filtra el acceso por versión TLS. Disponible durante UpdateDomain y DeleteDomain operaciones |
ArrayOfString |
|
Filtra el acceso por los pares clave-valor de la etiqueta en la solicitud |
String |
|
Filtra el acceso por las etiquetas asociadas a un recurso |
String |
|
Filtra las acciones mediante las claves de etiqueta en la solicitud. |
ArrayOfString |
