Hemat biaya dan dapatkan lebih banyak fitur dengan AWS Elemental MediaConvert
MediaConvert adalah layanan transcoding video berbasis file yang lebih baru yang menyediakan rangkaian lengkap fitur transcoding canggih, dengan tarif sesuai permintaan mulai dari $0,0075/menit. Baca lebih lanjut
Sudah menggunakan Amazon Elastic Transcoder? Sangat mudah untuk bermigrasi ke MediaConvert. Untuk informasi selengkapnya, lihat ikhtisar 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 alur, kirim permintaan PUT ke alur/2012-09-25/pipelines/
PipelineID
sumber daya.
penting
Ketika Anda mengubah pengaturan pipa, perubahan Anda akan segera berlaku. Pekerjaan yang telah Anda kirimkan dan Elastic Transcoder belum mulai diproses terpengaruh selain pekerjaan yang Anda kirimkan setelah Anda mengubah pengaturan.
Cara Memperbarui dan Menghapus Nilai
Untuk memperbarui nilai, tentukan nilai baru, misalnya:
"GranteeType":"Canonical"
Untuk meninggalkan nilai tidak berubah, lakukan salah satu hal berikut:
Tentukan nilai saat ini.
Tentukan nilai null. Hal ini berlaku baik untuk objek individu (misalnya,
"Role":null
) dan array (misalnya,"ContentConfig":null
).Menghilangkan objek JSON dari permintaan. Hal ini berlaku baik untuk objek individu, misalnya,
Role
, dan untuk array, misalnya,ContentConfig
.
Untuk menghapus nilai saat ini, tentukan nilai kosong. Misalnya, untuk menghapus notifikasi, tentukan string kosong: "Progressing":""
. Untuk menghapus semua nilai dalam array, tentukan array kosong:"Permissions":[]
.
Misalnya, jika Anda tidak lagi ingin diberi tahu saat Elastic Transcoder menemukan peringatan saat memproses pekerjaan, dan Anda tidak ingin mengubah pengaturan notifikasi lainnya, Anda akan menentukan yang berikut untukNotifications
dalam permintaan:
... "Notifications":{ "Warning":"" }, ...
Permintaan
Sintaksis
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 dalam isi permintaan berisi objek input untukUpdatePipeline
operasi. Untuk informasi lebih lanjut tentang objek input, lihatPengaturan yang Anda Berikan Saat Membuat Jalur Elastic Transcoder.
- Id
-
Identifier untuk alur. Anda menggunakan nilai ini untuk mengidentifikasi pipa di mana Anda ingin melakukan berbagai operasi, misalnya, membuat pekerjaan atau preset.
- Status
-
Status alur saat ini:
Active
: Pipa ini memproses pekerjaan.Paused
: Pipa saat ini tidak memproses pekerjaan.
Respons
Sintaksis
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 Respons HTTP.
Isi Respons
Ketika Anda membuat pipa, Elastic Transcoder mengembalikan nilai-nilai yang Anda tentukan dalam permintaan. Untuk informasi selengkapnya, lihat Isi Permintaan.
Elastic Transcoder juga mencakup peringatan berikut, jika berlaku:
(Otomatis) Peringatan
Bila Anda membuat pipa yang menggunakan sumber daya di wilayah lain, Elastic Transcoder mengembalikan satu atau lebih peringatan. Pipa Anda masih dibuat, tetapi mungkin telah meningkatkan waktu pemrosesan dan dikenakan biaya lintas daerah. Peringatan dalam format berikut:
- Kode
-
Pesan— pesan yang terkait dengan kode peringatan.
Berikut ini adalah daftar kode peringatan yang valid dan pesan mereka:
- 6000
-
Ember input dan pipa berada di berbagai daerah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas daerah, gunakan wilayah yang sama untuk ember input dan pipa.
- 6001
-
Ember ContentConfig dan pipa berada di berbagai daerah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas daerah, gunakan wilayah yang sama untuk bucket ContentConfig dan pipa.
- 6002
-
Bucket ThumbnailConfig dan pipa berada di berbagai daerah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas daerah, gunakan wilayah yang sama untuk bucket ThumbnailConfig dan pipa.
- 6003
-
Topik pemberitahuan SNS untuk acara maju dan pipa berada di berbagai daerah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas daerah, gunakan wilayah yang sama untuk topik pemberitahuan SNS dan pipa.
- 6004
-
Topik pemberitahuan SNS untuk acara peringatan dan pipa berada di berbagai daerah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas daerah, gunakan wilayah yang sama untuk topik pemberitahuan SNS dan pipa.
- 6005
-
Topik pemberitahuan SNS untuk peristiwa penyelesaian dan pipa berada di berbagai daerah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas daerah, gunakan wilayah yang sama untuk topik pemberitahuan SNS dan pipa.
- 6006
-
Topik pemberitahuan SNS untuk kejadian kesalahan dan pipa berada di berbagai daerah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas daerah, gunakan wilayah yang sama untuk topik pemberitahuan SNS dan pipa.
- 6007
-
Kunci AWS KMS dan bucket ContentConfig 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 bucket ThumbnailConfig 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 tombol KMS dan bucket ThumbnailConfig.
Kesalahan
Untuk informasi tentang pengecualian dan pesan kesalahan Elastic Transcoder, lihatPenanganan Kesalahan di Elastic Transcoder.
Contoh
Contoh berikut permintaan update pipa yang memiliki Id1111111111111-abcde1
.
Sampel Permintaan
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." }, {...} ] }