Perbarui Pipeline - Amazon Elastic Transcoder
DeskripsiCara Memperbarui dan Menghapus NilaiPermintaanResponsKesalahanContoh

Pemberitahuan akhir dukungan: Pada 13 November 2025, AWS akan menghentikan dukungan untuk Amazon Elastic Transcoder. Setelah 13 November 2025, Anda tidak akan lagi dapat mengakses konsol Elastic Transcoder atau sumber daya Elastic Transcoder.

Untuk informasi lebih lanjut tentang transisi ke AWS Elemental MediaConvert, kunjungi posting blog ini.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Perbarui Pipeline

Deskripsi

Untuk memperbarui pengaturan untuk pipeline, kirim permintaan PUT ke /2012-09-25/pipelines/ pipelineId sumber daya.

penting

Saat Anda mengubah pengaturan pipeline, perubahan Anda akan segera berlaku. Pekerjaan yang telah Anda kirimkan dan Elastic Transcoder belum mulai diproses akan terpengaruh selain pekerjaan yang Anda kirimkan setelah Anda mengubah pengaturan.

Cara Memperbarui dan Menghapus Nilai

Untuk memperbarui nilai, tentukan nilai baru, misalnya:

"GranteeType":"Canonical"

Agar nilai tidak berubah, lakukan salah satu hal berikut:

  • Tentukan nilai saat ini.

  • Tentukan nilai nol. Ini berlaku baik untuk objek individu (misalnya,"Role":null) dan untuk array (misalnya,"ContentConfig":null).

  • Hilangkan objek JSON dari permintaan. Ini berlaku baik untuk objek individu, misalnya,Role, dan untuk array, misalnya,ContentConfig.

Untuk menghapus nilai saat ini, tentukan nilai kosong. Misalnya, untuk menghapus pemberitahuan, tentukan string kosong:"Progressing":"". Untuk menghapus semua nilai dalam array, tentukan array kosong:"Permissions":[].

Misalnya, jika Anda tidak lagi ingin diberi tahu ketika Elastic Transcoder menemukan peringatan saat memproses pekerjaan, dan Anda tidak ingin mengubah pengaturan notifikasi lainnya, Anda akan menentukan yang berikut untuk dalam Notifications permintaan:

...
"Notifications":{
   "Warning":""
},
...

Permintaan

Sintaks

PUT /2012-09-25/pipelines/pipelineId 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",
   "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"
   },
   "Status":"Active|Paused"
}

Parameter Permintaan

Operasi ini tidak menggunakan parameter permintaan.

Header Permintaan

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat Konten Header HTTP.

Isi Permintaan

String JSON di badan permintaan berisi objek input untuk UpdatePipeline operasi. Untuk informasi lebih lanjut tentang objek masukan, lihatPengaturan yang Anda Tentukan Saat Membuat Pipa Transcoder Elastis.

Id

Pengidentifikasi untuk pipa. Anda menggunakan nilai ini untuk mengidentifikasi pipeline di mana Anda ingin melakukan berbagai operasi, misalnya, membuat pekerjaan atau preset.

Status

Status pipa saat ini:

  • Active: Pipa sedang memproses pekerjaan.

  • Paused: Pipa saat ini tidak memproses pekerjaan.

Respons

Sintaks

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":"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 id",
   "Notifications":{
      "Progressing":"SNS topic to notify when
         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
         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",
   "(Otomatis) Peringatan": [
      {
         "Code": "6000|6001|6002|6003|6004|6005|6006|6007|6008",
         "Message": "The code message"
      },
      {...}
   ]
}

Header Respons

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat Tanggapan HTTP.

Isi Respons

Saat Anda membuat pipeline, Elastic Transcoder mengembalikan nilai yang Anda tentukan dalam permintaan. Untuk informasi selengkapnya, lihat Isi Permintaan.

Elastic Transcoder juga mencakup peringatan berikut, jika berlaku:

(Otomatis) Peringatan

Saat Anda membuat pipeline yang menggunakan sumber daya di wilayah lain, Elastic Transcoder mengembalikan satu atau beberapa peringatan. Pipeline Anda masih dibuat, tetapi mungkin telah meningkatkan waktu pemrosesan dan menimbulkan biaya lintas wilayah. Peringatan dalam format berikut:

Kode

Pesan — pesan yang terkait dengan kode peringatan.

Berikut ini adalah daftar kode peringatan yang valid dan pesannya:

6000

Bucket input dan pipa berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipa dan dapat menimbulkan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah muatan lintas wilayah, gunakan wilayah yang sama untuk bucket input dan pipa.

6001

ContentConfig Bucket dan pipa berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di dalam pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah muatan lintas wilayah, gunakan wilayah yang sama untuk ContentConfig ember dan pipa.

6002

ThumbnailConfig Bucket dan pipa berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di dalam pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah muatan lintas wilayah, gunakan wilayah yang sama untuk ThumbnailConfig ember dan pipa.

6003

Topik notifikasi SNS untuk acara lanjutan dan saluran pipa berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di dalam pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas wilayah, gunakan wilayah yang sama untuk topik notifikasi SNS dan pipeline.

6004

Topik notifikasi SNS untuk acara peringatan dan pipeline berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di dalam pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas wilayah, gunakan wilayah yang sama untuk topik notifikasi SNS dan pipeline.

6005

Topik notifikasi SNS untuk acara penyelesaian dan pipeline berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipeline dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas wilayah, gunakan wilayah yang sama untuk topik notifikasi SNS dan pipeline.

6006

Topik notifikasi SNS untuk kejadian kesalahan dan pipeline berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipeline dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas wilayah, gunakan wilayah yang sama untuk topik notifikasi SNS dan pipeline.

6007

Kunci AWS KMS dan ContentConfig bucket yang ditentukan untuk pipeline ini berada di berbagai wilayah, yang menyebabkan output menggunakan mode enkripsi s3-aws-kms gagal. Untuk menggunakan mode enkripsi s3-aws-kms, gunakan wilayah yang sama untuk kunci KMS dan bucket. ContentConfig

6008

Kunci AWS KMS dan ThumbnailConfig bucket yang ditentukan untuk pipeline ini berada di berbagai wilayah, yang menyebabkan output menggunakan mode enkripsi s3-aws-kms gagal. Untuk menggunakan mode enkripsi s3-aws-kms, gunakan wilayah yang sama untuk kunci KMS dan bucket. ThumbnailConfig

Kesalahan

Untuk informasi tentang pengecualian Elastic Transcoder dan pesan kesalahan, lihat. Kesalahan Penanganan di Elastic Transcoder

Contoh

Contoh permintaan berikut memperbarui pipeline yang memiliki Id1111111111111-abcde1.

Permintaan Sampel

PUT /2012-09-25/pipelines/1111111111111-abcde1 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"
   "Name":"Default",
   "InputBucket":"salesoffice.example.com-source",
   "OutputBucket":"salesoffice.example.com-output",
   "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"
   },
   "Status":"Active"
}

Contoh Respons

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",
   "Name":"Default",
   "InputBucket":"salesoffice.example.com-source",
   "OutputBucket":"salesoffice.example.com-output",
   "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"
   },
   "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."
      },
      {...}
   ]
}