サポート終了通知: 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 アカウントに関連付けられたパイプラインのリストを取得するには、`/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**
結果の 2 ページ目以降のページ (存在する場合) にアクセスするために使用する値。パイプラインが 1 ページに収まる場合、または結果の最後のページに達したとき、`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"
}
]
}
```