功能介绍
更新某一个保护组的名称。
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
PUT /v1/{project_id}/server-groups/{server_group_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 |
|
server_group_id |
是 |
String |
保护组ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
保护组的ID。 |
|
name |
String |
保护组的名称。 |
|
description |
String |
保护组的描述。 |
|
status |
String |
保护组的状态。 |
|
progress |
Integer |
保护组的同步进度。单位：百分比（%）。 最小值：0 最大值：100 |
|
source_availability_zone |
String |
保护组创建时的生产站点可用区名称。注意：保护组切换、故障切换后，该值不变。 |
|
target_availability_zone |
String |
保护组创建时的容灾站点可用区名称。注意：保护组切换、故障切换后，该值不变。 |
|
domain_id |
String |
双活域ID。 |
|
domain_name |
String |
双活 域名 称。 |
|
priority_station |
String |
用于标识保护组的当前生产站点。 source：表示当前生产站点可用区为source_availability_zone的值。 target：表示当前生产站点可用区为target_availability_zone的值。 |
|
protected_instance_num |
Integer |
该保护组中保护实例的个数。 |
|
replication_num |
Integer |
该保护组中复制对的个数。 |
|
disaster_recovery_drill_num |
Integer |
该保护组中容灾演练的个数。 |
|
protected_status |
String |
保护状态。started：表示该保护组开始保护。stopped：表示该保护组停止保护。 说明:系统近期进行了升级，对于升级后创建的保护组，该字段值为null，无实际意义。 枚举值：
|
|
replication_status |
String |
数据同步状态。 active：表示数据已同步完成。 inactive：表示数据未同步。 copying：表示数据正在同步。 active-stopped：表示数据已停止同步。 说明:系统近期进行了升级，对于升级后创建的保护组，该字段值为null，无实际意义。 枚举值：
|
|
health_status |
String |
健康状态。 normal：表示该保护组处于正常状态。 abnormal：表示该保护组处于非正常状态。 说明:系统近期进行了升级，对于升级后创建的保护组，该字段值为null，无实际意义。 枚举值：
|
|
source_vpc_id |
String |
生产站点 虚拟私有云 ID。 |
|
target_vpc_id |
String |
容灾站点虚拟 私有云 ID。 |
|
test_vpc_id |
String |
容灾演练虚拟私有云ID。（该参数暂未使用） |
|
dr_type |
String |
部署模式。默认值为“migration”，migration表示VPC内 迁移 。 |
|
created_at |
String |
创建时间。默认格式为："yyyy-MM-dd'T'HH:mm:ss.SSSZ"，例："2019-04-01T12:00:00.000Z"。 |
|
updated_at |
String |
更新时间。默认格式为："yyyy-MM-dd'T'HH:mm:ss.SSSZ"，例："2019-04-01T12:00:00.000Z"。 |
|
protection_type |
String |
保护模式。 replication-pair：表示以复制对为单位进行数据同步。 null：表示将保护组中的所有复制对作为一个整体进行数据同步。 说明:当保护组中的所有复制对作为一个整体进行数据同步时，如果数据同步失败，保护组中的所有复制对都会受到影响。因此，SDRS服务对系统做了优化升级： 对于升级后创建的资源，默认以复制对为单位进行数据同步，返回值为replication-pair； 对于已有资源，仍以一个整体进行数据同步，返回值为null。 枚举值：
|
|
replication_model |
String |
复制类型。 说明:预留参数，暂未启用。 |
|
server_type |
String |
管理的服务器类型 ECS：表示管理的服务器类型为 云服务器 。 |
状态码： 400
状态码： 401
状态码： 403
状态码： 405
状态码： 406
状态码： 407
状态码： 408
状态码： 409
状态码： 500
状态码： 501
状态码： 502
状态码： 503
状态码： 504
请求示例
PUT https://{endpoint}/v1/{project_id}/server-groups/ e98cefcd-2398-4a4d-8c52-c79f00e21484
{
"server_group" : {
"name" : "my_test_server_group"
}
}
响应示例
状态码： 200
OK
{
"server_group" : {
"id" : "decf224d-87fe-403a-8721-037a1a45c287",
"name" : "Protection-Group-lwx",
"description" : null,
"source_availability_zone" : "cn-north-1a",
"target_availability_zone" : "cn-north-1b",
"domain_id" : "fb4bb8e3-a574-4437-a156-78c916aeea4d",
"domain_name" : "ActiveactiveDomain",
"status" : "available",
"protected_status" : null,
"replication_status" : null,
"health_status" : null,
"progress" : 0,
"priority_station" : "source",
"protected_instance_num" : 0,
"replication_num" : 0,
"disaster_recovery_drill_num" : 0,
"source_vpc_id" : "046852ef-c49d-409b-8389-546aaaa5701f",
"target_vpc_id" : "046852ef-c49d-409b-8389-546aaaa5701f",
"test_vpc_id" : null,
"dr_type" : "migration",
"created_at" : "2019-05-22 08:16:54.413",
"updated_at" : "2019-05-23 09:11:10.856",
"protection_type" : "replication-pair",
"replication_model" : null
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
405 |
Method Not Allowed |
|
406 |
Not Acceptable |
|
407 |
Proxy Authentication Required |
|
408 |
Request Timeout |
|
409 |
Conflict |
|
500 |
Internal Server Error |
|
501 |
Not Implemented |
|
502 |
Bad Gateway |
|
503 |
Service Unavailable |
|
504 |
Gateway Timeout |
错误码
请参见错误码。
