云服务器内容精选

  • 响应示例 { "backups": [ { "id": "a696cd25e4fc453aa503650225cece8bbr14", "name": "GaussDB-hly-ha-20220509080110906", "description": null, "status": "FAILED", "size": 0.0, "type": "auto", "datastore": { "type": "GaussDB", "version": "1.4" }, "begin_time": "2022-05-09T16:01:10+0800", "end_time": "2022-05-09T16:04:31+0800", "instance_id": "164abc6d35114095bb849d007b19db3bin14" }, { "id": "5651c62a7f12461c98020dd3abfe24ccbr14", "name": "GaussDB-hly-master-20220509022658257", "description": null, "status": "FAILED", "size": 0.0, "type": "auto", "datastore": { "type": "GaussDB", "version": "1.4" }, "begin_time": "2022-05-09T10:26:58+0800", "end_time": "2022-05-09T10:30:17+0800", "instance_id": "fd26e3bf26e5467587eec857e4f66ef0in14" } ], "total_count": 167 }
  • 响应参数 表2 响应参数 参数 参数类型 描述 backups Array of objects 备份信息。 详情请参见表3。 total_count Long 备份文件的总数。 表3 backups字段数据结构说明 参数 参数类型 描述 id String 备份ID。 name String 备份名称。 description String 备份文件描述信息。 begin_time String 备份开始时间,格式为"yyyy-mm-ddThh:mm:ssZ"。 其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。 end_time String 备份结束时间,格式为“yyyy-mm-ddThh:mm:ssZ”。 其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。 status String 备份状态 枚举值: BUILDING:备份中。 COMPLETED:备份完成。 FAILED:备份失败。 size Double 备份大小(单位:MB)。 type String 备份类型 取值: auto:自动全量备份。 manual:手动全量备份。 datastore Object 数据库信息。 详情请参见表4 instance_id String 实例ID。 表4 datastore字段数据结构说明 参数 参数类型 描述 type String 数据库引擎,不区分大小写,取值如下: GaussDB。 version String 数据库版本。不填时,默认为当前最新版本。 数据库支持版本可根据查询数据库引擎的版本接口获取。
  • URI GET https://{Endpoint}/v3/{project_id}/backups?instance_id={instance_id}&backup_id={backup_id}&backup_type={backup_type}&offset={offset}&limit={limit}&begin_time={begin_time}&end_time={end_time} 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 instance_id 否 String 实例ID。 backup_id 否 String 备份ID,严格匹配UUID规则。 backup_type 否 String 备份类型,取值范围: auto 自动全量备份 manual 手动全量备份 offset 否 Integer 索引位置,偏移量。从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。 最小值:0 limit 否 Integer 查询记录数。默认为100,不能为负数,最小值为1,最大值为100。 最小值:1 最大值:100 begin_time 否 String 查询开始时间,格式为“yyyy-mm-ddThh:mm:ssZ”。其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。与end_time必须同时使用。 end_time 否 String 查询结束时间,格式为“yyyy-mm-ddThh:mm:ssZ”,且大于查询开始时间。其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。与begin_time必须同时使用。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 job_id String 执行异步任务的JobID。 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_code String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误码。 error_msg String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误信息。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口,响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 backup_id 是 String 备份ID。 export_path 是 String OBS导出路径。
  • URI GET /v1.0/{project_id}/graphs/{graph_id}/backups 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参见获取项目ID。 graph_id 是 String 图ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页资源数量的最大值,默认为10。 offset 否 Integer 本次请求的起始位置,默认为0。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 errorMessage String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误信息。 errorCode String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误码。 backupCount Integer 备份总个数。请求失败时,该字段为空。 backupList Array of backup objects 当前Project下指定Graph的备份列表。请求失败时,该字段为空。 表5 backup 参数 参数类型 描述 id String 备份ID。 name String 备份名称。 backupMethod String 备份方法,取值为auto或manual。 graphId String 备份关联的图ID。 graph_name String 备份关联的图Name。 graphStatus String 备份关联的图状态。 graphSizeTypeIndex String 备份关联的图规格。 dataStoreVersion String 备份关联的图版本。 arch String 备份关联的图CPU架构。 status String 备份状态。 backing_up:备份中 success:备份成功 failed:备份失败 startTimestamp Long 备份开始时间戳。 startTime String 备份时间。 endTimestamp Long 备份结束时间戳。 endTime String 备份时间。 size Long 备份文件大小,单位为MB。 duration Long 备份时间,单位为秒。 encrypted Boolean 是否加密。true表示加密,默认值为"false",不加密。
  • 响应示例 状态码: 200 OK { "backupCount": 2, "backupList": [ { "id": "ada3e720-ab87-48cb-bff7-3ec5ae1a9652", "name": "ges060803_nodelete-20210608135513", "backupMethod": "manual", "graphId": "4c5f882d-a813-4d78-a8e3-6d3212ddd121", "graph_name": "ges060803_nodelete", "graphStatus": "200", "graphSizeTypeIndex": "1", "dataStoreVersion": "2.2.22", "arch": "x86_64", "status": "success", "startTimestamp": 1623160513000, "startTime": "2021-06-08T13:55:13", "endTimestamp": 1623160568000, "endTime": "2021-06-08T13:56:08", "size": 1, "duration": 54, "encrypted": false }, { "id": "7ed3f51d-816d-4651-9129-fe21b64b5c91", "name": "ges060803_nodelete_20210609203323_auto", "backupMethod": "auto", "graphId": "4c5f882d-a813-4d78-a8e3-6d3212ddd121", "graph_name": "ges060803_nodelete", "graphStatus": "200", "graphSizeTypeIndex": "1", "dataStoreVersion": "2.2.21", "arch": "x86_64", "status": "success", "startTimestamp": 1623242004000, "startTime": "2021-06-09T12:33:24", "endTimestamp": 1623242004000, "endTime": "2021-06-09T12:33:24", "size": 1, "duration": 0, "encrypted": false } ] } 状态码: 400 Bad Request { "errorCode" : "GES.7000", "errorMessage" : "The graph does not exist or has been deleted." }
  • 响应示例 状态码: 200 OK { "backupCount": 3, "backupList": [ { "id": "ada3e720-ab87-48cb-bff7-3ec5ae1a9652", "name": "ges060803_nodelete-20210608135513", "backupMethod": "manual", "graphId": "4c5f882d-a813-4d78-a8e3-6d3212ddd121", "graph_name": "ges060803_nodelete", "graphStatus": "200", "graphSizeTypeIndex": "1", "dataStoreVersion": "2.2.21", "arch": "x86_64", "status": "success", "startTimestamp": 1623160513000, "startTime": "2021-06-08T13:55:13", "endTimestamp": 1623160568000, "endTime": "2021-06-08T13:56:08", "size": 1, "duration": 54, "encrypted": false }, { "id": "7ed3f51d-816d-4651-9129-fe21b64b5c91", "name": "ges060803_nodelete_20210609203323_auto", "backupMethod": "auto", "graphId": "4c5f882d-a813-4d78-a8e3-6d3212ddd121", "graph_name": "ges060803_nodelete", "graphStatus": "200", "graphSizeTypeIndex": "1", "dataStoreVersion": "2.2.21", "arch": "x86_64", "status": "success", "startTimestamp": 1623242004000, "startTime": "2021-06-09T12:33:24", "endTimestamp": 1623242004000, "endTime": "2021-06-09T12:33:24", "size": 1, "duration": 0, "encrypted": false }, { "id": "604bfb46-04dd-45fc-a9ae-df24a0705b9d", "name": "ges060802_nodelete-20210608135523", "backupMethod": "manual", "graphId": "9b9a05c2-0cdb-41ac-b55f-93caffb0519a", "graph_name": "ges060802_nodelete", "graphStatus": "400", "graphSizeTypeIndex": "0", "dataStoreVersion": "2.2.23", "arch": "x86_64", "status": "success", "startTimestamp": 1623160524000, "startTime": "2021-06-08T13:55:24", "endTimestamp": 1623160577000, "endTime": "2021-06-08T13:56:17", "size": 1, "duration": 53, "encrypted": false } ] } 状态码: 400 Bad Request { "errorCode" : "GES.7006", "errorMessage" : "The underlying graph engine has internal error." }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 errorMessage String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误信息。 errorCode String 系统提示信息。 执行成功时,字段可能为空。 执行失败时,用于显示错误码。 backupCount Integer 备份总个数。请求失败时,该字段为空。 backupList Array of backup objects 当前Project ID下的所有图的备份列表。请求失败时,该字段为空。 表5 backup 参数 参数类型 描述 id String 备份ID。 name String 备份名称。 backupMethod String 备份方法,取值为auto或manual。 graphId String 备份关联的图ID。 graph_name String 备份关联的图Name。 graphStatus String 备份关联的图状态。 graphSizeTypeIndex String 备份关联的图规格。 dataStoreVersion String 备份关联的图版本。 arch String 备份关联的图CPU架构。 status String 备份状态。 backing_up:备份中 success:备份成功 failed:备份失败 startTimestamp Long 备份开始时间戳。 startTime String 备份时间。 endTimestamp Long 备份结束时间戳。 endTime String 备份时间。 size Long 备份文件大小,单位为MB。 duration Long 备份时间,单位为秒。 encrypted Boolean 是否加密。true表示加密,false表示不加密,默认值为false。
  • 约束与限制 同时满足以下条件的云服务器备份才能执行创建复制操作: 备份由弹性云服务器产生。 备份数据包含系统盘。 备份状态为“可用”。 仅支持对源区域生成的备份或备份存储库执行复制操作,不支持对复制操作产生的备份和复制存储库再次执行复制操作,从其他区域复制而来的备份仅可用于创建镜像或文件系统。 一个源备份可以分别复制到不同的目标区域,一个目标区域只能同时存在该源备份的一个目标备份。向一个目标区域复制的次数在不同的复制方式下有所不同: 对单个备份手动创建复制:在目标区域将目标备份删除后可再次复制。 通过策略复制:每个目标区域仅能复制一次,即使将目标备份删除后也不允许再次复制。 仅支持向具备复制能力的目标区域复制备份数据。
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 backup_id String 备份ID。 backup_name String 备份名称。 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码: 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 X-Language 否 String 请求语言类型。默认en-us。 取值范围: en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 restore_time 是 Long 备份要恢复的目标时间点。 restore_tables 是 Array of RestoreDatabaseInfo objects 备份要恢复的库表信息。 表4 RestoreDatabaseInfo 参数 是否必选 参数类型 描述 database 是 String 数据库名。 tables 是 Array of RestoreTableInfo objects 数据库表信息。 表5 RestoreTableInfo 参数 是否必选 参数类型 描述 old_name 是 String 原表名。 new_name 是 String 恢复后的表名。
  • 请求示例 POST https://{endpoint}/v3.1/619d3e78f61b4be68bc5aa0b59edcf7b/instances/7033e7c3cf93438797d44ad7ae0a7d95in07/restore/tables { "restore_time" : 1673852043000, "restore_tables" : [ { "database" : "huawei-test", "tables" : [ { "old_name" : "user_table", "new_name" : "new_user_table" } ] } ] }
  • 响应参数 状态码: 200 表6 响应Body参数 参数 参数类型 描述 job_id String 工作流ID。 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码: 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。