Acciones, recursos y claves de condición para Amazon Q Business

Amazon Q Business (prefijo de servicio: qbusiness) proporciona las siguientes acciones, recursos y claves de contexto de condición específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:

• Obtenga información para configurar este servicio.

• Vea una lista de las operaciones de API disponibles para este servicio.

• Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos de IAM.

Acciones definidas por Amazon Q Business

Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.

La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.

La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.

nota

Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.

Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.

Acciones	Descripción	Nivel de acceso	Tipos de recursos (*necesarios)	Claves de condición	Acciones dependientes
AddUserLicenses	Concede permiso para agregar uno o varios usuarios para las licencias	Escritura
BatchDeleteDocument	Concede permiso para documento de eliminación por lotes	Escritura	application*
			index*
BatchPutDocument	Concede permiso para documento de inserción por lotes	Escritura	application*
			index*
CancelSubscription	Concede permiso para cancelar una suscripción	Escritura	application*
			subscription*
Chat	Concede permiso para chatear mediante una aplicación	Leer	application*
ChatSync	Concede permiso para chatear de forma sincrónica mediante una aplicación	Leer	application*
CreateApplication	Concede permiso para crear una aplicación.	Escritura		aws:RequestTag/${TagKey} aws:TagKeys
CreateDataSource	Concede permiso para crear un origen de datos para un índice y una aplicación determinados	Escritura	application*
			index*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateIndex	Concede permiso para crear una instantánea para una aplicación determinada	Escritura	application*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateLicense	Concede permiso para crear una licencia	Escritura
CreatePlugin	Concede permiso para crear un complemento para una aplicación determinada	Escritura	application*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateRetriever	Concede permiso para crear un recuperador para una aplicación determinada	Escritura	application*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateSubscription	Otorga permiso para crear una suscripción	Escritura	application*
CreateUser	Concede permiso para crear un usuario	Escritura	application*
CreateWebExperience	Concede permiso para crear una experiencia web para una aplicación determinada	Escritura	application*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteApplication	Concede permiso para eliminar una aplicación.	Escritura	application*
DeleteChatControlsConfiguration	Concede permiso para eliminar la configuración de los controles del chat para una aplicación	Escritura	application*
DeleteConversation	Concede permiso para eliminar una conversación	Escritura	application*
DeleteDataSource	Otorga permiso para eliminar un DataSource	Escritura	application*
			data-source*
			index*
DeleteGroup	Concede permiso para eliminar un grupo	Escritura	application*
			index*
DeleteIndex	Concede permiso para eliminar un índice	Escritura	application*
			index*
DeletePlugin	Concede permiso para eliminar un complemento	Escritura	application*
			plugin*
DeleteRetriever	Concede permiso para eliminar un recuperador	Escritura	application*
			retriever*
DeleteUser	Concede permiso para eliminar un usuario	Escritura	application*
DeleteWebExperience	Concede permiso para eliminar una experiencia web	Escritura	application*
			web-experience*
GetApplication	Concede el permiso para obtener una aplicación	Leer	application*
GetChatControlsConfiguration	Concede permiso para obtener la configuración de los controles de chat de una aplicación	Enumeración	application*
GetDataSource	Concede permiso para obtener un origen de datos	Leer	application*
			data-source*
			index*
GetGroup	Concede permiso para obtener un grupo	Leer	application*
			index*
GetIndex	Concede permiso para obtener un índice	Leer	application*
			index*
GetLicense	Otorga permiso para obtener una licencia.	Leer	user-license*
GetPlugin	Concede permiso para obtener un complemento	Leer	application*
			plugin*
GetRetriever	Concede permiso para obtener un recuperador	Leer	application*
			retriever*
GetUser	Concede permiso para obtener un usuario	Leer	application*
GetWebExperience	Concede permiso para obtener una experiencia web	Leer	application*
			web-experience*
