============
**错误响应**
============

描述
----

当调用接口失败时，NOS富媒体服务将返回错误码和详细错误信息，以帮助用户定位问题。返回格式支持"json"和"xml"，通过在header中配置"X-Nos-Entity-Type"即可。

格式
----

.. code:: xml
    :number-lines:
    
    <Error>
	<Code>${ErrorCode}</Code>
	<Message>${Message}</Message>
	<Resource>${resource}</Resource>
	<RequestId>${requestId}</RequestId>
    </Error>


元素说明
--------

.. list-table::
    :widths: 10 40
    :header-rows: 1

    * - 名称	
      - 描述
    * - Code
      - 富媒体服务返回给用户的错误码
    * - Message
      - 富媒体服务给出的详细错误信息
    * - Resource
      - 请求资源信息
    * - Resource
      - 用以标识错误请求的唯一UUID，在无法解决问题时候，可以使用此错误ID发送给图片处理服务的工程师去定位错误的原因
      
错误码
------

.. list-table::
    :widths: 10 10 40
    :header-rows: 1

    * - ErrorCode
      - Http Code	
      - Description
    * - NotAnImage
      - 400
      - 图片操作请求对象不是图片
    * - ImageFormatNotSupported
      - 400
      - 图片操作原图或type指定格式不支持
    * - VideoNotSupported
      - 415
      - 非法视频文件
    * - VideoParamInvalid
      - 400
      - 视频操作参数非法
    * - VideoInternalError
      - 500
      - 视频转码内部错误
    * - DirectRefusedRequest
      - 503
      - 目录繁忙（当前队列已满，插入队列失败）
    * - WaitRefusedRequest
      - 503
      - 当前任务队列中任务过多，从队列中取出时发现该任务等待处理已超时
    * - ProcessTimeOut
      - 503
      - 数据处理超时，常由文件过大引发
    * - InvalidArgument
      - 400
      - 参数非法
    * - InvalidChainOperator
      - 400
      - 链式处理非法，包括未指定操作，链式操作非法
    * - ReqPathTooLong
      - 400
      - 请求路径太长
    * - QueryStrTooLong
      - 400
      - queryStr太长（超过1024）
    * - NotAnObjectPath
      - 400
      - 请求路径非object路径
    * - OperatorForbid
      - 403
      - 操作不允许
    * - NotFound
      - 403
      - 请求资源不存在
    * - InternalError
      - 500
      - 内部错误
    * - UnsupportedMediaType
      - 415
      - 请求媒体文件格式不支持
    * - AudioNotSupported
      - 415
      - 不支持的音频格式
    * - AudioInternalError
      - 500
      - 音频转码内部错误
    * - AudioInvalidArgument
      - 400
      - 非法音频转码参数
    * - ServerBusy
      - 503
      - 系统繁忙
    * - RequestRangeNotSatisfiable
      - 416
      - 请求Range非法
    * - OtherError
      - 500
      - 其它错误
    * - BadRequest
      - 400
      - 请求错误
    * - NotModified
      - 304
      - NotModified
    * - LogoEdgeSizeOutOfLimit
      - 400
      - logo水印图片超出限制长度
    * - WEBPEdgeSizeOutOfLimit
      - 400
      - webp图片边长超出大小限制--webp图片类型支持的长宽不得超过16384
    * - InvalidPadColor
      - 400
      - pad颜色非法
    * - LogoNotAnImage
      - 400
      - logo水印图片不是图片
    * - LogoNotFound
      - 404
      - logo水印图片不存在
    * - UnSupportedLogoType
      - 400
      - 不支持的logo格式，如logo图片是gif
    * - ImageNotFound
      - 404
      - 图片未找到，主要为gif合成时，指定图片不存在
    * - GIFOptionInvalid
      - 400
      - gif合成参数文件非法