Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Actions, ressources et clés de condition pour Amazon API Gateway Management
Amazon API Gateway Management (préfixe du service : apigateway) fournit les opérations, ressources, actions et clés de condition spécifiques au service suivantes à utiliser dans les politiques d'autorisation IAM.
Références :
-
Découvrez comment configurer ce service.
-
Affichez la liste des opérations d'API disponibles pour ce service.
-
Découvrez comment protéger ce service et ses ressources avec les stratégies d'autorisation IAM.
-
Consultez le référence d'autorisation de service programmatique
pour ce service.
Rubriques
Opérations d'API définies par Amazon API Gateway Management
Le tableau suivant associe les opérations d'API aux actions IAM qu'elles autorisent. Seules les clés de condition qui ont des valeurs statiques pour l'API et l'action données sont répertoriées ; pour l'ensemble complet des clés de condition prises en charge par chaque action, consultez le Tableau des actions.
| Opération | Action IAM | Clé de condition | Valeur (s) possible (s) | Niveau d’accès |
|---|---|---|---|---|
|
CreateApiKey |
Écrire |
|||
Écrire |
||||
|
CreateAuthorizer |
Écrire |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Écrire |
||
|
CreateBasePathMapping |
Écrire |
|||
|
CreateDeployment |
Écrire |
|||
|
CreateDocumentationPart |
Écrire |
|||
|
CreateDocumentationVersion |
Écrire |
|||
|
CreateDomainName |
Gestion des autorisations, Rédaction |
|||
Écrire |
||||
Écrire |
||||
Gestion des autorisations, Rédaction |
||||
|
CreateDomainNameAccessAssociation |
Gestion des autorisations, Rédaction |
|||
Écrire |
||||
Écrire |
||||
|
CreateModel |
Écrire |
|||
|
CreateRequestValidator |
Écrire |
|||
|
CreateResource |
Écrire |
|||
|
CreateRestApi |
Écrire |
|||
Écrire |
||||
Gestion des autorisations, Rédaction |
||||
|
CreateStage |
Écrire |
|||
Écrire |
||||
|
CreateUsagePlan |
Écrire |
|||
Écrire |
||||
|
CreateUsagePlanKey |
Écrire |
|||
|
CreateVpcLink |
Écrire |
|||
Écrire |
||||
|
DeleteApiKey |
Écrire |
|||
|
DeleteAuthorizer |
Écrire |
|||
|
DeleteBasePathMapping |
Écrire |
|||
|
DeleteClientCertificate |
Écrire |
|||
|
DeleteDeployment |
Écrire |
|||
|
DeleteDocumentationPart |
Écrire |
|||
|
DeleteDocumentationVersion |
Écrire |
|||
|
DeleteDomainName |
Écrire |
|||
Gestion des autorisations, Rédaction |
||||
|
DeleteDomainNameAccessAssociation |
Écrire |
|||
|
DeleteGatewayResponse |
Écrire |
|||
|
DeleteIntegration |
Écrire |
|||
|
DeleteIntegrationResponse |
Écrire |
|||
|
DeleteMethod |
Écrire |
|||
|
DeleteMethodResponse |
Écrire |
|||
|
DeleteModel |
Écrire |
|||
|
DeleteRequestValidator |
Écrire |
|||
|
DeleteResource |
Écrire |
|||
|
DeleteRestApi |
Écrire |
|||
|
DeleteStage |
Écrire |
|||
|
DeleteUsagePlan |
Écrire |
|||
|
DeleteUsagePlanKey |
Écrire |
|||
|
DeleteVpcLink |
Écrire |
|||
|
FlushStageAuthorizersCache |
Écrire |
|||
|
FlushStageCache |
Écrire |
|||
|
GenerateClientCertificate |
Écrire |
|||
Écrire |
||||
|
GetAccount |
Lecture |
|||
|
GetApiKey |
Lecture |
|||
|
GetApiKeys |
Lecture |
|||
|
GetAuthorizer |
Lecture |
|||
|
GetAuthorizers |
Lecture |
|||
|
GetBasePathMapping |
Lecture |
|||
|
GetBasePathMappings |
Lecture |
|||
|
GetClientCertificate |
Lecture |
|||
|
GetClientCertificates |
Lecture |
|||
|
GetDeployment |
Lecture |
|||
|
GetDeployments |
Lecture |
|||
|
GetDocumentationPart |
Lecture |
|||
|
GetDocumentationParts |
Lecture |
|||
|
GetDocumentationVersion |
Lecture |
|||
|
GetDocumentationVersions |
Lecture |
|||
|
GetDomainName |
Lecture |
|||
|
GetDomainNameAccessAssociations |
Lecture |
|||
|
GetDomainNames |
Lecture |
|||
|
GetExport |
Lecture |
|||
|
GetGatewayResponse |
Lecture |
|||
|
GetGatewayResponses |
Lecture |
|||
|
GetIntegration |
Lecture |
|||
|
GetIntegrationResponse |
Lecture |
|||
|
GetMethod |
Lecture |
|||
|
GetMethodResponse |
Lecture |
|||
|
GetModel |
Lecture |
|||
|
GetModelTemplate |
Lecture |
|||
|
GetModels |
Lecture |
|||
|
GetRequestValidator |
Lecture |
|||
|
GetRequestValidators |
Lecture |
|||
|
GetResource |
Lecture |
|||
|
GetResources |
Lecture |
|||
|
GetRestApi |
Lecture |
|||
|
GetRestApis |
Lecture |
|||
|
GetSdk |
Lecture |
|||
|
GetSdkType |
Lecture |
|||
|
GetSdkTypes |
Lecture |
|||
|
GetStage |
Lecture |
|||
|
GetStages |
Lecture |
|||
|
GetTags |
Lecture |
|||
|
GetUsage |
Lecture |
|||
|
GetUsagePlan |
Lecture |
|||
|
GetUsagePlanKey |
Lecture |
|||
|
GetUsagePlanKeys |
Lecture |
|||
|
GetUsagePlans |
Lecture |
|||
|
GetVpcLink |
Lecture |
|||
|
GetVpcLinks |
Lecture |
|||
|
ImportApiKeys |
Écrire |
|||
|
ImportDocumentationParts |
Écrire |
|||
|
ImportRestApi |
Écrire |
|||
Gestion des autorisations, Rédaction |
||||
iam:PassedToService |
apigateway.amazonaws.com |
Écrire |
||
|
PutGatewayResponse |
Écrire |
|||
|
PutIntegration |
Écrire |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Écrire |
||
|
PutIntegrationResponse |
Écrire |
|||
|
PutMethod |
Écrire |
|||
|
PutMethodResponse |
Écrire |
|||
|
PutRestApi |
Écrire |
|||
Gestion des autorisations, Rédaction |
||||
iam:PassedToService |
apigateway.amazonaws.com |
Écrire |
||
|
RejectDomainNameAccessAssociation |
Gestion des autorisations, Rédaction |
|||
|
TagResource |
Écrire |
|||
Écrire |
||||
Écrire |
||||
|
TestInvokeAuthorizer |
Écrire |
|||
|
TestInvokeMethod |
Écrire |
|||
|
UntagResource |
Écrire |
|||
Écrire |
||||
|
UpdateAccount |
Écrire |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Écrire |
||
|
UpdateApiKey |
Écrire |
|||
|
UpdateAuthorizer |
Écrire |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Écrire |
||
|
UpdateBasePathMapping |
Écrire |
|||
|
UpdateClientCertificate |
Écrire |
|||
|
UpdateDeployment |
Écrire |
|||
|
UpdateDocumentationPart |
Écrire |
|||
|
UpdateDocumentationVersion |
Écrire |
|||
|
UpdateDomainName |
Gestion des autorisations, Rédaction |
|||
Écrire |
||||
Gestion des autorisations, Rédaction |
||||
Gestion des autorisations, Rédaction |
||||
Gestion des autorisations, Rédaction |
||||
|
UpdateGatewayResponse |
Écrire |
|||
|
UpdateIntegration |
Écrire |
|||
iam:PassedToService |
apigateway.amazonaws.com |
Écrire |
||
|
UpdateIntegrationResponse |
Écrire |
|||
|
UpdateMethod |
Écrire |
|||
|
UpdateMethodResponse |
Écrire |
|||
|
UpdateModel |
Écrire |
|||
|
UpdateRequestValidator |
Écrire |
|||
|
UpdateResource |
Écrire |
|||
|
UpdateRestApi |
Écrire |
|||
Gestion des autorisations, Rédaction |
||||
|
UpdateStage |
Écrire |
|||
|
UpdateUsage |
Écrire |
|||
|
UpdateUsagePlan |
Écrire |
|||
|
UpdateVpcLink |
Écrire |
Actions définies par Amazon API Gateway Management
Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. Pour chaque action, le tableau répertorie les types de ressources et les clés de condition pris en charge par cette action. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une politique, vous autorisez ou refusez généralement l'accès à l'opération d'API ou à la commande CLI portant le même nom. Toutefois, dans certains cas, une seule action contrôle l'accès à plusieurs opérations. D'autres opérations, quant à elles, requièrent plusieurs actions différentes.
Types de ressources définis par Amazon API Gateway Management
Ce service définit les types de ressources suivants, qui peuvent être utilisés dans l' Resource élément des déclarations de politique d'autorisation IAM.
| Types de ressources | ARN | Clés de condition |
|---|---|---|
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 |
Clés de condition pour Amazon API Gateway Management
Amazon API Gateway Management définit les clés de condition suivantes que vous pouvez utiliser dans l'élément Condition d'une politique IAM.
| Clés de condition | Description | Type |
|---|---|---|
Filtre l'accès par source d'association d'accès. Disponible pendant la CreateDomainNameAccessAssociation opération |
String |
|
Filtre l'accès en fonction de la destination du journal d'accès. Disponible pendant la CreateStage et UpdateStage opérations |
String |
|
Filtre l'accès en fonction du format de journal d'accès. Disponible pendant CreateStage et UpdateStage opérations |
String |
|
Filtre l'accès en fonction de la nécessité ou non d'une clé API. Disponible pendant CreateMethod et PutMethod opérations. Également disponible en collection lors de l'importation et de la réimportation |
ArrayOfBool |
|
Filtre l'accès en fonction du nom d'API. Disponible pendant la CreateRestApi et UpdateRestApi opérations |
String |
|
Filtre l'accès en fonction du type d'autorisation dans la demande, par exemple TOKEN, REQUEST, JWT. Disponible pendant CreateAuthorizer et UpdateAuthorizer. Également disponible lors de l'importation et de la réimportation en tant que ArrayOfString |
ArrayOfString |
|
Filtre l'accès en fonction du statut du point de terminaison execute-api par défaut. Disponible pendant la CreateRestApi et DeleteRestApi opérations |
Bool |
|
Filtre l'accès par nom de domaine ARN. Disponible pendant la CreateDomainNameAccessAssociation opération |
ARN |
|
Filtre l'accès en fonction du type de point de terminaison. Disponible pendant la CreateDomainName, UpdateDomainName, CreateRestApi, et UpdateRestApi opérations |
ArrayOfString |
|
Filtre l'accès en fonction de l'URI du magasin de confiance utilisé pour l'authentification TLS mutuelle. Disponible pendant CreateDomainName et UpdateDomainName opérations |
String |
|
Filtre l'accès en fonction de la version du magasin de confiance utilisé pour l'authentification TLS mutuelle. Disponible pendant CreateDomainName et UpdateDomainName opérations |
String |
|
Filtre l'accès en fonction du type d'autorisation, par exemple NONE, AWS_IAM, CUSTOM, JWT, COGNITO_USER_POOLS. Disponible pendant CreateMethod et PutMethod opérations Également disponible sous forme de collection lors de l'importation |
ArrayOfString |
|
Filtre l'accès par mode de routage du nom de domaine. Disponible pendant CreateDomainName et UpdateDomainName opérations |
String |
|
Filtre l'accès en fonction de la version TLS. Disponible pendant CreateDomain et UpdateDomain opérations |
ArrayOfString |
|
Filtre l'accès en fonction du nom d'étape du déploiement que vous tentez de créer. Disponible pendant CreateDeployment opération |
String |
|
Filtre l'accès en fonction de la destination du journal d'accès de la ressource Stage actuelle. Disponible pendant la UpdateStage et DeleteStage opérations |
String |
|
Filtre l'accès en fonction du format de journal d'accès de la ressource Stage actuelle. Disponible pendant UpdateStage et DeleteStage opérations |
String |
|
Filtre l'accès en fonction de la nécessité ou non d'une clé API pour la ressource Method existante. Disponible pendant PutMethod et DeleteMethod opérations. Également disponible en collection lors de la réimportation |
ArrayOfBool |
|
Filtre l'accès par nom d'API de l'existant RestApi ressource. Disponible pendant UpdateRestApi et DeleteRestApi opérations |
String |
|
Filtre l'accès en fonction du type actuel d'autorisation, par exemple TOKEN, REQUEST, JWT. Disponible pendant UpdateAuthorizer et DeleteAuthorizer opérations. Également disponible lors de la réimportation en tant que ArrayOfString |
ArrayOfString |
|
Filtre l'accès en fonction de l'état du point de terminaison execute-api par défaut de l'actuel RestApi ressource. Disponible pendant UpdateRestApi et DeleteRestApi opérations |
Bool |
|
Filtre l'accès en fonction du type de point de terminaison. Disponible pendant UpdateDomainName, DeleteDomainName, UpdateRestApi, et DeleteRestApi opérations |
ArrayOfString |
|
Filtre l'accès en fonction de l'URI du magasin de confiance utilisé pour l'authentification TLS mutuelle. Disponible pendant UpdateDomainName et DeleteDomainName opérations |
String |
|
Filtre l'accès en fonction de la version du magasin de confiance utilisé pour l'authentification TLS mutuelle. Disponible pendant UpdateDomainName et DeleteDomainName opérations |
String |
|
Filtre l'accès en fonction du type d'autorisation de la ressource Method existante, par exemple NONE, AWS_IAM, CUSTOM, JWT, COGNITO_USER_POOLS. Disponible pendant PutMethod et DeleteMethod opérations. Également disponible en collection lors de la réimportation |
ArrayOfString |
|
Filtre l'accès par mode de routage du nom de domaine. Disponible pendant UpdateDomainName et DeleteDomainName opérations |
String |
|
Filtre l'accès en fonction de la version TLS. Disponible pendant UpdateDomain et DeleteDomain opérations |
ArrayOfString |
|
Filtre l'accès en fonction des paires clé-valeur de la balise dans la demande |
String |
|
Filtre l'accès en fonction des balises attachées à une ressource |
String |
|
Filtrer l'accès en fonction des clés de balise dans la demande |
ArrayOfString |
