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 V2
La administración de Amazon API Gateway V2 (prefijo de servicio: apigateway) proporciona los siguientes recursos, acciones y claves de contexto de condición específicos del servicio para usarse 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.
Temas
Acciones definidas por la administración de Amazon API Gateway V2
Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. 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.
La columna Nivel de acceso de la tabla Acciones describe cómo se clasifica la acción (lista, lectura, administración de permisos o etiquetado). Esta clasificación puede ayudarle a entender el nivel de acceso que una acción concede cuando se utiliza en una política. Para obtener más información sobre los niveles de acceso, consulte Niveles de acceso en los resúmenes de políticas.
La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.
La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.
La columna Acciones dependientes de la tabla Acciones muestra los permisos adicionales que pueden ser necesarios para llamar a una acción correctamente. Es posible que estos permisos sean necesarios además del permiso para la acción en sí. Cuando una acción especifica acciones dependientes, esas dependencias pueden aplicarse a los recursos adicionales definidos para esa acción, no solo al primer recurso de la tabla.
nota
Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.
Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.
| Acciones | Descripción | Nivel de acceso | Tipos de recursos (*necesarios) | Claves de condición | Acciones dependientes |
|---|---|---|---|---|---|
| CreatePortal | Otorga permiso para crear un portal | Escritura | |||
|
apigateway:Request/PortalDisplayName apigateway:Request/PortalDomainName |
|||||
| CreatePortalProduct | Otorga permiso para crear un producto de portal | Escritura | |||
| CreateProductPage | Otorga permiso para crear una página de producto | Escritura | |||
| CreateProductRestEndpointPage | Otorga permiso para crear una página de punto final REST del producto | Escritura | |||
| CreateRoutingRule | Concede permiso para crear una regla de enrutamiento. | Escritura | |||
| DELETE | Otorga permiso para eliminar un recurso determinado | Escritura | |||
| DeletePortal | Otorga permiso para eliminar un portal | Escritura | |||
| DeletePortalProduct | Otorga permiso para eliminar un producto del portal | Escritura | |||
| DeletePortalProductSharingPolicy | Otorga permiso para eliminar una política de uso compartido de productos del portal | Administración de permisos | |||
| DeleteProductPage | Otorga permiso para eliminar una página de producto | Escritura | |||
| DeleteProductRestEndpointPage | Otorga permiso para eliminar una página de punto final REST de un producto | Escritura | |||
| DeleteRoutingRule | Concede permiso para eliminar una regla de enrutamiento. | Escritura | |||
| DisablePortal | Otorga permiso para deshabilitar un portal | Escritura | |||
| GET | Otorga permiso para leer un recurso determinado | Lectura | |||
| GetPortal | Otorga permiso para leer un portal | Lectura | |||
| GetPortalProduct | Otorga permiso para leer un producto del portal | Lectura | |||
| GetPortalProductSharingPolicy | Otorga permiso para leer una política de uso compartido de productos del portal | Lectura | |||
| GetProductPage | Otorga permiso para leer una página de producto | Lectura | |||
| GetProductRestEndpointPage | Otorga permiso para leer una página de punto final REST de un producto | Lectura | |||
| GetRoutingRule | Concede permiso para leer una regla de enrutamiento. | Lectura | |||
| ListPortalProducts | Otorga permiso para publicar los productos del portal | Enumeración | |||
| ListPortals | Otorga permiso para publicar portales | Enumeración | |||
| ListProductPages | Otorga permiso para publicar páginas de productos | Enumeración | |||
| ListProductRestEndpointPages | Otorga permiso para publicar páginas de puntos finales REST de productos | Enumeración | |||
| ListRoutingRules | Concede permiso para enumerar reglas de enrutamiento bajo un nombre de dominio. | Enumeración | |||
| PATCH | Otorga permiso para actualizar un recurso determinado | Write | |||
| POST | Otorga permiso para crear un recurso determinado | Write | |||
| PUT | Otorga permiso para actualizar un recurso determinado | Escritura | |||
| PreviewPortal | Otorga permiso para previsualizar un portal | Escritura | |||
| PublishPortal | Otorga permiso para publicar un portal | Escritura | |||
| PutPortalProductSharingPolicy | Otorga permiso para establecer una política de uso compartido de productos en el portal | Administración de permisos | |||
| UpdatePortal | Otorga permiso para actualizar un portal | Escritura | |||
|
apigateway:Request/PortalDisplayName apigateway:Request/PortalDomainName |
|||||
| UpdatePortalProduct | Otorga permiso para actualizar un producto del portal | Escritura | |||
| UpdateProductPage | Otorga permiso para actualizar una página de producto | Escritura | |||
| UpdateProductRestEndpointPage | Otorga permiso para actualizar la página de punto final REST de un producto | Escritura | |||
| UpdateRoutingRule | Otorga permiso para actualizar una regla de enrutamiento mediante la PutRoutingRule API | Escritura | |||
Tipos de recursos definidos por la administración de Amazon API Gateway V2
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. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.
| Tipos de recurso | ARN | Claves de condición |
|---|---|---|
| AccessLogSettings |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages/${StageName}/accesslogsettings
|
|
| Api |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}
|
apigateway:Request/ApiKeyRequired apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType apigateway:Request/RouteAuthorizationType apigateway:Resource/ApiKeyRequired apigateway:Resource/AuthorizerType apigateway:Resource/AuthorizerUri apigateway:Resource/DisableExecuteApiEndpoint apigateway:Resource/EndpointType |
| Apis |
arn:${Partition}:apigateway:${Region}::/apis
|
apigateway:Request/ApiKeyRequired apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType |
| ApiMapping |
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/apimappings/${ApiMappingId}
|
|
| ApiMappings |
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/apimappings
|
|
| Authorizer |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/authorizers/${AuthorizerId}
|
apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Resource/AuthorizerType |
| Authorizers |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/authorizers
|
apigateway:Request/AuthorizerType |
| AuthorizersCache |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages/${StageName}/cache/authorizers
|
|
| Cors |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/cors
|
|
| Deployment |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/deployments/${DeploymentId}
|
|
| Deployments |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/deployments
|
|
| ExportedAPI |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/exports/${Specification}
|
|
| Integration |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations/${IntegrationId}
|
|
| Integrations |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations
|
|
| IntegrationResponse |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations/${IntegrationId}/integrationresponses/${IntegrationResponseId}
|
|
| IntegrationResponses |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations/${IntegrationId}/integrationresponses
|
|
| Model |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/models/${ModelId}
|
|
| Models |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/models
|
|
| ModelTemplate |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/models/${ModelId}/template
|
|
| Route |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/routes/${RouteId}
|
apigateway:Request/ApiKeyRequired apigateway:Request/RouteAuthorizationType apigateway:Resource/ApiKeyRequired |
| Routes |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/routes
|
apigateway:Request/ApiKeyRequired |
| RouteResponse |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/routes/${RouteId}/routeresponses/${RouteResponseId}
|
|
| RouteResponses |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/routes/${RouteId}/routeresponses
|
|
| RouteRequestParameter |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/routes/${RouteId}/requestparameters/${RequestParameterKey}
|
|
| RouteSettings |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages/${StageName}/routesettings/${RouteKey}
|
|
| RoutingRule |
arn:${Partition}:apigateway:${Region}:${Account}:/domainnames/${DomainName}/routingrules/${RoutingRuleId}
|
|
| Stage |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages/${StageName}
|
apigateway:Request/AccessLoggingDestination apigateway:Request/AccessLoggingFormat apigateway:Resource/AccessLoggingDestination |
| Stages |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages
|
apigateway:Request/AccessLoggingDestination |
| VpcLink |
arn:${Partition}:apigateway:${Region}::/vpclinks/${VpcLinkId}
|
|
| VpcLinks |
arn:${Partition}:apigateway:${Region}::/vpclinks
|
|
| Portal |
arn:${Partition}:apigateway:${Region}:${Account}:/portals/${PortalId}
|
apigateway:Resource/CognitoUserPoolArn apigateway:Resource/PortalDisplayName apigateway:Resource/PortalDomainName |
| PortalProduct |
arn:${Partition}:apigateway:${Region}:${Account}:/portalproducts/${PortalProductId}
|
|
| ProductPage |
arn:${Partition}:apigateway:${Region}:${Account}:/portalproducts/${PortalProductId}/productpages/${ProductPageId}
|
|
| ProductRestEndpointPage |
arn:${Partition}:apigateway:${Region}:${Account}:/portalproducts/${PortalProductId}/productrestendpointpages/${ProductRestEndpointPageId}
|
Claves de condición para la administración de Amazon API Gateway V2
La administración de Amazon API Gateway V2 define las siguientes claves de condición que pueden utilizarse en el elemento Condition de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla de Claves de condición.
A fin de ver las claves de condición globales que están disponibles para todos los servicios, consulte AWS Claves de contexto de condición globales.
| Claves de condición | Descripción | Tipo |
|---|---|---|
| apigateway:Request/AccessLoggingDestination | Filtra el acceso por destino del registro de acceso. Disponible durante las UpdateStage operaciones CreateStage y | Cadena |
| apigateway:Request/AccessLoggingFormat | Filtra el acceso por formato de registro de acceso. Disponible durante las UpdateStage operaciones CreateStage y | Cadena |
| apigateway:Request/ApiKeyRequired | Filtra el acceso por el requisito de la API. Disponible durante las UpdateRoute operaciones CreateRoute y. También disponible como colección durante la importación y reimportación | ArrayOfBool |
| apigateway:Request/ApiName | Filtra el acceso por nombre de API. Disponible durante las UpdateApi operaciones CreateApi y | Cadena |
| apigateway:Request/AuthorizerType | Filtra el acceso por tipo de autorizador en la solicitud; por ejemplo, REQUEST o JWT. Disponible durante CreateAuthorizer y UpdateAuthorizer. También disponible durante la importación y la reimportación como ArrayOfString | ArrayOfString |
| apigateway:Request/AuthorizerUri | Filtra el acceso por URI de una función de autorización de Lambda. Disponible durante CreateAuthorizer y. UpdateAuthorizer También disponible durante la importación y la reimportación como ArrayOfString | ArrayOfString |
| apigateway:Request/CognitoUserPoolArn | Filtra el acceso realizado por el Portal CognitoUserPoolArn que se incluye en la solicitud | ARN |
| apigateway:Request/ConditionBasePaths | Filtra el acceso por rutas base definidas en función de una regla de enrutamiento. Disponible durante las UpdateRoutingRule operaciones CreateRoutingRule y | ArrayOfString |
| apigateway:Request/DisableExecuteApiEndpoint | Filtra el acceso por estado del punto de enlace ejecute-api predeterminado. Disponible durante las UpdateApi operaciones CreateApi y | Bool |
| apigateway:Request/EndpointType | Filtra el acceso por tipo de punto de enlace. Disponible durante CreateDomainName las UpdateApi operaciones UpdateDomainName CreateApi, y | ArrayOfString |
| apigateway:Request/Method | Filtra el acceso mediante ProductRestEndpointPage el método HTTP que se pasa en la solicitud | Cadena |
| apigateway:Request/MtlsTrustStoreUri | Filtra el acceso por URI del almacén de confianza utilizado para la autenticación TLS mutua. Disponible durante las UpdateDomainName operaciones CreateDomainName y | Cadena |
| apigateway:Request/MtlsTrustStoreVersion | Filtra el acceso por versión del almacén de confianza utilizado para la autenticación TLS mutua. Disponible durante las UpdateDomainName operaciones CreateDomainName y | Cadena |
| apigateway:Request/PortalDisplayName | Filtra el acceso por el nombre para mostrar del portal que se incluye en la solicitud | Cadena |
| apigateway:Request/PortalDomainName | Filtra el acceso por el nombre de dominio personalizado del Portal que se incluye en la solicitud | Cadena |
| apigateway:Request/PortalProductDisplayName | Filtra el acceso por PortalProduct el nombre para mostrar que se incluye en la solicitud | Cadena |
| apigateway:Request/Priority | Filtra el acceso según la prioridad de la regla de enrutamiento. Disponible durante las UpdateRoutingRule operaciones CreateRoutingRule y | Numérico |
| apigateway:Request/ProductPageTitle | Filtra el acceso por ProductPage el título que se incluye en la solicitud | Cadena |
| apigateway:Request/ProductRestEndpointPageEndpointPrefix | Filtra el acceso por ProductRestEndpointPage la EndpointPrefix letra a que se pasa en la solicitud | Cadena |
| apigateway:Request/RestApiId | Filtra el acceso por el ID ProductRestEndpointPage de API de Amazon API Gateway que se pasa en la solicitud | Cadena |
| apigateway:Request/RouteAuthorizationType | Filtra el acceso por tipo de autorización, por ejemplo, NONE AWS_IAM, CUSTOM o JWT. Disponible durante las UpdateRoute operaciones CreateRoute y. También disponible como colección durante la importación | ArrayOfString |
| apigateway:Request/RoutingMode | Filtra el acceso por modo de enrutamiento del nombre de dominio. Disponible durante las UpdateDomainName operaciones CreateDomainName y | Cadena |
| apigateway:Request/SecurityPolicy | Filtra el acceso por versión TLS. Disponible durante las UpdateDomain operaciones CreateDomain y | ArrayOfString |
| apigateway:Request/Stage | Filtra el acceso por el nombre ProductRestEndpointPage de etapa de Amazon API Gateway que se pasa en la solicitud | Cadena |
| apigateway:Request/StageName | Filtra el acceso por nombre de etapa de la implementación que intenta crear. Disponible durante la CreateDeployment operación | Cadena |
| apigateway:Resource/AccessLoggingDestination | Filtra el acceso por destino del registro de acceso del recurso Stage actual. Disponible durante las DeleteStage operaciones UpdateStage y | Cadena |
| apigateway:Resource/AccessLoggingFormat | Filtra el acceso por formato del registro de acceso del recurso Stage actual. Disponible durante las DeleteStage operaciones UpdateStage y | Cadena |
| apigateway:Resource/ApiKeyRequired | Filtra el acceso por el requisito de clave de API para el recurso Route existente. Disponible durante las DeleteRoute operaciones UpdateRoute y. También disponible como colección durante la reimportación | ArrayOfBool |
| apigateway:Resource/ApiName | Filtra el acceso por nombre de API. Disponible durante las DeleteApi operaciones UpdateApi y | Cadena |
| apigateway:Resource/AuthorizerType | Filtra el acceso por el tipo actual de autorizador; por ejemplo, REQUEST o JWT. Disponible durante las DeleteAuthorizer operaciones UpdateAuthorizer y durante las mismas. También está disponible durante la importación y la reimportación como ArrayOfString | ArrayOfString |
| apigateway:Resource/AuthorizerUri | Filtra el acceso por el URI del autorizador de Lambda actual asociado a la API actual. Disponible durante UpdateAuthorizer y. DeleteAuthorizer También disponible como colección durante la reimportación | ArrayOfString |
| apigateway:Resource/CognitoUserPoolArn | Filtra el acceso por parte de un portal CognitoUserPoolArn asociado al recurso | ARN |
| apigateway:Resource/ConditionBasePaths | Filtra el acceso por rutas base definidas en función de la regla de enrutamiento existente. Disponible durante las DeleteRoutingRule operaciones UpdateRoutingRule y | ArrayOfString |
| apigateway:Resource/DisableExecuteApiEndpoint | Filtra el acceso por estado del punto de enlace ejecute-api predeterminado. Disponible durante las DeleteApi operaciones UpdateApi y | Bool |
| apigateway:Resource/EndpointType | Filtra el acceso por tipo de punto de enlace. Disponible durante UpdateDomainName las DeleteApi operaciones DeleteDomainName UpdateApi, y | ArrayOfString |
| apigateway:Resource/Method | Filtra el acceso mediante un ProductRestEndpointPage método HTTP asociado al recurso | Cadena |
| apigateway:Resource/MtlsTrustStoreUri | Filtra el acceso por URI del almacén de confianza utilizado para la autenticación TLS mutua. Disponible durante las DeleteDomainName operaciones UpdateDomainName y | Cadena |
| apigateway:Resource/MtlsTrustStoreVersion | Filtra el acceso por versión del almacén de confianza utilizado para la autenticación TLS mutua. Disponible durante las DeleteDomainName operaciones UpdateDomainName y | Cadena |
| apigateway:Resource/PortalDisplayName | Filtra el acceso por el nombre para mostrar del portal asociado al recurso | Cadena |
| apigateway:Resource/PortalDomainName | Filtra el acceso por el nombre de dominio personalizado del portal asociado al recurso | Cadena |
| apigateway:Resource/PortalProductDisplayName | Filtra el acceso por PortalProduct el nombre para mostrar asociado al recurso | Cadena |
| apigateway:Resource/PortalPublishStatus | Filtra el acceso según el estado publicado de un portal asociado al recurso | Cadena |
| apigateway:Resource/Priority | Filtra el acceso según la prioridad de la regla de enrutamiento existente. Disponible durante las DeleteRoutingRule operaciones UpdateRoutingRule y | Numérico |
| apigateway:Resource/ProductPageTitle | Filtra el acceso por el título asociado al recurso ProductPage | Cadena |
| apigateway:Resource/ProductRestEndpointPageEndpointPrefix | Filtra el acceso por un ProductRestEndpointPage EndpointPrefix elemento asociado al recurso | Cadena |
| apigateway:Resource/RestApiId | Filtra el acceso por el ID ProductRestEndpointPage de API de Amazon API Gateway asociado al recurso | Cadena |
| apigateway:Resource/RouteAuthorizationType | Filtra el acceso por tipo de autorización del recurso de ruta existente, por ejemplo, NONE AWS_IAM, CUSTOM. Disponible durante las DeleteRoute operaciones UpdateRoute y. También disponible como colección durante la reimportación | ArrayOfString |
| apigateway:Resource/RoutingMode | Filtra el acceso por modo de enrutamiento del nombre de dominio existente. Disponible durante las DeleteDomainName operaciones UpdateDomainName y | Cadena |
| apigateway:Resource/SecurityPolicy | Filtra el acceso por versión TLS. Disponible durante las DeleteDomainName operaciones UpdateDomainName y | ArrayOfString |
| apigateway:Resource/Stage | Filtra el acceso por el nombre ProductRestEndpointPage de etapa de Amazon API Gateway asociado al recurso | Cadena |
| aws:RequestTag/${TagKey} | Filtra el acceso según si hay pares de clave-valor de etiqueta en la solicitud. | Cadena |
| aws:ResourceTag/${TagKey} | Filtra el acceso por los pares de clave-valor de etiqueta adjuntados al recurso | Cadena |
| aws:TagKeys | Filtra el acceso en función de la presencia de claves de etiqueta en la solicitud | ArrayOfString |
