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:
-
Scopri come configurare questo servizio.
-
Visualizza un elenco delle operazioni API disponibili per questo servizio.
-
Scopri come proteggere questo servizio e le sue risorse utilizzando le policy delle autorizzazioni IAM.
Argomenti
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 | |||
AssociatePermission | Concede l'autorizzazione ad associare una dichiarazione politica basata sulle risorse all'applicazione | Scrittura |
qbusiness:PutResourcePolicy |
||
BatchDeleteDocument | Concede l'autorizzazione per l'eliminazione in batch il documento | Scrittura | |||
BatchPutDocument | Concede l'autorizzazione per l'inserimento in batch del documento | Scrittura | |||
CancelSubscription | Concede l'autorizzazione per annullare un abbonamento | Scrittura | |||
Chat | Concede l'autorizzazione per chattare utilizzando un'applicazione | Lettura | |||
ChatSync | Concede l'autorizzazione per chattare in modo sincrono utilizzando un'applicazione | Lettura | |||
CreateApplication | Autorizza l'utente a creare una nuova applicazione. | Scrittura | |||
CreateDataAccessor | Concede il permesso di creare DataAccessor all'applicazione | Scrittura | |||
CreateDataSource | Concede l'autorizzazione per creare un'origine dati per una determinata applicazione e un determinato indice | Scrittura | |||
CreateIndex | Concede l'autorizzazione per creare un indice per una determinata applicazione | Scrittura | |||
CreateIntegration | Concede l'autorizzazione a creare una nuova integrazione per un'applicazione Q Business | Scrittura | |||
CreateLicense | Concede l'autorizzazione per creare una licenza | Scrittura | |||
CreatePlugin | Concede l'autorizzazione per creare un plug-in per una determinata applicazione | Scrittura | |||
CreateRetriever | Concede l'autorizzazione per creare un retriever per una determinata applicazione | Scrittura | |||
CreateSubscription | Concede l'autorizzazione a creare un abbonamento | Scrittura | |||
CreateUser | Concede l'autorizzazione per creare un utente | Scrittura | |||
CreateWebExperience | Concede l'autorizzazione per creare un'esperienza Web per una determinata applicazione | Scrittura | |||
DeleteApplication | Concede l'autorizzazione per eliminare un'app. | Scrittura | |||
DeleteAttachment | Concede il permesso di eliminare un allegato nel contesto di chat corrente | Scrittura | |||
DeleteChatControlsConfiguration | Concede l'autorizzazione per eliminare la configurazione dei controlli della chat per un'applicazione | Scrittura | |||
DeleteConversation | Concede l'autorizzazione per eliminare una conversazione | Scrittura | |||
DeleteDataAccessor | Concede l'autorizzazione all'eliminazione DataAccessor | Scrittura | |||
DeleteDataSource | Concede il permesso di eliminare un DataSource | Scrittura | |||
DeleteGroup | Concede l'autorizzazione per eliminare un gruppo | Scrittura | |||
DeleteIndex | Concede l'autorizzazione per eliminare un indice | Scrittura | |||
DeleteIntegration | Concede il permesso di eliminare un'integrazione per un'applicazione Q Business | Scrittura | |||
DeletePlugin | Concede l'autorizzazione per eliminare un plug-in | Scrittura | |||
DeleteRetriever | Concede l'autorizzazione per eliminare un retriever | Scrittura | |||
DeleteUser | Concede l'autorizzazione per eliminare un utente | Scrittura | |||
DeleteWebExperience | Concede l'autorizzazione per eliminare una web-experience | Scrittura | |||
DisableAclOnDataSource [solo autorizzazione] | Concede l'autorizzazione a disabilitare la scansione ACL durante la creazione della risorsa sorgente dati Amazon Q Business | Scrittura | |||
DisassociatePermission | Concede l'autorizzazione a dissociare dall'applicazione la dichiarazione di policy basata sulle risorse | Scrittura |
qbusiness:PutResourcePolicy |
||
GetApplication | Concede l'autorizzazione per ottenere un'applicazione | Lettura | |||
GetChatControlsConfiguration | Concede l'autorizzazione per ottenere la configurazione dei controlli della chat per un'applicazione | Elenco | |||
GetDataAccessor | Concede l'autorizzazione a ottenere DataAccessor | Lettura | |||
GetDataSource | Concede l'autorizzazione per ottenere un'origine dati | Lettura | |||
GetGroup | Concede l'autorizzazione per ottenere un gruppo | Lettura | |||
GetIndex | Concede l'autorizzazione per ottenere un indice | Lettura | |||
GetIntegration | Concede l'autorizzazione a ottenere un'integrazione per un'applicazione Q Business | Lettura | |||
GetLicense | Concede l'autorizzazione per ottenere una licenza | Lettura | |||
GetMedia | Concede il permesso di associare i file multimediali a un messaggio di sistema | Lettura | |||
GetPlugin | Concede l'autorizzazione per ottenere un plug-in | Lettura | |||
GetPolicy | Concede l'autorizzazione a ottenere una politica basata sulle risorse dell'applicazione | Lettura | |||
GetRetriever | Concede l'autorizzazione per ottenere un retriever | Lettura | |||
GetUser | Concede l'autorizzazione per ottenere un utente | Lettura | |||
GetWebExperience | Concede l'autorizzazione per ottenere una web-experience | Lettura | |||
ListApplications | Concede l'autorizzazione per elencare le applicazioni | Elenco | |||
ListAttachments | Concede l'autorizzazione a elencare gli allegati nel contesto di chat corrente | Elenco | |||
ListConversations | Concede l'autorizzazione per elencare tutte le conversazioni per un'applicazione | Elenco | |||
ListDataAccessors | Concede l'autorizzazione all'elenco per l'applicazione DataAccessors | Elenco | |||
ListDataSourceSyncJobs | Concede l'autorizzazione per ottenere la cronologia dei processi di sincronizzazione dell'origine dati | Elenco | |||
ListDataSources | Concede l'autorizzazione per elencare le origini dati di un'applicazione e di un indice | Elenco | |||
ListDocuments | Concede l'autorizzazione per elencare tutti i documenti | Elenco | |||
ListGroups | Concede l'autorizzazione per elencare i gruppi | Elenco | |||
ListIndices | Concede l'autorizzazione per elencare gli indici di un'applicazione | Elenco | |||
ListIntegrations | Concede l'autorizzazione a elencare tutte le integrazioni per un'applicazione Q Business | Elenco | |||
ListMessages | Concede l'autorizzazione per elencare tutti i messaggi | Elenco | |||
ListPluginActions | Concede il permesso di elencare le azioni del plug-in di un plug-in all'interno dell'applicazione | Lettura | |||
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 | |||
ListRetrievers | Concede l'autorizzazione per elencare i retriever di un'applicazione | Elenco | |||
ListSubscriptions | Concede l'autorizzazione per elencare le sottoscrizioni | Elenco | |||
ListTagsForResource | Concede l'autorizzazione per elencare i tag per una risorsa | Lettura | |||
ListUserLicenses | Concede l'autorizzazione per elencare le licenze | Elenco | |||
ListWebExperiences | Concede l'autorizzazione per elencare le esperienze Web di un'applicazione | Elenco | |||
PutFeedback | Concede l'autorizzazione per inserire un feedback relativo a un messaggio di conversazione | Scrittura | |||
PutGroup | Concede l'autorizzazione per inserire un gruppo di utenti | Scrittura | |||
PutResourcePolicy | Concede l'autorizzazione a inserire nell'applicazione una dichiarazione politica basata sulle risorse | Scrittura | |||
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 | |||
StartDataSourceSyncJob | Concede l'autorizzazione per avviare il processo di sincronizzazione dell'origine dati | Scrittura | |||
StartDeployment | Concede l'autorizzazione per avviare la distribuzione di un'integrazione | Scrittura | |||
StopDataSourceSyncJob | Concede l'autorizzazione per interrompere il processo di sincronizzazione dell'origine dati | Scrittura | |||
TagResource | Concede l'autorizzazione per applicare tag a una risorsa con determinate coppie di chiave/valore | Assegnazione di tag | |||
UntagResource | Concede l'autorizzazione per rimuovere il tag con la chiave specificata da una risorsa | Assegnazione di tag | |||
UpdateApplication | Concede l'autorizzazione per aggiornare un'applicazione | Scrittura | |||
UpdateChatControlsConfiguration | Concede l'autorizzazione per aggiornare la configurazione dei controlli della chat per un'applicazione | Scrittura | |||
UpdateDataAccessor | Concede l'autorizzazione all'aggiornamento DataAccessor | Scrittura | |||
UpdateDataSource | Concede l'autorizzazione ad aggiornare un DataSource | Scrittura | |||
UpdateIndex | Concede l'autorizzazione per aggiornare un indice | Scrittura | |||
UpdateIntegration | Concede l'autorizzazione ad aggiornare un'integrazione per un'applicazione Q Business | Scrittura | |||
UpdatePlugin | Concede l'autorizzazione per aggiornare un plug-in | Scrittura | |||
UpdateRetriever | Concede l'autorizzazione per aggiornare un retriever | Scrittura | |||
UpdateSubscription | Concede l'autorizzazione ad aggiornare un abbonamento | Scrittura | |||
UpdateUser | Concede l'autorizzazione per aggiornare un utente | Scrittura | |||
UpdateWebExperience | Concede l'autorizzazione ad aggiornare un WebExperience | Scrittura | |||
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}
|
|
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}
|
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 |