Actions, ressources et clés de condition pour Amazon Q Business

Amazon Q Business (préfixe de service : qbusiness) fournit les ressources, actions et clés de contexte de condition propres au service suivantes en vue de leur utilisation 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 stratégies d'autorisation IAM.

Actions définies par Amazon Q Business

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

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
AddUserLicenses	Octroie l'autorisation d'ajouter un ou plusieurs utilisateurs pour les licences.	Écrire
BatchDeleteDocument	Accorde l'autorisation de supprimer des documents par lots	Écrire	application*
			index*
BatchPutDocument	Accorde l'autorisation d'ajouter des documents par lots	Écrire	application*
			index*
CancelSubscription	Autorise l'annulation d'un abonnement	Écrire	application*
			subscription*
Chat	Octroie l'autorisation de discuter à l'aide d'une application.	Lecture	application*
ChatSync	Octroie l'autorisation de discuter de manière synchrone à l'aide d'une application.	Lecture	application*
CreateApplication	Accorde l'autorisation de créer une application	Écrire		aws:RequestTag/${TagKey} aws:TagKeys
CreateDataSource	Octroie l'autorisation de créer une source de données pour une application et un index donnés.	Écrire	application*
			index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateIndex	Octroie l'autorisation de créer un index pour une application donnée.	Écrire	application*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateLicense	Octroie l'autorisation de créer une licence.	Écrire
CreatePlugin	Octroie l'autorisation de créer un plug-in pour une application donnée.	Écrire	application*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateRetriever	Octroie l'autorisation de créer un extracteur pour une application donnée.	Écrire	application*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateSubscription	Accorde l'autorisation de créer un abonnement	Écrire	application*
CreateUser	Accorde l'autorisation de créer un utilisateur	Écrire	application*
CreateWebExperience	Octroie l'autorisation de créer une expérience Web pour une application donnée.	Écrire	application*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteApplication	Accorde l'autorisation de supprimer une application	Écrire	application*
DeleteChatControlsConfiguration	Octroie l'autorisation de supprimer une configuration de contrôles de chat pour une application.	Écrire	application*
DeleteConversation	Octroie l'autorisation de supprimer une conversation.	Écrire	application*
DeleteDataSource	Accorde l'autorisation de supprimer un DataSource	Écrire	application*
			data-source*
			index*
DeleteGroup	Accorde l'autorisation de supprimer un groupe	Écrire	application*
			index*
DeleteIndex	Octroie l'autorisation de supprimer un index.	Écrire	application*
			index*
DeletePlugin	Octroie l'autorisation de supprimer un plug-in.	Écrire	application*
			plugin*
DeleteRetriever	Octroie l'autorisation de supprimer un extracteur.	Écrire	application*
			retriever*
DeleteUser	Accorde l'autorisation de supprimer un utilisateur	Écrire	application*
DeleteWebExperience	Octroie l'autorisation de supprimer une expérience Web.	Écrire	application*
			web-experience*
GetApplication	Accorde l'autorisation d'obtenir une application	Lecture	application*
GetChatControlsConfiguration	Octroie l'autorisation d'obtenir une configuration de contrôles de chat pour une application.	Liste	application*
GetDataSource	Octroie l'autorisation d'obtenir une source de données.	Lecture	application*
			data-source*
			index*
GetGroup	Octroie l'autorisation d'obtenir un groupe.	Lecture	application*
			index*
GetIndex	Octroie l'autorisation d'obtenir un index.	Lecture	application*
			index*
GetLicense	Accorde l'autorisation d'obtenir une licence	Lecture	user-license*
GetPlugin	Octroie l'autorisation d'obtenir un plug-in.	Lecture	application*
			plugin*
GetRetriever	Octroie l'autorisation d'obtenir un extracteur.	Lecture	application*
			retriever*
GetUser	Octroie l'autorisation d'obtenir un utilisateur.	Lecture	application*
GetWebExperience	Octroie l'autorisation d'obtenir une expérience Web.	Lecture	application*
			web-experience*
ListApplications	Octroie l'autorisation de répertorier les applications.	Liste
ListConversations	Octroie l'autorisation de répertorier toutes les conversations d'une application.	Liste	application*
ListDataSourceSyncJobs	Accorde l'autorisation d'obtenir l'historique des tâches de synchronisation des sources de données	Liste	application*
			data-source*
			index*
