列出管道 - Amazon Elastic Transcoder

通过以下方式节省成本并获得更多功能 AWS Elemental MediaConvert

MediaConvert 是一项较新的基于文件的视频转码服务,它提供了一套全面的高级转码功能,按需费率起价为每分钟 0.0075 美元。阅读更多

已经在使用 Amazon Elastic Transcoder? 迁移到很简单 MediaConvert。有关更多信息,请参阅本概述,其中包含有关迁移过程的重要信息以及指向其他资源的链接。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

列出管道

描述

要获取与当前 AWS 账户关联的管道的列表,请向 /2012-09-25/pipelines/ 资源发送 GET 请求。

请求

语法

要获取与当前 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

PageToken

当 Elastic Transcoder 返回多个结果页面时,请使用后续 GET 请求中的 PageToken 获取每个连续的结果页面。

请求标头

此操作仅使用所有操作通用的请求标头。有关通用请求标头的信息,请参阅 HTTP 标头内容

请求正文

此操作没有请求正文。

响应

语法

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" } ] }