

Pemberitahuan akhir dukungan: Pada 13 November 2025, AWS akan menghentikan dukungan untuk Amazon Elastic Transcoder. Setelah 13 November 2025, Anda tidak akan lagi dapat mengakses konsol Elastic Transcoder atau sumber daya Elastic Transcoder.

Untuk informasi lebih lanjut tentang transisi ke AWS Elemental MediaConvert, kunjungi [posting blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/) ini.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Baca Pipeline
<a name="get-pipeline"></a>

**Topics**
+ [Deskripsi](#get-pipeline-description)
+ [Permintaan](#get-pipeline-requests)
+ [Respons](#get-pipeline-responses)
+ [Kesalahan](#get-pipeline-response-errors)
+ [Contoh](#get-pipeline-examples)

## Deskripsi
<a name="get-pipeline-description"></a>

Untuk mendapatkan informasi terperinci tentang pipa, kirim permintaan GET ke `/2012-09-25/pipelines/pipelineId` sumber daya.

## Permintaan
<a name="get-pipeline-requests"></a>

### Sintaks
<a name="get-pipeline-request-syntax"></a>

```
GET /2012-09-25/pipelines/pipelineId 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
```

### Parameter Permintaan
<a name="get-pipeline-request-parameters"></a>

Operasi ini mengambil parameter permintaan berikut. 

**PipelineID**  
Pengidentifikasi pipa yang ingin Anda dapatkan informasi detailnya. 

### Header Permintaan
<a name="get-pipeline-request-headers"></a>

Operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header permintaan umum, lihat [Konten Header HTTP](making-http-requests.md#http-request-header).

### Isi Permintaan
<a name="get-pipeline-request-body"></a>

Operasi ini tidak memiliki isi permintaan.

## Respons
<a name="get-pipeline-responses"></a>

### Sintaks
<a name="get-pipeline-response-syntax"></a>

```
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

{
   "Pipeline":{
      "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"
   },
   "(Otomatis) Peringatan": [
      {
         "Code": "6000|6001|6002|6003|6004|6005|6006|6007|6008",
         "Message": "The code message"
      },
      {...}
   ]
}
```

### Header Respons
<a name="get-pipeline-response-headers"></a>

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat [Tanggapan HTTP](making-http-requests.md#http-response-header).

### Isi Respons
<a name="get-pipeline-response-body"></a>

String JSON di badan respons mengembalikan nilai yang Anda tentukan saat Anda membuat pipeline. Untuk detail lebih lanjut tentang objek individu, lihat[Pengaturan yang Anda Tentukan Saat Membuat Pipa Transcoder Elastis](pipeline-settings.md).

Elastic Transcoder juga mencakup nilai dan peringatan berikut, jika berlaku:

**(Otomatis) Id**  
Pengidentifikasi untuk pipa. Anda menggunakan nilai ini untuk mengidentifikasi pipeline di mana Anda ingin melakukan berbagai operasi, misalnya, membuat pekerjaan atau preset. 

**Status (Otomatis)**  
Status pipa saat ini:  
+ `Active`: Pipa sedang memproses pekerjaan.
+ `Paused`: Pipa saat ini tidak memproses pekerjaan.

#### (Otomatis) Peringatan
<a name="get-pipeline-response-warnings"></a>

Saat Anda membuat pipeline yang menggunakan sumber daya di wilayah lain, Elastic Transcoder mengembalikan satu atau beberapa peringatan. Pipeline Anda masih dibuat, tetapi mungkin telah meningkatkan waktu pemrosesan dan menimbulkan biaya lintas wilayah. Peringatan dalam format berikut:

**Kode**  
**Pesan** — pesan yang terkait dengan kode peringatan.

Berikut ini adalah daftar kode peringatan yang valid dan pesannya:

**6000**  
Bucket input dan pipa berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipa dan dapat menimbulkan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah muatan lintas wilayah, gunakan wilayah yang sama untuk bucket input dan pipa. 

**6001**  
 ContentConfig Bucket dan pipa berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di dalam pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah muatan lintas wilayah, gunakan wilayah yang sama untuk ContentConfig ember dan pipa. 

**6002**  
 ThumbnailConfig Bucket dan pipa berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di dalam pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah muatan lintas wilayah, gunakan wilayah yang sama untuk ThumbnailConfig ember dan pipa. 

**6003**  
Topik notifikasi SNS untuk acara lanjutan dan saluran pipa berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di dalam pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas wilayah, gunakan wilayah yang sama untuk topik notifikasi SNS dan pipeline.

**6004**  
Topik notifikasi SNS untuk acara peringatan dan pipeline berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di dalam pipa dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas wilayah, gunakan wilayah yang sama untuk topik notifikasi SNS dan pipeline.

**6005**  
Topik notifikasi SNS untuk acara penyelesaian dan pipeline berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipeline dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas wilayah, gunakan wilayah yang sama untuk topik notifikasi SNS dan pipeline.

**6006**  
Topik notifikasi SNS untuk kejadian kesalahan dan pipeline berada di berbagai wilayah, yang meningkatkan waktu pemrosesan untuk pekerjaan di pipeline dan dapat dikenakan biaya tambahan. Untuk mengurangi waktu pemrosesan dan mencegah biaya lintas wilayah, gunakan wilayah yang sama untuk topik notifikasi SNS dan pipeline. 

**6007**  
Kunci AWS KMS dan ContentConfig bucket yang ditentukan untuk pipeline ini berada di berbagai wilayah, yang menyebabkan output menggunakan mode enkripsi s3-aws-kms gagal. Untuk menggunakan mode enkripsi s3-aws-kms, gunakan wilayah yang sama untuk kunci KMS dan bucket. ContentConfig 

**6008**  
Kunci AWS KMS dan ThumbnailConfig bucket yang ditentukan untuk pipeline ini berada di berbagai wilayah, yang menyebabkan output menggunakan mode enkripsi s3-aws-kms gagal. Untuk menggunakan mode enkripsi s3-aws-kms, gunakan wilayah yang sama untuk kunci KMS dan bucket. ThumbnailConfig 

## Kesalahan
<a name="get-pipeline-response-errors"></a>

Untuk informasi tentang pengecualian Elastic Transcoder dan pesan kesalahan, lihat. [Kesalahan Penanganan di Elastic Transcoder](error-handling.md)

## Contoh
<a name="get-pipeline-examples"></a>

Contoh permintaan berikut mendapatkan pipeline yang memiliki ID`1111111111111-abcde1`.

### Permintaan Sampel
<a name="get-pipeline-examples-sample-request"></a>

```
GET /2012-09-25/pipelines/1111111111111-abcde1 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
```

### Contoh Respons
<a name="get-pipeline-examples-sample-response"></a>

```
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

{
   "Pipeline":{
      "Id":"1111111111111-abcde1",
      "Name":"Default",
      "InputBucket":"salesoffice.example.com-source",
      "OutputBucket":"salesoffice.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:ET_Errors"
      },
      "ContentConfig":{
         "Bucket":"salesoffice.example.com-public-promos",
         "Permissions":[
            {
               "GranteeType":"Email",
               "Grantee":"marketing-promos@example.com",
               "Access":[
                  "FullControl"
               ]
            }
         ],
         "StorageClass":"Standard"
      },
      "ThumbnailConfig":{
         "Bucket":"salesoffice.example.com-public-promos-thumbnails",
         "Permissions":[
            {
               "GranteeType":"Email",
               "Grantee":"marketing-promos@example.com",
               "Access":[
                  "FullControl"
               ]
            }
         ],
         "StorageClass":"ReducedRedundancy"
      },
      "Status":"Active"
   },
   "Warnings": [
      {
         "Code": "6000",
         "Message": "The input bucket and the pipeline are in different 
            regions, which increases processing time for jobs in the 
            pipeline and can incur additional charges. To decrease 
            processing time and prevent cross-regional charges, use the 
            same region for the input bucket and the pipeline."
      },
      {...}
   ]
}
```