Operazioni Tipi di risorsa Chiavi di condizione

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
Tipi di risorsa definiti da Amazon Q Business
Chiavi di condizione per Amazon Q Business

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*
AllowVendedLogDeliveryForResource [solo autorizzazione]		Gestione delle autorizzazioni		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*
BatchDeleteDocument		Scrittura	index*
BatchPutDocument	Concede l'autorizzazione per l'inserimento in batch del documento	Scrittura	application*
BatchPutDocument		Scrittura	index*
CancelSubscription	Concede l'autorizzazione per annullare un abbonamento	Scrittura	application*
CancelSubscription	Concede l'autorizzazione per annullare un abbonamento	Scrittura	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*
CreateIndex		Scrittura		aws:RequestTag/${TagKey} aws:TagKeys
CreateIntegration	Concede l'autorizzazione a creare una nuova integrazione per un'applicazione Q Business	Scrittura	application*
CreateIntegration		Scrittura		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*
CreatePlugin		Scrittura		aws:RequestTag/${TagKey} aws:TagKeys
CreateRetriever	Concede l'autorizzazione per creare un retriever per una determinata applicazione	Scrittura	application*
CreateRetriever		Scrittura		aws:RequestTag/${TagKey} aws:TagKeys
CreateSubscription	Concede l'autorizzazione a creare un abbonamento	Scrittura	application*
CreateSubscription	Concede l'autorizzazione a creare un abbonamento	Scrittura		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*
CreateWebExperience		Scrittura		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*
DeleteDataAccessor	Concede l'autorizzazione all'eliminazione DataAccessor	Scrittura	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*
DeleteGroup	Concede l'autorizzazione per eliminare un gruppo	Scrittura	index*
DeleteIndex	Concede l'autorizzazione per eliminare un indice	Scrittura	application*
DeleteIndex	Concede l'autorizzazione per eliminare un indice	Scrittura	index*
DeleteIntegration	Concede il permesso di eliminare un'integrazione per un'applicazione Q Business	Scrittura	application*
DeleteIntegration		Scrittura	integration*
DeletePlugin	Concede l'autorizzazione per eliminare un plug-in	Scrittura	application*
DeletePlugin	Concede l'autorizzazione per eliminare un plug-in	Scrittura	plugin*
DeleteRetriever	Concede l'autorizzazione per eliminare un retriever	Scrittura	application*
DeleteRetriever	Concede l'autorizzazione per eliminare un retriever	Scrittura	retriever*
DeleteUser	Concede l'autorizzazione per eliminare un utente	Scrittura	application*
DeleteWebExperience	Concede l'autorizzazione per eliminare una web-experience	Scrittura	application*
DeleteWebExperience	Concede l'autorizzazione per eliminare una web-experience	Scrittura	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*
GetDataAccessor	Concede l'autorizzazione a ottenere DataAccessor	Lettura	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*
GetGroup	Concede l'autorizzazione per ottenere un gruppo	Lettura	index*
GetIndex	Concede l'autorizzazione per ottenere un indice	Lettura	application*
GetIndex	Concede l'autorizzazione per ottenere un indice	Lettura	index*
GetIntegration	Concede l'autorizzazione a ottenere un'integrazione per un'applicazione Q Business	Lettura	application*
GetIntegration		Lettura	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*
GetPlugin	Concede l'autorizzazione per ottenere un plug-in	Lettura	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*
GetRetriever	Concede l'autorizzazione per ottenere un retriever	Lettura	retriever*
GetUser	Concede l'autorizzazione per ottenere un utente	Lettura	application*
GetWebExperience	Concede l'autorizzazione per ottenere una web-experience	Lettura	application*
GetWebExperience	Concede l'autorizzazione per ottenere una web-experience	Lettura	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*
ListDataSources		Elenco	index*
ListDocuments	Concede l'autorizzazione per elencare tutti i documenti	Elenco	application*
ListDocuments	Concede l'autorizzazione per elencare tutti i documenti	Elenco	index*
ListGroups	Concede l'autorizzazione per elencare i gruppi	Elenco	application*
ListGroups	Concede l'autorizzazione per elencare i gruppi	Elenco	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*
ListPluginActions		Lettura	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*
PutGroup	Concede l'autorizzazione per inserire un gruppo di utenti	Scrittura	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*
StartDeployment		Scrittura	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*
UpdateDataAccessor	Concede l'autorizzazione all'aggiornamento DataAccessor	Scrittura	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*
UpdateIndex	Concede l'autorizzazione per aggiornare un indice	Scrittura	index*
UpdateIntegration	Concede l'autorizzazione ad aggiornare un'integrazione per un'applicazione Q Business	Scrittura	application*
UpdateIntegration		Scrittura	integration*
UpdatePlugin	Concede l'autorizzazione per aggiornare un plug-in	Scrittura	application*
UpdatePlugin	Concede l'autorizzazione per aggiornare un plug-in	Scrittura	plugin*
UpdateRetriever	Concede l'autorizzazione per aggiornare un retriever	Scrittura	application*
UpdateRetriever	Concede l'autorizzazione per aggiornare un retriever	Scrittura	retriever*
UpdateSubscription	Concede l'autorizzazione ad aggiornare un abbonamento	Scrittura	application*
UpdateSubscription	Concede l'autorizzazione ad aggiornare un abbonamento	Scrittura	subscription*
UpdateUser	Concede l'autorizzazione per aggiornare un utente	Scrittura	application*
UpdateWebExperience	Concede l'autorizzazione ad aggiornare un WebExperience	Scrittura	application*
UpdateWebExperience	Concede l'autorizzazione ad aggiornare un WebExperience	Scrittura	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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Amazon Q

App Q Amazon Q Business