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](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/) ini.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Perbarui Pipeline
**Topics**
+ [Deskripsi](#update-pipeline-description)
+ [Cara Memperbarui dan Menghapus Nilai](#update-pipeline-how-to)
+ [Permintaan](#update-pipeline-requests)
+ [Respons](#update-pipeline-responses)
+ [Kesalahan](#update-pipeline-response-errors)
+ [Contoh](#update-pipeline-examples)
## 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](making-http-requests.md#http-request-header).
### Isi Permintaan
String JSON di badan permintaan berisi objek input untuk `UpdatePipeline` operasi. Untuk informasi lebih lanjut tentang objek masukan, lihat[Pengaturan yang Anda Tentukan Saat Membuat Pipa Transcoder Elastis](pipeline-settings.md).
**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](making-http-requests.md#http-response-header).
### Isi Respons
Saat Anda membuat pipeline, Elastic Transcoder mengembalikan nilai yang Anda tentukan dalam permintaan. Untuk informasi selengkapnya, lihat [Isi Permintaan](#update-pipeline-request-body).
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](error-handling.md)
## Contoh
Contoh permintaan berikut memperbarui pipeline yang memiliki Id`1111111111111-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."
},
{...}
]
}
```