Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Azioni, risorse e chiavi di condizione per Amazon API Gateway Management V2
Amazon API Gateway Management V2 (prefisso del servizio:apigateway) fornisce le seguenti risorse, azioni e chiavi di contesto delle condizioni specifiche del servizio da utilizzare nelle politiche di autorizzazione. IAM
Riferimenti:
-
Scopri come configurare questo servizio.
-
Visualizza un elenco delle APIoperazioni disponibili per questo servizio.
-
Scopri come proteggere questo servizio e le sue risorse utilizzando le politiche di IAM autorizzazione.
Argomenti
Azioni definite da Amazon API Gateway Management V2
È possibile specificare le seguenti azioni nell'Actionelemento di una dichiarazione IAM politica. Utilizza le policy per concedere le autorizzazioni per eseguire un'operazione in AWS. Quando si utilizza un'azione in una politica, in genere si consente o si nega l'accesso all'APIoperazione o al CLI comando 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.
La colonna Tipi di risorsa della tabella Operazioni indica se ogni operazione supporta le autorizzazioni a livello di risorsa. Se non vi è nessun valore in corrispondenza di questa colonna, è necessario specificare tutte le risorse ("*") alle quali si applica la policy nell'elemento Resource dell'istruzione di policy. Se la colonna include un tipo di risorsa, è possibile specificarne uno ARN di quel tipo in un'istruzione con tale azione. Se l'operazione ha una o più risorse richieste, il chiamante deve disporre dell'autorizzazione per utilizzare l'operazione con tali risorse. Le risorse richieste sono indicate nella tabella con un asterisco (*). Se si limita l'accesso alle risorse con l'Resourceelemento di una IAM policy, è necessario includere uno schema ARN o per ogni tipo di risorsa richiesto. Alcune operazioni supportano più tipi di risorse. Se il tipo di risorsa è facoltativo (non indicato come obbligatorio), puoi scegliere di utilizzare uno tra i tipi di risorsa facoltativi.
La colonna Chiavi di condizione della tabella Operazioni contiene le chiavi che è possibile specificare nell'elemento Condition di un'istruzione di policy. Per ulteriori informazioni sulle chiavi di condizione associate alle risorse per il servizio guarda la colonna Chiavi di condizione della tabella Tipi di risorsa.
Nota
Le chiavi relative alle condizioni delle risorse sono elencate nella tabella Tipi di risorse. Nella colonna Tipi di risorse (*obbligatorio) della tabella Operazioni è presente un collegamento al tipo di risorsa che si applica a un'operazione. Il tipo di risorsa nella tabella Tipi di risorse include la colonna Chiavi di condizione, che contiene le chiavi delle condizioni delle risorse che si applicano a un'operazione nella tabella Operazioni.
Per dettagli sulle colonne nella tabella seguente, consultare Tabella delle operazioni.
| Azioni | Descrizione | Livello di accesso | Tipi di risorsa (*obbligatorio) | Chiavi di condizione | Operazioni dipendenti |
|---|---|---|---|---|---|
| DELETE | Concede l'autorizzazione per eliminare una determinata risorsa | Write | |||
| GET | Concede l'autorizzazione per leggere una determinata risorsa | Read | |||
| PATCH | Concede l'autorizzazione per aggiornare una determinata risorsa | Write | |||
| POST | Concede l'autorizzazione per creare una determinata risorsa | Write | |||
| PUT | Concede l'autorizzazione per aggiornare una determinata risorsa | Scrittura | |||
Tipi di risorse definiti da Amazon API Gateway Management V2
I seguenti tipi di risorse sono definiti da questo servizio e possono essere utilizzati nell'Resourceelemento delle dichiarazioni sulle politiche di IAM autorizzazione. Ogni operazione nella Tabella delle operazioni identifica i tipi di risorse che possono essere specificati con tale operazione. Un tipo di risorsa può anche definire quali chiavi di condizione puoi includere in una policy. Queste chiavi vengono visualizzate nell'ultima colonna della tabella Tipi di risorsa. Per dettagli sulle colonne nella tabella seguente, consulta Tabella dei tipi di risorsa.
| Tipi di risorsa | ARN | Chiavi di condizione |
|---|---|---|
| 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}
|
|
| 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
|
Chiavi di condizione per Amazon API Gateway Management V2
Amazon API Gateway Management V2 definisce le seguenti chiavi di condizione che possono essere utilizzate nell'Conditionelemento di una IAM policy. Puoi utilizzare queste chiavi per perfezionare ulteriormente le condizioni in base alle quali si applica l'istruzione di policy. Per dettagli sulle colonne nella tabella seguente, consulta Tabella delle chiavi di condizione.
Per visualizzare le chiavi di condizione globali disponibili per tutti i servizi, consulta Chiavi di condizione globali disponibili.
| Chiavi di condizione | Descrizione | Tipo |
|---|---|---|
| apigateway:Request/AccessLoggingDestination | Filtra l'accesso in base alla destinazione del log di accesso. Disponibile durante le operazioni CreateStage finali UpdateStage | Stringa |
| apigateway:Request/AccessLoggingFormat | Filtra l'accesso in base al formato del log di accesso. Disponibile durante le UpdateStage operazioni CreateStage e | Stringa |
| apigateway:Request/ApiKeyRequired | Filtra l'accesso in base al requisito diAPI. Disponibile durante le UpdateRoute operazioni CreateRoute e. Disponibile anche come raccolta durante l'importazione e la reimportazione | ArrayOfBool |
| apigateway:Request/ApiName | Filtra l'accesso per API nome. Disponibile durante le UpdateApi operazioni CreateApi e | Stringa |
| apigateway:Request/AuthorizerType | Filtra l'accesso per tipo di autorizzatore nella richiesta, ad esempio REQUEST oJWT. Disponibile durante CreateAuthorizer e. UpdateAuthorizer Disponibile anche durante l'importazione e la reimportazione come ArrayOfString | ArrayOfString |
| apigateway:Request/AuthorizerUri | Filtra l'accesso in base a una funzione URI di autorizzazione Lambda. Disponibile durante CreateAuthorizer e. UpdateAuthorizer Disponibile anche durante l'importazione e la reimportazione come ArrayOfString | ArrayOfString |
| apigateway:Request/DisableExecuteApiEndpoint | Filtra l'accesso in base allo stato dell'endpoint execute-api predefinito. Disponibile durante le operazioni CreateApi e UpdateApi | Bool |
| apigateway:Request/EndpointType | Filtra l'accesso in base al tipo di endpoint. Disponibile durante le UpdateApi operazioni CreateDomainName UpdateDomainName CreateApi,, e | ArrayOfString |
| apigateway:Request/MtlsTrustStoreUri | Filtra l'accesso in base URI al truststore utilizzato per TLS l'autenticazione reciproca. Disponibile durante le operazioni CreateDomainName e UpdateDomainName | Stringa |
| apigateway:Request/MtlsTrustStoreVersion | Filtra l'accesso in base alla versione del truststore utilizzata per TLS l'autenticazione reciproca. Disponibile durante le operazioni CreateDomainName e UpdateDomainName | Stringa |
| apigateway:Request/RouteAuthorizationType | Filtra l'accesso per tipo di autorizzazioneNONE, ad esempio AWS_IAM,CUSTOM,JWT. Disponibile durante CreateRoute le UpdateRoute operazioni finali. Disponibile anche come raccolta durante l'importazione | ArrayOfString |
| apigateway:Request/SecurityPolicy | Filtra l'accesso per TLS versione. Disponibile durante CreateDomain le UpdateDomain operazioni | ArrayOfString |
| apigateway:Request/StageName | Filtra l'accesso in base al nome della fase della distribuzione che si tenta di creare. Disponibile durante l' CreateDeployment operazione | Stringa |
| apigateway:Resource/AccessLoggingDestination | Filtra l'accesso in base alla destinazione del log degli accessi della risorsa Stage corrente. Disponibile durante UpdateStage le DeleteStage operazioni finali | Stringa |
| apigateway:Resource/AccessLoggingFormat | Filtra l'accesso in base al formato del log degli accessi della risorsa Stage corrente. Disponibile durante le DeleteStage operazioni UpdateStage e | Stringa |
| apigateway:Resource/ApiKeyRequired | Filtra l'accesso in base al requisito della API chiave per la risorsa Route esistente. Disponibile durante le DeleteRoute operazioni UpdateRoute e. Disponibile anche come raccolta durante la reimportazione | ArrayOfBool |
| apigateway:Resource/ApiName | Filtra l'accesso per API nome. Disponibile durante le DeleteApi operazioni UpdateApi e | Stringa |
| apigateway:Resource/AuthorizerType | Filtra l'accesso in base al tipo corrente di autorizzatore, ad esempio REQUEST oJWT. Disponibile durante UpdateAuthorizer e durante DeleteAuthorizer le operazioni. Disponibile anche durante l'importazione e la reimportazione come ArrayOfString | ArrayOfString |
| apigateway:Resource/AuthorizerUri | Filtra l'accesso tramite URI l'autorizzatore Lambda corrente associato alla corrente. API Disponibile durante UpdateAuthorizer e. DeleteAuthorizer Disponibile anche come raccolta durante la reimportazione | ArrayOfString |
| apigateway:Resource/DisableExecuteApiEndpoint | Filtra l'accesso in base allo stato dell'endpoint execute-api predefinito. Disponibile durante UpdateApi le DeleteApi operazioni finali | Bool |
| apigateway:Resource/EndpointType | Filtra l'accesso in base al tipo di endpoint. Disponibile durante le DeleteApi operazioni UpdateDomainName DeleteDomainName UpdateApi,, e | ArrayOfString |
| apigateway:Resource/MtlsTrustStoreUri | Filtra l'accesso in base URI al truststore utilizzato per TLS l'autenticazione reciproca. Disponibile durante le operazioni UpdateDomainName e DeleteDomainName | Stringa |
| apigateway:Resource/MtlsTrustStoreVersion | Filtra l'accesso in base alla versione del truststore utilizzata per TLS l'autenticazione reciproca. Disponibile durante le operazioni UpdateDomainName e DeleteDomainName | Stringa |
| apigateway:Resource/RouteAuthorizationType | Filtra l'accesso in base al tipo di autorizzazione della risorsa Route esistenteNONE, ad esempio AWS_IAM,CUSTOM. Disponibile durante le DeleteRoute operazioni UpdateRoute e. Disponibile anche come raccolta durante la reimportazione | ArrayOfString |
| apigateway:Resource/SecurityPolicy | Filtra l'accesso per TLS versione. Disponibile durante UpdateDomainName le DeleteDomainName operazioni | ArrayOfString |
| aws:RequestTag/${TagKey} | Filtra l'accesso in base alla presenza di coppie chiave-valore di tag nella richiesta | Stringa |
| aws:ResourceTag/${TagKey} | Filtra le operazioni in base alle coppie chiave-valore di tag collegate alla risorsa | Stringa |
| aws:TagKeys | Filtra l'accesso in base alla presenza di chiavi di tag nella richiesta | ArrayOfString |
