文档首页/ 云数据库 RDS/ API参考/ API v3(推荐)/ 获取日志信息/ 获取错误日志下载链接(PostgreSQL)
更新时间:2024-11-01 GMT+08:00

获取错误日志下载链接(PostgreSQL)

功能介绍

获取错误日志下载链接。

需要低频重复调用,直到status返回FINISH,就可以获取下载链接。

或者取第一次调用返回的workflow_id,去查询任务状态,成功后再次调用此接口即可获取下载链接。

接口约束

目前,该接口仅支持获取正常状态实例的错误日志下载链接。

URI

  • URI格式

    POST /v3/{project_id}/instances/{instance_id}/errorlog-download

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    参数解释

    租户在某一Region下的项目ID。

    获取方法请参见获取项目ID

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    instance_id

    参数解释

    要查询的实例ID。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

请求消息

  • 参数说明

  • URI样例

    POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/3d39c18788b54a919bab633874c159dfin01/errorlog-download

响应消息

  • 正常响应要素说明
    表2 要素说明

    名称

    参数类型

    说明

    list

    Array of objects

    参数解释

    错误下载链接列表,详见表3

    status

    String

    参数解释

    错误日志下载链接生成状态。

    取值范围

    • FINISH,表示下载链接已经生成完成。
    • CREATING,表示正在生成文件,准备下载链接。
    • FAILED,表示存在日志文件准备失败。

    count

    Integer

    参数解释

    错误日志链接数量。

    取值范围

    不涉及。

    表3 list字段数据结构说明

    名称

    参数类型

    说明

    workflow_id

    String

    参数解释

    任务ID。

    取值范围

    不涉及。

    file_name

    String

    参数解释

    生成的下载文件名。

    取值范围

    不涉及。

    status

    String

    参数解释

    当前链接的生成状态。

    取值范围

    不涉及。

    file_size

    String

    参数解释

    文件大小。

    取值范围

    不涉及。

    file_link

    String

    参数解释

    下载链接。

    取值范围

    不涉及。

    create_at

    Long

    参数解释

    生成时间。

    取值范围

    不涉及。

    update_at

    Long

    参数解释

    更新时间。

    取值范围

    不涉及。

  • 正常响应样例

    错误日志下载链接获取成功:

    { 
       "list" : [ { 
         "workflow_id" : "44fb1d85-2fcc-4d63-ad3b-c3d1ecd7000e", 
         "file_name" : "054bc9c1f680d55c1f36c006e5a9f67b_errorlog_download_20200515080614589", 
         "file_size" : "0", 
         "file_link" : "https://rdsbucket.xxx.myhuaweicloud.com:443/054bc9c1f680d55c1f36c006e5a9f67b_errorlog_download_20200515080614589?AWSAccessKeyId=1BQ38TBCQHAVQXBUMUTC&Expires=1589530200&response-cache-control=no-cache%2Cno-store&Signature=Fgi4%2BLOJ9frAXyOkz5hRoW5O%2BUM%3D", 
         "create_at" : 1589529991385, 
         "update_at" : 1589529991385 
       } ], 
       "status" : "finish", 
       "count" : 1 
     }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码