Acciones, recursos y claves de condición para Amazon Q Business - Referencia de autorizaciones de servicio
ActionsTipos de recursoClaves de condición

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:

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
AllowVendedLogDeliveryForResource [solo permiso] Concede permiso para configurar la entrega de registros suministrados para el recurso de la aplicación de Amazon Q Business Administración de permisos

application*

aws:ResourceTag/${TagKey}

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 Concede 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 Concede 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*

DisableAclOnDataSource [solo permiso] Concede permiso para desactivar el rastreo de ACL al crear el recurso de origen de datos de Amazon Q Business Escritura

application*

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 Concede 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 Concede permiso para actualizar una suscripción Escritura

application*

subscription*

UpdateUser Concede permisos para actualizar un usuario Escritura

application*

UpdateWebExperience Concede permiso para actualizar un 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