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 AWS AppSync
AWS AppSync (préfixe de service :appsync) fournit les ressources, actions et clés contextuelles de condition spécifiques au service suivantes à utiliser dans IAM les politiques d'autorisation.
Références :
-
Découvrez comment configurer ce service.
-
Consultez la liste des APIopérations disponibles pour ce service.
-
Découvrez comment protéger ce service et ses ressources avec les stratégies d'autorisation IAM.
Rubriques
Actions définies par AWS AppSync
Vous pouvez spécifier les actions suivantes dans l'élément Action d'une instruction de stratégie IAM. 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'APIopération ou à la CLI commande 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 spécifier un type ARN de ressource de ce type dans une instruction comportant 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 d'une IAM politique, vous devez inclure un modèle ARN ou 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 un GraphQL API à un nom de domaine personnalisé dans AppSync | Écrire | |||
| AssociateMergedGraphqlApi | Accorde l'autorisation d'associer une fusion API à une source API | Écrire | |||
| AssociateSourceGraphqlApi | Accorde l'autorisation d'associer une source API à une fusion API | Écrire | |||
| CreateApi | Accorde l'autorisation de créer un API | Écrire |
iam:CreateServiceLinkedRole |
||
| CreateApiCache | Accorde l'autorisation de créer un API cache 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 | |||
| CreateChannelNamespace | Autorise la création d'un espace de noms de chaîne | É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 un GraphQLAPI, qui est la ressource de premier niveau AppSync | Écrire |
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 | |||
| DeleteApi | Accorde l'autorisation de supprimer unAPI. Cela nettoiera également toutes les AppSync ressources situées en dessous API | Écrire | |||
| DeleteApiCache | Accorde l'autorisation de supprimer un API cache dans AppSync | Écrire | |||
| DeleteApiKey | Accorde l'autorisation de supprimer une API clé | Écrire | |||
| DeleteChannelNamespace | Autorise la suppression de l'espace de noms d'une chaîne | É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 | |||
| 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 API | Écrire | |||
| 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 un API GraphQL d'un nom de domaine personnalisé dans AppSync | Écrire | |||
| DisassociateMergedGraphqlApi | Accorde l'autorisation de supprimer une source associée API d'une fusion API identifiée par la source API | Écrire | |||
| DisassociateSourceGraphqlApi | Accorde l'autorisation de supprimer une source associée API d'une fusion API identifiée par la fusion API | Écrire | |||
| 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 | |||
| EventConnect | Accorde l'autorisation de se connecter à un événement API | Écrire | |||
| EventPublish | Autorise la publication d'événements dans l'espace de noms d'une chaîne | Écrire | |||
| EventSubscribe | Accorde l'autorisation de s'abonner à un espace de noms de chaîne | Écrire | |||
| FlushApiCache | Accorde l'autorisation de vider un API cache AppSync | Écrire | |||
| GetApi | Accorde l'autorisation de récupérer un API | Lecture | |||
| GetApiAssociation | Accorde l'autorisation de lire les détails de l'APIassociation nom de domaine personnalisé - GraphQL dans AppSync | Lecture | |||
| GetApiCache | Accorde l'autorisation de lire les informations relatives à un API cache dans AppSync | Lecture | |||
| GetChannelNamespace | Accorde l'autorisation de récupérer l'espace de noms d'une chaîne | 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 | |||
| GetFunction | Accorde l'autorisation de récupérer une fonction | Lecture | |||
| GetGraphqlApi | Accorde l'autorisation de récupérer un GraphQL API | Lecture | |||
| GetGraphqlApiEnvironmentVariables | Accorde l'autorisation de récupérer les variables d'environnement pour un GraphQL API | Lecture | |||
| GetIntrospectionSchema | Accorde l'autorisation de récupérer le schéma d'introspection pour un GraphQL API | 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 source API associée fusionnée API | Lecture | |||
| GetType | Accorde l'autorisation de récupérer un type | Lecture | |||
| GraphQL [autorisation uniquement] | Accorde l'autorisation d'envoyer une requête GraphQL à un GraphQL API | Écrire | |||
| ListApiKeys | Accorde l'autorisation de répertorier les API clés pour une donnée API | Liste | |||
| ListApis | Accorde l'autorisation de mettre en vente APIs | Liste | |||
| ListChannelNamespaces | Accorde l'autorisation de répertorier l'espace de noms des chaînes | Liste | |||
| ListDataSources | Accorde l'autorisation de répertorier les sources de données pour une donnée API | 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 pour une donnée API | Liste | |||
| ListGraphqlApis | Accorde l'autorisation de répertorier GraphQL APIs | Liste | |||
| ListResolvers | Accorde l'autorisation de répertorier les résolveurs pour un type API et 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 sources APIs associées à une fusion donnée API | Liste | |||
| ListTagsForResource | Accorde l'autorisation de répertorier les balises d'une ressource | Lecture | |||
| ListTypes | Accorde l'autorisation de répertorier les types pour une donnée API | Liste | |||
| ListTypesByAssociation | Accorde l'autorisation de répertorier les types pour une association fusionnée API et une API association source donnée | Liste | |||
| PutGraphqlApiEnvironmentVariables | Accorde l'autorisation de mettre à jour les variables d'environnement pour un GraphQL API | Écrire | |||
| PutResourcePolicy [autorisation uniquement] | Accorde l'autorisation de définir une stratégie de ressources. | Écrire | |||
| SetWebACL | Accorde l'autorisation de configurer un site Web ACL | Écrire | |||
| SourceGraphQL [autorisation uniquement] | Accorde l'autorisation d'envoyer une requête GraphQL à une source API d'une fusion API | Écrire | |||
| 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 GraphQLAPI. Cette opération est asynchrone : elle GetSchemaCreationStatus peut s'afficher lorsqu'elle est terminée | Écrire | |||
| StartSchemaMerge | Accorde l'autorisation d'initier une fusion de schémas pour une source fusionnée API et associée donnée API | Écrire | |||
| TagResource | Accorde l'autorisation de baliser une ressource | Balisage | |||
| UntagResource | Accorde l'autorisation d'annuler le balisage d'une ressource | Identification | |||
| UpdateApi | Accorde l'autorisation de mettre à jour un API | Écrire |
iam:CreateServiceLinkedRole |
||
| UpdateApiCache | Accorde l'autorisation de mettre à jour un API cache dans AppSync | Écrire | |||
| UpdateApiKey | Accorde l'autorisation de mettre à jour une API clé pour une donnée API | Écrire | |||
| UpdateChannelNamespace | Autorise la mise à jour de l'espace de noms d'une chaîne | É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 | |||
| UpdateFunction | Accorde l'autorisation de mettre à jour une fonction existante | Écrire | |||
| UpdateGraphqlApi | Autorise la mise à jour d'un GraphQL API | Écrire |
iam:CreateServiceLinkedRole |
||
| UpdateResolver | Accorde l'autorisation de mettre à jour un résolveur | Écrire | |||
| UpdateSourceApiAssociation | Autorise la mise à jour d'une API association de API sources fusionnée | Écrire | |||
| 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'élément Resource des instructions de stratégie 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}
|
|
| 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}
|
|
| api |
arn:${Partition}:appsync:${Region}:${Account}:apis/${ApiId}
|
|
| channelNamespace |
arn:${Partition}:appsync:${Region}:${Account}:apis/${ApiId}/channelNamespace/${ChannelNamespaceName}
|
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 IAM politique. 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'un 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 |
