Azioni, risorse e chiavi di condizione per AWS AppSync

AWS AppSync (prefisso di servizio:appsync) 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 operazioni API disponibili per questo servizio.

• Scopri come proteggere questo servizio e le sue risorse utilizzando le policy delle autorizzazioni IAM.

Operazioni definite da AWS AppSync

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.

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, puoi specificare un ARN di quel tipo in una istruzione con tale operazione. 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'elemento Resource in una policy IAM, è necessario includere un ARN o un modello per ogni tipo di risorsa richiesta. 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
AssociateApi	Concede l'autorizzazione a collegare un'API GraphQL a un nome di dominio personalizzato in AppSync	Scrittura	domain*
AssociateMergedGraphqlApi	Concede l'autorizzazione ad associare un'API unita a un'API di origine	Scrittura	graphqlapi*
AssociateSourceGraphqlApi	Concede l'autorizzazione ad associare un'API di origine a un'API unita	Scrittura	graphqlapi*
CreateApiCache	Concede l'autorizzazione a creare una cache API in AppSync	Scrittura
CreateApiKey	Concede l'autorizzazione per creare una chiave univoca che è possibile distribuire ai client che eseguono l'API	Scrittura
CreateDataSource	Concede l'autorizzazione per creare un'origine dati	Scrittura
CreateDomainName	Concede l'autorizzazione a creare un nome di dominio personalizzato in AppSync	Scrittura
CreateFunction	Concede l'autorizzazione per creare una nuova funzione	Scrittura
CreateGraphqlApi	Concede l'autorizzazione a creare un'API GraphQL, che è la risorsa di primo livello AppSync	Scrittura		aws:RequestTag/${TagKey} aws:TagKeys appsync:Visibility	iam:CreateServiceLinkedRole
CreateResolver	Concede l'autorizzazione per creare un resolver. Un resolver converte le richieste in entrata in un formato che un'origine dati è in grado di comprendere e converte le risposte dell'origine dati in GraphQL.	Scrittura
CreateType	Concede l'autorizzazione per creare un tipo	Scrittura
DeleteApiCache	Concede l'autorizzazione a eliminare una cache API in AppSync	Scrittura
DeleteApiKey	Concede l'autorizzazione per eliminare una chiave API	Scrittura
DeleteDataSource	Concede l'autorizzazione per eliminare un'origine dati	Scrittura
DeleteDomainName	Concede l'autorizzazione a eliminare un nome di dominio personalizzato in AppSync	Scrittura	domain*
DeleteFunction	Concede l'autorizzazione per eliminare una funzione	Scrittura
DeleteGraphqlApi	Concede l'autorizzazione per eliminare un'API GraphQL. Ciò pulirà anche ogni AppSync risorsa al di sotto di quell'API	Scrittura	graphqlapi*
				aws:ResourceTag/${TagKey}
DeleteResolver	Concede l'autorizzazione per eliminare un resolver	Scrittura
DeleteResourcePolicy [solo autorizzazione]	Concede l'autorizzazione per rimuovere una policy delle risorse	Scrittura
DeleteType	Concede l'autorizzazione per eliminare un tipo	Scrittura
DisassociateApi	Concede l'autorizzazione a scollegare un'API GraphQL a un nome di dominio personalizzato in AppSync	Scrittura	domain*
DisassociateMergedGraphqlApi	Concede l'autorizzazione a rimuovere un'API di origine associata da un'API unita identificata dall'API di origine	Scrittura	mergedApiAssociation*
DisassociateSourceGraphqlApi	Concede l'autorizzazione a rimuovere un'API di origine associata da un'API unita identificata dall'API unita	Scrittura	sourceApiAssociation*
EvaluateCode	Concede l'autorizzazione per valutare il codice con un runtime e un contesto	Lettura
EvaluateMappingTemplate	Concede l'autorizzazione per valutare la mappatura dei modelli	Lettura
FlushApiCache	Concede l'autorizzazione a svuotare una cache API AppSync	Scrittura
GetApiAssociation	Concede l'autorizzazione a leggere i dettagli dell'associazione dell'API GraphQL in AppSync	Lettura	domain*
GetApiCache	Concede l'autorizzazione a leggere le informazioni su una cache API in AppSync	Lettura
GetDataSource	Concede l'autorizzazione per recuperare un'origine dati	Lettura
GetDataSourceIntrospection	Concede l'autorizzazione per recuperare l'introspezione di un'origine dati	Lettura
GetDomainName	Concede l'autorizzazione a leggere le informazioni su un nome di dominio personalizzato in AppSync	Lettura	domain*
GetFunction	Concede l'autorizzazione per recuperare una funzione	Lettura
GetGraphqlApi	Concede l'autorizzazione per recuperare un'API GraphQL	Lettura	graphqlapi*
				aws:ResourceTag/${TagKey}
GetGraphqlApiEnvironmentVariables	Concede il permesso di recuperare le variabili di ambiente per un'API GraphQL	Lettura
GetIntrospectionSchema	Concede l'autorizzazione per recuperare lo schema di introspezione per un'API GraphQL	Lettura
GetResolver	Concede l'autorizzazione per recuperare un resolver	Lettura
GetResourcePolicy [solo autorizzazione]	Concede l'autorizzazione per leggere una policy della risorsa	Lettura
GetSchemaCreationStatus	Concede l'autorizzazione per recuperare lo stato corrente di un'operazione di creazione dello schema	Lettura
GetSourceApiAssociation	Concede l'autorizzazione per leggere le informazioni su un'API unita associata all'API di origine	Lettura	sourceApiAssociation*
GetType	Concede l'autorizzazione per recuperare un tipo	Lettura
GraphQL	Concede l'autorizzazione per inviare una query GraphQL a un'API GraphQL	Scrittura	field*
			graphqlapi*
