Actualizar notificaciones de la canalización - Amazon Elastic Transcoder
DescripciónSolicitudesRespuestasErroresEjemplos

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.

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

Descripción

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

Sintaxis

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 solicitud

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

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.

Cuerpo de la solicitud

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 en la Guía para desarrolladores de Amazon Simple Notification Service.

importante

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.

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

Sintaxis

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

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.

Cuerpo de respuesta

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.

Errores

Para obtener información acerca de los mensajes de error y las excepciones en Elastic Transcoder, consulte Gestión de errores en Elastic Transcoder.

Ejemplos

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

Solicitud de muestra

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

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"
   }
}