# 创建慢日志下载信息 - CreatingaSlowQueryLogDownloadTask #### 功能介绍 创建慢日志下载信息。 - 调用接口前，您需要了解API [认证鉴权](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_011.html)。 - 调用接口前，您需要提前获取到[地区和终端节点](https://developer.huaweicloud.com/endpoint)。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=GaussDBforopenGauss&api=CreateSlowLogDownload)中调试该接口。 #### URI POST /v3/{project_id}/instances/{instance_id}/slow-log/download 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 租户在某一Region下的项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_196.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**： 不涉及。 | | instance_id | 是 | String | **参数解释：** 实例ID，此参数是用户创建实例的唯一标识。请参考[查询数据库实例列表 - QueryingDBInstances](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_328.html)接口获取实例ID。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为36个字符。 **默认取值** **：** 不涉及。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取。 请求响应成功后在响应消息头中包含的"X-Subject-Token"的值即为Token值。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值** **：** 不涉及。 | | X-Language | 否 | String | **参数解释：** 指定接口返回信息的语言类型。 **约束限制：** 不涉及。 **取值范围：** - **zh-cn**：中文 - **en-us**：英文 **默认取值** **：** **en-us** | #### 响应参数 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | list | Array of SlowLogDownloadInfo objects | **参数解释：** 慢日志下载信息列表。详情请参见 [表4] 。 | 表4SlowLogDownloadInfo字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 慢日志ID。 **取值范围：** 不涉及。 | | instance_id | String | **参数解释：** 实例ID。 **取值范围：** 不涉及。 | | node_id | String | **参数解释：** 节点ID。 **取值范围：** 不涉及。 | | workflow_id | String | **参数解释：** 工作流ID。 **取值范围：** 不涉及。 | | file_name | String | **参数解释：** 文件名。 **取值范围：** 不涉及。 | | file_size | String | **参数解释：** 文件大小，单位：Byte。 **取值范围：** 不涉及。 | | file_link | String | **参数解释：** 文件下载链接。 **取值范围：** 不涉及。 | | bucket_name | String | **参数解释：** 桶名称。 **取值范围：** 不涉及。 | | created_at | Long | **参数解释：** 创建时间。ms时间戳格式。 **取值范围：** 不涉及。 | | updated_at | Long | **参数解释：** 更新时间。ms时间戳格式。 **取值范围：** 不涉及。 | | version | String | **参数解释：** 慢日志版本。 **取值范围：** 不涉及。 | | status | String | **参数解释：** 慢日志下载状态。 **取值范围：** - EXPORTING：准备中。 - SUCCESS：准备完成。 | | message | String | **参数解释：** 慢日志消息。 **取值范围：** 不涉及。 | #### 请求示例 ``` POST https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/cc6fd964d93f4003851dfc29d57d30a5in14/slow-log/download ``` #### 响应示例 ![](https://support.huaweicloud.com/api-gaussdb/public_sys-resources/notice_3.0-zh-cn.png) 首次下发请求，响应为空列表。 ``` { "list" : [] } ``` ``` { "list" : [ { "id" : "64d7bad3-6665-4590-baa2-eb5394e49625", "instance_id" : "9b2f4cc6cd584c67bc179a2bfbb37f90in14", "node_id" : "9d8c79cc41074452977a564b335220f5no14", "workflow_id" : "7d77153c12dde-4f3c-a333-7d30503267f2", "file_name" : "c7025305deb34ae9af1be94f698e7949_slowlog_download__9d8c79cc41074452977a564b335220f5no1420230823024331782", "file_size" : "719.0", "file_link" : "***", "bucket_name" : null, "created_at" : 1692758611782, "updated_at" : 1692758611782, "version" : null, "status" : "EXPORTING", "message" : null }, { "id" : "4712c3b1-d26a-49d4-9652-211d6ac106c5", "instance_id" : "9b2f4cc6cd584c67bc179a2bfbb37f90in14", "node_id" : "9d03b0a73ebd415eb2f692862f326cb7no14", "workflow_id" : "7d77153c12dde-4805-bd0b-d70c803a873a", "file_name" : "c7025305deb34ae9af1be94f698e7949_slowlog_download__9d03b0a73ebd415eb2f692862f326cb7no1420230823024331727", "file_size" : "719.0", "file_link" : "***", "bucket_name" : null, "created_at" : 1692758611727, "updated_at" : 1692758611727, "version" : null, "status" : "EXPORTING", "message" : null } ] } ``` #### 状态码 - 正常 202 - 异常 请参见[状态码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_194.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_195.html)。