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

Amazon Rekognition (prefijo de servicio: rekognition) 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 del IAM.

Acciones definidas por Amazon Rekognition

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
AssociateFaces	Concede permiso para asociar varios rostros individuales a un solo usuario	Escritura	collection*
CompareFaces	Concede permiso para comparar los rostros de la imagen de entrada de origen con cada rostro detectado en la imagen de entrada de destino	Lectura
CopyProjectVersion	Concede permiso para copiar una versión del modelo existente en una nueva versión del modelo.	Escritura	project*
			projectversion*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateCollection	Otorga permiso para crear una colección en una Región de AWS	Escritura	collection*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDataset	Otorga permiso para crear un nuevo conjunto de datos de etiquetas personalizadas de Amazon Rekognition.	Escritura	project*
CreateFaceLivenessSession	Concede permiso para crear una sesión de prueba de vida	Escritura
CreateProject	Otorga permiso para crear un proyecto de etiquetas personalizadas de Amazon Rekognition.	Escritura	project*
CreateProjectVersion	Otorga permiso para comenzar a entrenar una nueva versión de un modelo.	Escritura	project*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateStreamProcessor	Otorga permiso para crear un procesador de transmisión de Amazon Rekognition.	Escritura	collection*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateUser	Concede permiso para crear un nuevo usuario en una colección con un ID de usuario único que usted proporcione	Escritura	collection*
DeleteCollection	Otorga permiso para eliminar la colección especificada.	Escritura	collection*
DeleteDataset	Otorga permiso para eliminar un conjunto de datos existente de etiquetas personalizadas de Amazon Rekognition.	Escritura	dataset*
DeleteFaces	Otorga permiso para eliminar rostros de una colección.	Escritura	collection*
DeleteProject	Concede permiso para eliminar un proyecto	Escritura	project*
DeleteProjectPolicy	Concede permiso para eliminar la política de recursos adjunta a un proyecto.	Escritura	project*
DeleteProjectVersion	Concede permiso para eliminar un modelo	Escritura	projectversion*
DeleteStreamProcessor	Otorga permiso para eliminar el procesador de transmisión especificado.	Escritura	streamprocessor*
DeleteUser	Concede permiso para eliminar un usuario de una colección en función del ID de usuario proporcionado	Escritura	collection*
DescribeCollection	Otorga permiso para leer detalles acerca de una colección.	Lectura	collection*
DescribeDataset	Otorga permiso para describir un conjunto de datos de etiquetas personalizadas de Amazon Rekognition.	Lectura	dataset*
DescribeProjectVersions	Otorga permiso para enumerar las versiones de un modelo en un proyecto de etiquetas personalizadas de Amazon Rekognition.	Lectura	project*
DescribeProjects	Otorga permiso para enumerar los proyectos de etiquetas personalizadas de Amazon Rekognition.	Lectura
DescribeStreamProcessor	Otorga permiso para obtener información acerca del procesador de transmisión especificado.	Lectura	streamprocessor*
DetectCustomLabels	Otorga permiso para detectar etiquetas personalizadas en una imagen suministrada.	Lectura	projectversion*
DetectFaces	Otorga permiso para detectar rostros humanos en una imagen proporcionada como entrada.	Lectura
DetectLabels	Otorga permiso para detectar instancias de etiquetas del mundo real dentro de una imagen proporcionada como entrada.	Lectura
DetectModerationLabels	Otorga permiso para detectar etiquetas de moderación dentro de la imagen de entrada,	Lectura	projectversion
DetectProtectiveEquipment	Otorga permiso para detectar el equipo de protección personal en la imagen de entrada.	Lectura
DetectText	Otorga permiso para detectar texto en la imagen de entrada y lo convierte en texto legible por una máquina.	Lectura
DisassociateFaces	Concede permiso para eliminar la asociación entre un ID de usuario y un ID de rostro	Escritura	collection*
DistributeDatasetEntries	Otorga permiso para distribuir las entradas de un conjunto de datos de formación en todo el conjunto de datos de formación y el conjunto de datos de prueba de un proyecto.	Escritura	dataset*
GetCelebrityInfo	Otorga permiso para leer el nombre y la información adicional de una celebridad.	Lectura
GetCelebrityRecognition	Otorga permiso para leer los resultados de reconocimiento de celebridades encontrados en un video almacenado por un trabajo de reconocimiento de celebridades asíncrono.	Lectura
GetContentModeration	Otorga permiso para leer los resultados del análisis de moderación de contenido que se encuentran en un video almacenado mediante un trabajo de moderación de contenido asíncrono.	Lectura
GetFaceDetection	Otorga permiso para leer los resultados de detección de rostros encontrados en un video almacenado mediante un trabajo de detección de rostros asíncrono.	Lectura
GetFaceLivenessSessionResults	Concede permiso para obtener los resultados de una sesión de prueba de vida	Lectura
GetFaceSearch	Otorga permiso para leer los rostros coincidentes de la colección encontrados en un video almacenado mediante un trabajo de búsqueda asíncrona de rostros.	Lectura
GetLabelDetection	Otorga permiso para leer los resultados de la etiqueta detectados en un video almacenado mediante un trabajo de detección de etiquetas asíncrono.	Lectura
GetMediaAnalysisJob	Otorga permiso para leer la referencia a los resultados del trabajo en S3 y la información adicional sobre un trabajo de análisis de medios	Lectura
GetPersonTracking	Otorga permiso para leer la lista de personas detectadas en un video almacenado por un trabajo de seguimiento de personas asíncrono.	Lectura
GetSegmentDetection	Otorga permiso para obtener los segmentos de video que se encuentran en un video almacenado mediante un trabajo de detección de segmentos asíncrono.	Lectura
GetTextDetection	Otorga permiso para obtener el texto encontrado en un video almacenado mediante un trabajo de detección de texto asíncrono.	Lectura
IndexFaces	Otorga permiso para actualizar una colección existente con rostros detectados en la imagen de entrada.	Escritura	collection*
ListCollections	Otorga permiso para leer los ID de colección de su cuenta.	Lectura
ListDatasetEntries	Otorga permiso para enumerar las entradas del conjunto de datos en un conjunto de datos de etiquetas personalizadas de Amazon Rekognition existente.	Lectura	dataset*
ListDatasetLabels	Otorga permiso para enumerar todas las etiquetas en un conjunto de datos.	Lectura	dataset*
ListFaces	Otorga permiso para leer metadatos de los rostros de la colección especificada.	Lectura	collection*
ListMediaAnalysisJobs	Otorga permiso para leer la lista de trabajos de análisis de medios	Lectura
ListProjectPolicies	Concede permiso para enumerar la política de recursos asociada a un proyecto.	Lectura	project*
ListStreamProcessors	Otorga permiso para obtener una lista de sus procesadores de streaming.	Enumeración	streamprocessor*
ListTagsForResource	Otorga permiso para devolver una lista de etiquetas asociadas a un recurso.	Lectura	projectversion*
ListUsers	Concede permiso para enumerar los UserIds y UserStatus	Lectura	collection*
PutProjectPolicy	Concede permiso para adjuntar una política de recursos a un proyecto.	Escritura	project*
RecognizeCelebrities	Otorga permiso para detectar celebridades en la imagen de entrada.	Lectura
SearchFaces	Otorga permiso para buscar en la colección especificada el ID de rostro suministrado.	Lectura	collection*
SearchFacesByImage	Otorga permiso para buscar en la colección especificada el rostro más grande de la imagen de entrada.	Lectura	collection*
SearchUsers	Concede permiso para buscar en la colección especificada el resultado de coincidencias de usuarios con el ID de rostro o ID de usuario proporcionado	Lectura	collection*
SearchUsersByImage	Concede permiso para buscar en la colección especificada el resultado de coincidencias de usuarios mediante el rostro más grande de la imagen de entrada	Lectura	collection*
StartCelebrityRecognition	Otorga permiso para iniciar el reconocimiento asincrónico de famosos en un vídeo almacenado	Escritura
StartContentModeration	Otorga permiso para iniciar la detección asincrónica de contenido explícito o sugerente para adultos en un video.	Escritura
StartFaceDetection	Otorga permiso para iniciar la detección asincrónica de rostros en un video almacenado.	Escritura
StartFaceLivenessSession	Concede permiso para iniciar la transmisión de vídeo para una sesión de prueba de vida	Escritura
StartFaceSearch	Otorga permiso para iniciarla búsqueda asincrónica de rostros en una colección que coincidan con los rostros de las personas detectadas en un video.	Escritura	collection*
StartLabelDetection	Otorga permiso para iniciar la detección asincrónica de etiquetas en un vídeo almacenado.	Escritura
StartMediaAnalysisJob	Concede permiso para comenzar un trabajo de análisis de medios	Escritura	projectversion
StartPersonTracking	Otorga permiso para iniciar el seguimiento asincrónico de personas en un vídeo almacenado.	Escritura
StartProjectVersion	Otorga permiso para iniciar a ejecutar una versión de un modelo.	Escritura	projectversion*
StartSegmentDetection	Otorga permiso para iniciarla detección asincrónica de segmentos en un video almacenado.	Escritura
StartStreamProcessor	Otorga permiso para iniciar la ejecución de un procesador de secuencia.	Escritura	streamprocessor*
StartTextDetection	Otorga permiso para iniciar la detección asincrónica del texto en un video almacenado	Escritura
StopProjectVersion	Otorga permiso para detener una versión de modelo en ejecución.	Escritura	projectversion*
StopStreamProcessor	Otorga permiso para detener un procesador de secuencia en ejecución.	Escritura	streamprocessor*
TagResource	Concede permiso para agregar una o varias etiquetas a un recurso.	Etiquetado	collection
			projectversion
			streamprocessor
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Concede permiso para eliminar una o varias etiquetas de un recurso.	Etiquetado	collection
			projectversion
			streamprocessor
				aws:TagKeys
UpdateDatasetEntries	Otorga permiso para agregar o actualizar una o más líneas JSON (entradas) en un conjunto de datos.	Escritura	dataset*
UpdateStreamProcessor	Otorga permiso para modificar las propiedades de un procesador de flujo.	Escritura	streamprocessor*

Tipos de recurso definidos por Amazon Rekognition

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
collection	arn:${Partition}:rekognition:${Region}:${Account}:collection/${CollectionId}	aws:ResourceTag/${TagKey}
streamprocessor	arn:${Partition}:rekognition:${Region}:${Account}:streamprocessor/${StreamprocessorId}	aws:ResourceTag/${TagKey}
project	arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/${CreationTimestamp}
projectversion	arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/version/${VersionName}/${CreationTimestamp}	aws:ResourceTag/${TagKey}
dataset	arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/dataset/${DatasetType}/${CreationTimestamp}

Claves de condición de Amazon Rekognition

Amazon Rekognition define las siguientes claves de condición que pueden utilizarse 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