Operazioni, risorse e chiavi di condizione per Amazon Q Business - Service Authorization Reference

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Operazioni, risorse e chiavi di condizione per Amazon Q Business

Amazon Q Business (prefisso di servizio: qbusiness) fornisce le chiavi del contesto di condizione, le operazioni, le risorse specifiche del servizio seguenti da utilizzare nelle policy di autorizzazione IAM.

Riferimenti:

Operazioni definite da Amazon Q Business

Puoi specificare le seguenti operazioni nell'elemento Action di un'istruzione di policy IAM. Utilizza le policy per concedere le autorizzazioni per eseguire un'operazione in AWS. Quando utilizzi un'operazione in una policy, in genere consenti o rifiuti l'accesso all'operazione API o al comando CLI con lo stesso nome. Tuttavia, in alcuni casi, una singola operazione controlla l'accesso a più di una operazione. In alternativa, alcune operazioni richiedono operazioni differenti.

La colonna Tipi di risorsa della tabella Operazioni indica se ogni operazione supporta le autorizzazioni a livello di risorsa. Se non vi è nessun valore in corrispondenza di questa colonna, è necessario specificare tutte le risorse ("*") alle quali si applica la policy nell'elemento Resource dell'istruzione di policy. Se la colonna include un tipo di risorsa, puoi specificare un ARN di quel tipo in una istruzione con tale operazione. Se l'operazione ha una o più risorse richieste, il chiamante deve disporre dell'autorizzazione per utilizzare l'operazione con tali risorse. Le risorse richieste sono indicate nella tabella con un asterisco (*). Se si limita l'accesso alle risorse con l'elemento Resource in una policy IAM, è necessario includere un ARN o un modello per ogni tipo di risorsa richiesta. Alcune operazioni supportano più tipi di risorse. Se il tipo di risorsa è facoltativo (non indicato come obbligatorio), puoi scegliere di utilizzare uno tra i tipi di risorsa facoltativi.

La colonna Chiavi di condizione della tabella Operazioni contiene le chiavi che è possibile specificare nell'elemento Condition di un'istruzione di policy. Per ulteriori informazioni sulle chiavi di condizione associate alle risorse per il servizio guarda la colonna Chiavi di condizione della tabella Tipi di risorsa.

Nota

Le chiavi relative alle condizioni delle risorse sono elencate nella tabella Tipi di risorse. Nella colonna Tipi di risorse (*obbligatorio) della tabella Operazioni è presente un collegamento al tipo di risorsa che si applica a un'operazione. Il tipo di risorsa nella tabella Tipi di risorse include la colonna Chiavi di condizione, che contiene le chiavi delle condizioni delle risorse che si applicano a un'operazione nella tabella Operazioni.

Per dettagli sulle colonne nella tabella seguente, consultare Tabella delle operazioni.

Operazioni Descrizione Livello di accesso Tipi di risorsa (*obbligatorio) Chiavi di condizione Operazioni dipendenti
AddUserLicenses Concede l'autorizzazione per aggiungere uno o più utenti per le licenze Scrittura
AllowVendedLogDeliveryForResource [solo autorizzazione] Concede l'autorizzazione a configurare la distribuzione dei registri venduti per la risorsa dell'applicazione Amazon Q Business Gestione delle autorizzazioni

application*

aws:ResourceTag/${TagKey}

AssociatePermission Concede l'autorizzazione ad associare una dichiarazione politica basata sulle risorse all'applicazione Scrittura

application*

qbusiness:PutResourcePolicy

BatchDeleteDocument Concede l'autorizzazione per l'eliminazione in batch il documento Scrittura

application*

index*

BatchPutDocument Concede l'autorizzazione per l'inserimento in batch del documento Scrittura

application*

index*

CancelSubscription Concede l'autorizzazione per annullare un abbonamento Scrittura

application*

subscription*

Chat Concede l'autorizzazione per chattare utilizzando un'applicazione Lettura