ListApplications	Concede permiso para enumerar las aplicaciones	Enumeración
ListConversations	Concede permiso para enumerar todas las conversaciones para una aplicación	Enumeración	application*
ListDataSourceSyncJobs	Concede permiso para obtener el historial de trabajos de sincronización de orígenes de datos	Enumeración	application*
			data-source*
			index*
ListDataSources	Concede permiso para enumerar los orígenes de datos de una aplicación y un índice	Enumeración	application*
			index*
ListDocuments	Concede permiso para enumerar todos los documentos	Enumeración	application*
			index*
ListGroups	Concede permiso para enumerar los grupos	Enumeración	application*
			index*
ListIndices	Concede permiso para enumerar los índices de una aplicación	Enumeración	application*
ListMessages	Concede permiso para enumerar todos los mensajes	Enumeración	application*
ListPlugins	Concede permiso para enumerar los complementos de una aplicación	Enumeración	application*
ListRetrievers	Concede permiso para enumerar los recuperadores de una aplicación	Enumeración	application*
ListSubscriptions	Concede permiso para enumerar suscripciones	Enumeración	application*
ListTagsForResource	Concede permiso para enumerar las etiquetas de un recurso	Leer	application
			data-source
			index
			plugin
			retriever
			web-experience
ListUserLicenses	Concede permiso para enumerar las licencias.	Enumeración
ListWebExperiences	Concede permiso para enumerar las experiencias web de una aplicación	Enumeración	application*
PutFeedback	Concede permiso para enviar comentarios sobre un mensaje de conversación	Escritura	application*
PutGroup	Concede los permisos para poner un grupo de usuarios	Escritura	application*
			index*
RemoveUserLicenses	Concede permiso para eliminar licencias para uno o varios usuarios	Escritura
StartDataSourceSyncJob	Concede permiso para iniciar el trabajo de sincronización de orígenes de datos	Escritura	application*
			data-source*
			index*
StopDataSourceSyncJob	Otorga permiso para detener el trabajo de sincronización de orígenes de datos	Escritura	application*
			data-source*
			index*
TagResource	Concede permiso para etiquetar un recurso con pares de valores de clave dados	Etiquetado	application
			data-source
			index
			plugin
			retriever
			web-experience
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Concede permiso para eliminar de un recurso la etiqueta con la clave dada	Etiquetado	application
			data-source
			index
			plugin
			retriever
			web-experience
				aws:TagKeys
UpdateApplication	Concede permiso para actualizar una aplicación	Escritura	application*
UpdateChatControlsConfiguration	Concede permiso para actualizar una configuración del controles de chat para una aplicación	Escritura	application*
UpdateDataSource	Otorga permiso para actualizar un DataSource	Escritura	application*
			data-source*
			index*
UpdateIndex	Concede permiso para actualizar un índice	Escritura	application*
			index*
UpdatePlugin	Concede permiso para actualizar un complemento	Escritura	application*
			plugin*
UpdateRetriever	Concede permisos para actualizar un recuperador	Escritura	application*
			retriever*
UpdateSubscription	Otorga permiso para actualizar una suscripción	Escritura	application*
			subscription*
UpdateUser	Concede permisos para actualizar un usuario	Escritura	application*
UpdateWebExperience	Otorga permiso para actualizar una WebExperience	Escritura	application*
			web-experience*

Tipos de recursos definidos por Amazon Q Business

Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.

Tipos de recurso	ARN	Claves de condición
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}

Claves de condición de Amazon Q Business

Amazon Q Business define las siguientes claves de condición que se pueden utilizar en el elemento Condition de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla de Claves de condición.

Para ver las claves de condición globales que están disponibles para todos los servicios, consulte Claves de condición globales disponibles.

Claves de condición	Descripción	Tipo
aws:RequestTag/${TagKey}	Filtra el acceso por las etiquetas que se pasan en la solicitud	Cadena
aws:ResourceTag/${TagKey}	Filtra el acceso por las etiquetas asociadas al recurso	Cadena
aws:TagKeys	Filtra el acceso por las claves de etiquetas que se pasan en la solicitud	ArrayOfString