描述请求响应错误示例

通过以下方式节省成本并获得更多功能 AWS Elemental MediaConvert

MediaConvert 是一项较新的基于文件的视频转码服务，它提供了一套全面的高级转码功能，按需费率起价为每分钟 0.0075 美元。阅读更多。

已经在使用 Amazon Elastic Transcoder？迁移到很简单 MediaConvert。有关更多信息，请参阅本概述，其中包含有关迁移过程的重要信息以及指向其他资源的链接。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

读取管道

主题

描述
请求
响应
错误
示例

描述

要获取有关管道的详细信息，请向 /2012-09-25/pipelines/pipelineId 资源发送 GET 请求。

请求

语法


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

请求参数

此操作接受以下请求参数。

pipelineId: 要获取其详细信息的管道的标识符。

请求标头

此操作仅使用所有操作通用的请求标头。有关通用请求标头的信息，请参阅 HTTP 标头内容。

请求正文

此操作没有请求正文。

响应

语法


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"
   },
   "（自动）Warnings": [
      {
         "Code": "6000|6001|6002|6003|6004|6005|6006|6007|6008",
         "Message": "The code message"
      },
      {...}
   ]
}

响应标头

此操作仅使用大多数响应通用的响应标头。有关通用响应标头的信息，请参阅 HTTP 响应。

响应正文

响应正文中的 JSON 字符串将返回您在创建管道时指定的值。有关各个对象的更多信息，请参阅您在创建 Elastic Transcoder 管道时指定的设置。

Elastic Transcoder 还包括以下值和警告（如果适用）：

（自动）Id

管道的标识符。您可以使用此值来标识要在其中执行各种操作的管道，例如创建任务或预设。

（自动）Status

管道的当前状态：

Active：管道正在处理任务。
Paused：管道当前未处理任务。

（自动）Warnings

当您创建使用其他区域资源的管道时，Elastic Transcoder 会返回一个或多个警告。您的管道仍在创建中，但处理时间可能会增加并产生跨区域费用。警告的格式如下所示：

代码: 消息——与警告代码关联的消息。

以下列表给出有效的警告代码及其消息：

6000: 输入存储桶和管道位于不同的区域，这会增加管道中任务的处理时间，并可能产生额外费用。要缩短处理时间并防止跨区域收费，请为输入存储桶和管道使用相同的区域。
6001: ContentConfig 存储桶和管道位于不同的区域，这会增加管道中任务的处理时间，并可能产生额外费用。要缩短处理时间并防止跨区域收费，请为 ContentConfig 存储桶和管道使用相同的区域。
6002: ThumbnailConfig 存储桶和管道位于不同的区域，这会增加管道中任务的处理时间，并可能产生额外费用。要缩短处理时间并防止跨区域收费，请为 ThumbnailConfig 存储桶和管道使用相同的区域。
6003: 正在进行的事件和管道的 SNS 通知主题位于不同的区域，这会增加管道中任务的处理时间，并可能产生额外费用。要缩短处理时间并防止跨区域收费，请在 SNS 通知主题和渠道中使用相同的区域。
6004: 警告事件和管道的 SNS 通知主题位于不同的区域，这会增加管道中任务的处理时间，并可能产生额外费用。要缩短处理时间并防止跨区域收费，请在 SNS 通知主题和渠道中使用相同的区域。
6005: 完成事件和管道的 SNS 通知主题位于不同的区域，这会增加管道中任务的处理时间，并可能产生额外费用。要缩短处理时间并防止跨区域收费，请在 SNS 通知主题和渠道中使用相同的区域。
6006: 错误事件和管道的 SNS 通知主题位于不同的区域，这会增加管道中任务的处理时间，并可能产生额外费用。要缩短处理时间并防止跨区域收费，请在 SNS 通知主题和渠道中使用相同的区域。
6007: 为此管道指定的 AWS KMS 密钥和 ContentConfig 存储桶位于不同的区域，这会导致使用 s3-aws-kms 加密模式的输出失败。要使用 s3-aws-kms 加密模式，请对 KMS 密钥和 ContentConfig 存储桶使用相同的区域。
6008: 为此管道指定的 AWS KMS 密钥和 ThumbnailConfig 存储桶位于不同的区域，这会导致使用 s3-aws-kms 加密模式的输出失败。要使用 s3-aws-kms 加密模式，请对 KMS 密钥和 ThumbnailConfig 存储桶使用相同的区域。

错误

有关 Elastic Transcoder 异常和错误消息的信息，请参阅处理 Elastic Transcoder 中的错误。

示例

以下请求示例会获取 ID 为 1111111111111-abcde1 的管道。

示例请求


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

示例响应


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."
      },
      {...}
   ]
}

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

列出管道

更新管道