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 las aplicaciones de Q de Amazon Q Business
Amazon Q Business Q Apps (prefijo de servicio:qapps
) 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.
-
Aprenda a proteger este servicio y sus recursos mediante políticas de IAM permisos.
Temas
Acciones definidas por las aplicaciones de Q de Amazon Q Business
Puede especificar las siguientes acciones en el Action
elemento de una declaración de IAM política. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando se utiliza una acción en una política, normalmente se permite o deniega el acceso a la API operación o 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 |
---|---|---|---|---|---|
AssociateLibraryItemReview | 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 | |||
AssociateQAppWithUser | 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 | |||
BatchCreateCategory | Otorga permiso para crear las categorías de una biblioteca en el entorno de aplicaciones de Q Business | Escritura | |||
BatchDeleteCategory | Otorga permiso para eliminar las categorías de una biblioteca en el entorno de aplicaciones de Q Business | Escritura | |||
BatchUpdateCategory | Otorga permiso para actualizar las categorías de una biblioteca en el entorno de aplicaciones de Q Business | Escritura | |||
CopyQApp [solo permiso] | Concede permiso para copiar la aplicación de Q en el entorno de la aplicación de Q Business | Escritura | |||
CreateLibraryItem | Concede permiso para crear un elemento de biblioteca en el entorno de aplicación de Q Business. | Escritura | |||
CreateLibraryItemReview [solo permiso] | Concede permiso para crear una revisión de un elemento de biblioteca en el entorno de aplicación de Q Business | Escritura | |||
CreatePresignedUrl | Otorga permiso para crear un archivo prefirmado URL para cargar un archivo en una sesión de Q App o Q App en el entorno de aplicaciones de Q Business | Escritura | |||
CreateQApp | Concede permiso para crear una aplicación de Q en el entorno de aplicación de Q Business | Escritura | |||
CreateSubscriptionToken [solo permiso] | 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 | |||
DeleteLibraryItem | Concede permiso para eliminar un elemento de biblioteca en el entorno de aplicación de Q Business | Escritura | |||
DeleteQApp | Concede permiso para eliminar una aplicación de Q en el entorno de aplicación de Q Business | Escritura | |||
DescribeQAppPermissions | Otorga permiso para obtener permisos de uso compartido de Q App en el entorno de aplicaciones de Q Business | Lectura | |||
DisassociateLibraryItemReview | Concede permiso para desasociar una revisión de un elemento de biblioteca en el entorno de aplicación de Q Business | Escritura | |||
DisassociateQAppFromUser | Concede permiso para desasociar una aplicación de Q con un usuario en el entorno de aplicación de Q Business | Escritura | |||
ExportQAppSessionData [solo permiso] | Concede permiso para exportar datos de sesión de la aplicación de Q en el entorno de aplicación de Q Business | Escritura | |||
GetLibraryItem | Concede permiso para obtener un elemento de biblioteca en el entorno de aplicación de Q Business | Lectura | |||
GetQApp | Concede permiso para obtener la aplicación de Q en el entorno de aplicación de Q Business | Lectura | |||
GetQAppSession | Concede permiso para obtener la sesión de la aplicación de Q en el entorno de aplicación de Q Business | Lectura | |||
GetQAppSessionMetadata [solo permiso] | 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 | |||
ImportDocument | 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 | |||
ImportDocumentToQApp [solo permiso] | Concede permiso para importar un documento a la aplicación de Q en el entorno de aplicación de Q Business | Escritura | |||
ImportDocumentToQAppSession [solo permiso] | Concede permiso para importar un documento a la sesión de la aplicación de Q en el entorno de aplicación de Q Business | Escritura | |||
ListCategories | Otorga permiso para enumerar categorías en el entorno de aplicaciones de Q Business | Enumeración | |||
ListLibraryItems | Concede permiso para enumerar elementos de biblioteca en el entorno de aplicación de Q Business | Enumeración | |||
ListQAppSessionData [solo permiso] | 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 | |||
ListQApps | Concede permiso para enumerar aplicaciones de Q en el entorno de aplicación de Q Business | Enumeración | |||
ListTagsForResource | Concede permiso para enumerar las etiquetas de un recurso | Lectura | |||
PredictProblemStatementFromConversation [solo permiso] | 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 | |||
PredictQApp | 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 | |||
PredictQAppFromProblemStatement [solo permiso] | 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 | |||
StartQAppSession | Concede permiso para iniciar la sesión de la aplicación de Q en el entorno de aplicación de Q Business | Escritura | |||
StopQAppSession | Concede permiso para detener la sesión de la aplicación de Q en el entorno de aplicación de Q Business | 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 | |||
UpdateLibraryItem | Concede permiso para actualizar un elemento de biblioteca en el entorno de aplicación de Q Business | Escritura | |||
UpdateLibraryItemMetadata | Concede permiso para actualizar los metadatos de un elemento de biblioteca en el entorno de aplicación de Q Business | Escritura | |||
UpdateQApp | Concede permiso para actualizar la aplicación de Q en el entorno de aplicación de Q Business | Escritura | |||
UpdateQAppPermissions | Otorga permiso para actualizar los permisos de uso compartido de Q App en el entorno de aplicaciones Q Business | Escritura | |||
UpdateQAppSession | Concede permiso para actualizar la sesión de la aplicación de Q en el entorno de aplicación de Q Business | Escritura | |||
UpdateQAppSessionMetadata [solo permiso] | 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 |
Tipos de recursos definidos por las aplicaciones de Q de Amazon Q Business
Este servicio define los siguientes tipos de recursos y se pueden utilizar como Resource
elemento de las declaraciones de política de IAM permisos. 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}
|
|
qapp |
arn:${Partition}:qapps:${Region}:${Account}:application/${ApplicationId}/qapp/${AppId}
|
|
qapp-session |
arn:${Partition}:qapps:${Region}:${Account}:application/${ApplicationId}/qapp/${AppId}/session/${SessionId}
|
Claves de condición para las aplicaciones de Q de Amazon Q Business
Amazon Q Business Q Apps 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 |
qapps:AppIsPublished | Filtra el acceso en función de si la aplicación de Q está publicada | Cadena |
qapps:SessionIsShared | Filtra el acceso según si la sesión de la aplicación de Q se ha compartido | Cadena |
qapps:UserIsAppOwner | Filtra el acceso según si el solicitante es propietario de la aplicación de Q | Cadena |
qapps:UserIsSessionModerator | Filtra el acceso según si el solicitante es moderador de la sesión de la aplicación de Q | Cadena |