節省成本並獲得更多功能 AWS Elemental MediaConvert
MediaConvert 是一項較新的檔案型視訊轉碼服務,提供全方位的進階轉碼功能,按需費率從每分鐘 $0.0075 起。閱讀更多
已經使用 Amazon Elastic Transcoder? 遷移到 MediaConvert. 如需詳細資訊,請參閱此概觀
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
列出管道
Description (描述)
欲取得與目前 AWS 帳戶相關聯的管道清單,請將 GET 請求傳送到 /2012-09-25/pipelines/
資源。
請求
Syntax (語法)
欲取得與目前 AWS 帳戶相關聯的所有管道資訊,請傳送下列 GET 請求。
GET /2012-09-25/pipelines/Ascending=true|false& PageToken=
value for accessing the next page of results
HTTP/1.1 Content-Type: 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
請求參數
此操作接受下列請求參數。Elastic Transcoder 會回傳所有管道。
- 升高
-
若要依照所提交的日期及時間依序列出管道,請輸入
true
。若要依照相反的時間順序列出管道,請輸入false
。 - 頁面令牌
-
當 Elastic Transcoder 會回傳多個結果頁面時,使用
PageToken
在後續GET
請求來取得每次的連續結果頁面。
請求標頭
此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊,請參閱 HTTP 標頭內容。
請求主體
此操作沒有請求內文。
回應
Syntax (語法)
Status: 200 OK 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 { "Pipelines":[ { "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":[ { "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" }, {...} ], "NextPageToken":value for accessing the next page of results
|null }
回應標頭
此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊,請參閱 HTTP 回應。
回應內文
回應文本內的 JSON 字串會回傳您建立管道時指定的值。如需個別物件的詳細資訊,請參閱您在建立 Elastic Transcoder 管道時指定的設定。
此外,Elastic Transcoder 會回傳下列值。
- (自動) Id
-
管道的標識符。使用此值可標識要在其中執行各種操作(例如創建作業或預設)的管道。
- (自動) Status
-
管道目前的狀態:
Active
:管道正在處理作業。Paused
:管道當前未處理作業。
- (自動) NextPageToken
-
用於訪問結果的第二頁和後續頁面(如果有)的值。當管線適合一頁或到達結果的最後一頁時,
NextPageToken
是null
。
錯誤
如需 Elastic Transcoder 例外和錯誤訊息的詳細資訊,請參處理 Elastic Transcoder 中的錯誤。
範例
下列範例請求會取得與目前 AWS 帳戶相關的管道清單。
請求範例
GET /2012-09-25/pipelines HTTP/1.1 Content-Type: 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
回應範例
Status: 200 OK 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 { "Pipelines":[ { "Id":"1111111111111-abcde1", "Name":"Tokyo-Default", "InputBucket":"salesoffice-tokyo.example.com-source", "OutputBucket":"salesoffice-tokyo.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:ETS_Errors" }, "ContentConfig":{ "Bucket":"salesoffice-tokyo.example.com-public-promos", "Permissions":[ { "GranteeType":"Email", "Grantee":"marketing-promos-tokyo@example.com", "Access":[ "FullControl" ] } ], "StorageClass":"Standard" }, "ThumbnailConfig":{ "Bucket":"salesoffice-tokyo.example.com-public-promos- thumbnails", "Permissions":[ { "GranteeType":"Email", "Grantee":"marketing-promos-tokyo@example.com", "Access":[ "FullControl" ] } ], "StorageClass":"ReducedRedundancy" }, "Status":"Active" }, { "Id":"2222222222222-abcde2", "Name":"Amsterdam-Default", "InputBucket":"salesoffice-amsterdam.example.com-source", "OutputBucket":"salesoffice-amsterdam.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:ETS_Errors" }, "ContentConfig":{ "Bucket":"salesoffice-amsterdam.example.com-public-promos", "Permissions":[ { "GranteeType":"Email", "Grantee":"marketing-promos-amsterdam@example.com", "Access":[ "FullControl" ] } ], "StorageClass":"Standard" }, "ThumbnailConfig":{ "Bucket":"salesoffice-amsterdam.example.com-public-promos- thumbnails", "Permissions":[ { "GranteeType":"Email", "Grantee":"marketing-promos-amsterdam@example.com", "Access":[ "FullControl" ] } ], "StorageClass":"ReducedRedundancy" }, "Status":"Active" } ] }