application*

ChatSync Concede l'autorizzazione per chattare in modo sincrono utilizzando un'applicazione Lettura

application*

CreateApplication Autorizza l'utente a creare una nuova applicazione. Scrittura

aws:RequestTag/${TagKey}

aws:TagKeys

CreateDataAccessor Concede il permesso di creare DataAccessor all'applicazione Scrittura

application*

CreateDataSource Concede l'autorizzazione per creare un'origine dati per una determinata applicazione e un determinato indice Scrittura

application*

index*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateIndex Concede l'autorizzazione per creare un indice per una determinata applicazione Scrittura

application*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateIntegration Concede l'autorizzazione a creare una nuova integrazione per un'applicazione Q Business Scrittura

application*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateLicense Concede l'autorizzazione per creare una licenza Scrittura
CreatePlugin Concede l'autorizzazione per creare un plug-in per una determinata applicazione Scrittura

application*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateRetriever Concede l'autorizzazione per creare un retriever per una determinata applicazione Scrittura

application*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateSubscription Concede l'autorizzazione a creare un abbonamento Scrittura

application*

identitystore:UserId

identitystore:GroupId

CreateUser Concede l'autorizzazione per creare un utente Scrittura

application*

CreateWebExperience Concede l'autorizzazione per creare un'esperienza Web per una determinata applicazione Scrittura

application*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteApplication Concede l'autorizzazione per eliminare un'app. Scrittura

application*

DeleteAttachment Concede il permesso di eliminare un allegato nel contesto di chat corrente Scrittura

application*

DeleteChatControlsConfiguration Concede l'autorizzazione per eliminare la configurazione dei controlli della chat per un'applicazione Scrittura

application*

DeleteConversation Concede l'autorizzazione per eliminare una conversazione Scrittura

application*

DeleteDataAccessor Concede l'autorizzazione all'eliminazione DataAccessor Scrittura

application*

data-accessor*

DeleteDataSource Concede il permesso di eliminare un DataSource Scrittura

application*

data-source*

index*

DeleteGroup Concede l'autorizzazione per eliminare un gruppo Scrittura

application*

index*

DeleteIndex Concede l'autorizzazione per eliminare un indice Scrittura

application*

index*

DeleteIntegration Concede il permesso di eliminare un'integrazione per un'applicazione Q Business Scrittura

application*

integration*

DeletePlugin Concede l'autorizzazione per eliminare un plug-in Scrittura

application*

plugin*

DeleteRetriever Concede l'autorizzazione per eliminare un retriever Scrittura

application*

retriever*

DeleteUser Concede l'autorizzazione per eliminare un utente Scrittura

application*

DeleteWebExperience Concede l'autorizzazione per eliminare una web-experience Scrittura

application*

web-experience*

DisableAclOnDataSource [solo autorizzazione] Concede l'autorizzazione a disabilitare la scansione ACL durante la creazione della risorsa sorgente dati Amazon Q Business Scrittura

application*

DisassociatePermission Concede l'autorizzazione a dissociare dall'applicazione la dichiarazione di policy basata sulle risorse Scrittura

application*

qbusiness:PutResourcePolicy

GetApplication Concede l'autorizzazione per ottenere un'applicazione Lettura

application*

GetChatControlsConfiguration Concede l'autorizzazione per ottenere la configurazione dei controlli della chat per un'applicazione Elenco

application*

GetDataAccessor Concede l'autorizzazione a ottenere DataAccessor Lettura

application*

data-accessor*

GetDataSource Concede l'autorizzazione per ottenere un'origine dati Lettura

application*

data-source*

index*

GetGroup Concede l'autorizzazione per ottenere un gruppo Lettura

application*

index*

GetIndex Concede l'autorizzazione per ottenere un indice Lettura

application*

index*

GetIntegration Concede l'autorizzazione a ottenere un'integrazione per un'applicazione Q Business Lettura

application*

integration*

