Actions, ressources et clés de condition pour AWS AppSync

AWS AppSync (préfixe de service :appsync) fournit les ressources, actions et clés de contexte 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 politiques d'autorisation IAM.

Actions définies par AWS AppSync

Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une stratégie, 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.

La colonne Types de ressources indique si chaque action prend en charge les autorisations au niveau des ressources. S'il n'y a pas de valeur pour cette colonne, vous devez indiquer toutes les ressources (« * ») dans l'élément Resource de votre déclaration de politique. Si la colonne inclut un type de ressource, vous pouvez indiquer un ARN de ce type dans une déclaration avec cette action. Si l'action comporte une ou plusieurs ressources requises, l'appelant doit être autorisé à utiliser l'action avec ces ressources. Les ressources requises sont indiquées dans le tableau par un astérisque (*). Si vous limitez l'accès aux ressources avec l'Resourceélément dans une politique IAM, vous devez inclure un ARN ou un modèle pour chaque type de ressource requis. Certaines actions prennent en charge plusieurs types de ressources. Si le type de ressource est facultatif (non indiqué comme obligatoire), vous pouvez choisir d'utiliser l'un, mais pas l'autre.

La colonne Clés de condition inclut des clés que vous pouvez spécifier dans l'élément Condition d'une déclaration de politique. Pour plus d'informations sur les clés de condition associées aux ressources du service, consultez la colonne Clés de condition du tableau des types de ressources.

Note

Les clés de condition des ressources sont répertoriées dans le tableau Types de ressources. Vous pouvez trouver un lien vers le type de ressource qui s'applique à une action dans la colonne Types de ressources (* obligatoire) du tableau Actions. Le type de ressource indiqué dans le tableau Types de ressources inclut la colonne Clés de condition, qui contient les clés de condition de ressource qui s'appliquent à une action dans le tableau Actions.

Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Actions.

Actions	Description	Niveau d'accès	Types de ressources (*obligatoire)	Clés de condition	Actions dépendantes
AssociateApi	Accorde l'autorisation d'associer une API GraphQL à un nom de domaine personnalisé dans AppSync	Écrire	domain*
AssociateMergedGraphqlApi	Accorde l'autorisation d'associer une API fusionnée à une API source.	Écrire	graphqlapi*
AssociateSourceGraphqlApi	Accorde l'autorisation d'associer une API source à une API fusionnée.	Écrire	graphqlapi*
CreateApiCache	Accorde l'autorisation de créer un cache d'API dans AppSync	Écrire
CreateApiKey	Accorde l'autorisation de créer une clé unique que vous pouvez distribuer aux clients qui exécutent votre API	Écrire
CreateDataSource	Accorde l'autorisation de créer une source de données.	Écrire
CreateDomainName	Accorde l'autorisation de créer un nom de domaine personnalisé dans AppSync	Écrire
CreateFunction	Accorde l'autorisation de créer une fonction	Écrire
CreateGraphqlApi	Accorde l'autorisation de créer une API GraphQL, qui est la ressource de premier niveau AppSync	Écrire		aws:RequestTag/${TagKey} aws:TagKeys appsync:Visibility	iam:CreateServiceLinkedRole
CreateResolver	Accorde l'autorisation de créer un résolveur. Un résolveur convertit les demandes entrantes dans un format qu'une source de données peut comprendre, et convertit les réponses de la source de données en GraphQL	Écrire
CreateType	Accorde l'autorisation de créer un type	Écrire
DeleteApiCache	Accorde l'autorisation de supprimer un cache d'API dans AppSync	Écrire
DeleteApiKey	Accorde l'autorisation de supprimer une clé d'API	Écrire
DeleteDataSource	Accorde l'autorisation de supprimer une source de données.	Écrire
DeleteDomainName	Accorde l'autorisation de supprimer un nom de domaine personnalisé dans AppSync	Écrire	domain*
DeleteFunction	Accorde l'autorisation de supprimer une fonction	Écrire
DeleteGraphqlApi	Accorde l'autorisation de supprimer une API GraphQL. Cela nettoiera également toutes les AppSync ressources situées en dessous de cette API	Écrire	graphqlapi*
				aws:ResourceTag/${TagKey}
