Operazioni, risorse e chiavi di condizione per Amazon API Gateway Management
Amazon API Gateway Management (prefisso del servizio:apigateway) fornisce le seguenti operazioni, risorse, azioni e chiavi di condizione specifiche del servizio da utilizzare nelle politiche di autorizzazione IAM.
Riferimenti:
-
Scopri come configurare questo servizio.
-
Visualizza un elenco delle operazioni API disponibili per questo servizio.
-
Scopri come proteggere questo servizio e le sue risorse utilizzando le policy delle autorizzazioni IAM.
-
Visualizza il riferimento programmatico all'autorizzazione del servizio
per questo servizio.
Argomenti
Operazioni API definite da Amazon API Gateway Management
La tabella seguente mappa le operazioni API alle azioni IAM che autorizzano. Sono elencate solo le chiavi di condizione che hanno valori statici per l'API e l'azione specificate; per il set completo di chiavi di condizione supportate da ciascuna azione, consulta la tabella Azioni.
| Operation | Azione IAM | Chiave di condizione | Valori possibili | Livello di accesso |
|---|---|---|---|---|
|
CreateApiKey |
Scrittura |
|||
Scrittura |
||||
|
CreateAuthorizer |
Scrittura |
|||
Io sono: PassedToService |
apigateway.amazonaws.com |
Scrittura |
||
|
CreateBasePathMapping |
Scrittura |
|||
|
CreateDeployment |
Scrittura |
|||
|
CreateDocumentationPart |
Scrittura |
|||
|
CreateDocumentationVersion |
Scrittura |
|||
|
CreateDomainName |
Gestione delle autorizzazioni, Write |
|||
Scrittura |
||||
Scrittura |
||||
Gestione delle autorizzazioni, Write |
||||
|
CreateDomainNameAccessAssociation |
Gestione delle autorizzazioni, Write |
|||
Scrittura |
||||
Scrittura |
||||
|
CreateModel |
Scrittura |
|||
|
CreateRequestValidator |
Scrittura |
|||
|
CreateResource |
Scrittura |
|||
|
CreateRestApi |
Scrittura |
|||
Scrittura |
||||
Gestione delle autorizzazioni, Write |
||||
|
CreateStage |
Scrittura |
|||
Scrittura |
||||
|
CreateUsagePlan |
Scrittura |
|||
Scrittura |
||||
|
CreateUsagePlanKey |
Scrittura |
|||
|
CreateVpcLink |
Scrittura |
|||
Scrittura |
||||
|
DeleteApiKey |
Scrittura |
|||
|
DeleteAuthorizer |
Scrittura |
|||
|
DeleteBasePathMapping |
Scrittura |
|||
|
DeleteClientCertificate |
Scrittura |
|||
|
DeleteDeployment |
Scrittura |
|||
|
DeleteDocumentationPart |
Scrittura |
|||
|
DeleteDocumentationVersion |
Scrittura |
|||
|
DeleteDomainName |
Scrittura |
|||
Gestione delle autorizzazioni, Write |
||||
|
DeleteDomainNameAccessAssociation |
Scrittura |
|||
|
DeleteGatewayResponse |
Scrittura |
|||
|
DeleteIntegration |
Scrittura |
|||
|
DeleteIntegrationResponse |
Scrittura |
|||
|
DeleteMethod |
Scrittura |
|||
|
DeleteMethodResponse |
Scrittura |
|||
|
DeleteModel |
Scrittura |
|||
|
DeleteRequestValidator |
Scrittura |
|||
|
DeleteResource |
Scrittura |
|||
|
DeleteRestApi |
Scrittura |
|||
|
DeleteStage |
Scrittura |
|||
|
DeleteUsagePlan |
Scrittura |
|||
|
DeleteUsagePlanKey |
Scrittura |
|||
|
DeleteVpcLink |
Scrittura |
|||
|
FlushStageAuthorizersCache |
Scrittura |
|||
|
FlushStageCache |
Scrittura |
|||
|
GenerateClientCertificate |
Scrittura |
|||
Scrittura |
||||
|
GetAccount |
Lettura |
|||
|
GetApiKey |
Lettura |
|||
|
GetApiKeys |
Lettura |
|||
|
GetAuthorizer |
Lettura |
|||
|
GetAuthorizers |
Lettura |
|||
|
GetBasePathMapping |
Lettura |
|||
|
GetBasePathMappings |
Lettura |
|||
|
GetClientCertificate |
Lettura |
|||
|
GetClientCertificates |
Lettura |
|||
|
GetDeployment |
Lettura |
|||
|
GetDeployments |
Lettura |
|||
|
GetDocumentationPart |
Lettura |
|||
|
GetDocumentationParts |
Lettura |
|||
|
GetDocumentationVersion |
Lettura |
|||
|
GetDocumentationVersions |
Lettura |
|||
|
GetDomainName |
Lettura |
|||
|
GetDomainNameAccessAssociations |
Lettura |
|||
|
GetDomainNames |
Lettura |
|||
|
GetExport |
Lettura |
|||
|
GetGatewayResponse |
Lettura |
|||
|
GetGatewayResponses |
Lettura |
|||
|
GetIntegration |
Lettura |
|||
|
GetIntegrationResponse |
Lettura |
|||
|
GetMethod |
Lettura |
|||
|
GetMethodResponse |
Lettura |
|||
|
GetModel |
Lettura |
|||
|
GetModelTemplate |
Lettura |
|||
|
GetModels |
Lettura |
|||
|
GetRequestValidator |
Lettura |
|||
|
GetRequestValidators |
Lettura |
|||
|
GetResource |
Lettura |
|||
|
GetResources |
Lettura |
|||
|
GetRestApi |
Lettura |
|||
|
GetRestApis |
Lettura |
|||
|
GetSdk |
Lettura |
|||
|
GetSdkType |
Lettura |
|||
|
GetSdkTypes |
Lettura |
|||
|
GetStage |
Lettura |
|||
|
GetStages |
Lettura |
|||
|
GetTags |
Lettura |
|||
|
GetUsage |
Lettura |
|||
|
GetUsagePlan |
Lettura |
|||
|
GetUsagePlanKey |
Lettura |
|||
|
GetUsagePlanKeys |
Lettura |
|||
|
GetUsagePlans |
Lettura |
|||
|
GetVpcLink |
Lettura |
|||
|
GetVpcLinks |
Lettura |
|||
|
ImportApiKeys |
Scrittura |
|||
|
ImportDocumentationParts |
Scrittura |
|||
|
ImportRestApi |
Scrittura |
|||
Gestione delle autorizzazioni, Write |
||||
Io sono: PassedToService |
apigateway.amazonaws.com |
Scrittura |
||
|
PutGatewayResponse |
Scrittura |
|||
|
PutIntegration |
Scrittura |
|||
Io sono: PassedToService |
apigateway.amazonaws.com |
Scrittura |
||
|
PutIntegrationResponse |
Scrittura |
|||
|
PutMethod |
Scrittura |
|||
|
PutMethodResponse |
Scrittura |
|||
|
PutRestApi |
Scrittura |
|||
Gestione delle autorizzazioni, Write |
||||
Io sono: PassedToService |
apigateway.amazonaws.com |
Scrittura |
||
|
RejectDomainNameAccessAssociation |
Gestione delle autorizzazioni, Write |
|||
|
TagResource |
Scrittura |
|||
Scrittura |
||||
Scrittura |
||||
|
TestInvokeAuthorizer |
Scrittura |
|||
|
TestInvokeMethod |
Scrittura |
|||
|
UntagResource |
Scrittura |
|||
Scrittura |
||||
|
UpdateAccount |
Scrittura |
|||
Io sono: PassedToService |
apigateway.amazonaws.com |
Scrittura |
||
|
UpdateApiKey |
Scrittura |
|||
|
UpdateAuthorizer |
Scrittura |
|||
Io sono: PassedToService |
apigateway.amazonaws.com |
Scrittura |
||
|
UpdateBasePathMapping |
Scrittura |
|||
|
UpdateClientCertificate |
Scrittura |
|||
|
UpdateDeployment |
Scrittura |
|||
|
UpdateDocumentationPart |
Scrittura |
|||
|
UpdateDocumentationVersion |
Scrittura |
|||
|
UpdateDomainName |
Gestione delle autorizzazioni, Write |
|||
Scrittura |
||||
Gestione delle autorizzazioni, Write |
||||
Gestione delle autorizzazioni, Write |
||||
Gestione delle autorizzazioni, Write |
||||
|
UpdateGatewayResponse |
Scrittura |
|||
|
UpdateIntegration |
Scrittura |
|||
Io sono: PassedToService |
apigateway.amazonaws.com |
Scrittura |
||
|
UpdateIntegrationResponse |
Scrittura |
|||
|
UpdateMethod |
Scrittura |
|||
|
UpdateMethodResponse |
Scrittura |
|||
|
UpdateModel |
Scrittura |
|||
|
UpdateRequestValidator |
Scrittura |
|||
|
UpdateResource |
Scrittura |
|||
|
UpdateRestApi |
Scrittura |
|||
Gestione delle autorizzazioni, Write |
||||
|
UpdateStage |
Scrittura |
|||
|
UpdateUsage |
Scrittura |
|||
|
UpdateUsagePlan |
Scrittura |
|||
|
UpdateVpcLink |
Scrittura |
Operazioni definite da Amazon API Gateway Management
Puoi specificare le seguenti operazioni nell'elemento Action di un'istruzione di policy IAM. Utilizza le policy per concedere le autorizzazioni per eseguire un'operazione in AWS. Quando utilizzi un'operazione in una policy, in genere consenti o rifiuti l'accesso all'operazione API o al comando CLI con lo stesso nome. Tuttavia, in alcuni casi, una singola operazione controlla l'accesso a più di una operazione. In alternativa, alcune operazioni richiedono operazioni differenti.
Tipi di risorsa definiti da Amazon API Gateway Management
I seguenti tipi di risorse sono definiti da questo servizio e possono essere utilizzati nell'elemento Resource delle istruzioni di policy delle autorizzazioni IAM.
| Tipi di risorse | ARN | Chiavi di condizione |
|---|---|---|
arn: $ {Partition} :apigateway: $ {Region}:: /account |
||
arn: $ {Partition} :apigateway: $ {Region}:: /apikeys/$ {} ApiKeyId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /apikeys |
||
arn: $ {Partition} :apigateway: $ {Region}: /apis/$ {} /authorizers/$ {}, arn: $ {PartitionApiId} :apigateway: $ {Region}:: /restapis/$ {AuthorizerId} /authorizers/$ {} RestApiId AuthorizerId |
apigateway: Request/AuthorizerType |
|
arn: $ {Partition} :apigateway: $ {Region}: /apis/$ {} /authorizers, arn: $ {Partition} :apigateway: $ {RegionApiId}:: /restapis/$ {} /authorizers RestApiId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /domainnames/$ {} /basepathmappings/$ {} DomainName BasePath |
||
arn: $ {Partition} :apigateway: $ {Region}:: /domainnames/$ {} /basepathmappings DomainName |
||
arn: $ {Partition} :apigateway: $ {Region}:: /clientcertificates/$ {} ClientCertificateId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /clientcertificates |
||
arn: $ {Partition} :apigateway: $ {Region}: /apis/$ {} /deployments/$ {}, arn: $ {PartitionApiId} :apigateway: $ {Region}:: /restapis/$ {DeploymentId} /deployments/$ {} RestApiId DeploymentId |
||
arn: $ {Partition} :apigateway: $ {Region}: /apis/$ {} /deployments, arn: $ {Partition} :apigateway: $ {RegionApiId}:: /restapis/$ {} /deployments RestApiId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {}//$ {} RestApiId documentation/parts DocumentationPartId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {}/RestApiIddocumentation/parts |
||
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {}//$ {} RestApiId documentation/versions DocumentationVersionId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {}/RestApiIddocumentation/versions |
||
arn: $ {Partition} :apigateway: $ {Region}:: /domainnames/$ {} DomainName |
apigateway: Request/EndpointType un gateway API: Request/MtlsTrustStoreUri un gateway API: Request/MtlsTrustStoreVersion un gateway API: Request/SecurityPolicy un gateway API: Resource/EndpointType un gateway API: Resource/MtlsTrustStoreUri un gateway API: Resource/MtlsTrustStoreVersion un gateway API: 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 un gateway API: Request/MtlsTrustStoreUri un gateway API: Request/MtlsTrustStoreVersion un gateway API: Request/SecurityPolicy |
|
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {} /gatewayresponses/$ {} RestApiId ResponseType |
||
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {} /gatewayresponse RestApiId |
||
arn: $ {Partition} :apigateway: $ {Region}: /apis/$ {} /integrations/$ {}, arn: $ {PartitionApiId} :apigateway: $ {Region}:: /restapis/$ {IntegrationId} /resources/$ {} /methods/$ {} /integrazione RestApiId ResourceId HttpMethodType |
||
arn: $ {Partition} :apigateway: $ {Region}:: /apis/$ {} /integrations/$ {} /integrationresponses/$ {ApiId}, arn: $ {PartitionIntegrationId} :apigateway: $ {Region}:: /restapis/$ {IntegrationResponseId} /resources/$ {} /methods/$ {}/$ {} /$ {} RestApiId ResourceId HttpMethodType integration/responses StatusCode |
||
arn: $ {Partition} :apigateway: $ {Region}: /restapis/$ {} /resources/$ {} /methods/$ {} RestApiId ResourceId HttpMethodType |
un gateway: Request/ApiKeyRequired un gateway API: Request/RouteAuthorizationType un gateway API: Resource/ApiKeyRequired |
|
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {} /resources/$ {} /methods/$ {} /respones/$ {} RestApiId ResourceId HttpMethodType StatusCode |
||
arn: $ {Partition} :apigateway: $ {Region}: /apis/$ {} /models/$ {}, arn: $ {PartitionApiId} :apigateway: $ {RegionModelId}:: /restapis/$ {} /models/$ {} RestApiId ModelName |
||
arn: $ {Partition} :apigateway: $ {Region}: /apis/$ {} /models, arn: $ {Partition} :apigateway: $ {RegionApiId}: /restapis/$ {} /models RestApiId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /domainnames/$ {} +$ {} /basepathmappings/$ {} DomainName DomainIdentifier BasePath |
||
arn: $ {Partition} :apigateway: $ {Region}:: /domainnames/$ {} +$ {} /basepathmappings DomainName DomainIdentifier |
||
arn: $ {Partition} :apigateway: $ {Region} :$ {Account} :/domainnames/$ {} +$ {} DomainName DomainIdentifier |
un gateway API: Request/EndpointType un gateway API: Resource/EndpointType |
|
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {} /requestvalidators/$ {} RestApiId RequestValidatorId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {} /requestvalidators RestApiId |
||
arn: $ {Partition} :apigateway: $ {Region}: /restapis/$ {} /resources/$ {} RestApiId ResourceId |
||
arn: $ {Partition} :apigateway: $ {Region}: /restapis/$ {} /resources RestApiId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {} RestApiId |
apigateway: Request/ApiKeyRequired un gateway API: Request/ApiName un gateway API: Request/AuthorizerType un gateway API: Request/DisableExecuteApiEndpoint un gateway API: Request/EndpointType un gateway API: Request/RouteAuthorizationType un gateway API: Request/SecurityPolicy un gateway API: Resource/ApiKeyRequired un gateway API: Resource/ApiName un gateway API: Resource/AuthorizerType un gateway API: Resource/DisableExecuteApiEndpoint un gateway API: Resource/EndpointType un gateway API: Resource/RouteAuthorizationType |
|
arn: $ {Partition} :apigateway: $ {Region}:: /restapis |
apigateway: Request/ApiKeyRequired un gateway API: Request/ApiName un gateway API: Request/AuthorizerType un gateway API: Request/DisableExecuteApiEndpoint un gateway API: Request/EndpointType un gateway API: Request/RouteAuthorizationType |
|
arn: $ {Partition} :apigateway: $ {Region}:: /restapis/$ {} /stages/$ {} /sdks/$ {} RestApiId StageName SdkType |
||
arn: $ {Partition} :apigateway: $ {Region}: /apis/$ {} /stages/$ {}, arn: $ {PartitionApiId} :apigateway: $ {RegionStageName}:: /restapis/$ {} /stages/$ {} RestApiId StageName |
un gateway API: Request/AccessLoggingDestination un gateway API: Request/AccessLoggingFormat un gateway API: Resource/AccessLoggingDestination |
|
arn: $ {Partition} :apigateway: $ {Region}: /apis/$ {} /stages, arn: $ {Partition} :apigateway: $ {RegionApiId}: /restapis/$ {} /stages RestApiId |
apigateway: Request/AccessLoggingDestination |
|
arn: $ {Partition} :apigateway: $ {Region}:: /tags/$ {} UrlEncodedResourceARN |
||
arn: $ {Partition} :apigateway: $ {Region}:://$ {} /template restapis/models ModelName |
||
arn: $ {Partition} :apigateway: $ {Region}:: /usageplans/$ {} UsagePlanId |
||
arn: $ {Partition} :apigateway: $ {Region}: /usageplans/$ {} /keys/$ {Id} UsagePlanId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /usageplans/$ {} /keys UsagePlanId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /usageplans |
||
arn: $ {Partition} :apigateway: $ {Region}:: /vpclinks/$ {} VpcLinkId |
||
arn: $ {Partition} :apigateway: $ {Region}:: /vpclinks |
Chiavi di condizione per Amazon API Gateway Management
Amazon API Gateway Management definisce le seguenti chiavi di condizione che possono essere utilizzate nell'elemento Condition di una policy IAM.
| Chiavi di condizione | Descrizione | Tipo |
|---|---|---|
Filtra l'accesso in base alla fonte dell'associazione di accesso. Disponibile durante l' CreateDomainNameAccessAssociation operazione |
Stringa |
|
Filtra l'accesso in base alla destinazione del log di accesso. Disponibile durante le operazioni CreateStage UpdateStage |
Stringa |
|
Filtra l'accesso in base al formato del log di accesso. Disponibile durante le operazioni CreateStage UpdateStage |
Stringa |
|
Filtra l'accesso in base alla necessità o meno di una chiave API. Disponibile durante le operazioni finali. CreateMethod PutMethod Disponibile anche come raccolta durante l'importazione e la reimportazione |
ArrayOfBool |
|
Filtra l'accesso in base al nome API. Disponibile durante le operazioni CreateRestApi UpdateRestApi |
Stringa |
|
Filtra l'accesso in base al tipo di autorizzazione nella richiesta, ad esempio TOKEN, REQUEST, JWT. Disponibile durante e. CreateAuthorizer UpdateAuthorizer Disponibile anche durante l'importazione e la reimportazione come ArrayOfString |
ArrayOfString |
|
Filtra l'accesso in base allo stato dell'endpoint execute-api predefinito. Disponibile durante le operazioni CreateRestApi DeleteRestApi |
Bool |
|
Filtra l'accesso per nome di dominio ARN. Disponibile durante l'operazione CreateDomainNameAccessAssociation |
ARN |
|
Filtra l'accesso in base al tipo di endpoint. Disponibile durante le operazioni CreateDomainName, UpdateDomainName, e CreateRestApi UpdateRestApi |
ArrayOfString |
|
Filtra l'accesso in base all'URI del Truststore utilizzato per l'autenticazione TLS reciproca. Disponibile durante le operazioni CreateDomainName UpdateDomainName |
Stringa |
|
Filtra l'accesso in base alla versione del Truststore utilizzato per l'autenticazione TLS reciproca. Disponibile durante le operazioni CreateDomainName UpdateDomainName |
Stringa |
|
Filtra l'accesso in base al tipo di autorizzazione, ad esempio NONE, AWS_IAM, CUSTOM, JWT, COGNITO_USER_POOLS. Disponibile durante le PutMethod operazioni CreateMethod e Disponibile anche come raccolta durante l'importazione |
ArrayOfString |
|
Filtra l'accesso in base alla modalità di routing del nome di dominio. Disponibile durante le operazioni CreateDomainName e UpdateDomainName |
Stringa |
|
Filtra l'accesso in base alla versione TLS. Disponibile durante le operazioni CreateDomain UpdateDomain |
ArrayOfString |
|
Filtra l'accesso in base al nome della fase della distribuzione che si tenta di creare. Disponibile durante l'operazione CreateDeployment |
Stringa |
|
Filtra l'accesso in base alla destinazione del log degli accessi della risorsa Stage corrente. Disponibile durante le operazioni UpdateStage DeleteStage |
Stringa |
|
Filtra l'accesso in base al formato del log degli accessi della risorsa Stage corrente. Disponibile durante le operazioni UpdateStage DeleteStage |
Stringa |
|
Filtra l'accesso in base alla necessità o meno di una chiave API per la risorsa Method esistente. Disponibile durante le operazioni finali. PutMethod DeleteMethod Disponibile anche come raccolta durante la reimportazione |
ArrayOfBool |
|
Filtra l'accesso in base al nome API della risorsa esistente. RestApi Disponibile durante UpdateRestApi e durante DeleteRestApi le operazioni |
Stringa |
|
Filtra l'accesso in base al tipo corrente di autorizzazione, ad esempio TOKEN, REQUEST, JWT. Disponibile durante le operazioni e durante le operazioni UpdateAuthorizer . DeleteAuthorizer Disponibile anche durante la reimportazione come ArrayOfString |
ArrayOfString |
|
Filtra l'accesso in base allo stato dell'endpoint execute-api predefinito della risorsa corrente. RestApi Disponibile durante le operazioni e durante le operazioni UpdateRestApi DeleteRestApi |
Bool |
|
Filtra l'accesso in base al tipo di endpoint. Disponibile durante le operazioni UpdateDomainName, DeleteDomainName, e UpdateRestApi DeleteRestApi |
ArrayOfString |
|
Filtra l'accesso in base all'URI del Truststore utilizzato per l'autenticazione TLS reciproca. Disponibile durante le operazioni UpdateDomainName DeleteDomainName |
Stringa |
|
Filtra l'accesso in base alla versione del Truststore utilizzato per l'autenticazione TLS reciproca. Disponibile durante le operazioni UpdateDomainName DeleteDomainName |
Stringa |
|
Filtra l'accesso in base al tipo di autorizzazione della risorsa Method esistente, ad esempio NONE, AWS_IAM, CUSTOM, JWT, COGNITO_USER_POOLS. Disponibile durante le operazioni finali. PutMethod DeleteMethod Disponibile anche come raccolta durante la reimportazione |
ArrayOfString |
|
Filtra l'accesso in base alla modalità di routing del nome di dominio. Disponibile durante le operazioni UpdateDomainName e DeleteDomainName |
Stringa |
|
Filtra l'accesso in base alla versione TLS. Disponibile durante le operazioni UpdateDomain DeleteDomain |
ArrayOfString |
|
Filtra l'accesso dalle coppie chiave-valore tag nella richiesta |
Stringa |
|
Filtra l'accesso dai tag collegati a una risorsa |
Stringa |
|
Filtra l'accesso in base alle chiavi tag nella richiesta |
ArrayOfString |