GetLicense Concede l'autorizzazione per ottenere una licenza Lettura

user-license*

GetMedia Concede il permesso di associare i file multimediali a un messaggio di sistema Lettura

application*

GetPlugin Concede l'autorizzazione per ottenere un plug-in Lettura

application*

plugin*

GetPolicy Concede l'autorizzazione a ottenere una politica basata sulle risorse dell'applicazione Lettura

application*

GetRetriever Concede l'autorizzazione per ottenere un retriever Lettura

application*

retriever*

GetUser Concede l'autorizzazione per ottenere un utente Lettura

application*

GetWebExperience Concede l'autorizzazione per ottenere una web-experience Lettura

application*

web-experience*

ListApplications Concede l'autorizzazione per elencare le applicazioni Elenco
ListAttachments Concede l'autorizzazione a elencare gli allegati nel contesto di chat corrente Elenco

application*

ListConversations Concede l'autorizzazione per elencare tutte le conversazioni per un'applicazione Elenco

application*

ListDataAccessors Concede l'autorizzazione all'elenco per l'applicazione DataAccessors Elenco

application*

ListDataSourceSyncJobs Concede l'autorizzazione per ottenere la cronologia dei processi di sincronizzazione dell'origine dati Elenco

application*

data-source*

index*

ListDataSources Concede l'autorizzazione per elencare le origini dati di un'applicazione e di un indice Elenco

application*

index*

ListDocuments Concede l'autorizzazione per elencare tutti i documenti Elenco

application*

index*

ListGroups Concede l'autorizzazione per elencare i gruppi Elenco

application*

index*

ListIndices Concede l'autorizzazione per elencare gli indici di un'applicazione Elenco

application*

ListIntegrations Concede l'autorizzazione a elencare tutte le integrazioni per un'applicazione Q Business Elenco

application*

ListMessages Concede l'autorizzazione per elencare tutti i messaggi Elenco

application*

ListPluginActions Concede il permesso di elencare le azioni del plug-in di un plug-in all'interno dell'applicazione Lettura

application*

plugin*

ListPluginTypeActions Concede il permesso di elencare tutte le azioni per un tipo di plugin Lettura
ListPluginTypeMetadata Concede il permesso di elencare tutti i metadati dei tipi di plugin Lettura
ListPlugins Concede l'autorizzazione per elencare i plug-in di un'applicazione Elenco

application*

ListRetrievers Concede l'autorizzazione per elencare i retriever di un'applicazione Elenco

application*

ListSubscriptions Concede l'autorizzazione per elencare le sottoscrizioni Elenco

application*

ListTagsForResource Concede l'autorizzazione per elencare i tag per una risorsa Lettura

application

data-accessor

data-source

index

integration

plugin

retriever

web-experience

ListUserLicenses Concede l'autorizzazione per elencare le licenze Elenco
ListWebExperiences Concede l'autorizzazione per elencare le esperienze Web di un'applicazione Elenco

application*

PutFeedback Concede l'autorizzazione per inserire un feedback relativo a un messaggio di conversazione Scrittura

application*

PutGroup Concede l'autorizzazione per inserire un gruppo di utenti Scrittura

application*

index*

PutResourcePolicy Concede l'autorizzazione a inserire nell'applicazione una dichiarazione politica basata sulle risorse Scrittura

application*

RemoveUserLicenses Concede l'autorizzazione per rimuovere le licenze per uno o più utenti Scrittura
SearchRelevantContent Concede l'autorizzazione a cercare contenuti pertinenti dall'applicazione Amazon Q Business Lettura

application*

StartDataSourceSyncJob Concede l'autorizzazione per avviare il processo di sincronizzazione dell'origine dati Scrittura

application*

data-source*

index*

StartDeployment Concede l'autorizzazione per avviare la distribuzione di un'integrazione Scrittura

application*

integration*

StopDataSourceSyncJob Concede l'autorizzazione per interrompere il processo di sincronizzazione dell'origine dati Scrittura

