View a markdown version of this page

Actions, ressources et clés de condition pour AWS AppSync - Référence de l'autorisation de service

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 opérations, ressources, actions et clés de condition spécifiques au service suivantes à utiliser dans les politiques d'autorisation IAM.

Références :

Opérations d'API définies par AWS AppSync

Le tableau suivant associe les opérations d'API aux actions IAM qu'elles autorisent. Seules les clés de condition qui ont des valeurs statiques pour l'API et l'action données sont répertoriées ; pour l'ensemble complet des clés de condition prises en charge par chaque action, consultez le Tableau des actions.

Opération Action IAM Clé de condition Valeur (s) possible (s) Niveau d’accès

AssociateApi

appsync:AssociateApi

Écrire

AssociateMergedGraphqlApi

appsync:AssociateMergedGraphqlApi

Écrire

appsync:AssociateSourceGraphqlApi

Écrire

AssociateSourceGraphqlApi

appsync:AssociateMergedGraphqlApi

Écrire

appsync:AssociateSourceGraphqlApi

Écrire

CreateApi

appsync:CreateApi

Écrire

appsync:TagResource

Marquer, écrire

iam:PassRole

iam:PassedToService

appsync.amazonaws.com

Écrire

CreateApiCache

appsync:CreateApiCache

Écrire

CreateApiKey

appsync:CreateApiKey

Écrire

CreateChannelNamespace

appsync:CreateChannelNamespace

Écrire

appsync:TagResource

Marquer, écrire

CreateDataSource

appsync:CreateDataSource

Écrire

iam:PassRole

iam:PassedToService

appsync.amazonaws.com

Écrire

lambda:PassNetworkConnector

Écrire

CreateDomainName

appsync:CreateDomainName

Écrire

appsync:TagResource

Marquer, écrire

CreateFunction

appsync:CreateFunction

Écrire

CreateGraphqlApi

appsync:CreateGraphqlApi

Écrire

appsync:TagResource

Marquer, écrire

iam:PassRole

iam:PassedToService

appsync.amazonaws.com

Écrire

CreateResolver

appsync:CreateResolver

Écrire

CreateType

appsync:CreateType

Écrire

DeleteApi

appsync:DeleteApi

Écrire

DeleteApiCache

appsync:DeleteApiCache

Écrire

DeleteApiKey

appsync:DeleteApiKey

Écrire

DeleteChannelNamespace

appsync:DeleteChannelNamespace

Écrire

DeleteDataSource

appsync:DeleteDataSource

Écrire

DeleteDomainName

appsync:DeleteDomainName

Écrire

DeleteFunction

appsync:DeleteFunction

Écrire

DeleteGraphqlApi

appsync:DeleteGraphqlApi

Écrire

DeleteResolver

appsync:DeleteResolver

Écrire

DeleteType

appsync:DeleteType

Écrire

DisassociateApi

appsync:DisassociateApi

Écrire

DisassociateMergedGraphqlApi

appsync:DisassociateMergedGraphqlApi

Écrire

DisassociateSourceGraphqlApi

appsync:DisassociateSourceGraphqlApi

Écrire

EvaluateCode

appsync:EvaluateCode

Lecture

EvaluateMappingTemplate

appsync:EvaluateMappingTemplate

Lecture

FlushApiCache

appsync:FlushApiCache

Écrire

GetApi

appsync:GetApi

Lecture

GetApiAssociation

appsync:GetApiAssociation

Lecture

GetApiCache

appsync:GetApiCache

Lecture

GetChannelNamespace

appsync:GetChannelNamespace

Lecture

GetDataSource

appsync:GetDataSource

Lecture

GetDataSourceIntrospection

appsync:GetDataSourceIntrospection

Lecture

GetDomainName

appsync:GetDomainName

Lecture

GetFunction

appsync:GetFunction

Lecture

GetGraphqlApi

appsync:GetGraphqlApi

Lecture

GetGraphqlApiEnvironmentVariables

appsync:GetGraphqlApiEnvironmentVariables

Lecture

GetIntrospectionSchema

appsync:GetIntrospectionSchema

Lecture

GetResolver

appsync:GetResolver

Lecture

GetSchemaCreationStatus

appsync:GetSchemaCreationStatus

Lecture

GetSourceApiAssociation

appsync:GetSourceApiAssociation

Lecture

GetType

appsync:GetType

Lecture

ListApiKeys

appsync:ListApiKeys

List

ListApis

appsync:ListApis

List

ListChannelNamespaces

appsync:ListChannelNamespaces

List

ListDataSources

appsync:ListDataSources

List

ListDomainNames

appsync:ListDomainNames

List

ListFunctions

appsync:ListFunctions

List

ListGraphqlApis

appsync:ListGraphqlApis

