Descrizione Richieste Risposte Errori Esempi

Risparmia sui costi e ottieni più funzionalità con AWS Elemental MediaConvert

MediaConvert è un nuovo servizio di transcodifica video basato su file che offre una suite completa di funzionalità di transcodifica avanzate, con tariffe su richiesta a partire da 0,0075 USD/minuto. Leggi di più.

Usi già Amazon Elastic Transcoder? È semplice migrare verso. MediaConvert Per ulteriori informazioni, consulta questa panoramica che include informazioni preziose sul processo di migrazione e collegamenti a risorse aggiuntive.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creazione di una pipeline

Descrizione

Per creare una pipeline, inviare una richiesta POST alla risorsa /2012-09-25/pipelines/.

Richieste

Sintassi


POST /2012-09-25/pipelines 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
{
   "Name":"pipeline name",
   "InputBucket":"Amazon S3 bucket that contains files to transcode 
      and graphics to use as watermarks",
   "OutputBucket":"Use this, or use ContentConfig:Bucket plus 
      ThumbnailConfig:Bucket",
   "Role":"IAM role ARN",
   "AwsKmsKeyArn":"AWS-KMS key arn of the AWS-KMS key you want to 
      use with this 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 encounters a warning condition"
      "Error":"SNS topic to notify when
         Elastic Transcoder encounters an error condition"
   },
   "ContentConfig":{
      "Bucket":"Use this plus ThumbnailConfig:Bucket,
         or use OutputBucket",
      "Permissions":[
         {
            "GranteeType":"Canonical|Email|Group",
            "Grantee":"AWS user ID or CloudFront origin access identity"|
                      "registered email address for AWS account"|
                      AllUsers|AuthenticatedUsers|LogDelivery",
            "Access":[
               "Read|ReadAcp|WriteAcp|FullControl",
               ...
            ]
         },
         {...}
      ],
      "StorageClass":"Standard|ReducedRedundancy"
   },
   "ThumbnailConfig":{
      "Bucket":"Use this plus ContentConfig:Bucket,
         or use OutputBucket",
      "Permissions":[
         {
            "GranteeType":"Canonical|Email|Group",
            "Grantee":"AWS user ID or CloudFront origin access identity"|
                      "registered email address for AWS account"|
                      AllUsers|AuthenticatedUsers|LogDelivery",
            "Access":[
               "Read|ReadAcp|WriteAcp|FullControl",
               ...
            ]
         },
         {...}
      ],
      "StorageClass":"Standard|ReducedRedundancy"
   }
}

Parametri della richiesta

Questa operazione non utilizza parametri richiesta.

Intestazioni di richiesta

Questa operazione utilizza solo le intestazioni richiesta che sono comuni a tutte le operazioni. Per informazioni sulle intestazioni richiesta comuni, consulta Contenuti nell'intestazione HTTP.

Corpo della richiesta

La stringa JSON nel corpo della richiesta contiene gli oggetti di input per l'operazione CreatePipeline. Per ulteriori informazioni sugli oggetti di input, consulta Impostazioni da specificare quando si crea una pipeline di Elastic Transcoder.

Risposte

Sintassi


Status: 201 Created
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",
      "Name":"pipeline name",
      "InputBucket":"Amazon S3 bucket that contains files to transcode
         and graphics to use as watermarks",
      "OutputBucket":"Use this, or use ContentConfig:Bucket plus 
         ThumbnailConfig:Bucket",
      "Role":"IAM role ARN",
      "AwsKmsKeyArn":"AWS-KMS key arn of the AWS-KMS key you want to
            use with this 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 encounters a warning condition",
         "Error":"SNS topic to notify when
            Elastic Transcoder encounters an error condition"
      },
      "ContentConfig":{
         "Bucket":"Use this plus ThumbnailConfig:Bucket,
            or use OutputBucket",
         "Permissions":[
            {
               "GranteeType":"Canonical|Email|Group",
               "Grantee":"AWS user ID or CloudFront origin access identity"|
                         "registered email address for AWS account|
                         AllUsers|AuthenticatedUsers|LogDelivery",
               "Access":[
                  "Read|ReadAcp|WriteAcp|FullControl",
                  ...
               ]
            },
            {...}
         ],
         "StorageClass":"Standard|ReducedRedundancy"
      },
      "ThumbnailConfig":{
         "Bucket":"Use this plus ContentConfig:Bucket,
            or use OutputBucket",
         "Permissions":[
            {
               "Access":[
                  "Read|ReadAcp|WriteAcp|FullControl",
                  ...
               ],
               "Grantee":"AWS user ID or CloudFront origin access identity"|
                         "registered email address for AWS account|
                         AllUsers|AuthenticatedUsers|LogDelivery",
               "GranteeType":"Canonical|Email|Group"
            },
            {...}
         ],
         "StorageClass":"Standard|ReducedRedundancy"
      },
      "Status":"Active|Paused"
   },
   "Warnings (automatico)": [
      {
         "Code": "6000|6001|6002|6003|6004|6005|6006|6007|6008", 
         "Message": "The code message"
      },
      {...}
   ]
}