ListDataSources	Octroie l'autorisation de répertorier les sources de données d'une application et d'un index.	Liste	application*
			index*
ListDocuments	Octroie l'autorisation de répertorier tous les documents.	Liste	application*
			index*
ListGroups	Accorde l'autorisation de répertorier des groupes	Liste	application*
			index*
ListIndices	Octroie l'autorisation de répertorier les index d'une application.	Liste	application*
ListMessages	Octroie l'autorisation de répertorier tous les messages.	Liste	application*
ListPlugins	Octroie l'autorisation de répertorier les plug-ins d'une application.	Liste	application*
ListRetrievers	Octroie l'autorisation de répertorier les extracteurs d'une application.	Liste	application*
ListSubscriptions	Accorde l'autorisation de répertorier les abonnements	Liste	application*
ListTagsForResource	Accorde l'autorisation de répertorier les identifications d'une ressource.	Lecture	application
			data-source
			index
			plugin
			retriever
			web-experience
ListUserLicenses	Accorde l'autorisation de répertorier les licences.	Liste
ListWebExperiences	Octroie l'autorisation de répertorier les expériences Web d'une application.	Liste	application*
PutFeedback	Octroie l'autorisation de saisir des commentaires concernant un message de conversation.	Écrire	application*
PutGroup	Octroie l'autorisation de saisir un groupe d'utilisateurs.	Écrire	application*
			index*
RemoveUserLicenses	Octroie l'autorisation de supprimer les licences d'un ou de plusieurs utilisateurs.	Écrire
StartDataSourceSyncJob	Accorde l'autorisation de démarrer la tâche de synchronisation des sources de données	Écrire	application*
			data-source*
			index*
StopDataSourceSyncJob	Accorde l'autorisation d'arrêter la tâche de synchronisation des sources de données	Écrire	application*
			data-source*
			index*
TagResource	Accorde l'autorisation d'identificationr une ressource avec des paires de valeurs clés données	Identification	application
			data-source
			index
			plugin
			retriever
			web-experience
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Accorde l'autorisation de supprimer la balise avec la clé donnée d'une ressource	Identification	application
			data-source
			index
			plugin
			retriever
			web-experience
				aws:TagKeys
UpdateApplication	Octroie l'autorisation de mettre à jour une application.	Écrire	application*
UpdateChatControlsConfiguration	Octroie l'autorisation de mettre à jour une configuration de contrôles de chat pour une application.	Écrire	application*
UpdateDataSource	Accorde l'autorisation de mettre à jour un DataSource	Écrire	application*
			data-source*
			index*
UpdateIndex	Octroie l'autorisation de mettre à jour un index.	Écrire	application*
			index*
UpdatePlugin	Octroie l'autorisation de mettre à jour un plug-in.	Écrire	application*
			plugin*
UpdateRetriever	Octroie l'autorisation de mettre à jour un extracteur.	Écrire	application*
			retriever*
UpdateSubscription	Autorise la mise à jour d'un abonnement	Écrire	application*
			subscription*
UpdateUser	Octroie l'autorisation de mettre à jour un utilisateur.	Écrire	application*
UpdateWebExperience	Accorde l'autorisation de mettre à jour un WebExperience	Écrire	application*
			web-experience*

Types de ressources définis par Amazon Q Business

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
application	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}	aws:ResourceTag/${TagKey}
retriever	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/retriever/${RetrieverId}	aws:ResourceTag/${TagKey}
index	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}	aws:ResourceTag/${TagKey}
data-source	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}/data-source/${DataSourceId}	aws:ResourceTag/${TagKey}
plugin	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/plugin/${PluginId}	aws:ResourceTag/${TagKey}
web-experience	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/web-experience/${WebExperienceId}	aws:ResourceTag/${TagKey}
user-license	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/user-license/${UserLicenseId}
subscription	arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/subscription/${SubscriptionId}

Clés de condition pour Amazon Q Business

Amazon Q Business définit les clés de condition suivantes que vous pouvez utiliser dans l'élément Condition 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
aws:RequestTag/${TagKey}	Filtre l'accès en fonction des identifications transmises dans la demande	Chaîne
aws:ResourceTag/${TagKey}	Filtre l'accès en fonction des identifications associées à la ressource	Chaîne
aws:TagKeys	Filtre l'accès en fonction des clés d'identification qui sont transmises dans la demande	ArrayOfString