# 获取错误日志下载链接（PostgreSQL） - DownloadErrorlog #### 功能介绍 获取错误日志下载链接。 需要低频重复调用，直到status返回FINISH，就可以获取下载链接。 或者取第一次调用返回的workflow_id，去查询任务状态，成功后再次调用此接口即可获取下载链接。 - 调用接口前，您需要了解API[认证鉴权](https://support.huaweicloud.com/api-rds/rds_03_0001.html)。 - 调用接口前，您需要了解[请求Header参数说明](https://support.huaweicloud.com/api-rds/rds_03_0005.html#rds_03_0005__section479119143310)。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/RDS/doc?api=DownloadErrorlog)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-rds/rds_10_0005.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### 接口约束 目前，该接口仅支持获取正常状态实例的错误日志下载链接。 #### URI - URI格式 POST /v3/{project_id}/instances/{instance_id}/errorlog-download - 参数说明 表1参数说明 | 名称 | 是否必选 | 说明 | |:---|:---|:---| | project_id | 是 | **参数解释：** 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-rds/rds_03_0002.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | instance_id | 是 | **参数解释：** 实例ID。 可调用[查询数据库实例列表](https://support.huaweicloud.com/api-rds/rds_01_0004.html)接口，通过[表4](https://support.huaweicloud.com/api-rds/rds_01_0004.html#rds_01_0004__table2058713718267)中的"id"获取。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 请求消息 - 参数说明 无 - URI样例 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/3d39c18788b54a919bab633874c159dfin01/errorlog-download #### 响应消息 - 正常响应要素说明 表2要素说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | list | Array of objects | **参数解释**： 错误日志下载链接列表，详见[表3]。 | | status | String | **参数解释**： 错误日志下载链接生成状态。 **取值范围**： - FINISH，表示下载链接已经生成完成。 - CREATING，表示正在生成文件，准备下载链接。 - FAILED，表示存在日志文件准备失败。 | | count | Integer | **参数解释**： 错误日志链接数量。 **取值范围**： 不涉及。 | 表3list字段数据结构说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | workflow_id | String | **参数解释**： 任务ID。 **取值范围**： 不涉及。 | | file_name | String | **参数解释**： 生成的下载文件名。 **取值范围**： 不涉及。 | | status | String | **参数解释**： 当前链接的生成状态。 **取值范围**： - SUCCESS：成功。 - FAILED：失败。 - EXPORTING：生成中。 | | 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 } ``` - 异常响应 请参见[异常响应结果](https://support.huaweicloud.com/api-rds/rds_01_0010.html)。 #### 状态码 - 正常 200 - 异常 请参见[状态码](https://support.huaweicloud.com/api-rds/rds_10_0200.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-rds/rds_10_0201.html)。