终止支持通知：2025 年 11 月 13 日， AWS 我们将停止对亚马逊 Elastic Transcoder 的支持。2025 年 11 月 13 日之后，您将无法再访问 Elastic Transcoder 控制台或 Elastic Transcoder 资源。
有关过渡到的更多信息 AWS Elemental MediaConvert，请访问此[博客文章](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 列出管道
**Topics**
+ [描述](#list-pipelines-description)
+ [请求](#list-pipelines-requests)
+ [响应](#list-pipelines-responses)
+ [错误](#list-pipelines-response-errors)
+ [示例](#list-pipelines-examples)
## 描述
要获取与当前 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 标头内容](making-http-requests.md#http-request-header)。
### 请求正文
此操作没有请求正文。
## 响应
### 语法
```
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 响应](making-http-requests.md#http-response-header)。
### 响应正文
响应正文中的 JSON 字符串将返回您在创建管道时指定的值。有关各个对象的更多信息，请参阅 [您在创建 Elastic Transcoder 管道时指定的设置](pipeline-settings.md)。
此外，Elastic Transcoder 将返回以下值。
**（自动）Id**
管道的标识符。您可以使用此值来标识要在其中执行各种操作的管道，例如创建任务或预设。
**（自动）Status**
管道的当前状态：
+ `Active`：管道正在处理任务。
+ `Paused`：管道当前未处理任务。
**（自动） NextPageToken**
用于访问第二页及后续结果页的值（如果有）。当管道适合放在一页上时，或当您已到达结果的最后一页时，`NextPageToken` 的值为 `null`。
## 错误
有关 Elastic Transcoder 异常和错误消息的信息，请参阅 [处理 Elastic Transcoder 中的错误](error-handling.md)。
## 示例
以下示例请求可获取与当前 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"
}
]
}
```