ListApiKeys	Concede l'autorizzazione per elencare le chiavi API per una determinata API	Elenco
ListDataSources	Concede l'autorizzazione per elencare le origini dati per una determinata API	Elenco
ListDomainNames	Concede l'autorizzazione a enumerare nomi di dominio personalizzati in AppSync	Elenco
ListFunctions	Concede l'autorizzazione per elencare le funzioni per una determinata API	Elenco
ListGraphqlApis	Concede l'autorizzazione per elencare le API GraphQL	Elenco
ListResolvers	Concede l'autorizzazione per elencare i resolver per una determinata API e tipo	Elenco
ListResolversByFunction	Concede l'autorizzazione per elencare i resolver associati a una funzione specifica	Elenco
ListSourceApiAssociations	Concede l'autorizzazione per elencare le API di origine associate a una determinata API unita	Elenco
ListTagsForResource	Concede l'autorizzazione per elencare i tag per una risorsa	Lettura	graphqlapi
				aws:ResourceTag/${TagKey}
ListTypes	Concede l'autorizzazione per elencare i tipi per una determinata API	Elenco
ListTypesByAssociation	Concede l'autorizzazione per elencare i tipi per una determinata API unita e un'associazione di API di origine	Elenco
PutGraphqlApiEnvironmentVariables	Concede il permesso di aggiornare le variabili di ambiente per un'API GraphQL	Scrittura
PutResourcePolicy [solo autorizzazione]	Concede l'autorizzazione per impostare una policy della risorsa	Scrittura
SetWebACL	Concede l'autorizzazione per impostare un ACL Web	Scrittura
SourceGraphQL [solo autorizzazione]	Concede l'autorizzazione per inviare una query GraphQL a un'API di origine di un'API unita	Scrittura	field*
			graphqlapi*
StartDataSourceIntrospection	Concede l'autorizzazione per eseguire l'introspezione di un'origine dati	Scrittura
StartSchemaCreation	Concede l'autorizzazione per aggiungere un nuovo schema all'API GraphQL. Questa operazione è asincrona: GetSchemaCreationStatus può essere visualizzata quando è stata completata	Scrittura
StartSchemaMerge	Concede l'autorizzazione per avviare un'unione di schemi per una determinata API unita e l'API di origine associata	Scrittura	sourceApiAssociation*
TagResource	Concede l'autorizzazione per applicare un tag a una risorsa.	Applicazione di tag	graphqlapi*
			graphqlapi
				aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys
UntagResource	Concede l'autorizzazione per rimuovere un tag da una risorsa.	Assegnazione di tag	graphqlapi*
			graphqlapi
				aws:TagKeys
UpdateApiCache	Concede l'autorizzazione ad aggiornare una cache API in AppSync	Scrittura
UpdateApiKey	Concede l'autorizzazione per aggiornare una chiave API per una determinata API	Scrittura
UpdateDataSource	Concede l'autorizzazione per aggiornare un'origine dati	Scrittura
UpdateDomainName	Concede l'autorizzazione ad aggiornare un nome di dominio personalizzato in AppSync	Scrittura	domain*
UpdateFunction	Concede l'autorizzazione per aggiornare una funzione esistente	Scrittura
UpdateGraphqlApi	Concede l'autorizzazione per aggiornare un'API GraphQL	Scrittura	graphqlapi*		iam:CreateServiceLinkedRole
				aws:ResourceTag/${TagKey}
UpdateResolver	Concede l'autorizzazione per aggiornare un resolver	Scrittura
UpdateSourceApiAssociation	Concede l'autorizzazione per aggiornare l'associazione di un'API di origine a un'API unita	Scrittura	sourceApiAssociation*
UpdateType	Concede l'autorizzazione per aggiornare un tipo	Scrittura

Tipi di risorsa definiti da AWS AppSync

I seguenti tipi di risorse sono definiti da questo servizio e possono essere utilizzati nell'elemento Resource delle istruzioni di policy delle autorizzazioni IAM. 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
datasource	arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}/datasources/${DatasourceName}
domain	arn:${Partition}:appsync:${Region}:${Account}:domainnames/${DomainName}
graphqlapi	arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}	aws:ResourceTag/${TagKey}
field	arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}/types/${TypeName}/fields/${FieldName}
type	arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}/types/${TypeName}
function	arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}/functions/${FunctionId}
sourceApiAssociation	arn:${Partition}:appsync:${Region}:${Account}:apis/${MergedGraphQLAPIId}/sourceApiAssociations/${Associationid}
mergedApiAssociation	arn:${Partition}:appsync:${Region}:${Account}:apis/${SourceGraphQLAPIId}/mergedApiAssociations/${Associationid}

Chiavi di condizione per l' AWS AppSync

AWS AppSync definisce le seguenti chiavi di condizione che possono essere utilizzate nell'Conditionelemento di una policy IAM. 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	Type
appsync:Visibility	Filtra l'accesso in base alla visibilità di un'API	Stringa
aws:RequestTag/${TagKey}	Filtra l'accesso dalle coppie chiave-valore tag nella richiesta	Stringa
aws:ResourceTag/${TagKey}	Filtra l'accesso 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