DeleteResolver	Accorde l'autorisation de supprimer un résolveur	Écrire
DeleteResourcePolicy [autorisation uniquement]	Accorde l'autorisation de supprimer une stratégie de ressources.	Écrire
DeleteType	Accorde l'autorisation de supprimer un type	Écrire
DisassociateApi	Accorde l'autorisation de détacher une API GraphQL d'un nom de domaine personnalisé dans AppSync	Écrire	domain*
DisassociateMergedGraphqlApi	Accorde l'autorisation de supprimer une API source associée d'une API fusionnée identifiée par l'API source.	Écrire	mergedApiAssociation*
DisassociateSourceGraphqlApi	Accorde l'autorisation de supprimer une API source associée d'une API fusionnée identifiée par l'API fusionnée.	Écrire	sourceApiAssociation*
EvaluateCode	Accorde l'autorisation d'évaluer le code à l'aide d'une durée d'exécution et d'un contexte	Lecture
EvaluateMappingTemplate	Accorde l'autorisation d'évaluer le mappage de modèle	Lecture
FlushApiCache	Accorde l'autorisation de vider le cache d'une API AppSync	Écrire
GetApiAssociation	Accorde l'autorisation de lire les détails de l'association entre le nom de domaine personnalisé et l'API GraphQL dans AppSync	Lecture	domain*
GetApiCache	Accorde l'autorisation de lire les informations relatives à un cache d'API dans AppSync	Lecture
GetDataSource	Accorde l'autorisation de récupérer une source de données	Lecture
GetDataSourceIntrospection	Octroie l'autorisation de récupérer une introspection de source de données.	Lecture
GetDomainName	Accorde l'autorisation de lire les informations relatives à un nom de domaine personnalisé dans AppSync	Lecture	domain*
GetFunction	Accorde l'autorisation de récupérer une fonction	Lecture
GetGraphqlApi	Accorde l'autorisation de récupérer une API GraphQL	Lecture	graphqlapi*
				aws:ResourceTag/${TagKey}
GetGraphqlApiEnvironmentVariables	Accorde l'autorisation de récupérer les variables d'environnement pour une API GraphQL	Lecture
GetIntrospectionSchema	Accorde l'autorisation de récupérer le schéma d'introspection d'une API GraphQL	Lecture
GetResolver	Accorde l'autorisation de récupérer un résolveur	Lecture
GetResourcePolicy [autorisation uniquement]	Accorde l'autorisation de lire une stratégie de ressources.	Lecture
GetSchemaCreationStatus	Accorde l'autorisation de récupérer le statut actuel d'une opération de création de schéma	Lecture
GetSourceApiAssociation	Accorde l'autorisation de lire les informations relatives à une API source associée à une API fusionnée.	Lecture	sourceApiAssociation*
GetType	Accorde l'autorisation de récupérer un type	Lecture
GraphQL	Accorde l'autorisation d'envoyer une requête GraphQL à une API GraphQL	Écrire	field*
			graphqlapi*
ListApiKeys	Accorde l'autorisation de répertorier les clés d'une API donnée	Liste
ListDataSources	Accorde l'autorisation de répertorier les sources de données d'une API donnée	Liste
ListDomainNames	Accorde l'autorisation d'énumérer des noms de domaine personnalisés dans AppSync	Liste
ListFunctions	Accorde l'autorisation de répertorier les fonctions d'une API donnée	Liste
ListGraphqlApis	Accorde l'autorisation de répertorier les API GraphQL	Liste
ListResolvers	Accorde l'autorisation de répertorier les résolveurs d'une API et d'un type donnés	Liste
ListResolversByFunction	Accorde l'autorisation de répertorier les résolveurs associés à une fonction spécifique	Liste
ListSourceApiAssociations	Accorde l'autorisation de répertorier les API sources associées à une API fusionnée donnée.	Liste
ListTagsForResource	Accorde l'autorisation de répertorier les balises d'une ressource	Lecture	graphqlapi
				aws:ResourceTag/${TagKey}
