지원 종료 공지: 2025년 11월 13일에 AWS 는 Amazon Elastic Transcoder에 대한 지원을 중단합니다. 2025년 11월 13일 이후에는 더 이상 Elastic Transcoder 콘솔 또는 Elastic Transcoder 리소스에 액세스할 수 없습니다.
로 전환하는 방법에 대한 자세한 내용은이 [블로그 게시물](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/)을 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는 모든 파이프라인을 반환합니다.
**Ascending**
파이프라인을 제출 날짜 및 시간순으로 나열하려면 `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"
}
]
}
```