Acciones, recursos y claves de condición de 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 de IAM.
Temas
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 | |||
| 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 | Leer | |||
| CopyProjectVersion | Concede permiso para copiar una versión del modelo existente en una nueva versión del modelo. | Escritura | |||
| CreateCollection | Otorga permiso para crear una colección en una Región de AWS | Escritura | |||
| CreateDataset | Otorga permiso para crear un nuevo conjunto de datos de etiquetas personalizadas de Amazon Rekognition. | Escritura | |||
| 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 | |||
| CreateProjectVersion | Otorga permiso para comenzar a entrenar una nueva versión de un modelo. | Escritura | |||
| CreateStreamProcessor | Otorga permiso para crear un procesador de transmisión de Amazon Rekognition. | Escritura | |||
| CreateUser | Concede permiso para crear un nuevo usuario en una colección con un ID de usuario único que usted proporcione | Escritura | |||
| DeleteCollection | Otorga permiso para eliminar la colección especificada. | Escritura | |||
| DeleteDataset | Otorga permiso para eliminar un conjunto de datos existente de etiquetas personalizadas de Amazon Rekognition. | Escritura | |||
| DeleteFaces | Otorga permiso para eliminar rostros de una colección. | Escritura | |||
| DeleteProject | Concede permiso para eliminar un proyecto | Escritura | |||
| DeleteProjectPolicy | Concede permiso para eliminar la política de recursos adjunta a un proyecto. | Escritura | |||
| DeleteProjectVersion | Concede permiso para eliminar un modelo | Escritura | |||
| DeleteStreamProcessor | Otorga permiso para eliminar el procesador de transmisión especificado. | Escritura | |||
| DeleteUser | Concede permiso para eliminar un usuario de una colección en función del ID de usuario proporcionado | Escritura | |||
| DescribeCollection | Otorga permiso para leer detalles acerca de una colección. | Leer | |||
| DescribeDataset | Otorga permiso para describir un conjunto de datos de etiquetas personalizadas de Amazon Rekognition. | Leer | |||
| DescribeProjectVersions | Otorga permiso para enumerar las versiones de un modelo en un proyecto de etiquetas personalizadas de Amazon Rekognition. | Leer | |||
| DescribeProjects | Otorga permiso para enumerar los proyectos de etiquetas personalizadas de Amazon Rekognition. | Leer | |||
| DescribeStreamProcessor | Otorga permiso para obtener información acerca del procesador de transmisión especificado. | Leer | |||
| DetectCustomLabels | Otorga permiso para detectar etiquetas personalizadas en una imagen suministrada. | Leer | |||
| DetectFaces | Otorga permiso para detectar rostros humanos en una imagen proporcionada como entrada. | Leer | |||
| DetectLabels | Otorga permiso para detectar instancias de etiquetas del mundo real dentro de una imagen proporcionada como entrada. | Leer | |||
| DetectModerationLabels | Otorga permiso para detectar etiquetas de moderación dentro de la imagen de entrada, | Leer | |||
| DetectProtectiveEquipment | Otorga permiso para detectar el equipo de protección personal en la imagen de entrada. | Leer | |||
| DetectText | Otorga permiso para detectar texto en la imagen de entrada y lo convierte en texto legible por una máquina. | Leer | |||
| DisassociateFaces | Concede permiso para eliminar la asociación entre un ID de usuario y un ID de rostro | Escritura | |||
| 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 | |||
| GetCelebrityInfo | Otorga permiso para leer el nombre y la información adicional de una celebridad. | Leer | |||
| 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. | Leer | |||
| 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. | Leer | |||
| 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. | Leer | |||
| GetFaceLivenessSessionResults | Concede permiso para obtener los resultados de una sesión de prueba de vida | Leer | |||
| 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. | Leer | |||
| 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. | Leer | |||
| 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 | Leer | |||
| GetPersonTracking | Otorga permiso para leer la lista de personas detectadas en un video almacenado por un trabajo de seguimiento de personas asíncrono. | Leer | |||
| 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. | Leer | |||
| GetTextDetection | Otorga permiso para obtener el texto encontrado en un video almacenado mediante un trabajo de detección de texto asíncrono. | Leer | |||
| IndexFaces | Otorga permiso para actualizar una colección existente con rostros detectados en la imagen de entrada. | Escritura | |||
| ListCollections | Otorga permiso para leer los ID de colección de su cuenta. | Leer | |||
| ListDatasetEntries | Otorga permiso para enumerar las entradas del conjunto de datos en un conjunto de datos de etiquetas personalizadas de Amazon Rekognition existente. | Leer | |||
| ListDatasetLabels | Otorga permiso para enumerar todas las etiquetas en un conjunto de datos. | Leer | |||
| ListFaces | Otorga permiso para leer metadatos de los rostros de la colección especificada. | Leer | |||
| ListMediaAnalysisJobs | Otorga permiso para leer la lista de trabajos de análisis de medios | Leer | |||
| ListProjectPolicies | Concede permiso para enumerar la política de recursos asociada a un proyecto. | Leer | |||
| ListStreamProcessors | Otorga permiso para obtener una lista de sus procesadores de streaming. | Enumeración | |||
| ListTagsForResource | Otorga permiso para devolver una lista de etiquetas asociadas a un recurso. | Leer | |||
| ListUsers | Concede permiso para enumerar los UserIds y UserStatus | Leer | |||
| PutProjectPolicy | Concede permiso para adjuntar una política de recursos a un proyecto. | Escritura | |||
| RecognizeCelebrities | Otorga permiso para detectar celebridades en la imagen de entrada. | Leer | |||
| SearchFaces | Otorga permiso para buscar en la colección especificada el ID de rostro suministrado. | Leer | |||
| SearchFacesByImage | Otorga permiso para buscar en la colección especificada el rostro más grande de la imagen de entrada. | Leer | |||
| 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 | Leer | |||
| 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 | Leer | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| StopStreamProcessor | Otorga permiso para detener un procesador de secuencia en ejecución. | Escritura | |||
| TagResource | Concede permiso para agregar una o varias etiquetas a un recurso. | Etiquetado | |||
| UntagResource | Concede permiso para eliminar una o varias etiquetas de un recurso. | Etiquetado | |||
| UpdateDatasetEntries | Otorga permiso para agregar o actualizar una o más líneas JSON (entradas) en un conjunto de datos. | Escritura | |||
| UpdateStreamProcessor | Otorga permiso para modificar las propiedades de un procesador de flujo. | Escritura |
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}
|
|
| streamprocessor |
arn:${Partition}:rekognition:${Region}:${Account}:streamprocessor/${StreamprocessorId}
|
|
| project |
arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/${CreationTimestamp}
|
|
| projectversion |
arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/version/${VersionName}/${CreationTimestamp}
|
|
| 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 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 |