List

ListResolvers

appsync:ListResolvers

List

ListResolversByFunction

appsync:ListResolversByFunction

List

ListSourceApiAssociations

appsync:ListSourceApiAssociations

List

ListTagsForResource

appsync:ListTagsForResource

Lecture

ListTypes

appsync:ListTypes

List

ListTypesByAssociation

appsync:ListTypesByAssociation

List

PutGraphqlApiEnvironmentVariables

appsync:PutGraphqlApiEnvironmentVariables

Écrire

StartDataSourceIntrospection

appsync:StartDataSourceIntrospection

Écrire

StartSchemaCreation

appsync:StartSchemaCreation

Écrire

StartSchemaMerge

appsync:StartSchemaMerge

Écrire

TagResource

appsync:TagResource

Marquer, écrire

UntagResource

appsync:UntagResource

Marquer, écrire

UpdateApi

appsync:UpdateApi

Écrire

iam:PassRole

iam:PassedToService

appsync.amazonaws.com

Écrire

UpdateApiCache

appsync:UpdateApiCache

Écrire

UpdateApiKey

appsync:UpdateApiKey

Écrire

UpdateChannelNamespace

appsync:UpdateChannelNamespace

Écrire

UpdateDataSource

appsync:UpdateDataSource

Écrire

iam:PassRole

iam:PassedToService

appsync.amazonaws.com

Écrire

lambda:PassNetworkConnector

Écrire

UpdateDomainName

appsync:UpdateDomainName

Écrire

UpdateFunction

appsync:UpdateFunction

Écrire

UpdateGraphqlApi

appsync:UpdateGraphqlApi

Écrire

iam:PassRole

iam:PassedToService

appsync.amazonaws.com

Écrire

UpdateResolver

appsync:UpdateResolver

Écrire

UpdateSourceApiAssociation

appsync:UpdateSourceApiAssociation

Écrire

UpdateType

appsync:UpdateType

Écrire

Actions définies par AWS AppSync

Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. Pour chaque action, le tableau répertorie les types de ressources et les clés de condition pris en charge par cette action. 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'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.

Actions Description Types de ressources (*obligatoire) Clés de condition Niveau d’accès

AssociateApi

Permet d'associer une API GraphQL à un nom de domaine personnalisé dans AppSync

domain*

aws:ResourceTag/${TagKey}

Écrire

AssociateMergedGraphqlApi

Accorde l'autorisation d'associer une API fusionnée à une API source.

graphqlapi*

aws:ResourceTag/${TagKey}

Écrire

AssociateSourceGraphqlApi

Accorde l'autorisation d'associer une API source à une API fusionnée.

graphqlapi*

aws:ResourceTag/${TagKey}

Écrire

CreateApi

Autorise la création d'une API

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Écrire

CreateApiCache

Autorise la création d'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

CreateChannelNamespace

Autorise la création d'un espace de noms de canal

channelNamespace*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Écrire

CreateDataSource

Accorde l'autorisation de créer une source de données.

Écrire

CreateDomainName

Autorise la création d'un nom de domaine personnalisé dans AppSync

domain*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Écrire

CreateFunction

Accorde l'autorisation de créer une fonction

Écrire

CreateGraphqlApi

Autorise la création d'une API GraphQL, qui est le niveau supérieur AppSync ressource

appsync:Visibility

aws:RequestTag/${TagKey}

aws:TagKeys

Écrire

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 une API. Cela permettra également de nettoyer tous AppSync ressource en dessous de cette API

api*

aws:ResourceTag/${TagKey}

Écrire

DeleteApiCache

Autorise la suppression d'un cache d'API dans AppSync

Écrire

DeleteApiKey

Accorde l'autorisation de supprimer une clé d'API

Écrire

DeleteChannelNamespace

Autorise la suppression de l'espace de noms d'une chaîne

channelNamespace*

aws:ResourceTag/${TagKey}

Écrire

DeleteDataSource

Accorde l'autorisation de supprimer une source de données.

Écrire

DeleteDomainName

Autorise la suppression d'un nom de domaine personnalisé dans AppSync

domain*

aws:ResourceTag/${TagKey}

Écrire

DeleteFunction

Accorde l'autorisation de supprimer une fonction

Écrire

DeleteGraphqlApi

Accorde l'autorisation de supprimer une API GraphQL. Cela permettra également de nettoyer tous AppSync ressource en dessous de cette API

graphqlapi*

aws:ResourceTag/${TagKey}

Écrire

DeleteResolver

Accorde l'autorisation de supprimer un résolveur

Écrire

DeleteType

Accorde l'autorisation de supprimer un type

Écrire

DisassociateApi

Accorde l'autorisation de détacher une API GraphQL à un nom de domaine personnalisé dans AppSync

