支援終止通知：2025 年 11 月 13 日， AWS 將停止對 Amazon 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 帳戶相關聯的管道清單，請將 GET 請求傳送到 `/2012-09-25/pipelines/` 資源。
## 請求
### 語法
欲取得與目前 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 字串會回傳您建立管道時指定的值。如需個別物件的詳細資訊，請參閱[您在建立彈性轉碼器管道時指定的設定](pipeline-settings.md)。
此外，Elastic Transcoder 會傳回下列值。
**（自動） ID**
管道的識別符。您可以使用此值來識別要在其中執行各種操作的管道，例如建立任務或預設集。
**（自動） 狀態**
管道的目前狀態：
+ `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"
}
]
}
```