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.

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.

Azioni	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
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
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
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*
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*
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*
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*
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*
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*
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*
GetLicense	Concede l'autorizzazione per ottenere una licenza	Lettura	user-license*
GetPlugin	Concede l'autorizzazione per ottenere un plug-in	Lettura	application*
			plugin*
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
ListConversations	Concede l'autorizzazione per elencare tutte le conversazioni per un'applicazione	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*
ListMessages	Concede l'autorizzazione per elencare tutti i messaggi	Elenco	application*
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-source
			index
			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*
RemoveUserLicenses	Concede l'autorizzazione per rimuovere le licenze per uno o più utenti	Scrittura
StartDataSourceSyncJob	Concede l'autorizzazione per avviare il processo di sincronizzazione dell'origine dati	Scrittura	application*
			data-source*
			index*
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-source
			index
			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-source
			index
			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*
UpdateDataSource	Concede il permesso di aggiornare un DataSource	Scrittura	application*
			data-source*
			index*
UpdateIndex	Concede l'autorizzazione per aggiornare un indice	Scrittura	application*
			index*
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}
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}

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