domain*

aws:ResourceTag/${TagKey}

Écrire

DisassociateMergedGraphqlApi

Accorde l'autorisation de supprimer une API source associée d'une API fusionnée identifiée par l'API source.

mergedApiAssociation*

Écrire

DisassociateSourceGraphqlApi

Accorde l'autorisation de supprimer une API source associée d'une API fusionnée identifiée par l'API fusionnée.

sourceApiAssociation*

É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

Autorise la connexion à une API d'événement

api*

aws:ResourceTag/${TagKey}

Écrire

EventPublish

Autorise la publication d'événements dans l'espace de noms d'une chaîne

channelNamespace*

aws:ResourceTag/${TagKey}

Écrire

EventSubscribe

Autorise l'abonnement à l'espace de noms d'une chaîne

channelNamespace*

aws:ResourceTag/${TagKey}

Écrire

FlushApiCache

Accorde l'autorisation de vider le cache d'une API dans AppSync

Écrire

GetApi

Autorise la récupération d'une API

api*

aws:ResourceTag/${TagKey}

Lecture

GetApiAssociation

Accorde l'autorisation de lire les détails de l'association entre le nom de domaine personnalisé et l'API GraphQL dans AppSync

domain*

aws:ResourceTag/${TagKey}

Lecture

GetApiCache

Autorise la lecture des informations relatives à un cache d'API dans AppSync

Lecture

GetChannelNamespace

Accorde l'autorisation de récupérer un espace de noms de canal

channelNamespace*

aws:ResourceTag/${TagKey}

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

Autorise la lecture des informations relatives à un nom de domaine personnalisé dans AppSync

domain*

aws:ResourceTag/${TagKey}

Lecture

GetFunction

Accorde l'autorisation de récupérer une fonction

Lecture

GetGraphqlApi

Accorde l'autorisation de récupérer une API GraphQL

graphqlapi*

aws:ResourceTag/${TagKey}

Lecture

GetGraphqlApiEnvironmentVariables

Autorise la récupération des 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

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.

sourceApiAssociation*

Lecture

GetType

Accorde l'autorisation de récupérer un type

Lecture

ListApiKeys

Accorde l'autorisation de répertorier les clés d'une API donnée

List

ListApis

Accorde l'autorisation de répertorier les API

aws:ResourceTag/${TagKey}

List

ListChannelNamespaces

Accorde l'autorisation de répertorier l'espace de noms des canaux

api*

aws:ResourceTag/${TagKey}

List

ListDataSources

Accorde l'autorisation de répertorier les sources de données d'une API donnée

List

ListDomainNames

Autorise l'énumération des noms de domaine personnalisés dans AppSync

aws:ResourceTag/${TagKey}

List

ListFunctions

Accorde l'autorisation de répertorier les fonctions d'une API donnée

List

ListGraphqlApis

Accorde l'autorisation de répertorier les API GraphQL

List

ListResolvers

Accorde l'autorisation de répertorier les résolveurs d'une API et d'un type donnés

List

ListResolversByFunction

Accorde l'autorisation de répertorier les résolveurs associés à une fonction spécifique

List

ListSourceApiAssociations

Accorde l'autorisation de répertorier les API sources associées à une API fusionnée donnée.

List

ListTagsForResource

Accorde l'autorisation de répertorier les balises d'une ressource

api

aws:ResourceTag/${TagKey}

Lecture

channelNamespace

aws:ResourceTag/${TagKey}

domain

aws:ResourceTag/${TagKey}

graphqlapi

aws:ResourceTag/${TagKey}

ListTypes

Accorde l'autorisation de répertorier les types d'une API donnée

List

ListTypesByAssociation

Accorde l'autorisation de répertorier les types d'une association d'API fusionnée et d'API source données.

List

PutGraphqlApiEnvironmentVariables

Autorise la mise à jour des variables d'environnement pour une API GraphQL

Écrire

SetWebACL

Accorde l'autorisation de définir une liste ACL web

Gestion des autorisations, Rédaction

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 - GetSchemaCreationStatus peut montrer quand il est terminé

É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.

sourceApiAssociation*

Écrire

TagResource

Accorde l'autorisation de baliser une ressource

api

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Marquer, écrire

channelNamespace

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

domain

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

graphqlapi

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

UntagResource

Accorde l'autorisation d'annuler le balisage d'une ressource

api

aws:ResourceTag/${TagKey}

aws:TagKeys

Marquer, écrire

channelNamespace

aws:ResourceTag/${TagKey}

aws:TagKeys

domain

aws:ResourceTag/${TagKey}

aws:TagKeys

graphqlapi

aws:ResourceTag/${TagKey}

aws:TagKeys

UpdateApi

