Acciones, recursos y claves de condición para Amazon Textract

Amazon Textract (prefijo de servicio textract) proporciona las siguientes claves de contexto de condición, acciones y recursos 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 Textract

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
AnalyzeDocument	Otorga permiso para detectar instancias de entidades de documentos del mundo real dentro de una imagen proporcionada como entrada	Lectura			s3:GetObject
AnalyzeExpense	Otorga permiso para detectar instancias de entidades de documentos del mundo real dentro de una imagen proporcionada como entrada	Lectura			s3:GetObject
AnalyzeID	Otorga permiso para detectar información relevante de los documentos de identidad proporcionados como entrada.	Lectura			s3:GetObject
CreateAdapter	Concede permiso para crear un adaptador de Amazon Textract	Escritura		aws:RequestTag/${TagKey} aws:TagKeys
CreateAdapterVersion	Concede permiso para crear una versión del adaptador de Amazon Textract	Escritura	adapter*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAdapter	Concede permiso para eliminar un adaptador de Amazon Textract	Escritura	adapter*
DeleteAdapterVersion	Concede permiso para eliminar una versión del adaptador de Amazon Textract	Escritura	adapterversion*
DetectDocumentText	Otorga permiso para detectar texto en imágenes de documentos	Lectura			s3:GetObject
GetAdapter	Concede permiso para obtener un adaptador de Amazon Textract	Lectura	adapter*
GetAdapterVersion	Concede permiso para obtener una versión del adaptador de Amazon Textract	Lectura	adapterversion*
GetDocumentAnalysis	Otorga permiso para devolver información sobre un trabajo de análisis de documento	Lectura
GetDocumentTextDetection	Otorga permiso para devolver información sobre un trabajo de detección de documento de texto	Lectura
GetExpenseAnalysis	Otorga permiso para devolver información acerca de un trabajo de análisis de gastos.	Lectura
GetLendingAnalysis	Otorga permiso para recuperar información de nivel de página relativa a un trabajo de análisis de préstamos	Lectura
GetLendingAnalysisSummary	Otorga permiso para recuperar información resumida relativa a un trabajo de análisis de préstamos	Lectura
ListAdapterVersions	Concede permiso para enumerar las versiones del adaptador de Amazon Textract	Lectura
ListAdapters	Concede permiso para enumerar los adaptadores de Amazon Textract	Lectura
ListTagsForResource	Otorga permiso para devolver una lista de etiquetas asociadas a un recurso.	Lectura	adapter
			adapterversion
StartDocumentAnalysis	Otorga permiso para comenzar un trabajo asíncrono para detectar instancias de entidades de documentos del mundo real dentro de una imagen o PDF proporcionado como entrada	Escritura			s3:GetObject
StartDocumentTextDetection	Otorga permiso para comenzar un trabajo asíncrono para detectar texto en PDF o imágenes de documentos	Escritura			s3:GetObject
StartExpenseAnalysis	Otorga permiso para comenzar un trabajo asíncrono para detectar instancias de facturas o recibos dentro de una imagen o PDF proporcionado como entrada.	Escritura			s3:GetObject
StartLendingAnalysis	Otorga permiso para iniciar un trabajo asíncrono para la detección de entidades en un documento de préstamo, toma una imagen o PDF proporcionado como entrada	Escritura			s3:GetObject
TagResource	Concede permiso para agregar una o varias etiquetas a un recurso.	Etiquetado	adapter
			adapterversion
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Concede permiso para eliminar una o varias etiquetas de un recurso.	Etiquetado	adapter
			adapterversion
				aws:TagKeys
UpdateAdapter	Concede permiso para actualizar el adaptador de Amazon Textract	Escritura	adapter*

Tipos de recurso definidos por Amazon Textract

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
adapter	arn:${Partition}:textract:${Region}:${Account}:/adapters/${AdapterId}	aws:ResourceTag/${TagKey}
adapterversion	arn:${Partition}:textract:${Region}:${Account}:/adapters/${AdapterId}/versions/${AdapterVersion}	aws:ResourceTag/${TagKey}

Claves de condición de Amazon Textract

Amazon Textract 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 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