application*

data-source*

index*

TagResource Concede l'autorizzazione per applicare tag a una risorsa con determinate coppie di chiave/valore Assegnazione di tag

application

data-accessor

data-source

index

integration

plugin

retriever

web-experience

aws:RequestTag/${TagKey}

aws:TagKeys

UntagResource Concede l'autorizzazione per rimuovere il tag con la chiave specificata da una risorsa Assegnazione di tag

application

data-accessor

data-source

index

integration

plugin

retriever

web-experience

aws:TagKeys

UpdateApplication Concede l'autorizzazione per aggiornare un'applicazione Scrittura

application*

UpdateChatControlsConfiguration Concede l'autorizzazione per aggiornare la configurazione dei controlli della chat per un'applicazione Scrittura

application*

UpdateDataAccessor Concede l'autorizzazione all'aggiornamento DataAccessor Scrittura

application*

data-accessor*

UpdateDataSource Concede l'autorizzazione ad aggiornare un DataSource Scrittura

application*

data-source*

index*

UpdateIndex Concede l'autorizzazione per aggiornare un indice Scrittura

application*

index*

UpdateIntegration Concede l'autorizzazione ad aggiornare un'integrazione per un'applicazione Q Business Scrittura

application*

integration*

UpdatePlugin Concede l'autorizzazione per aggiornare un plug-in Scrittura

application*

plugin*

UpdateRetriever Concede l'autorizzazione per aggiornare un retriever Scrittura

application*

retriever*

UpdateSubscription Concede l'autorizzazione ad aggiornare un abbonamento Scrittura

application*

subscription*

UpdateUser Concede l'autorizzazione per aggiornare un utente Scrittura

application*

UpdateWebExperience Concede l'autorizzazione ad aggiornare un WebExperience Scrittura

application*

web-experience*

Tipi di risorsa definiti da Amazon Q Business

I seguenti tipi di risorse sono definiti da questo servizio e possono essere utilizzati nell'elemento Resource delle istruzioni di policy delle autorizzazioni IAM. Ogni operazione nella Tabella delle operazioni identifica i tipi di risorse che possono essere specificati con tale operazione. Un tipo di risorsa può anche definire quali chiavi di condizione puoi includere in una policy. Queste chiavi vengono visualizzate nell'ultima colonna della tabella Tipi di risorsa. Per dettagli sulle colonne nella tabella seguente, consulta Tabella dei tipi di risorsa.

Tipi di risorsa ARN Chiavi di condizione
application arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}

aws:ResourceTag/${TagKey}

integration arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/integration/${IntegrationId}

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}
data-accessor arn:${Partition}:qbusiness:${Region}:${Account}:application/${ApplicationId}/data-accessor/${DataAccessorId}

aws:ResourceTag/${TagKey}

Chiavi di condizione per Amazon Q Business

Amazon Q Business definisce le seguenti chiavi di condizione che possono essere utilizzate nell'elemento Condition di una policy IAM. Puoi utilizzare queste chiavi per perfezionare ulteriormente le condizioni in base alle quali si applica l'istruzione di policy. Per dettagli sulle colonne nella tabella seguente, consulta Tabella delle chiavi di condizione.

Per visualizzare le chiavi di condizione globali disponibili per tutti i servizi, consulta Chiavi di condizione globali disponibili.

Chiavi di condizione Descrizione Tipo
aws:RequestTag/${TagKey} Filtra l'accesso per i tag passati nella richiesta Stringa
aws:ResourceTag/${TagKey} Filtra l'accesso per i tag associati alla risorsa Stringa
aws:TagKeys Filtra l'accesso tramite le chiavi di tag passate nella richiesta ArrayOfString
identitystore:GroupId Filtra l'accesso in base all'ID del gruppo IAM Identity Center ArrayOfString
identitystore:UserId Filtra l'accesso in base all'ID utente di IAM Identity Center ArrayOfString