Autorise la mise à jour d'une API

api*

aws:ResourceTag/${TagKey}

Écrire

UpdateApiCache

Autorise la mise à jour d'un cache d'API dans AppSync

Écrire

UpdateApiKey

Accorde l'autorisation de mettre à jour la clé d'une API donnée

Écrire

UpdateChannelNamespace

Autorise la mise à jour de l'espace de noms d'une chaîne

channelNamespace*

aws:ResourceTag/${TagKey}

Écrire

UpdateDataSource

Accorde l'autorisation de mettre à jour une source de données

Écrire

UpdateDomainName

Autorise la mise à jour d'un nom de domaine personnalisé dans AppSync

domain*

aws:ResourceTag/${TagKey}

Écrire

UpdateFunction

Accorde l'autorisation de mettre à jour une fonction existante

Écrire

UpdateGraphqlApi

Accorde l'autorisation de mettre à jour une API GraphQL

graphqlapi*

aws:ResourceTag/${TagKey}

Écrire

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.

sourceApiAssociation*

Écrire

UpdateType

Accorde l'autorisation de mettre à jour un type

Écrire

Permission-only actions pour AWS AppSync

Les actions suivantes sont définies par AWS AppSync mais ne sont directement invocables via aucune opération d'API. Ils ne peuvent être utilisés que dans les déclarations de politique IAM pour accorder ou refuser des autorisations.

Actions Description Types de ressources (*obligatoire) Clés de condition Niveau d’accès

AssociateWebACL

Autorise l'association d'une ACL Web à une ressource

api

aws:ResourceTag/${TagKey}

Écrire

graphqlapi

aws:ResourceTag/${TagKey}

DeleteResourcePolicy

Accorde l'autorisation de supprimer une stratégie de ressources.

Écrire

DisassociateWebACL

Autorise la dissociation d'une ACL Web et d'une ressource

api

aws:ResourceTag/${TagKey}

Écrire

graphqlapi

aws:ResourceTag/${TagKey}

GetResourcePolicy

Accorde l'autorisation de lire une stratégie de ressources.

Lecture

GetWebACLForResource

Accorde l'autorisation d'obtenir les ACL Web associées à une ressource

api

aws:ResourceTag/${TagKey}

Lecture

graphqlapi

aws:ResourceTag/${TagKey}

GraphQL

Accorde l'autorisation d'envoyer une requête GraphQL à une API GraphQL

field*

Écrire

graphqlapi*

aws:ResourceTag/${TagKey}

ListResourcesForWebACL

Autorise l'accès aux ressources associées à une ACL Web

List

PutResourcePolicy

Accorde l'autorisation de définir une stratégie de ressources.

Écrire

SourceGraphQL

Accorde l'autorisation d'envoyer une requête GraphQL à une API source d'une API fusionnée.

field*

Écrire

graphqlapi*

aws:ResourceTag/${TagKey}

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.

Types de ressources ARN Clés de condition

api

arn:${Partition}:appsync:${Region}:${Account}:apis/${ApiId}

aws:ResourceTag/${TagKey}

channelNamespace

arn:${Partition}:appsync:${Region}:${Account}:apis/${ApiId}/channelNamespace/${ChannelNamespaceName}

aws:ResourceTag/${TagKey}

datasource

arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}/datasources/${DatasourceName}

domain

arn:${Partition}:appsync:${Region}:${Account}:domainnames/${DomainName}

aws:ResourceTag/${TagKey}

field

arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}/types/${TypeName}/fields/${FieldName}

function

arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}/functions/${FunctionId}

graphqlapi

arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}

aws:ResourceTag/${TagKey}

mergedApiAssociation

arn:${Partition}:appsync:${Region}:${Account}:apis/${SourceGraphQLAPIId}/mergedApiAssociations/${Associationid}

sourceApiAssociation

arn:${Partition}:appsync:${Region}:${Account}:apis/${MergedGraphQLAPIId}/sourceApiAssociations/${Associationid}

type

arn:${Partition}:appsync:${Region}:${Account}:apis/${GraphQLAPIId}/types/${TypeName}

Clés de condition pour AWS AppSync

AWS AppSync définit les clés de condition suivantes qui peuvent être utilisées dans Condition élément d'une politique IAM.

Clés de condition Description Type

appsync:Visibility

Filtre l'accès en fonction de la visibilité d'une API

String

aws:RequestTag/${TagKey}

Filtre l'accès en fonction des paires clé-valeur de la balise dans la demande

String

aws:ResourceTag/${TagKey}

Filtre l'accès en fonction des paires clé-valeur d'identification attachées à la ressource

String

aws:TagKeys

Filtre l'accès en fonction de la présence de clés d'identification dans la demande

ArrayOfString