Intestazioni di risposta

Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta Risposte HTTP.

Corpo della risposta

Quando si crea una pipeline, Elastic Transcoder restituisce i valori specificati nella richiesta. Per ulteriori informazioni, consultare Corpo della richiesta.

Inoltre, Elastic Transcoder restituisce i seguenti valori.

IdId (automatico)

Identificatore per la pipeline. Questo valore viene utilizzato per identificare la pipeline in cui si desidera eseguire una serie di operazioni, ad esempio la creazione di un processo o di un preset.

Statatus (automatico)

Lo stato corrente della pipeline:

Active: La pipeline sta elaborando i lavori.
Paused: La pipeline non sta attualmente elaborando i processi.

Warnings (automatico)

Quando si crea una pipeline che utilizza risorse in altre regioni, Elastic Transcoder restituisce uno o più avvisi. La pipeline è ancora stata creata, ma potrebbe aver aumentato i tempi di elaborazione e comportare addebiti interregionali. Le avvertenze sono nel seguente formato:

Code— Il codice di avvertimento.: Messaggio— Il messaggio associato al codice di avviso.

Messaggi e codici di avviso possono essere restituiti come segue:

6000: Il bucket di input e la pipeline si trovano in diverse regioni, il che aumenta i tempi di elaborazione per i lavori nella pipeline e possono comportare costi aggiuntivi. Per ridurre i tempi di elaborazione e prevenire gli addebiti interregionali, utilizzare la stessa regione per il bucket di input e la pipeline.
6001: Il bucket ContentConfig e la pipeline si trovano in diverse regioni, il che aumenta i tempi di elaborazione per i lavori nella pipeline e possono comportare costi aggiuntivi. Per ridurre i tempi di elaborazione e prevenire addebiti interregionali, utilizzare la stessa regione per il bucket ContentConfig e la pipeline.
6002: Il bucket ThumbnailConfig e la pipeline si trovano in diverse regioni, il che aumenta i tempi di elaborazione per i lavori nella pipeline e possono comportare costi aggiuntivi. Per ridurre i tempi di elaborazione e prevenire addebiti interregionali, utilizzare la stessa regione per il bucket ThumbnailConfig e la pipeline.
6003: L'argomento di notifica SNS per gli eventi in corso e la pipeline si trovano in diverse regioni, il che aumenta i tempi di elaborazione per i processi nella pipeline e può comportare costi aggiuntivi. Per ridurre i tempi di elaborazione e prevenire addebiti interregionali, utilizzare la stessa area per l'argomento di notifica SNS e la pipeline.
6004: L'argomento di notifica SNS per gli eventi di avviso e la pipeline si trovano in diverse regioni, il che aumenta i tempi di elaborazione per i processi nella pipeline e può comportare costi aggiuntivi. Per ridurre i tempi di elaborazione e prevenire addebiti interregionali, utilizzare la stessa area per l'argomento di notifica SNS e la pipeline.
6005: L'argomento di notifica SNS per gli eventi di completamento e la pipeline si trovano in diverse regioni, il che aumenta i tempi di elaborazione per i processi nella pipeline e può comportare costi aggiuntivi. Per ridurre i tempi di elaborazione e prevenire addebiti interregionali, utilizzare la stessa area per l'argomento di notifica SNS e la pipeline.
6006: L'argomento di notifica SNS per gli eventi di errore e la pipeline si trovano in diverse regioni, il che aumenta i tempi di elaborazione per i processi nella pipeline e può comportare costi aggiuntivi. Per ridurre i tempi di elaborazione e prevenire addebiti interregionali, utilizzare la stessa area per l'argomento di notifica SNS e la pipeline.
6007: La chiave AWS KMS e il bucket ContentConfig specificati per questa pipeline si trovano in diverse regioni, il che causa il fallimento degli output che utilizzano la modalità di crittografia s3-aws-kms. Per utilizzare la modalità di crittografia s3-aws-kms, utilizzare la stessa regione per la chiave KMS e il bucket ContentConfig.
6008: La chiave AWS KMS e il bucket ThumbnailConfig specificati per questa pipeline si trovano in diverse regioni, il che causa il fallimento degli output che utilizzano la modalità di crittografia s3-aws-kms. Per utilizzare la modalità di crittografia s3-aws-kms, utilizzare la stessa regione per la chiave KMS e il bucket ThumbnailConfig.

