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 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.
Rubriques
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 | |||
AllowVendedLogDeliveryForResource [autorisation uniquement] | Accorde l'autorisation de configurer la livraison des journaux vendus pour la ressource d'application Amazon Q Business | Gestion des autorisations | |||
AssociatePermission | Accorde l'autorisation d'associer une déclaration de politique basée sur les ressources à l'application | Écrire |
qbusiness:PutResourcePolicy |
||
BatchDeleteDocument | Accorde l'autorisation de supprimer des documents par lots | Écrire | |||
BatchPutDocument | Accorde l'autorisation d'ajouter des documents par lots | Écrire | |||
CancelSubscription | Autorise l'annulation d'un abonnement | Écrire | |||
Chat | Octroie l'autorisation de discuter à l'aide d'une application. | Lecture | |||
ChatSync | Octroie l'autorisation de discuter de manière synchrone à l'aide d'une application. | Lecture | |||
CreateApplication | Accorde l'autorisation de créer une application | Écrire | |||
CreateDataAccessor | Accorde l'autorisation de créer DataAccessor à l'application | Écrire | |||
CreateDataSource | Octroie l'autorisation de créer une source de données pour une application et un index donnés. | Écrire | |||
CreateIndex | Octroie l'autorisation de créer un index pour une application donnée. | Écrire | |||
CreateIntegration | Accorde l'autorisation de créer une nouvelle intégration pour une application Q Business | Écrire | |||
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 | |||
CreateRetriever | Octroie l'autorisation de créer un extracteur pour une application donnée. | Écrire | |||
CreateSubscription | Accorde l'autorisation de créer un abonnement | Écrire | |||
CreateUser | Accorde l'autorisation de créer un utilisateur | Écrire | |||
CreateWebExperience | Octroie l'autorisation de créer une expérience Web pour une application donnée. | Écrire | |||
DeleteApplication | Accorde l'autorisation de supprimer une application | Écrire | |||
DeleteAttachment | Accorde l'autorisation de supprimer une pièce jointe dans le contexte de discussion actuel | Écrire | |||
DeleteChatControlsConfiguration | Octroie l'autorisation de supprimer une configuration de contrôles de chat pour une application. | Écrire | |||
DeleteConversation | Octroie l'autorisation de supprimer une conversation. | Écrire | |||
DeleteDataAccessor | Accorde l'autorisation de suppression DataAccessor | Écrire | |||
DeleteDataSource | Accorde l'autorisation de supprimer un DataSource | Écrire | |||
DeleteGroup | Accorde l'autorisation de supprimer un groupe | Écrire | |||
DeleteIndex | Octroie l'autorisation de supprimer un index. | Écrire | |||
DeleteIntegration | Accorde l'autorisation de supprimer une intégration pour une application Q Business | Écrire | |||
DeletePlugin | Octroie l'autorisation de supprimer un plug-in. | Écrire | |||
DeleteRetriever | Octroie l'autorisation de supprimer un extracteur. | Écrire | |||
DeleteUser | Accorde l'autorisation de supprimer un utilisateur | Écrire | |||
DeleteWebExperience | Octroie l'autorisation de supprimer une expérience Web. | Écrire | |||
DisableAclOnDataSource [autorisation uniquement] | Accorde l'autorisation de désactiver l'analyse ACL lors de la création de la ressource de source de données Amazon Q Business | Écrire | |||
DisassociatePermission | Accorde l'autorisation de dissocier la déclaration de politique basée sur les ressources de l'application | Écrire |
qbusiness:PutResourcePolicy |
||
GetApplication | Accorde l'autorisation d'obtenir une application | Lecture | |||
GetChatControlsConfiguration | Octroie l'autorisation d'obtenir une configuration de contrôles de chat pour une application. | Liste | |||
GetDataAccessor | Donne l'autorisation d'obtenir DataAccessor | Lecture | |||
GetDataSource | Octroie l'autorisation d'obtenir une source de données. | Lecture | |||
GetGroup | Octroie l'autorisation d'obtenir un groupe. | Lecture | |||
GetIndex | Octroie l'autorisation d'obtenir un index. | Lecture | |||
GetIntegration | Accorde l'autorisation d'obtenir une intégration pour une application Q Business | Lecture | |||
GetLicense | Accorde l'autorisation d'obtenir une licence | Lecture | |||
GetMedia | Accorde l'autorisation d'obtenir le média associé à un message système | Lecture | |||
GetPlugin | Octroie l'autorisation d'obtenir un plug-in. | Lecture | |||
GetPolicy | Accorde l'autorisation d'obtenir la politique basée sur les ressources de l'application | Lecture | |||
GetRetriever | Octroie l'autorisation d'obtenir un extracteur. | Lecture | |||
GetUser | Octroie l'autorisation d'obtenir un utilisateur. | Lecture | |||
GetWebExperience | Octroie l'autorisation d'obtenir une expérience Web. | Lecture | |||
ListApplications | Octroie l'autorisation de répertorier les applications. | Liste | |||
ListAttachments | Accorde l'autorisation de répertorier les pièces jointes dans le contexte de discussion actuel | Liste | |||
ListConversations | Octroie l'autorisation de répertorier toutes les conversations d'une application. | Liste | |||
ListDataAccessors | Accorde l'autorisation de mettre en DataAccessors vente pour l'application | Liste | |||
ListDataSourceSyncJobs | Accorde l'autorisation d'obtenir l'historique des tâches de synchronisation des sources de données | Liste | |||
ListDataSources | Octroie l'autorisation de répertorier les sources de données d'une application et d'un index. | Liste | |||
ListDocuments | Octroie l'autorisation de répertorier tous les documents. | Liste | |||
ListGroups | Accorde l'autorisation de répertorier des groupes | Liste | |||
ListIndices | Octroie l'autorisation de répertorier les index d'une application. | Liste | |||
ListIntegrations | Accorde l'autorisation de répertorier toutes les intégrations pour une application Q Business | Liste | |||
ListMessages | Octroie l'autorisation de répertorier tous les messages. | Liste | |||
ListPluginActions | Accorde l'autorisation de répertorier les actions d'un plugin dans l'application | Lecture | |||
ListPluginTypeActions | Accorde l'autorisation de répertorier toutes les actions pour un type de plugin | Lecture | |||
ListPluginTypeMetadata | Accorde l'autorisation de répertorier toutes les métadonnées du type de plugin | Lecture | |||
ListPlugins | Octroie l'autorisation de répertorier les plug-ins d'une application. | Liste | |||
ListRetrievers | Octroie l'autorisation de répertorier les extracteurs d'une application. | Liste | |||
ListSubscriptions | Accorde l'autorisation de répertorier les abonnements | Liste | |||
ListTagsForResource | Accorde l'autorisation de répertorier les identifications d'une ressource. | Lecture | |||
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 | |||
PutFeedback | Octroie l'autorisation de saisir des commentaires concernant un message de conversation. | Écrire | |||
PutGroup | Octroie l'autorisation de saisir un groupe d'utilisateurs. | Écrire | |||
PutResourcePolicy | Accorde l'autorisation d'ajouter une déclaration de politique basée sur les ressources à l'application | Écrire | |||
RemoveUserLicenses | Octroie l'autorisation de supprimer les licences d'un ou de plusieurs utilisateurs. | Écrire | |||
SearchRelevantContent | Accorde l'autorisation de rechercher du contenu pertinent à partir de l'application Amazon Q Business | Lecture | |||
StartDataSourceSyncJob | Accorde l'autorisation de démarrer la tâche de synchronisation des sources de données | Écrire | |||
StartDeployment | Accorde l'autorisation de démarrer le déploiement d'une intégration | Écrire | |||
StopDataSourceSyncJob | Accorde l'autorisation d'arrêter la tâche de synchronisation des sources de données | Écrire | |||
TagResource | Accorde l'autorisation d'identificationr une ressource avec des paires de valeurs clés données | Identification | |||
UntagResource | Accorde l'autorisation de supprimer la balise avec la clé donnée d'une ressource | Identification | |||
UpdateApplication | Octroie l'autorisation de mettre à jour une application. | Écrire | |||
UpdateChatControlsConfiguration | Octroie l'autorisation de mettre à jour une configuration de contrôles de chat pour une application. | Écrire | |||
UpdateDataAccessor | Accorde l'autorisation de mise à jour DataAccessor | Écrire | |||
UpdateDataSource | Accorde l'autorisation de mettre à jour un DataSource | Écrire | |||
UpdateIndex | Octroie l'autorisation de mettre à jour un index. | Écrire | |||
UpdateIntegration | Autorise la mise à jour d'une intégration pour une application Q Business | Écrire | |||
UpdatePlugin | Octroie l'autorisation de mettre à jour un plug-in. | Écrire | |||
UpdateRetriever | Octroie l'autorisation de mettre à jour un extracteur. | Écrire | |||
UpdateSubscription | Autorise la mise à jour d'un abonnement | Écrire | |||
UpdateUser | Octroie l'autorisation de mettre à jour un utilisateur. | Écrire | |||
UpdateWebExperience | Accorde l'autorisation de mettre à jour un WebExperience | Écrire | |||
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}
|
|
integration |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/integration/${IntegrationId}
|
|
retriever |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/retriever/${RetrieverId}
|
|
index |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}
|
|
data-source |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/index/${IndexId}/data-source/${DataSourceId}
|
|
plugin |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/plugin/${PluginId}
|
|
web-experience |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/web-experience/${WebExperienceId}
|
|
user-license |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/user-license/${UserLicenseId}
|
|
subscription |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/subscription/${SubscriptionId}
|
|
data-accessor |
arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/data-accessor/${DataAccessorId}
|
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 |
identitystore:GroupId | Filtre l'accès par ID de groupe IAM Identity Center | ArrayOfString |
identitystore:UserId | Filtre l'accès par ID d'utilisateur d'IAM Identity Center. | ArrayOfString |