Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Acciones, recursos y claves de condición para Amazon Q Business
Amazon Q Business (prefijo de servicio:qbusiness
) proporciona los siguientes recursos, acciones y claves de contexto de condición específicos del servicio para su uso en IAM las políticas de permisos.
Referencias:
-
Obtenga información para configurar este servicio.
-
Consulte una lista de las APIoperaciones disponibles para este servicio.
-
Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos deIAM.
Temas
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 se utiliza una acción en una política, se suele permitir o denegar el acceso a la API operación o al CLI comando 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 uno ARN de ese tipo en una declaración con esa 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 Resource
elemento de una IAM política, debe incluir un patrón ARN o 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 | |||
AssociatePermission | Asocie la declaración de política basada en los recursos a la aplicación | Escritura |
qbusiness:PutResourcePolicy |
||
BatchDeleteDocument | Concede permiso para documento de eliminación por lotes | Escritura | |||
BatchPutDocument | Concede permiso para documento de inserción por lotes | Escritura | |||
CancelSubscription | Concede permiso para cancelar una suscripción | Escritura | |||
Chat | Concede permiso para chatear mediante una aplicación | Lectura | |||
ChatSync | Concede permiso para chatear de forma sincrónica mediante una aplicación | Lectura | |||
CreateApplication | Concede permiso para crear una aplicación. | Escritura | |||
CreateDataAccessor | Cree DataAccessor en la aplicación | Escritura | |||
CreateDataSource | Concede permiso para crear un origen de datos para un índice y una aplicación determinados | Escritura | |||
CreateIndex | Concede permiso para crear una instantánea para una aplicación determinada | Escritura | |||
CreateIntegration | Otorga permiso para crear una nueva integración para una aplicación de Q Business | Escritura | |||
CreateLicense | Concede permiso para crear una licencia | Escritura | |||
CreatePlugin | Concede permiso para crear un complemento para una aplicación determinada | Escritura | |||
CreateRetriever | Concede permiso para crear un recuperador para una aplicación determinada | Escritura | |||
CreateSubscription | Concede permiso para crear una suscripción | Escritura | |||
CreateUser | Concede permiso para crear un usuario | Escritura | |||
CreateWebExperience | Concede permiso para crear una experiencia web para una aplicación determinada | Escritura | |||
DeleteApplication | Concede permiso para eliminar una aplicación. | Escritura | |||
DeleteChatControlsConfiguration | Concede permiso para eliminar la configuración de los controles del chat para una aplicación | Escritura | |||
DeleteConversation | Concede permiso para eliminar una conversación | Escritura | |||
DeleteDataAccessor | Eliminar DataAccessor | Escritura | |||
DeleteDataSource | Otorga permiso para eliminar un DataSource | Escritura | |||
DeleteGroup | Concede permiso para eliminar un grupo | Escritura | |||
DeleteIndex | Concede permiso para eliminar un índice | Escritura | |||
DeleteIntegration | Otorga permiso para eliminar una integración de una aplicación de Q Business | Escritura | |||
DeletePlugin | Concede permiso para eliminar un complemento | Escritura | |||
DeleteRetriever | Concede permiso para eliminar un recuperador | Escritura | |||
DeleteUser | Concede permiso para eliminar un usuario | Escritura | |||
DeleteWebExperience | Concede permiso para eliminar una experiencia web | Escritura | |||
DisableAclOnDataSource [solo permiso] | Otorga permiso para deshabilitar el ACL rastreo al crear el recurso de fuente de datos de Amazon Q Business | Escritura | |||
DisassociatePermission | Desvincula la declaración de política basada en recursos de la aplicación | Escritura |
qbusiness:PutResourcePolicy |
||
GetApplication | Concede el permiso para obtener una aplicación | Lectura | |||
GetChatControlsConfiguration | Concede permiso para obtener la configuración de los controles de chat de una aplicación | Enumeración | |||
GetDataAccessor | Obtenga DataAccessor | Lectura | |||
GetDataSource | Concede permiso para obtener un origen de datos | Lectura | |||
GetGroup | Concede permiso para obtener un grupo | Lectura | |||
GetIndex | Concede permiso para obtener un índice | Lectura | |||
GetIntegration | Otorga permiso para obtener una integración para una aplicación de Q Business | Lectura | |||
GetLicense | Otorga permiso para obtener una licencia. | Lectura | |||
GetMedia | Otorga permiso para asociar el contenido multimedia a un mensaje del sistema | Lectura | |||
GetPlugin | Concede permiso para obtener un complemento | Lectura | |||
GetPolicy | Obtenga la política de la aplicación basada en los recursos | Lectura | |||
GetRetriever | Concede permiso para obtener un recuperador | Lectura | |||
GetUser | Concede permiso para obtener un usuario | Lectura | |||
GetWebExperience | Concede permiso para obtener una experiencia web | Lectura | |||
ListApplications | Concede permiso para enumerar las aplicaciones | Enumeración | |||
ListAttachments | Otorga permiso para enumerar los archivos adjuntos en el contexto de chat actual | Enumeración | |||
ListConversations | Concede permiso para enumerar todas las conversaciones para una aplicación | Enumeración | |||
ListDataAccessors | Lista DataAccessor para la aplicación | Enumeración | |||
ListDataSourceSyncJobs | Concede permiso para obtener el historial de trabajos de sincronización de orígenes de datos | Enumeración | |||
ListDataSources | Concede permiso para enumerar los orígenes de datos de una aplicación y un índice | Enumeración | |||
ListDocuments | Concede permiso para enumerar todos los documentos | Enumeración | |||
ListGroups | Concede permiso para enumerar los grupos | Enumeración | |||
ListIndices | Concede permiso para enumerar los índices de una aplicación | Enumeración | |||
ListIntegrations | Otorga permiso para enumerar todas las integraciones de una aplicación de Q Business | Enumeración | |||
ListMessages | Concede permiso para enumerar todos los mensajes | Enumeración | |||
ListPluginActions | Otorga permiso para enumerar las acciones de un complemento dentro de la aplicación | Lectura | |||
ListPluginTypeActions | Otorga permiso para enumerar todas las acciones de un tipo de complemento | Lectura | |||
ListPluginTypeMetadata | Otorga permiso para enumerar todos los metadatos del tipo de complemento | Lectura | |||
ListPlugins | Concede permiso para enumerar los complementos de una aplicación | Enumeración | |||
ListRetrievers | Concede permiso para enumerar los recuperadores de una aplicación | Enumeración | |||
ListSubscriptions | Concede permiso para enumerar suscripciones | Enumeración | |||
ListTagsForResource | Concede permiso para enumerar las etiquetas de un recurso | Lectura | |||
ListUserLicenses | Concede permiso para enumerar las licencias. | Enumeración | |||
ListWebExperiences | Concede permiso para enumerar las experiencias web de una aplicación | Enumeración | |||
PutFeedback | Concede permiso para enviar comentarios sobre un mensaje de conversación | Escritura | |||
PutGroup | Concede los permisos para poner un grupo de usuarios | Escritura | |||
PutResourcePolicy | Coloca una declaración de política basada en recursos en la aplicación | Escritura | |||
RemoveUserLicenses | Concede permiso para eliminar licencias para uno o varios usuarios | Escritura | |||
SearchRelevantContent | Busca contenido relevante en la aplicación Amazon Q Business | Lectura | |||
StartDataSourceSyncJob | Otorga permiso para iniciar el trabajo de sincronización de orígenes de datos | Escritura | |||
StartDeployment | Otorga permiso para iniciar la implementación de una integración | Escritura | |||
StopDataSourceSyncJob | Otorga permiso para detener el trabajo de sincronización de orígenes de datos | Escritura | |||
TagResource | Concede permiso para etiquetar un recurso con pares de valores de clave dados | Etiquetado | |||
UntagResource | Concede permiso para eliminar de un recurso la etiqueta con la clave dada | Etiquetado | |||
UpdateApplication | Concede permiso para actualizar una aplicación | Escritura | |||
UpdateChatControlsConfiguration | Concede permiso para actualizar una configuración del controles de chat para una aplicación | Escritura | |||
UpdateDataAccessor | Actualización DataAccessor | Escritura | |||
UpdateDataSource | Otorga permiso para actualizar un DataSource | Escritura | |||
UpdateIndex | Concede permiso para actualizar un índice | Escritura | |||
UpdateIntegration | Otorga permiso para actualizar una integración de una aplicación de Q Business | Escritura | |||
UpdatePlugin | Concede permiso para actualizar un complemento | Escritura | |||
UpdateRetriever | Concede permisos para actualizar un recuperador | Escritura | |||
UpdateSubscription | Concede permiso para actualizar una suscripción | Escritura | |||
UpdateUser | Concede permisos para actualizar un usuario | Escritura | |||
UpdateWebExperience | Otorga permiso para actualizar un WebExperience | Escritura | |||
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}
|
|
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}
|
Claves de condición de Amazon Q Business
Amazon Q Business define las siguientes claves de condición que se pueden utilizar en el Condition
elemento de una IAM política. 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 |
identitystore:GroupId | Filtra el acceso por ID de grupo del Centro de IAM Identidad | ArrayOfString |
identitystore:UserId | Filtra el acceso por ID de usuario de IAM Identity Center | ArrayOfString |