

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 puntos de conexión de Amazon Comprehend
<a name="manage-endpoints"></a>

En Amazon Comprehend, los puntos de conexión permiten que sus modelos personalizados estén disponibles para la clasificación en tiempo real o la detección de entidades. Después de crear un punto de conexión, puede efectuar cambios en él a medida que evolucionen las necesidades de su empresa. Por ejemplo, puede supervisar el uso de sus puntos de conexión y aplicar el escalado automático para configurar automáticamente el aprovisionamiento de puntos de conexión de forma que se adapte a sus necesidades de capacidad. Puede gestionar todos sus puntos de conexión desde una única vista y, cuando ya no necesite uno, puede eliminarlo para ahorrar costes. 

Antes de poder gestionar un punto de conexión, debe crear uno. Para obtener más información, consulte los siguientes procedimientos:
+ [Creación de un punto de conexión para una clasificación personalizada](custom-sync.md#create-endpoint)
+ [Creación de un punto de conexión para la detección personalizada de entidades](detecting-cer-real-time.md#detecting-cer-real-time-create-endpoint)

**Topics**
+ [Información general de los puntos de conexión de Amazon Comprehend](manage-endpoints-overview.md)
+ [Uso de puntos de conexión de Amazon Comprehend](using-endpoints.md)
+ [Monitorización de puntos de conexión de Amazon Comprehend](manage-endpoints-monitor.md)
+ [Actualización de puntos de conexión de Amazon Comprehend](manage-endpoints-update.md)
+ [Uso Trusted Advisor con Amazon Comprehend](manage-endpoints-trusted-advisor.md)
+ [Eliminación de puntos de conexión de Amazon Comprehend](manage-endpoints-delete.md)
+ [Escalado automático con puntos de conexión](comprehend-autoscaling.md)

# Información general de los puntos de conexión de Amazon Comprehend
<a name="manage-endpoints-overview"></a>

La página de puntos de conexión de la consola Amazon Comprehend le proporciona una visión global de sus puntos de conexión. En la página de descripción general de los puntos de conexión, puede ver todos los puntos de conexión en un solo lugar para comparar el uso de los puntos de conexión con el uso real de los recursos. En la parte superior derecha de la página de puntos de conexión, puede especificar los puntos de conexión que desea ver: todos ellos, los puntos de conexión del clasificador personalizado o los puntos de conexión de su entidad personalizados.

Puede crear, actualizar, supervisar y eliminar puntos de conexión desde esta página. En la sección de descripción general de los puntos de conexión, puede ver una lista de los puntos de conexión, los modelos personalizados que alojan los puntos de conexión, su tiempo de creación, el rendimiento aprovisionado y el estado del punto de conexión. Al seleccionar un punto de conexión específico de la tabla de descripción general del punto de conexión, se muestran los detalles del punto de conexión. 

Además, si es cliente de [AWS Business Support](https://aws.amazon.com/premiumsupport/plans/business/) o [AWS Enterprise Support](https://aws.amazon.com/premiumsupport/plans/enterprise/), tiene acceso a las verificaciones de Trusted Advisor específicas de sus puntos de conexión. Para obtener más información, consulte [Uso Trusted Advisor con Amazon Comprehend](manage-endpoints-trusted-advisor.md). Para obtener una lista completa de verificaciones y descripciones, consulte las [Prácticas recomendadas de Trusted Advisor](https://aws.amazon.com/premiumsupport/technology/trusted-advisor/best-practice-checklist/).

Para obtener más información acerca de cómo administrar sus puntos de conexión, consulte los siguientes temas. 
+ [Uso de puntos de conexión de Amazon Comprehend](using-endpoints.md)
+ [Monitorización de puntos de conexión de Amazon Comprehend](manage-endpoints-monitor.md)
+ [Actualización de puntos de conexión de Amazon Comprehend](manage-endpoints-update.md)
+ [Uso Trusted Advisor con Amazon Comprehend](manage-endpoints-trusted-advisor.md)
+ [Eliminación de puntos de conexión de Amazon Comprehend](manage-endpoints-delete.md)

**importante**  
El coste de la clasificación personalizada en tiempo real se basa tanto en el rendimiento que se establezca como en el tiempo que el punto de conexión esté activo. Si usted ya no usa el punto de conexión o no lo usa durante un período prolongado, debe configurar una política de escalado automático para reducir sus costes. O, si ya no utiliza un punto de conexión, puede eliminarlo para evitar incurrir en costes adicionales. Para obtener más información, consulte [Escalado automático con puntos de conexión](comprehend-autoscaling.md).

# Uso de puntos de conexión de Amazon Comprehend
<a name="using-endpoints"></a>

Usted crea un punto de conexión para ejecutar un análisis en tiempo real mediante un modelo personalizado. Un punto de conexión incluye recursos gestionados que permiten que su modelo personalizado esté disponible para su inferencia en tiempo real. 

Amazon Comprehend asigna el rendimiento a un punto de conexión mediante *Unidades de inferencia* (UI). Una UI representa un rendimiento de datos de 100 caracteres por segundo. Puede aprovisionar el punto de conexión con hasta 10 unidades de inferencia. Puede aumentar o reducir el rendimiento del punto de conexión actualizando dicho punto de conexión. 

Si los documentos de entrada incluyen documentos semiestructurados o archivos de imagen, el rendimiento de 100 caracteres por segundo corresponde a los caracteres extraídos del archivo de entrada. El número de los IUs que aprovisione para un punto final depende de la densidad de caracteres de los documentos de entrada.

 Las respuestas [ClassifyDocument](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ClassifyDocument.html)y las de la [DetectEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectEntities.html)API incluyen el recuento de caracteres de cada página de entrada. Puede usar esta información para estimar el número de unidades de inferencia que debe aprovisionar para lograr el rendimiento deseado.

Una vez que haya completado el análisis en tiempo real, elimine el punto de conexión, ya que el coste se seguirá cobrando mientras esté activo. Puede crear otro punto de conexión cuando esté preparado para realizar más análisis en tiempo real.

Para obtener más información sobre el coste de los puntos de conexión, consulte los precios de [Amazon Comprehend.](https://aws.amazon.com/comprehend/pricing/)

Después de crear un punto final, puedes supervisarlo con Amazon CloudWatch, actualizarlo para cambiar sus unidades de inferencia o eliminarlo cuando ya no sea necesario. Para obtener más información, consulte [Monitorización de puntos de conexión de Amazon Comprehend](manage-endpoints-monitor.md).

# Monitorización de puntos de conexión de Amazon Comprehend
<a name="manage-endpoints-monitor"></a>

Puede ajustar el rendimiento de su punto final aumentando o disminuyendo el número de unidades de inferencia ()IUs. Para obtener más información sobre cómo actualizar su punto de conexión, consulte [Actualización de puntos de conexión de Amazon Comprehend](manage-endpoints-update.md).

Puede determinar la mejor manera de ajustar el rendimiento de su punto final supervisando su uso con la CloudWatch consola de Amazon.

**Supervise el uso de sus puntos finales con CloudWatch**

1. Inicie sesión en la [CloudWatch consola Consola de administración de AWS y ábrala](https://console.aws.amazon.com/cloudwatch/).

1. A la izquierda, seleccione **Métricas** y, a continuación, **Todas las métricas**.

1. En **Todas las métricas**, seleccione **Comprehend**.  
![\[Pantalla de consola de la página de métricas que muestra el panel Comprehend.\]](http://docs.aws.amazon.com/es_es/comprehend/latest/dg/images/cloudwatch-metrics1.png)

1. La CloudWatch consola muestra las dimensiones de las métricas de **Comprehend.** Elija la **EndpointArn**dimensión.   
![\[Pantalla de consola de la página de métricas de Amazon Comprehend que muestra la EndpointArndimensión.\]](http://docs.aws.amazon.com/es_es/comprehend/latest/dg/images/cloudwatch-metrics2.png)

   La consola muestra **ProvisionedInferenceUnits**RequestedInferenceUnits**ConsumedInferenceUnits******, y **InferenceUtilization**para cada uno de sus puntos de conexión.  
![\[CloudWatch consola que muestra las cuatro métricas.\]](http://docs.aws.amazon.com/es_es/comprehend/latest/dg/images/cloudwatch-metrics3.png)

   Seleccione las cuatro métricas y vaya a la pestaña **Métricas gráficas**.

1. **Defina las columnas de estadísticas para **RequestedInferenceUnits**y para **ConsumedInferenceUnits**Sumar.**

1. **Defina la columna de estadísticas como **InferenceUtilization**Suma.**

1. **Establezca la columna de estadísticas en Promedio **ProvisionedInferenceUnits**.**

1. Cambie la columna Período de todas las métricas a **1 minuto**.

1. Seleccione **InferenceUtilization**y seleccione la flecha para moverla a un **eje Y independiente.**

   El gráfico está listo para el análisis. 

     
![\[Pantalla de consola que muestra las métricas graficadas.\]](http://docs.aws.amazon.com/es_es/comprehend/latest/dg/images/graphed_metrics_endpoint.png)

Según las CloudWatch métricas, también puede configurar el escalado automático para ajustar automáticamente el rendimiento de su punto final. Para obtener más información acerca del uso del escalado automático con sus puntos de conexión, consulte [Escalado automático con puntos de conexión](comprehend-autoscaling.md). 


+ **ProvisionedInferenceUnits**- Esta métrica representa el número medio de aprovisionados IUs en el momento en que se realizó la solicitud. 
+  **RequestedInferenceUnits**- Se basa en el uso de cada solicitud enviada al servicio que se envió para su procesamiento. Esto puede resultar útil para comparar la solicitud enviada para ser procesada con la que realmente se procesó sin sufrir ningún tipo de limitación ()ConsumedInferenceUnits. El valor de esta métrica se calcula tomando el número de caracteres enviados para su procesamiento y dividiéndolo por el número de caracteres que se pueden procesar en un minuto para obtener 1 IU. 
+ **ConsumedInferenceUnits**- Esto se basa en el uso de cada solicitud enviada al servicio que se procesó correctamente (no se restringió). Esto puede resultar útil a la hora de comparar lo que se consume con lo aprovisionado. IUs El valor de esta métrica se calcula tomando el número de caracteres procesados y dividiéndolo por el número de caracteres que se pueden procesar en un minuto para 1 UI. 
+ **InferenceUtilization**- Se emite por solicitud. Este valor se calcula tomando el consumo IUs definido, dividiéndolo por él **ProvisionedInferenceUnits**y convirtiéndolo en **ConsumedInferenceUnits**un porcentaje de 100. 

**nota**  
 Todas las métricas se emiten solo para las solicitudes correctas. La métrica no aparecerá si proviene de una solicitud que está limitada o que ha fallado debido a un error interno del servidor o a un error del cliente. 

# Actualización de puntos de conexión de Amazon Comprehend
<a name="manage-endpoints-update"></a>

Con frecuencia, el nivel de rendimiento que necesita cambia después de crear un punto de conexión o cambia su primera estimación de sus necesidades. Cuando esto ocurre, puede que sea necesario actualizar el punto de conexión para aumentar o disminuir el rendimiento. El rendimiento depende del número de unidades de inferencia con las que haya aprovisionado su punto de conexión. Cada unidad de inferencia representa un rendimiento de 100 caracteres por segundo para un máximo de 2 documentos por segundo. Es posible que también desee actualizar la versión del modelo asociada al punto de conexión. Al editar un punto de conexión, puede elegir una versión diferente del modelo para el punto de conexión.

También puede resultar útil añadir etiquetas al punto de conexión para mantenerlo organizado. Esto también se puede hacer al actualizar el punto de conexión. Para obtener más información acerca de los puntos de conexión, consulte [Etiquetado de los recursos](tagging.md)

**Cómo actualizar un punto de conexión (consola)**

1. Inicie sesión en la consola Amazon Comprehend Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/comprehend/](https://console.aws.amazon.com/comprehend/)

1. En el menú de la izquierda, seleccione **Puntos de conexión**.

1. En la lista de **Clasificadores**, elija el nombre del modelo personalizado desde el que desea actualizar el punto de conexión y siga el enlace. Se muestra la página de detalles del modelo.

1. En la página de detalles del modelo, seleccione los detalles de la versión. Aparece la lista de puntos de conexión. 

1. Seleccione la casilla correspondiente a su punto de conexión. En la parte superior derecha de la tabla de puntos de conexión, seleccione el icono **Acciones**.

1. Elija **Edit (Edición de)**. Puede actualizar las etiquetas aprovisionadas IUs y editarlas. 

1. Guarde los cambios.

1. Para editar el número de unidades de inferencia con las que se aprovisiona el punto de conexión, seleccione **Editar**.

1. Introduzca el número actualizado de unidades de inferencia que se van a asignar al punto de conexión. Cada unidad representa un rendimiento de 100 caracteres por segundo. Puede asignar hasta un máximo de 10 unidades de inferencia por punto de conexión. 
**nota**  
El coste de usar un punto de conexión se basa en la cantidad de tiempo de operación y el rendimiento (en función del número de unidades de inferencia). Aumentar el número de unidades de inferencia aumentará el costo de operación. Para obtener más información, consulte [Precios de Amazon Comprehend](https://aws.amazon.com/comprehend/pricing).

1. Seleccione **Editar punto de conexión**. Se muestra la página de detalles del punto de conexión. 

1. Confirme que el punto de conexión se está actualizando mediante la elección del nombre del modelo en la ruta de navegación en la parte superior de la página. En la página de detalles del modelo personalizado, navegue hasta la lista de **Puntos de conexión** y compruebe que aparece **Actualización** junto al punto de conexión. Cuando se complete la actualización, aparecerá **Listo**.

   El siguiente ejemplo demuestra el uso de la *UpdateEndpoint*operación con la AWS CLI. 

   El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\$1) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

   ```
   aws comprehend update-endpoint \
       --desired-inference-units updated number of inference units \
       --desired-model-arn arn:aws:comprehend:region:account-id:model type/model name \
       --desired-data-access-role-arn arn:aws:iam:account id:role/role name
       --endpoint-arn arn:aws:comprehend:region:account id:endpoint/endpoint name
   ```

   Si la acción se realiza correctamente, Amazon Comprehend responde con una respuesta HTTP 200 con un cuerpo HTTP vacío.

1. Para editar el modelo personalizado adjunto a su punto de conexión, desde la página de detalles del modelo personalizado, vaya a la lista de **Puntos de conexión**.

1. Seleccione el punto de conexión que desee cambiar y seleccione **Editar**.

1. En la página de configuración del punto de conexión, en **Seleccionar el modelo de clasificador** o **Seleccionar el modelo de reconocedor** en función del dispositivo de punto de conexión, puede buscar un modelo en el menú desplegable. Seleccione el modelo que desee.

1. En **Seleccionar versión**, puede buscar la versión del modelo que desee. Seleccione la versión.

1. Seleccione **Editar punto de conexión** para guardarla. 

# Uso Trusted Advisor con Amazon Comprehend
<a name="manage-endpoints-trusted-advisor"></a>

AWS Trusted Advisor es una herramienta en línea que proporciona recomendaciones para ayudarlo a aprovisionar sus recursos siguiendo las AWS mejores prácticas.

Si tienes un plan Basic o Developer Support, puedes usar la Trusted Advisor consola para acceder a todas las comprobaciones de la categoría Límites de servicio y a seis comprobaciones de la categoría Seguridad. Si tiene un plan de soporte empresarial o empresarial, puede usar la Trusted Advisor consola y la [AWS Support API](https://docs.aws.amazon.com/awssupport/latest/user/Welcome.html) para acceder a todas las Trusted Advisor comprobaciones.

Amazon Comprehend admite las siguientes Trusted Advisor comprobaciones para ayudar a los clientes a optimizar el coste y la seguridad de sus puntos de conexión de Amazon Comprehend mediante recomendaciones prácticas.

## Puntos de conexión infrautilizados de Amazon Comprehend
<a name="manage-endpoints-trusted-advisor-underutilized-endpoints"></a>

La verificación de **puntos de conexión infrautilizados de Amazon Comprehend** evalúa la configuración de rendimiento de los puntos de conexión. Esta verificación le avisa cuando los puntos de conexión no se utilizan activamente para solicitudes de inferencia en tiempo real. Un punto de conexión que no se utiliza durante más de 15 días se considera infrautilizado. Todos los puntos de conexión acumulan cargos en función del conjunto de rendimiento y del tiempo durante el cual el punto de conexión está activo. Para un punto de conexión que no se haya utilizado en los últimos 15 días, le recomendamos que defina una política de escalado para el recurso mediante [Aplicación de escalado automático](https://docs.aws.amazon.com/autoscaling/application/userguide/what-is-application-auto-scaling.html) Para un punto de conexión que no se haya utilizado en los últimos 30 días y que tenga definida una política de escalado automático, le recomendamos que utilice la inferencia asíncrona o que la elimine. Los resultados de estas comprobaciones se actualizan automáticamente una vez al día y se pueden ver en la categoría de la **CostOptimization**consola. Trusted Advisor 

**Cómo ver el estado de utilización de todos sus puntos de conexión y las recomendaciones correspondientes**

1. Inicie sesión en la Trusted Advisor consola Consola de administración de AWS y ábrala.

1. En el panel de navegación, selecciona la categoría de **CostOptimization**verificación.

1. En la página de la categoría, puede ver el resumen de cada categoría de verificación:
   + **Acción recomendada (rojo)**: Trusted Advisor recomienda una acción para la comprobación.
   + **Investigación recomendada (amarillo)**: Trusted Advisor detecta un posible problema para la verificación.
   + **No se detectó ningún problema (verde)**: Trusted Advisor no detecta ningún problema en la comprobación.
   + **Elementos excluidos (gris)**: el número de verificaciones que tienen elementos excluidos, como los recursos que desea que omita una verificación.

1. Seleccione **Verificación de puntos de conexión infrautilizados de Amazon Comprehend** para ver la descripción de la verificación y los siguientes detalles:
   + **Criterios de alerta**: describe el umbral en el que una verificación cambiará de estado.
   + **Acción recomendada**: describe las acciones recomendadas para esta verificación.
   + **Tabla de recursos:** una tabla en la que se muestran los detalles de sus puntos de conexión y el estado de cada uno de ellos en función de sus recomendaciones.

1. En la Tabla de recursos, si un punto de conexión aparece marcado con la advertencia “**Se recomienda investigar** porque **no se ha utilizado en los últimos 30 días**”, puede ir a la página de detalles del punto de conexión en la consola de Amazon Comprehend.
   + Si ya no desea utilizar este punto de conexión, seleccione **Eliminar**.
   + Vuelva a elegir **Eliminar** para confirmar la eliminación. Se mostrará la página de detalles del modelo personalizado. Confirme que el punto de conexión que ha eliminado muestra **Eliminando** junto a él. Cuando se haya eliminado, el punto de conexión se suprimirá de la lista de **Puntos de conexión**. 

1. En la tabla de recursos de la Trusted Advisor consola, si un endpoint está marcado con el estado **Investigation Recommended** porque no se ha utilizado en los últimos 15 días, y si está AutoScaling deshabilitado, puede ir a la página de detalles del punto final de la consola Amazon Comprehend para ajustar el punto final.
   + Si desea reducir el rendimiento configurado para este punto de conexión, haga clic en **Editar**. Introduzca el número actualizado de unidades de inferencia para asignarlas al punto de conexión, seleccione la casilla de verificación para confirmarlo y, a continuación, seleccione **Editar punto de conexión.** Cuando se complete la actualización, el estado aparecerá como **Listo**. 
   + Si desea configurar automáticamente el aprovisionamiento de puntos de conexión en su punto de conexión en lugar de ajustar manualmente la configuración de rendimiento, le recomendamos que utilice el escalado automático de **Aplicación de escalado automático**.

1. En la tabla de recursos de la Trusted Advisor consola, si un punto final está marcado con el estado No se ha **detectado ningún problema** debido al motivo Se **utiliza activamente**, significa que el punto final se está utilizando activamente para ejecutar solicitudes de inferencia en tiempo real y no se recomienda ninguna acción.

Este es un ejemplo que muestra la vista de CostOptimization categorías en la Trusted Advisor consola:

![\[Ejemplo de resultado de las comprobaciones de optimización de costes.\]](http://docs.aws.amazon.com/es_es/comprehend/latest/dg/images/TA_cost_optimization_new.png)


## Riesgo de acceso a los puntos de conexión de Amazon Comprehend
<a name="manage-endpoints-trusted-advisor-endpoint-access-risk"></a>

La verificación de **riesgos de acceso a puntos de conexión de Amazon Comprehend** evalúa los permisos de clave AWS Key Management Service (AWS KMS) para un punto de conexión en el que el modelo subyacente se cifró mediante claves administradas por el cliente. Si la clave administrada por el cliente está desactivada, o si se ha modificado la política de clave para modificar los permisos permitidos para Amazon Comprehend, la disponibilidad del punto de conexión podría verse afectada. Si la clave estaba deshabilitada, le recomendamos habilitarla. Si la política de claves se ha modificado y usted desea seguir utilizando este punto de conexión, le recomendamos que actualice la política de claves. Los resultados de la verificación se actualizan automáticamente varias veces durante el día. Esta verificación se puede consultar en la categoría **Tolerancia a fallos** de la consola de Trusted Advisor .

**Para ver el estado AWS KMS clave de sus puntos de conexión de Amazon Comprehend**

1. Inicie sesión en la consola Consola de administración de AWS y ábrala. Trusted Advisor 

1. En el panel de navegación, selecciona la categoría de **FaultTolerance**verificación.

1. En la página de la categoría, puede ver el resumen de cada categoría de verificación:
   + **Acción recomendada (rojo)**: Trusted Advisor recomienda una acción para la comprobación.
   + **Investigación recomendada (amarillo)**: Trusted Advisor detecta un posible problema para la verificación.
   + **No se detectó ningún problema (verde)**: Trusted Advisor no detecta ningún problema en la comprobación.
   + **Elementos excluidos (gris)**: el número de verificaciones que tienen elementos excluidos, como los recursos que desea que se omita una verificación.

1. Elija la verificación de riesgos de acceso a puntos de conexión de Amazon Comprehend y podrá ver la descripción del control y los siguientes detalles:
   + **Criterios de alerta**: describe el umbral en el que una verificación cambiará de estado.
   + **Acción recomendada**: describe las acciones recomendadas para esta verificación.
   + **Tabla de recursos**: tabla en la que se enumeran los detalles de los puntos de conexión cifrados con KMS y el estado de cada uno de ellos, en función de si se recomiendan acciones o no.

1. En la tabla de recursos, si un terminal está marcado con el estado **Acción recomendada**, seleccione el enlace de la KeyId columna KMS y se le redirigirá a la página AWS KMS clave correspondiente.
   + Para habilitar una AWS KMS clave deshabilitada, elija **Acciones clave** y, a continuación, seleccione **Habilitar**.
   + Si el estado de la clave aparece como **Habilitado**, actualice la política de claves seleccionando **Cambiar a la vista de políticas** en la sección Política de claves. Edite el documento de política de claves para proporcionar los permisos necesarios a Amazon Comprehend y, a continuación, seleccione **Guardar cambios**. 

Este es un ejemplo de la vista por FaultTolerance categorías en la Trusted Advisor consola:

![\[Ejemplo de salida de las comprobaciones de tolerancia a fallos.\]](http://docs.aws.amazon.com/es_es/comprehend/latest/dg/images/TA_fault_tolerance_checks_new.png)


Estas comprobaciones y sus resultados también se pueden ver consultando la Trusted Advisor sección de la AWS Support API.

Para obtener más información sobre cómo configurar alarmas mediante CloudWatch, consulte: [Creación de Trusted Advisor alarmas mediante CloudWatch](https://docs.aws.amazon.com/awssupport/latest/user/cloudwatch-metrics-ta.html). Para ver un conjunto completo de comprobaciones de Trusted Advisor mejores prácticas, consulte: [lista de verificación de AWS Trusted Advisor mejores prácticas](https://aws.amazon.com/premiumsupport/technology/trusted-advisor/best-practice-checklist/).

# Eliminación de puntos de conexión de Amazon Comprehend
<a name="manage-endpoints-delete"></a>

Una vez que ya no necesite su punto de conexión, debe eliminarlo para dejar de incurrir en costes por él. Puede crear fácilmente otro punto de conexión siempre que lo necesite desde la sección **Puntos de conexión**.

**Cómo eliminar un punto de conexión (consola)**

1. Inicie sesión en la consola Amazon Comprehend Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/comprehend/](https://console.aws.amazon.com/comprehend/)

1. En el menú de la izquierda, seleccione **Puntos de conexión**.

1. En la **Tabla de puntos de conexión**, busque el punto de conexión que desea eliminar. Puede buscar o filtrar todos los puntos de conexión para encontrar el que necesita. 

1. Seleccione la casilla de verificación de punto de conexión correspondiente al punto de conexión que desea eliminar. En la parte superior derecha de la tabla de puntos de conexión, seleccione el icono **Acciones**.

1. Elija **Eliminar**.

1. Vuelva a elegir **Eliminar** para confirmar la eliminación. Se muestra la página de detalles del punto de conexión. Confirme que el punto de conexión que ha eliminado muestra **Eliminando** junto a él. Cuando se elimina, el punto de conexión se elimina de la lista de **Puntos de conexión**.





**Cómo eliminar un punto de conexión (AWS CLI)**

El siguiente ejemplo demuestra el uso de la *DeleteEndpoint*operación con la AWS CLI. 

El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\$1) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

```
aws comprehend delete-endpoint \
    --endpoint-arn arn:aws:comprehend:region:account-id endpoint/endpoint name
```

Si la acción se realiza correctamente, Amazon Comprehend responde con una respuesta HTTP 200 con un cuerpo HTTP vacío.

# Escalado automático con puntos de conexión
<a name="comprehend-autoscaling"></a>

En lugar de ajustar manualmente la cantidad de unidades de inferencia aprovisionadas para los puntos de conexión de clasificación de documentos y los puntos de conexión del reconocedor de entidades, usted puede utilizar el escalado automático para configurar automáticamente el aprovisionamiento de puntos de conexión en función de sus necesidades de capacidad. 

Hay dos formas de utilizar el escalado automático para ajustar el número de unidades de inferencia aprovisionadas para el punto de conexión:
+ [Seguimiento de objetivos](targettracking.md): Configure el escalado automático para ajustar el aprovisionamiento de puntos de conexión a fin de adaptarlo a las necesidades de capacidad en función del uso. 
+ [Escalado programado](ScheduledScaling.md): Configure el escalado automático para ajustar el aprovisionamiento de puntos de conexión a fin de adaptarlo a las necesidades de capacidad en un cronograma específico.

Puede configurar el escalado automático solo con AWS Command Line Interface (AWS CLI). Para obtener más información sobre el escalado automático, consulte [¿Qué es la aplicación del escalado automático?](https://docs.aws.amazon.com/autoscaling/application/userguide/what-is-application-auto-scaling.html)

# Seguimiento de objetivos
<a name="targettracking"></a>

Con el seguimiento de destino, puede ajustar el aprovisionamiento de puntos de conexión para que se adapte a sus necesidades de capacidad en función del uso. El número de unidades de inferencia se ajusta automáticamente para que la capacidad utilizada esté dentro del porcentaje de destino de la capacidad aprovisionada. Puede utilizar el seguimiento de destino para adaptarse a los aumentos temporales de uso de los puntos de conexión de clasificación de documentos y los puntos de conexión del reconocedor de entidades. Para obtener más información, consulte [Políticas de escalado de seguimiento de destino para la aplicación del escalado automático](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html).

**nota**  
Los siguientes ejemplos tienen formato para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\$1) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

## Configuración del seguimiento de destino
<a name="setup-target-tracking"></a>

Para configurar el seguimiento de objetivos para un punto final, utilice los comandos AWS CLI para registrar un objetivo escalable y, a continuación, crear una política de escalado. El destino escalable define las unidades de inferencia como el recurso utilizado para ajustar el aprovisionamiento de puntos de conexión, y la política de escalado define las métricas que controlan el escalado automático de la capacidad aprovisionada. 

**Cómo establecer el seguimiento de destino**

1. Registrar un destino escalable. Los siguientes ejemplos registran un destino escalable para ajustar el aprovisionamiento de puntos de conexión con una capacidad mínima de 1 unidad de inferencia y una capacidad máxima de 2 unidades de inferencia.

   Para un punto final de clasificación de documentos, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling register-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
       --min-capacity 1 \
       --max-capacity 2
   ```

   Para un punto final de reconocimiento de entidades, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling register-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits \
       --min-capacity 1 \
       --max-capacity 2
   ```

1. Para verificar el registro del objetivo escalable, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling describe-scalable-targets \
       --service-namespace comprehend \
       --resource-id endpoint ARN
   ```

1. Cree una configuración de seguimiento de destino para la política de escalado y guarde la configuración en un archivo denominado `config.json`. El siguiente es un ejemplo de una configuración de seguimiento de objetivos para un punto final de clasificación de documentos que tiene como objetivo mantener la InferenceUtilization métrica al 70%.

   ```
   {
     "TargetValue": 70,
     "CustomizedMetricSpecification": {
       "MetricName": "InferenceUtilization",
       "Namespace": "MyNamespace",
       "Dimensions": [
         {
           "Name": "EndpointArn",
           "Value": "arn:aws:comprehend:region:account-id:document-classifier-endpoint/name"
         }
       ],
       "Statistic": "Sum",
       "Unit": "Percent"
     }
   }
   ```

   El siguiente es un ejemplo de un punto final de reconocimiento de entidades:

   ```
   {
     "TargetValue": 70,
     "CustomizedMetricSpecification": {
       "MetricName": "InferenceUtilization",
       "Namespace": "MyNamespace",
       "Dimensions": [
         {
           "Name": "EndpointArn",
           "Value": "arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name"
         }
       ],
       "Statistic": "Sum",
       "Unit": "Percent"
     }
   }
   ```

1. Cree una política de escalado. Los siguientes ejemplos crean una política de escalado basada en la configuración de seguimiento de destino definida en el archivo `config.json`. 

   Para un punto final de clasificación de documentos, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling put-scaling-policy \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
       --policy-name TestPolicy \
       --policy-type TargetTrackingScaling \
       --target-tracking-scaling-policy-configuration file://config.json
   ```

   Para un punto final de reconocimiento de entidades, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling put-scaling-policy \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits \
       --policy-name TestPolicy \
       --policy-type TargetTrackingScaling \
       --target-tracking-scaling-policy-configuration file://config.json
   ```

## Consideraciones
<a name="considerations"></a>

Las siguientes consideraciones se aplican al utilizar el seguimiento de objetivos con los puntos finales de Comprehend:
+ Las métricas de punto final se emiten solo cuando las solicitudes se realizan correctamente. Las métricas no aparecerán en el caso de las solicitudes que se hayan limitado o que hayan fallado debido a un error interno del servidor o a un error del cliente.
+ Si faltan puntos de datos, los estados de CloudWatch alarma de respaldo cambiarán a. `INSUFFICIENT_DATA ` Cuando esto ocurre, Application Auto Scaling no puede escalar su punto final.
+ Las matemáticas métricas pueden ser útiles para evitar esta limitación. Por ejemplo, para usar un valor de 0 cuando no se informa de ninguna métrica, utilice la `FILL(m1,0)` función where `m1` is the metric. Es importante probar la configuración para asegurarse de que se comporta como se espera. Consulte [Crear políticas de seguimiento de objetivos mediante matemáticas métricas](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking-metric-math.html) para ver más opciones.

## Eliminación del seguimiento de destino
<a name="remove-target-tracking"></a>

Para eliminar el seguimiento del destino de un punto final, utilice los comandos de la AWS CLI para eliminar la política de escalado y, a continuación, anular el registro del objetivo escalable.

**Cómo eliminar el seguimiento de destino**

1. Elimine la política de escalado. En los siguientes ejemplos se elimina la política de escalado especificada.

   Para un punto final de clasificación de documentos, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling delete-scaling-policy \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
       --policy-name TestPolicy \
   ```

   Para un punto final de reconocimiento de entidades, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling delete-scaling-policy \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits \
       --policy-name TestPolicy
   ```

1. Anule el registro del destino escalable. En los siguientes ejemplos se anula el registro de un destino escalable específico.

   Para un punto final de clasificación de documentos, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling deregister-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits
   ```

   Para un punto final de reconocimiento de entidades, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling deregister-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits
   ```

# Escalado programado
<a name="ScheduledScaling"></a>

Con el escalado programado, puede ajustar el aprovisionamiento de puntos de conexión para que se adapte a sus necesidades de capacidad según un cronograma específico. El escalado programado ajusta automáticamente el número de unidades de inferencia para adaptarse a los picos de uso en momentos específicos. Puede utilizar el escalado programado para los puntos de conexión de clasificación de documentos y los puntos de conexión del reconocedor de entidades. Para obtener más información sobre el uso del escalado programado, consulte [Escalado programado en la Guía del usuario de la aplicación del escalado automático](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-scheduled-scaling.html).

**nota**  
Los siguientes ejemplos tienen formato para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\$1) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

## Configuración del escalado programado
<a name="setup-scheduled-scaling"></a>

Para configurar el escalado programado para un punto final, utilice los comandos AWS CLI para registrar un objetivo escalable y, a continuación, crear una acción programada. El destino escalable define las unidades de inferencia como el recurso que se utiliza para ajustar el aprovisionamiento de puntos de conexión, y la acción programada controla el escalado automático de la capacidad aprovisionada en momentos específicos.

**Cómo configurar el escalado programado**

1. Registrar un destino escalable. Los siguientes ejemplos registran un destino escalable para ajustar el aprovisionamiento de puntos de conexión con una capacidad mínima de 1 unidad de inferencia y una capacidad máxima de 2 unidades de inferencia.

   Para un punto final de clasificación de documentos, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling register-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
       --min-capacity 1 \
       --max-capacity 2
   ```

   Para un punto final de reconocimiento de entidades, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling register-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits \
       --min-capacity 1 \
       --max-capacity 2
   ```

1. Cree una acción programada. Los siguientes ejemplos crean una acción programada para ajustar automáticamente la capacidad aprovisionada todos los días a las 12:00 UTC con un mínimo de 2 unidades de inferencia y un máximo de 5 unidades de inferencia. Para obtener más información sobre las expresiones cronológicas y el escalado programado, consulte [Programar expresiones.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html) 

   Para un punto final de clasificación de documentos, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling put-scheduled-action \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
       --scheduled-action-name TestScheduledAction \
       --schedule "cron(0 12 * * ? *)" \
       --scalable-target-action MinCapacity=2,MaxCapacity=5
   ```

   Para un punto final de reconocimiento de entidades, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling put-scheduled-action \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits \
       --scheduled-action-name TestScheduledAction \
       --schedule "cron(0 12 * * ? *)" \
       --scalable-target-action MinCapacity=2,MaxCapacity=5
   ```

## Eliminación del escalado programado
<a name="remove-scheduled-scaling"></a>

Para eliminar el escalado programado de un punto final, utilice los comandos AWS CLI para eliminar la acción programada y, a continuación, anular el registro del objetivo escalable.

**Cómo eliminar el escalado programado**

1. Elimine la acción programada. Los siguientes ejemplos eliminan una acción programada especificada.

   Para un punto final de clasificación de documentos, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling delete-scheduled-action \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits \
       --scheduled-action-name TestScheduledAction
   ```

   Para un punto final de reconocimiento de entidades, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling delete-scheduled-action \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits \
       --scheduled-action-name TestScheduledAction
   ```

1. Anule el registro del destino escalable. En los siguientes ejemplos se anula el registro de un destino escalable específico.

   Para un punto final de clasificación de documentos, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling deregister-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:document-classifier-endpoint/name \
       --scalable-dimension comprehend:document-classifier-endpoint:DesiredInferenceUnits
   ```

   Para un punto final de reconocimiento de entidades, utilice el siguiente comando AWS CLI:

   ```
   aws application-autoscaling deregister-scalable-target \
       --service-namespace comprehend \
       --resource-id arn:aws:comprehend:region:account-id:entity-recognizer-endpoint/name \
       --scalable-dimension comprehend:entity-recognizer-endpoint:DesiredInferenceUnits
   ```