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 Amazon API Gateway Management
Amazon API Gateway Management (prefijo de servicio:apigateway
) proporciona los siguientes recursos, acciones y claves de contexto de condición específicos del servicio para su uso en IAM las políticas de permisos.
Referencias:
-
Obtenga información para configurar este servicio.
-
Consulte una lista de las APIoperaciones disponibles para este servicio.
-
Aprenda a proteger este servicio y sus recursos mediante políticas de IAM permisos.
Temas
Acciones definidas por la administración de Amazon API Gateway
Puede especificar las siguientes acciones en el Action
elemento de una declaración de IAM política. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando se utiliza una acción en una política, normalmente se permite o deniega el acceso a la API operación o CLI comando 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 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 uno ARN de ese tipo en una declaración con esa 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 Resource
elemento de una IAM política, debe incluir un patrón ARN o 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.
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 |
---|---|---|---|---|---|
AddCertificateToDomain | Otorga permiso para añadir certificados de TLS autenticación mutua a un nombre de dominio. Este es un control de autorización adicional para administrar el DomainName recurso debido a la naturaleza confidencial de m TLS | Administración de permisos | |||
DELETE | Otorga permiso para eliminar un recurso determinado | Write | |||
GET | Otorga permiso para leer un recurso determinado | Read | |||
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 | |||
RemoveCertificateFromDomain | Otorga permiso para eliminar los certificados de TLS autenticación mutua de un nombre de dominio. Este es un control de autorización adicional para administrar el DomainName recurso debido a la naturaleza confidencial de m TLS | Administración de permisos | |||
SetWebACL | Otorga permiso para establecer una lista de control de WAF acceso (ACL). Este es un control de autorización adicional para administrar el recurso de Stage debido a la naturaleza confidencial WebAcl de | Administración de permisos | |||
UpdateRestApiPolicy | Otorga permiso para administrar la política de IAM recursos de unAPI. Este es un control de autorización adicional para administrar un, API debido a la naturaleza delicada de la política de recursos | Administración de permisos | |||
Tipos de recursos definidos por Amazon API Gateway Management
Este servicio define los siguientes tipos de recursos y se pueden utilizar como Resource
elemento de las declaraciones de política de IAM permisos. 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 |
---|---|---|
Account |
arn:${Partition}:apigateway:${Region}::/account
|
|
ApiKey |
arn:${Partition}:apigateway:${Region}::/apikeys/${ApiKeyId}
|
|
ApiKeys |
arn:${Partition}:apigateway:${Region}::/apikeys
|
|
Authorizer |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/authorizers/${AuthorizerId}
|
apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Resource/AuthorizerType |
Authorizers |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/authorizers
|
apigateway:Request/AuthorizerType |
BasePathMapping |
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/basepathmappings/${BasePath}
|
|
BasePathMappings |
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/basepathmappings
|
|
ClientCertificate |
arn:${Partition}:apigateway:${Region}::/clientcertificates/${ClientCertificateId}
|
|
ClientCertificates |
arn:${Partition}:apigateway:${Region}::/clientcertificates
|
|
Deployment |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/deployments/${DeploymentId}
|
|
Deployments |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/deployments
|
|
DocumentationPart |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/parts/${DocumentationPartId}
|
|
DocumentationParts |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/documentation/parts
|
|
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 |
DomainNames |
arn:${Partition}:apigateway:${Region}::/domainnames
|
apigateway:Request/EndpointType apigateway:Request/MtlsTrustStoreUri apigateway:Request/MtlsTrustStoreVersion |
GatewayResponse |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/gatewayresponses/${ResponseType}
|
|
GatewayResponses |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/gatewayresponses
|
|
Integration |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/integration
|
|
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 |
MethodResponse |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources/${ResourceId}/methods/${HttpMethodType}/responses/${StatusCode}
|
|
Model |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/models/${ModelName}
|
|
Models |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/models
|
|
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}
|
|
Resources |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/resources
|
|
RestApi |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}
|
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 |
RestApis |
arn:${Partition}:apigateway:${Region}::/restapis
|
apigateway:Request/ApiKeyRequired apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType |
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 |
Stages |
arn:${Partition}:apigateway:${Region}::/restapis/${RestApiId}/stages
|
apigateway:Request/AccessLoggingDestination |
Template |
arn:${Partition}:apigateway:${Region}::/restapis/models/${ModelName}/template
|
|
UsagePlan |
arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId}
|
|
UsagePlans |
arn:${Partition}:apigateway:${Region}::/usageplans
|
|
UsagePlanKey |
arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId}/keys/${Id}
|
|
UsagePlanKeys |
arn:${Partition}:apigateway:${Region}::/usageplans/${UsagePlanId}/keys
|
|
VpcLink |
arn:${Partition}:apigateway:${Region}::/vpclinks/${VpcLinkId}
|
|
VpcLinks |
arn:${Partition}:apigateway:${Region}::/vpclinks
|
|
Tags |
arn:${Partition}:apigateway:${Region}::/tags/${UrlEncodedResourceARN}
|
Claves de condición de Amazon API Gateway Management
Amazon API Gateway Management define las siguientes claves de condición que se pueden utilizar en el Condition
elemento de una IAM política. 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.
Para ver las claves de condición globales que están disponibles para todos los servicios, consulte Claves de condición globales disponibles.
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 en función de si se requiere o no una API clave. Disponible durante las PutMethod operaciones CreateMethod y. También disponible como colección durante la importación y reimportación | ArrayOfBool |
apigateway:Request/ApiName | Filtra el acceso por API nombre. Disponible durante las UpdateRestApi operaciones CreateRestApi y | Cadena |
apigateway:Request/AuthorizerType | Filtra el acceso por tipo de autorizador de la solicitud, por ejemplo TOKENREQUEST,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 mediante una función URI de autorización Lambda. Disponible durante CreateAuthorizer y. UpdateAuthorizer También disponible durante la importación y la reimportación como ArrayOfString | ArrayOfString |
apigateway:Request/DisableExecuteApiEndpoint | Filtra el acceso por estado del punto de enlace ejecute-api predeterminado. Disponible durante las operaciones CreateRestApi y DeleteRestApi | Bool |
apigateway:Request/EndpointType | Filtra el acceso por tipo de punto de enlace. Disponible durante CreateDomainName las UpdateRestApi operaciones UpdateDomainName CreateRestApi, y | ArrayOfString |
apigateway:Request/MtlsTrustStoreUri | Filtra el acceso por el almacén URI de confianza utilizado para la TLS autenticación mutua. Disponible durante las operaciones CreateDomainName y UpdateDomainName | Cadena |
apigateway:Request/MtlsTrustStoreVersion | Filtra el acceso por versión del almacén de confianza utilizado para la TLS autenticación mutua. Disponible durante las operaciones CreateDomainName y UpdateDomainName | Cadena |
apigateway:Request/RouteAuthorizationType | Filtra el acceso por tipo de autorización, por ejemplo NONE AWS_IAM,CUSTOM,JWT,, COGNITO _ USER _POOLS. Disponible durante las PutMethod operaciones CreateMethod y También disponible como colección durante la importación | ArrayOfString |
apigateway:Request/SecurityPolicy | Filtra el acceso por TLS versión. Disponible durante las UpdateDomain operaciones CreateDomain y | ArrayOfString |
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 en función de si se requiere o no una API clave para el recurso de método existente. Disponible durante las DeleteMethod operaciones PutMethod y. También disponible como colección durante la reimportación | ArrayOfBool |
apigateway:Resource/ApiName | Filtra el acceso por API nombre del RestApi recurso existente. Disponible durante DeleteRestApi las operaciones UpdateRestApi y | Cadena |
apigateway:Resource/AuthorizerType | Filtra el acceso según el tipo de autorizador actual, por ejemplo TOKENREQUEST,JWT. Disponible durante las DeleteAuthorizer operaciones UpdateAuthorizer y durante las mismas. También está disponible durante la reimportación como ArrayOfString | ArrayOfString |
apigateway:Resource/AuthorizerUri | Filtra el acceso mediante una función URI de autorización Lambda. Disponible durante las operaciones UpdateAuthorizer y durante las mismas. DeleteAuthorizer También está disponible durante la reimportación como ArrayOfString | ArrayOfString |
apigateway:Resource/DisableExecuteApiEndpoint | Filtra el acceso según el estado del punto final execute-api predeterminado del recurso actual. RestApi Disponible durante las operaciones UpdateRestApi y DeleteRestApi | Bool |
apigateway:Resource/EndpointType | Filtra el acceso por tipo de punto de enlace. Disponible durante UpdateDomainName las DeleteRestApi operaciones DeleteDomainName UpdateRestApi, y | ArrayOfString |
apigateway:Resource/MtlsTrustStoreUri | Filtra el acceso por el almacén URI de confianza utilizado para la TLS autenticación mutua. Disponible durante las operaciones UpdateDomainName y DeleteDomainName | Cadena |
apigateway:Resource/MtlsTrustStoreVersion | Filtra el acceso por versión del almacén de confianza utilizado para la TLS autenticación mutua. Disponible durante las operaciones UpdateDomainName y DeleteDomainName | Cadena |
apigateway:Resource/RouteAuthorizationType | Filtra el acceso por tipo de autorización del recurso Method existenteNONE, por ejemplo AWS_IAMCUSTOM,JWT,, COGNITO _ USER _POOLS. Disponible durante las DeleteMethod operaciones PutMethod y. También disponible como colección durante la reimportación | ArrayOfString |
apigateway:Resource/SecurityPolicy | Filtra el acceso por TLS versión. Disponible durante UpdateDomain y durante DeleteDomain las operaciones | ArrayOfString |
aws:RequestTag/${TagKey} | Filtra el acceso por los pares clave-valor de la etiqueta en la solicitud | Cadena |
aws:ResourceTag/${TagKey} | Filtra el acceso por las etiquetas asociadas a un recurso | Cadena |
aws:TagKeys | Filtra las acciones mediante las claves de etiqueta en la solicitud. | ArrayOfString |