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.
# Administración de adaptadores con la AWS CLI y SDKs
Rekognition le permite utilizar múltiples características que aprovechan los modelos de visión artificial previamente entrenados. Con estos modelos, puede llevar a cabo tareas como la detección de etiquetas y la moderación del contenido. También puede personalizar estos modelos específicos con un adaptador.
Puede utilizar la creación y gestión de proyectos de Rekognition APIs (como [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html)y [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)) para crear y entrenar adaptadores. En las siguientes páginas se describe cómo usar las operaciones de la API para crear, entrenar y administrar los adaptadores mediante la AWS consola, el AWS SDK que elija o la AWS CLI.
Después de entrenar un adaptador, puede usarlo para realizar inferencias con las características compatibles. Actualmente, los adaptadores son compatibles cuando se utiliza la característica de moderación de contenido.
Cuando entrenes un adaptador con un AWS SDK, debes proporcionar las etiquetas de información básica (anotaciones de imagen) en forma de archivo de manifiesto. También puede utilizar la consola de Rekognition para crear y entrenar un adaptador.
**nota**
Los adaptadores no se pueden copiar. Solo se pueden copiar las versiones de los proyectos de Etiquetas personalizadas de Rekognition.
**Topics**
+ [Estados de adaptador](#managing-adapters-project-versions-statuses)
+ [Creación de un proyecto](managing-adapters-create-project.md)
+ [Descripción de proyectos](managing-adapters-describe-projects.md)
+ [Eliminación de un proyecto](managing-adapters-delete-project.md)
+ [Creación de una versión del proyecto](managing-adapters-create-project-version.md)
+ [Describir una versión del proyecto](managing-adapters-describe-project.md)
+ [Eliminación de una versión del proyecto](managing-adapters-delete-project-version.md)
## Estados de adaptador
El adaptador de Moderación personalizada (versiones de los proyectos) puede tener uno de los siguientes estados:
+ TRAINING\$1IN\$1PROGRESS: el adaptador está en proceso de entrenamiento con los archivos que ha proporcionado como documentos de entrenamiento.
+ TRAINING\$1COMPLETED: el adaptador ha completado correctamente el entrenamiento y está listo para que revise su rendimiento.
+ TRAINING\$1FAILED: el adaptador no ha podido completar su entrenamiento por algún motivo. Revise el archivo del manifiesto de salida y el resumen del manifiesto de salida para obtener información sobre la causa del error.
+ DELETING: el adaptador está en proceso de eliminarse.
+ DEPRECATED: el adaptador se ha entrenado con una versión anterior del modelo base de Moderación de contenido. Está en periodo de gracia y expirará entre 60 y 90 días a partir del lanzamiento de la nueva versión del modelo base. Durante el período de gracia, puedes seguir utilizando el adaptador para realizar inferencias [DetectModerationLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectModerationLabels.html)o [StartMediaAnalysisJob](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartMediaAnalysisJob.html)realizar operaciones de API. Consulte la consola de Moderación personalizada para ver la fecha de vencimiento de los adaptadores.
+ CADUCADO: el adaptador se entrenó con una versión anterior del modelo base de moderación de contenido y ya no se puede utilizar para obtener resultados personalizados con las operaciones de la StartMediaAnalysisJob API DetectModerationLabels o de la API. Si se especifica un adaptador con el estado Expired en una solicitud de inferencia, este se ignorará y, en su lugar, se devolverá la respuesta de la versión más reciente del modelo base de Moderación personalizada.
# Creación de un proyecto
Con esta [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html)operación, puede crear un proyecto que contenga un adaptador para las operaciones de detección de etiquetas de Rekognition. Un proyecto es un grupo de recursos y, en el caso de operaciones de detección de etiquetas, por ejemplo DetectModerationLabels, un proyecto te permite almacenar adaptadores que puedes usar para personalizar el modelo base de Rekognition. Al invocar CreateProject, se proporciona al argumento el nombre del proyecto que se quiere crear. ProjectName
Para crear un proyecto con la AWS consola:
+ Inicie sesión en la consola de Rekognition
+ Haga clic en **Moderación personalizada**
+ Elija **Crear proyecto**
+ Seleccione **Crear un nuevo proyecto** o **Agregar a un proyecto existente**
+ Agregue un **nombre de proyecto**
+ Agregue un **nombre de adaptador**
+ Agregue una descripción si lo desea
+ Elija cómo quiere importar las imágenes de su entrenamiento: archivo de manifiesto, desde un bucket de S3 o desde su ordenador
+ Elija si quiere dividir automáticamente sus datos de entrenamiento o importar un archivo de manifiesto
+ Seleccione si quiere que el proyecto se actualice automáticamente o no
+ Haga clic en **Crear proyecto**
Para crear un proyecto con la AWS CLI y el SDK:
1. Si aún no lo ha hecho, instale y configure la AWS CLI y el AWS SDKs. Para obtener más información, consulte [Paso 2: Configure y AWS CLI AWS SDKs](setup-awscli-sdk.md) .
1. Utilice el siguiente código para crear un proyecto:
------
#### [ CLI ]
```
# Request
# Creating Content Moderation Project
aws rekognition create-project \
--project-name "project-name" \
--feature CONTENT_MODERATION \
--auto-update ENABLED
--profile profile-name
```
------
# Descripción de proyectos
Puede usar la [DescribeProjects](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjects.html)API para obtener información sobre sus proyectos, incluida la información sobre todos los adaptadores asociados a un proyecto.
Para describir los proyectos con la AWS CLI y el SDK:
1. Si aún no lo ha hecho, instale y configure la AWS CLI y el AWS SDKs. Para obtener más información, consulte [Paso 2: Configure y AWS CLI AWS SDKs](setup-awscli-sdk.md) .
1. Utilice el siguiente código para describir un proyecto:
------
#### [ CLI ]
```
# Request
# Getting CONTENT_MODERATION project details
aws rekognition describe-projects \
--features CONTENT_MODERATION
--profile profile-name
```
------
# Eliminación de un proyecto
Puedes eliminar un proyecto mediante la consola de Rekognition o llamando a la API. [DeleteProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProject.html) Para eliminar un proyecto, primero debe eliminar todos los adaptadores asociados. No se puede recuperar un proyecto o modelo después de eliminarlo.
Para eliminar un proyecto con la consola: AWS
+ Inicie sesión en la consola de Rekognition.
+ Haga clic en **Moderación personalizada**.
+ Debe eliminar cada adaptador asociado al proyecto para poder eliminar el proyecto en sí. Elimine todos los adaptadores asociados al proyecto seleccionando el adaptador y, a continuación, seleccionando **Eliminar**.
+ Seleccione el proyecto y, a continuación, pulse el botón **Eliminar**.
Para eliminar un proyecto con la AWS CLI y el SDK:
1. Si aún no lo ha hecho, instale y configure la AWS CLI y el AWS SDKs. Para obtener más información, consulte [Paso 2: Configure y AWS CLI AWS SDKs](setup-awscli-sdk.md) .
1. Utilice el código siguiente para eliminar un proyecto:
------
#### [ CLI ]
```
aws rekognition delete-project
--project-arn project_arn \
--profile profile-name
```
------
# Creación de una versión del proyecto
Puede entrenar un adaptador para su implementación mediante la [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)operación. CreateProjectVersion primero crea una nueva versión de un adaptador asociado a un proyecto y, a continuación, comienza a entrenarlo. La respuesta de CreateProjectVersion es un nombre de recurso de Amazon (ARN) para la versión del modelo. El entrenamiento tarda un tiempo en completarse. Puede obtener el estado actual llamando DescribeProjectVersions. Al entrenar un modelo, Rekognition usa los conjuntos de datos de entrenamiento y prueba asociados al proyecto. Para crear conjuntos de datos, deberá utilizar la consola. Para obtener más información, consulte la sección sobre conjuntos de datos.
Para crear un proyecto con la consola de Rekognition:
+ Inicie sesión en la consola de AWS Rekognition
+ Haga clic en Moderación personalizada
+ Seleccionar un proyecto.
+ En la página Detalles del proyecto, elija **Crear adaptador**
+ En la página Crear un proyecto, rellene los detalles necesarios para Detalles del proyecto, Imágenes de entrenamiento e Imágenes de prueba y, a continuación, seleccione **Crear proyecto**.
+ En la página Asignar etiquetas a las imágenes, añada etiquetas a sus imágenes y, cuando termine, seleccione **Comenzar a entrenar**
Para crear una versión del proyecto con la AWS CLI y el SDK:
1. Si aún no lo ha hecho, instale y configure la AWS CLI y el AWS SDKs. Para obtener más información, consulte [Paso 2: Configure y AWS CLI AWS SDKs](setup-awscli-sdk.md) .
1. Utilice el siguiente código para crear una versión del proyecto:
------
#### [ CLI ]
```
# Request
aws rekognition create-project-version \
--project-arn project-arn \
--training-data '{Assets=[GroundTruthManifest={S3Object="amzn-s3-demo-source-bucket",Name="manifest.json"}]}' \
--output-config S3Bucket=amzn-s3-demo-destination-bucket,S3KeyPrefix=my-results \
--feature-config "ContentModeration={ConfidenceThreshold=70}"
--profile profile-name
```
------
# Describir una versión del proyecto
Puede enumerar y describir los adaptadores asociados a un proyecto mediante la [DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions.html)operación. Puede especificar hasta 10 versiones de modelo en ProjectVersionArns. Si no indica un valor, se devolverán las descripciones de todas las versiones del modelo en el proyecto.
Para describir la versión de un proyecto con la AWS CLI y el SDK:
1. Si aún no lo ha hecho, instale y configure la AWS CLI y el AWS SDKs. Para obtener más información, consulte [Paso 2: Configure y AWS CLI AWS SDKs](setup-awscli-sdk.md) .
1. Utilice el siguiente código para describir una versión del proyecto:
------
#### [ CLI ]
```
aws rekognition describe-project-versions
--project-arn project_arn \
--version-names [versions]
```
------
# Eliminación de una versión del proyecto
Puede eliminar un adaptador de Rekognition asociado a un proyecto mediante esta operación. [DeleteProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectVersion.html) No puede eliminar un adaptador si se está ejecutando o si se está entrenando. Para comprobar el estado de un adaptador, llame a la DescribeProjectVersions operación y compruebe el campo de estado que devuelve. Para detener una llamada al adaptador en ejecución StopProjectVersion. Si el modelo se está entrenando, espere a que termine de entrenarse para eliminarlo. Debe eliminar cada adaptador asociado al proyecto para poder eliminar el proyecto en sí.
Para eliminar un proyecto con la consola de Rekognition:
+ Inicie sesión en la consola de Rekognition
+ Haga clic en Moderación personalizada
+ En la pestaña Proyectos, puede ver todos sus proyectos y los adaptadores asociados. Seleccione un adaptador y, a continuación, seleccione **Eliminar**.
Para eliminar una versión del proyecto con la AWS CLI y el SDK:
1. Si aún no lo ha hecho, instale y configure la AWS CLI y el AWS SDKs. Para obtener más información, consulte [Paso 2: Configure y AWS CLI AWS SDKs](setup-awscli-sdk.md) .
1. Utilice el código siguiente para eliminar una versión del proyecto:
------
#### [ CLI ]
```
# Request
aws rekognition delete-project-version
--project-version-arn model_arn \
--profile profile-name
```
------