ListTypes	Accorde l'autorisation de répertorier les types d'une API donnée	Liste
ListTypesByAssociation	Accorde l'autorisation de répertorier les types d'une association d'API fusionnée et d'API source données.	Liste
PutGraphqlApiEnvironmentVariables	Accorde l'autorisation de mettre à jour les variables d'environnement pour une API GraphQL	Écrire
PutResourcePolicy [autorisation uniquement]	Accorde l'autorisation de définir une stratégie de ressources.	Écrire
SetWebACL	Accorde l'autorisation de définir une liste ACL web	Écrire
SourceGraphQL [autorisation uniquement]	Accorde l'autorisation d'envoyer une requête GraphQL à une API source d'une API fusionnée.	Écrire	field*
			graphqlapi*
StartDataSourceIntrospection	Octroie l'autorisation de procéder à l'introspection d'une source de données.	Écrire
StartSchemaCreation	Accorde l'autorisation d'ajouter un nouveau schéma à votre API GraphQL. Cette opération est asynchrone : elle GetSchemaCreationStatus peut s'afficher lorsqu'elle est terminée	Écrire
StartSchemaMerge	Accorde l'autorisation de lancer une fusion de schémas pour une API fusionnée donnée et l'API source associée.	Écrire	sourceApiAssociation*
TagResource	Accorde l'autorisation de baliser une ressource	Balisage	graphqlapi*
			graphqlapi
				aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys
UntagResource	Accorde l'autorisation d'annuler le balisage d'une ressource	Identification	graphqlapi*
			graphqlapi
				aws:TagKeys
UpdateApiCache	Accorde l'autorisation de mettre à jour un cache d'API dans AppSync	Écrire
UpdateApiKey	Accorde l'autorisation de mettre à jour la clé d'une API donnée	Écrire
UpdateDataSource	Accorde l'autorisation de mettre à jour une source de données	Écrire
UpdateDomainName	Accorde l'autorisation de mettre à jour un nom de domaine personnalisé dans AppSync	Écrire	domain*
UpdateFunction	Accorde l'autorisation de mettre à jour une fonction existante	Écrire
UpdateGraphqlApi	Accorde l'autorisation de mettre à jour une API GraphQL	Écrire	graphqlapi*		iam:CreateServiceLinkedRole
				aws:ResourceTag/${TagKey}
UpdateResolver	Accorde l'autorisation de mettre à jour un résolveur	Écrire
UpdateSourceApiAssociation	Accorde l'autorisation de mettre à jour l'association d'une API fusionnée et d'une API source.	Écrire	sourceApiAssociation*
UpdateType	Accorde l'autorisation de mettre à jour un type	Écrire

Types de ressources définis par AWS AppSync

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. Chaque action du tableau Actions identifie les types de ressources pouvant être spécifiés avec cette action. Un type de ressource peut également définir les clés de condition que vous pouvez inclure dans une politique. Ces clés sont affichées dans la dernière colonne du tableau. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Types de ressources.

Types de ressources	ARN	Clés de condition
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}

Clés de condition pour AWS AppSync

AWS AppSync définit les clés de condition suivantes qui peuvent être utilisées dans l'Conditionélément d'une politique IAM. Vous pouvez utiliser ces clés pour affiner les conditions d'application de la déclaration de politique. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Clés de condition.

Pour afficher les clés de condition globales disponibles pour tous les services, consultez Clés de condition globales disponibles.

Clés de condition	Description	Type
appsync:Visibility	Filtre l'accès en fonction de la visibilité d'une API	Chaîne
aws:RequestTag/${TagKey}	Filtre l'accès en fonction des paires clé-valeur de la balise dans la demande	Chaîne
aws:ResourceTag/${TagKey}	Filtre l'accès en fonction des paires clé-valeur d'identification attachées à la ressource	Chaîne
aws:TagKeys	Filtre l'accès en fonction de la présence de clés d'identification dans la demande	ArrayOfString