Errori

Per informazioni sulle eccezioni e i messaggi di errore di Elastic Transcoder, consultaGestione degli errori in Elastic Transcoder.

Esempi

La richiesta di esempio seguente crea una pipeline denominata Default.

Richiesta di esempio


POST /2012-09-25/pipelines 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
{  
   "Name":"Default",
   "InputBucket":"salesoffice.example.com-source",
   "Role":"arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role",
   "AwsKmsKeyArn":"base64-encoded key from KMS",
   "Notifications":{
      "Progressing":"",
      "Complete":"",
      "Warning":"",
      "Error":"arn:aws:sns:us-east-1:111222333444:ET_Errors"
   },
   "ContentConfig":{
      "Bucket":"salesoffice.example.com-public-promos",
      "Permissions":[
         {
            "GranteeType":"Email",
            "Grantee":"marketing-promos@example.com",
            "Access":[
               "FullControl"
            ]
         }
      ],
      "StorageClass":"Standard"
   },
   "ThumbnailConfig":{
      "Bucket":"salesoffice.example.com-public-promos-thumbnails",
      "Permissions":[
         {
            "GranteeType":"Email",
            "Grantee":"marketing-promos@example.com",
            "Access":[
               "FullControl"
            ]
         }
      ],
      "StorageClass":"ReducedRedundancy"
   }
}

Risposta di esempio


Status: 201 Created
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":"1111111111111-abcde1",
     "Name":"Default",
     "InputBucket":"salesoffice.example.com-source",
     "Role":"arn:aws:iam::123456789012:role/Elastic_Transcoder_Default_Role",
     "AwsKmsKeyArn":"base64-encoded key from KMS",
     "Notifications":{
         "Complete":"",
         "Error":"arn:aws:sns:us-east-1:111222333444:ET_Errors",
         "Progressing":"",
         "Warning":""
      },
      "ContentConfig":{
         "Bucket":"salesoffice.example.com-public-promos",
         "Permissions":[
            {
               "GranteeType":"Email",
               "Grantee":"marketing-promos@example.com",
               "Access":[
                  "FullControl"
               ]
            }
         ],
         "StorageClass":"Standard"
      },
      "ThumbnailConfig":{
         "Bucket":"salesoffice.example.com-public-promos-thumbnails",
         "Permissions":[
            {
               "GranteeType":"Email",
               "Grantee":"marketing-promos@example.com",
               "Access":[
                  "FullControl"
               ]
            }
         ],
         "StorageClass":"ReducedRedundancy"
      },
      "Status":"Active"
   },
   "Warnings": [
      {
         "Code": "6000", 
         "Message": "The input bucket and the pipeline are in different 
            regions, which increases processing time for jobs in the 
            pipeline and can incur additional charges. To decrease 
            processing time and prevent cross-regional charges, use the 
            same region for the input bucket and the pipeline."
      },
      {...}
   ]
}

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Operazioni relative alle pipeline

Elenco delle pipeline