Acciones, recursos y claves de condición para las aplicaciones de Q de Amazon Q Business
Amazon Q Business Q Apps (prefijo de servicio:qapps) proporciona las siguientes operaciones, recursos, acciones y claves 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.
-
Consulte la referencia de autorización de servicio programática de este servicio
.
Temas
Operaciones de API definidas por Amazon Q Business Q Apps
La siguiente tabla asigna las operaciones de la API a las acciones de IAM que autorizan. Solo se muestran las claves de condición que tienen valores estáticos para la API y la acción determinadas; para ver el conjunto completo de claves de condición que admite cada acción, consulte la tabla de acciones.
| Operación | Acción de IAM | Clave de condición | Valores posibles | Nivel de acceso |
|---|---|---|---|---|
|
AssociateLibraryItemReview |
Escritura |
|||
|
AssociateQAppWithUser |
Escritura |
|||
|
BatchCreateCategory |
Escritura |
|||
|
BatchDeleteCategory |
Escritura |
|||
|
BatchUpdateCategory |
Escritura |
|||
|
CreateLibraryItem |
Escritura |
|||
|
CreatePresignedUrl |
Escritura |
|||
|
Crear QApp |
Escritura |
|||
|
DeleteLibraryItem |
Escritura |
|||
|
Eliminar QApp |
Escritura |
|||
|
DescribeQAppPermissions |
Lectura |
|||
|
DisassociateLibraryItemReview |
Escritura |
|||
|
DisassociateQAppFromUser |
Escritura |
|||
|
ExportQAppSessionData |
Escritura |
|||
|
GetLibraryItem |
Lectura |
|||
|
GetQApp |
Lectura |
|||
|
GetQAppSession |
Lectura |
|||
|
GetQAppSessionMetadata |
Lectura |
|||
|
ImportDocument |
Escritura |
|||
|
ListCategories |
Enumeración |
|||
|
ListLibraryItems |
Enumeración |
|||
|
ListQAppSessionData |
Lectura |
|||
|
ListApps |
Enumeración |
|||
|
ListTagsForResource |
Lectura |
|||
|
StartQAppSession |
Escritura |
|||
|
StopQAppSession |
Escritura |
|||
|
TagResource |
Etiquetar, escribir |
|||
|
UntagResource |
Etiquetar, escribir |
|||
|
UpdateLibraryItem |
Escritura |
|||
|
UpdateLibraryItemMetadata |
Escritura |
|||
|
Actualizar QApp |
Escritura |
|||
|
UpdateQAppPermissions |
Escritura |
|||
|
UpdateQAppSession |
Escritura |
|||
|
UpdateQAppSessionMetadata |
Escritura |
Acciones definidas por las aplicaciones de Q de 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.
| Acciones | Description (Descripción) | Tipos de recursos (*necesarios) | Claves de condición | Nivel de acceso |
|---|---|---|---|---|
Concede permiso para asociar una revisión de un elemento de la biblioteca en el entorno de la aplicación Q de Amazon Q Business |
Escritura |
|||
Concede permiso para asociar una aplicación de Q de Amazon Q Business a un usuario en el entorno de la aplicación Q de Amazon Q Business |
Escritura |
|||
Concede permiso para crear las categorías de una biblioteca en el entorno de aplicación de Q Business. |
Escritura |
|||
Concede permiso para eliminar las categorías de una biblioteca en el entorno de aplicación de Q Business. |
Escritura |
|||
Concede permiso para actualizar las categorías de una biblioteca en el entorno de aplicación de Q Business. |
Escritura |
|||
Concede permiso para crear un elemento de biblioteca en el entorno de aplicación de Q Business. |
Escritura |
|||
Concede permiso para crear una aplicación de Q en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para eliminar un elemento de biblioteca en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para eliminar una aplicación de Q en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para obtener los permisos de uso compartido de la aplicación de Q en el entorno de la aplicación de Q Business. |
Lectura |
|||
Concede permiso para desasociar una revisión de un elemento de biblioteca en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para desasociar una aplicación de Q con un usuario en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para exportar datos de sesión de la aplicación de Q en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para obtener un elemento de biblioteca en el entorno de aplicación de Q Business |
Lectura |
|||
Concede permiso para obtener la aplicación de Q en el entorno de aplicación de Q Business |
Lectura |
|||
Concede permiso para obtener la sesión de la aplicación de Q en el entorno de aplicación de Q Business |
Lectura |
|||
Concede permiso para obtener los metadatos de la sesión de una aplicación de Q en el entorno de aplicación de Q Business |
Lectura |
|||
Concede permiso para importar un documento a la aplicación de Q o a la sesión de la aplicación de Q en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para enumerar categorías en el entorno de aplicación de Q Business. |
Enumeración |
|||
Concede permiso para enumerar elementos de biblioteca en el entorno de aplicación de Q Business |
Enumeración |
|||
Concede permiso para obtener los datos de la sesión de la aplicación de Q en el entorno de aplicación de Q Business |
Lectura |
|||
Concede permiso para enumerar aplicaciones de Q en el entorno de aplicación de Q Business |
Enumeración |
|||
Concede permiso para enumerar las etiquetas de un recurso |
Lectura |
|||
Concede permiso para predecir la aplicación de Q a partir del registro de conversación o de la declaración de problema en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para iniciar la sesión de la aplicación de Q en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para detener la sesión de la aplicación de Q en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para etiquetar un recurso con pares de valores de clave dados |
Etiquetar, escribir |
|||
Concede permiso para eliminar de un recurso la etiqueta con la clave dada |
Etiquetar, escribir |
|||
Concede permiso para actualizar un elemento de biblioteca en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para actualizar los metadatos de un elemento de biblioteca en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para actualizar la aplicación de Q en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para actualizar los permisos de uso compartido de la aplicación de Q en el entorno de la aplicación de Q Business. |
Escritura |
|||
Concede permiso para actualizar la sesión de la aplicación de Q en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para actualizar los metadatos de la sesión de la aplicación de Q en el entorno de aplicación de Q Business |
Escritura |
Permission-only acciones para Amazon Q Business Q Apps
Amazon Q Business Q Apps define las siguientes acciones, pero no se pueden invocar directamente a través de ninguna operación de API. Solo se pueden utilizar en las declaraciones de política de IAM para conceder o denegar permisos.
| Acciones | Description (Descripción) | Tipos de recursos (*necesarios) | Claves de condición | Nivel de acceso |
|---|---|---|---|---|
Concede permiso para copiar la aplicación de Q en el entorno de la aplicación de Q Business |
Escritura |
|||
Concede permiso para crear una revisión de un elemento de biblioteca en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para suscribirse a un tema del bus de eventos de una aplicación de Q en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para predecir una declaración de problema a partir del registro de conversación en el entorno de aplicación de Q Business |
Escritura |
|||
Concede permiso para predecir los metadatos de la aplicación de Q a partir de la declaración de problema en el entorno de aplicación de Q Business |
Escritura |
Tipos de recursos definidos por las aplicaciones de Q de 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.
| Tipos de recurso | ARN | Claves de condición |
|---|---|---|
arn: $ {Partition} :qbusiness: $ {Region} :$ {Account} :application/$ {} ApplicationId |
||
arn: $ {Partition} :qapps: $ {Region} :$ {Account} :application/$ {} /qapp/$ {} ApplicationId AppId |
||
arn: $ {Partition} :qapps: $ {Region} :$ {Account} :application/$ {} /qapp/$ {} /session/$ {} ApplicationId AppId SessionId |
Claves de condición para las aplicaciones de Q de Amazon Q Business
Las aplicaciones de Q de Amazon Q Business definen las siguientes claves de condición que se pueden utilizar en el elemento Condition de una política de IAM.
| Claves de condición | Descripción | Tipo |
|---|---|---|
Filtra el acceso por las etiquetas que se pasan en la solicitud |
Cadena |
|
Filtra el acceso por las etiquetas asociadas al recurso |
Cadena |
|
Filtra el acceso por las claves de etiquetas que se pasan en la solicitud |
ArrayOfString |
|
Filtra el acceso en función de si la aplicación de Q está publicada |
Cadena |
|
Filtra el acceso según si la sesión de la aplicación de Q se ha compartido |
Cadena |
|
Filtra el acceso según si el solicitante es propietario de la aplicación de Q |
Cadena |
|
Filtra el acceso según si el solicitante es moderador de la sesión de la aplicación de Q |
Cadena |