Aviso de fin de soporte: el 13 de noviembre de 2025, AWS dejaremos de ofrecer soporte a Amazon Elastic Transcoder. Después del 13 de noviembre de 2025, ya no podrás acceder a la consola de Elastic Transcoder ni a los recursos de Elastic Transcoder.

[Para obtener más información sobre la transición a AWS Elemental MediaConvert, visite esta entrada de blog.](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)

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.

# Actualizar notificaciones de la canalización
<a name="update-pipeline-notifications"></a>

**Topics**
+ [Descripción](#update-pipeline-notifications-description)
+ [Solicitudes](#update-pipeline-notifications-requests)
+ [Respuestas](#update-pipeline-notifications-responses)
+ [Errores](#update-pipeline-notifications-response-errors)
+ [Ejemplos](#update-pipeline-notifications-examples)

## Descripción
<a name="update-pipeline-notifications-description"></a>

A fin de actualizar solo las notificaciones de Amazon Simple Notification Service (Amazon SNS) para una canalización, envíe una solicitud POST al recurso `/2012-09-25/pipelines/pipelineId/notifications`.

**importante**  
Cuando realiza cambios en las notificaciones, estos surten efecto inmediatamente. Las tareas que ya ha enviado y que Elastic Transcoder no ha comenzado a procesar se ven afectadas además de las tareas que envíe después de cambiar las notificaciones.

## Solicitudes
<a name="update-pipeline-notifications-requests"></a>

### Sintaxis
<a name="update-pipeline-notifications-request-syntax"></a>

```
POST /2012-09-25/pipelines/pipelineId/notifications HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.Elastic Transcoder endpoint.amazonaws.com:443
x-amz-date: 20130114T174952Z
Authorization: AWS4-HMAC-SHA256 
               Credential=AccessKeyID/request-date/Elastic Transcoder endpoint/elastictranscoder/aws4_request,
               SignedHeaders=host;x-amz-date;x-amz-target,
               Signature=calculated-signature
Content-Length: number of characters in the JSON string
{
   "Id":"pipelineId",
   "Notifications":{
      "Progressing":"SNS topic to notify when
         Elastic Transcoder has started to process the job",
      "Complete":"SNS topic to notify when
         Elastic Transcoder has finished processing the job",
      "Warning":"SNS topic to notify when
      	Elastic Transcoder returns a warning",
      "Error":"SNS topic to notify when
         Elastic Transcoder returns an error"
   }
}
```

### Parámetros de la solicitud
<a name="update-pipeline-notifications-request-parameters"></a>

Esta operación toma el siguiente parámetro de solicitud. 

**pipelineId**  
Identificador de la canalización cuya configuración de la notificación desea cambiar. 

### Encabezados de solicitud
<a name="update-pipeline-notifications-request-headers"></a>

Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte [Contenido de los encabezados HTTP](making-http-requests.md#http-request-header).

### Cuerpo de la solicitud
<a name="update-pipeline-notifications-request-body"></a>

La cadena JSON del cuerpo de solicitud contiene los siguientes objetos. 

**Id**  
ID de la canalización que desea actualizar.

**Notifications:Progressing**  
El tema de Amazon Simple Notification Service (Amazon SNS) que desea notificar cuando Elastic Transcoder comience a procesar una tarea en esta canalización. Se trata del ARN que Amazon SNS devolvió cuando se creó el tema. Para obtener más información, consulte [Creación de un tema](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) en la *Guía para desarrolladores de Amazon Simple Notification Service*.  
Para recibir notificaciones, también debe suscribirse al nuevo tema en la consola de Amazon SNS.
Amazon SNS ofrece una variedad de opciones de notificación, incluida la posibilidad de enviar mensajes de Amazon SNS a las colas de Amazon Simple Queue Service. Para obtener más información, consulte la [Guía para desarrolladores de Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/).

**Notificaciones: Finalizadas**  
Se tema de ARN del tema de Amazon SNS que desee notificar cuando Elastic Transcoder termine de procesar una tarea en esta canalización. Se trata del ARN que Amazon SNS devolvió cuando se creó el tema. 

**Notifications:Warning**  
Se tema de ARN del tema de Amazon SNS que desee notificar cuando Elastic Transcoder encuentre una advertencia mientras procesa una tarea en esta canalización. Se trata del ARN que Amazon SNS devolvió cuando se creó el tema. 

**Notifications:Error**  
Se tema de ARN del tema de Amazon SNS que desee notificar cuando Elastic Transcoder encuentre un error mientras procesa una tarea en esta canalización. Se trata del ARN que Amazon SNS devolvió cuando se creó el tema. 

## Respuestas
<a name="update-pipeline-notifications-responses"></a>

### Sintaxis
<a name="update-pipeline-notifications-response-syntax"></a>

```
Status: 202 Accepted
x-amzn-RequestId: c321ec43-378e-11e2-8e4c-4d5b971203e9
Content-Type: application/json
Content-Length: number of characters in the response
Date: Mon, 14 Jan 2013 06:01:47 GMT
{
   "Pipeline":{
      "Id":"ID for the new pipeline",
      "Notifications":{
         "Progressing":"SNS topic to notify when Elastic Transcoder has started to process the job",
         "Complete":"SNS topic to notify when Elastic Transcoder has finished processing the job",
         "Warning":"SNS topic to notify when Elastic Transcoder returns a warning",
         "Error":"SNS topic to notify when Elastic Transcoder returns an error"
      }
   }
}
```

### Encabezados de respuesta
<a name="update-pipeline-notifications-response-headers"></a>

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte [Respuestas HTTP](making-http-requests.md#http-response-header).

### Cuerpo de respuesta
<a name="update-pipeline-notifications-response-body"></a>

Al actualizar las notificaciones para una canalización, Elastic Transcoder devuelve los valores que se especificaron en la solicitud. Para obtener más información, consulte [Cuerpo de la solicitud](#update-pipeline-notifications-request-body).

## Errores
<a name="update-pipeline-notifications-response-errors"></a>

Para obtener información acerca de los mensajes de error y las excepciones en Elastic Transcoder, consulte [Gestión de errores en Elastic Transcoder](error-handling.md).

## Ejemplos
<a name="update-pipeline-notifications-examples"></a>

La siguiente solicitud de ejemplo actualiza las notificaciones para una canalización.

### Solicitud de muestra
<a name="update-pipeline-notifications-examples-sample-request"></a>

```
POST /2012-09-25/pipelines/1111111111111-abcde1/notifications HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: */*
Host: elastictranscoder.Elastic Transcoder endpoint.amazonaws.com:443
x-amz-date: 20130114T174952Z
Authorization: AWS4-HMAC-SHA256 
               Credential=AccessKeyID/request-date/Elastic Transcoder endpoint/elastictranscoder/aws4_request,
               SignedHeaders=host;x-amz-date;x-amz-target,
               Signature=calculated-signature
Content-Length: number of characters in the JSON string
{
   "Id":"1111111111111-abcde1",
   "Notifications":{
      "Progressing":"",
      "Complete":"",
      "Warning":"",
      "Error":"arn:aws:sns:us-east-1:111222333444:ETS_Errors"
   }
}
```

### Respuesta de ejemplo
<a name="update-pipeline-notifications-examples-sample-response"></a>

```
Status: 202 Accepted
x-amzn-RequestId: c321ec43-378e-11e2-8e4c-4d5b971203e9
Content-Type: application/json
Content-Length: number of characters in the response
Date: Mon, 14 Jan 2013 06:01:47 GMT

{
   "Id":"1111111111111-abcde1",
   "Notifications":{
      "Progressing":"",
      "Complete":"",
      "Warning":"",
      "Error":"arn:aws:sns:us-east-1:111222333444:ETS_Errors"
   }
}
```