华为云用户手册

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 job_id String 创建 云桌面 总任务id。 状态码：400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

响应参数 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 是 String 发送的实体的MIME类型。 表3 请求Body参数 参数 是否必选 参数类型 描述 function_config 否 FunctionConfig object 租户个性配置。 表4 FunctionConfig 参数 是否必选 参数类型 描述 id 否 String 功能配置id。 name 否 String 功能配置名称。 status 否 String 功能配置开关的状态，表示开启还是关闭 ON/OFF。 - ON： 开启该功能 - OFF： 关闭该功能。 values 否 Array of MapObject objects 配置项列表，键值对格式。 表5 MapObject 参数 是否必选 参数类型 描述 key 否 String 配置项的键。 value 否 String 配置项对应的值。

请求示例 PUT /v2/fb2e5ec048384c8f9469d22db0037908/auth-config/method-config { "auth_type" : "RADIUS_GATEWAY", "radius_gateway_config" : { "enable" : true, "app_id" : "sms3d356sd4f1s3e", "password" : 123456, "token_url" : "www.xxx-token.com", "verification_cipher_url" : "www.xxx-sms.com", "cert_content" : "cert_content" } }

响应参数 状态码：200 表9 响应Body参数 参数 参数类型 描述 project_id String 项目ID。 状态码：400 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：401 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：403 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：404 表13 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：500 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

请求示例 { "desktop_type" : "DEDICATED", "image_type" : "gold", "image_id" : "a866298d-67db-44b0-a1f1-9d09bdddc20f", "root_volume" : { "type" : "SAS", "size" : 80 }, "availability_zone" : "az3.manage.x86", "desktops" : [ { "user_name" : "ljh-002", "user_group" : "administrators", "user_email" : "aaaaa@huawei.com" } ], "nics" : [ { "subnet_id" : "5dee0216-2260-47c2-9368-98a27d910e55" } ], "product_id" : "workspace.c2.large.windows.2", "email_notification" : true }

响应参数 状态码：200 表11 响应Body参数 参数 参数类型 描述 job_id String 创建云桌面总任务id。 状态码：400 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：401 表13 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：403 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：404 表15 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：500 表16 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

响应示例 状态码：200 成功响应。 { "count" : 0, "items" : [ { "server_id" : "489533790436196976", "machine_name" : "APS-DDP9KKUYTR", "maintain_status" : true, "server_name" : "APS-20221011032502-DL51DUK113", "server_group_id" : "489533790436196976", "server_group_name" : "测试使用服务器组", "sid" : "489533790436196976", "session_count" : 10, "status" : "UNREGISTER", "current_version" : "22.10.0.1020" } ] }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 count Integer 总数。 items Array of ServerHdaDetails objects 返回列表条目数量上限为分页的最大上限值。 表5 ServerHdaDetails 参数 参数类型 描述 server_id String 服务器id。 machine_name String 机器名称。 maintain_status Boolean 是否是维护状态。 server_name String 服务器名称。 server_group_id String 服务器组id。 server_group_name String 服务器组名称。 sid String 服务器的sid。 session_count Integer 会话数量。 status String 实例的状态： UNREGISTER - 未就绪 REGISTERED - 就绪状态 MAINTAINING - 维护中 FREEZE - 冻结 STOPPED - 停止 NONE - 异常状态 current_version String 当前的accessAgent版本。 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：405 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：409 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：500 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：503 表13 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。

URI GET /v1/{project_id}/app-servers/access-agent/list 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目唯一标识。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 查询的偏移量，默认值0。 limit 否 Integer 查询的数量，值区间[1-100]，默认值10。 server_group_id 否 String 服务器组id。 server_name 否 String 服务器名称。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 job_id String 任务id。 状态码：default 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 是 String 发送的实体的MIME类型。 表3 请求Body参数 参数 是否必选 参数类型 描述 desktop_ids 否 Array of strings 需要开通上网功能的桌面id列表。 eip_type 是 String 支持的类型请参考EIP服务支持的类型。可通过调用如下链接的接口查询，https://support.huaweicloud.com/api-eip/ShowPublicIpType.html。 eip_charge_mode 是 String eip带宽计费模式 TRAFFIC：按流量计费。 BANDW IDT H：按带宽计费。 bandwidth_size 是 Integer 带宽大小，单位Mbit/s。默认1Mbit/s~2000Mbit/s（具体范围以各区域配置为准，请参见控制台对应页面显示）。 enterprise_project_id 否 String 企业项目ID，默认"0。" count 否 Integer 需要购买EIP的数量，当desktop_ids为空时需要填，兼容单独购买EIP场景。

响应示例 状态码：200 查询产品列表响应。 { "os_type" : "string", "architecture" : "string", "availability_zone" : "string", "products" : [ { "product_id" : "string", "flavor_id" : "string", "type" : "string", "architecture" : "string", "cpu" : "string", "cpu_desc" : "string", "memory" : "string", "is_gpu" : true, "system_disk_type" : "SAS", "system_disk_size" : "80", "data_disk_size" : "80", "gpu_desc" : "string", "bill_switch" : "on", "descriptions" : "string。", "product_desc" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "charge_mode" : "st", "contain_data_disk" : true, "resource_type" : "string", "cloud_service_type" : "string", "volume_product_type" : "string", "domain_ids" : [ "string" ], "status" : "normal", "sub_product_list" : [ "string" ], "package_type" : "string", "series_type" : "string", "name" : { "additionalProp1" : "string", "additionalProp2" : "string", "additionalProp3" : "string" }, "default_desktop_num" : 4, "max_apply_desktop_num" : 14, "share_space_size" : 100 } ], "total_count" : 0 }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 os_type String 套餐所支持操作系统类型。请求参数有os_type时，才有此参数。 architecture String 产品架构。请求参数有package_type=agile时，才有此参数。 availability_zone String 可用分区。请求参数有availability_zone时，才有此参数。 products Array of Product objects 产品列表。 total_count Integer 对象总数。 表5 Product 参数 参数类型 描述 product_id String 产品id。 flavor_id String 规格ID。 type String 产品类型。取值为： BASE：表示产品基础套餐，套餐镜像中不包括除操作系统之外的其他商业软件，私有镜像场景只能使用此类套餐。 architecture String 产品架构，当前支持：arm、x86。 cpu String cpu。 cpu_desc String cpu描述。 memory String 内存。 is_gpu Boolean 是否是GPU类型的规格。 system_disk_type String 系统盘类型。 system_disk_size String 系统盘大小，单位GB。 data_disk_size String 数据盘大小，单位GB。 gpu_desc String GPU描述。 bill_switch String 话单开关，默认on,on-出话单模式,off-关话单模式,只支持反序列化，不支持序列化，不在接口中展示。 descriptions String 产品描述。 charge_mode String 周期套餐标识。0表示包周期，1表示按需。 contain_data_disk Boolean 套餐计费是否包含了数据盘,off-不包含。 resource_type String 资源规格。 cloud_service_type String 云服务编码。 volume_product_type String 磁盘产品类型。 domain_ids Array of strings 该产品套餐支持的专有域id（domainId）。 status String 产品状态，normal：正常、sellout：售空、abandon：下线。 sub_product_list Array of strings 专属主机的子产品。 default_desktop_num Integer 专享主机套餐默认的桌面数。 max_apply_desktop_num Integer 专享主机支持创建的最大桌面数。 share_space_size Integer 协同方数。该套餐支持的最大协同人数。 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：405 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：500 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：503 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

URI GET /v2/{project_id}/products 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 product_id 否 String 产品ID。 availability_zone 否 String 可用分区。 os_type 否 String 产品套餐的操作系统类型，当前支持：Windows、Linux。 charge_mode 否 String 周期套餐标识。0表示包周期，1表示按需。 architecture 否 String 架构类型，当前支持：arm、x86。 package_type 否 String 套餐系列。 limit 否 Integer 每页数量，范围0-100，默认100。 offset 否 Integer 偏移量，默认0。

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 状态码：400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：404 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：405 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：409 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：503 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。

响应示例 状态码：200 查询定时任务列表响应。 { "scheduled_tasks" : [ { "id" : "2b31e-d520xxxx-xxebedb6-e57xxxxxx", "task_name" : "测试任务", "task_type" : "START", "scheduled_type" : "FIXED_TIME", "life_cycle_type" : "string", "last_status" : "SUC CES S", "next_execution_time" : "2022-12-23 09:00:00", "enable" : true, "description" : "一个描述。", "priority" : 0, "time_zone" : "string", "wait_time" : 0 } ], "total_count" : 10 }

URI GET /v2/{project_id}/scheduled-tasks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 是 Integer 用于分页查询，查询的起始记录序号，从0开始。 limit 是 Integer 用于分页查询，每页返回的个数，取值范围0~50。 task_name 否 String 任务名称。 task_type 否 String 任务类型。START：开机，STOP：关机，REBOOT：重启，HIBERNATE：休眠，REBUILD：重建系统盘，EXECUTE_SCRIPT：执行脚本，CREATE_SNAPSHOT：创建EVS镜像。 scheduled_type 否 String 执行周期类型。FIXED_TIME：指定时间，DAY：按天，WEEK：按周，MONTH：按月，LIFE_CYCLE：触发式。指定LIFE_CYCLE时，才返回触发式任务。 life_cycle_type 否 String 触发场景类型。POST_CREATE_DESKTOP_SUCCESS：创建桌面成功后，POST_REBUILD_DESKTOP_SUCCESS：重建桌面成功后，POST_REATTACH_DESKTOP_SUCCESS：触发重建的分配用户任务成功后，POST_DESKTOP_DISCONNECTED：桌面断开连接后。 last_status 否 String 最近一次执行状态。SUCCESS：成功，SKIP：跳过，FAIL：失败。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 scheduled_tasks Array of ScheduledTask objects 定时任务列表。 total_count Integer 总个数。 表5 ScheduledTask 参数 参数类型 描述 id String 任务id。 task_name String 任务名称。 task_type String 任务类型。START：开机，STOP：关机，REBOOT：重启，HIBERNATE：休眠，REBUILD：重建系统盘，EXECUTE_SCRIPT：执行脚本，CREATE_SNAPSHOT：创建快照。 scheduled_type String 执行周期。FIXED_TIME：指定时间，DAY：按天，WEEK：按周，MONTH：按月。 life_cycle_type String 触发场景类型。 last_status String 最近一次执行状态。SUCCESS：成功，SKIP：跳过，FAIL：失败。 next_execution_time String 下一次执行时间。格式为yyyy-MM-dd HH:mm:ss。 enable Boolean 是否启用。 description String 描述。 priority Integer 优先级。触发式任务使用。 time_zone String 时区。 wait_time Integer 触发式任务触发后，等待时长。 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 状态码：500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

解决方案 治理：提供OS合规性自动化定时巡检能力，打造开箱即用体验，同时保留客户自定义能力，及时发现OS合规性问题并输出合规性报告； 运维：基于合规性报告触发补丁修复，通过增量迭代方式保证OS合规性全覆盖，保证OS合规性问题闭环SLA； 图1 一站式资源运维 补丁管理：COC提供OS补丁管理能力，支持对Linux下的Huawei Cloud EulerOS、CentOS、EulerOS三种系统进行补丁扫描和修复，并且支持E CS 节点和CCE集群两种场景。COC通过补丁基线中的规则，对主机的OS补丁进行扫描并且提供合规性报告。COC提供三条公共补丁基线，同时支持用户自定义创建补丁基线。用户可以自定义补丁安装规则、补丁的合规性级别、补丁例外。 使用补丁管理包含以下步骤： 创建补丁基线，基于操作系统及对应的补丁扫描基线。 补丁扫描，基于扫描基线对资源进行补丁扫描。 查看摘要，扫描完成后可以查看资源的扫描合规性。 补丁修复，不合规的资源可以执行批量修复。 定时运维：COC提供自动化运维能力，包含脚本管理、作业管理、定时运维三种能力。 脚本管理：COC提供公共脚本和自定义脚本，用户可以自定义创建脚本，支持shell、python、bat三种类型。 作业管理：用户可以将云服务API、公共作业、自定义作业、作业控制编排成自定义作业。 定时运维：定时运维向客户提供了定时或周期性的向特定实例执行特定脚本或者作业的功能。

解决方案 混沌演练驱动主动运维：从客户实际业务场景出发，按照风险分析、应急预案、演练执行、复盘改进4个维度，提供端到端混沌演练能力； 沉淀故障模式：首创基于容错视角的故障场景分析方法，沉淀华为云SRE多年的故障模式库，内置300个+典型故障模式。 图1 全旅程混沌工程 风险分析：分析应用架构，找出风险点。 应急预案：针对风险点，制定应急预案。 故障演练：针对风险分析的结果和应急预案，制定演练方案，进行故障演练。 复盘改进：演练完成后，对演练进行复盘总结，输出演练报告和改进事项。

概述 SLA（服务等级协议，Service Level Agreement）在业界常用于衡量服务质量，云运维中心COC的SLA管理功能为客户提供了工单时效管理能力，当工单触发某SLA规则时，COC会记录工单SLA触发详情，并通知客户及时跟进和处理。 SLA功能概要如下： 支持客户自定义SLA，或使用COC预置的公共SLA规则。 支持事件单/告警单/待办任务/问题单4类工单。 支持设定SLA目标（工单需要在指定时间内完结某状态），当工单触发规则后，按指定方式通知指定的人员，且支持持续通知。 支持设定SLA预警目标，即将打破SLA时，提前指定时间发送通知。 支持查看SLA记录，包含工单ID，SLA状态，SLA规则等关键信息。 创建或修改SLA后，将对新进入SLA流程的工单开始生效，对已处于SLA流程中的工单不会生效。 自定义SLA优先级高于公共SLA，部分应用优先级高于全部应用。 父主题： SLA管理

响应消息 响应参数 参数 参数类型 描述 status String 共享状态 created_at String 共享时间，格式为UTC时间 updated_at String 更新时间，格式为UTC时间 image_id String 镜像ID member_id String 成员ID schema String 共享视图 member_type string 共享成员类型 urn string 共享组织的URN 响应样例 STATUS CODE 200 { "status": "accepted", "created_at": "2023-08-23T04:09:12Z", "updated_at": "2023-08-23T04:09:12Z", "image_id": "370befec-a369-475e-a224-44a45927a8fe", "member_id": "ou-qdjrky7i07higfa4f6reqv9etybmp4ng", "schema": "/v2/schemas/member", "member_type": "organization", "urn": "organizations::6c031a41eefc480bb60f20c003891fcd:ou:o-z5142zmm6p5cumsxralfljeb3qrwqamd/ou-qdjrky7i07higfa4f6reqv9etybmp4ng" }

请求消息 请求参数 参数 是否必选 参数类型 描述 images 是 Array of strings 镜像ID列表 projects 是 Array of strings 项目ID列表 domains 否 Array of strings 账号ID列表 organizations 否 Array of strings 组织URN列表 projects、domains和organizations参数字段必须存在其中一个 。

请求消息 请求参数 参数 是否必选 参数类型 描述 images 是 Array of strings 镜像ID列表 projects 是 Array of strings 项目ID列表 domains 否 Array of strings 账号ID列表 organizations 否 Array of strings 组织URN列表 projects、domains和organizations参数字段必须存在其中一个 。

响应示例 当任务类型为imsCreateImageByInstance，云服务器创建镜像时，响应示例如下： { "job_id": "9a175ac792fa12d20193002100dd2762", "job_type": "imsCreateImageByInstance", "begin_time": "2024-11-06T06:19:43.195Z", "end_time": "2024-11-06T06:23:25.158Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "3f7185de-b59a-4bb8-aa1d-7a513528b0e9" } } 当任务类型为imsImportImageJob，外部镜像文件创建镜像时，响应示例如下： { "job_id": "9a175ac892fa1342019300224f22218e", "job_type": "imsImportImageJob", "begin_time": "2024-11-06T06:21:08.769Z", "end_time": "2024-11-06T06:27:03.742Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "subJobId": "ff80808192e19edc0193002261910d47", "image_id": "431df7fd-a898-4dc0-86b1-22cfefb8a517" } } 当任务类型为imsImportOvaImageJob，外部Ova镜像文件创建镜像时，响应示例如下： { "job_id": "9a175ac892fa13420193006a49173317", "job_type": "imsImportOvaImageJob", "begin_time": "2024-11-06T07:39:45.814Z", "end_time": "2024-11-06T07:49:45.814Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "sub_jobs_result": [ { "job_id": "9a175ac892fa13420193006c29e133f0", "job_type": "imsImportImageJob", "begin_time": "2024-11-06T07:41:48.896Z", "end_time": "2024-11-06T07:49:45.814Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "fc496c19-40c2-4220-8b1a-eba9d53fca7b" } } ], "sub_jobs_list": [ "9a175ac892fa13420193006c29e133f0" ] } } 当任务类型为imsVolumeCreateImageJob，数据盘创建系统盘镜像时，响应示例如下： { "job_id": "9a175ac692fa125401930037d9e329aa", "job_type": "imsVolumeCreateImageJob", "begin_time": "2024-11-06T06:44:40.545Z", "end_time": "2024-11-06T06:47:40.545Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "21b04ab5-e817-40ee-8d56-7ccdb8820335" } } 当任务类型为imsImportDataImageJob，外部镜像文件创建数据盘镜像时，响应示例如下： { "job_id": "9a175ac692fa125401930027b9c026b3", "job_type": "imsImportDataImageJob", "begin_time": "2024-11-06T06:27:03.742Z", "end_time": "2024-11-06T06:37:03.742Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "aa5306f7-bc95-4fa3-aa40-dd38fbdf2031" } } 当任务类型为imsCreateWholeImageByInstanceJob，云服务器创建整机镜像时，响应示例如下： { "job_id": "9a175ac792fa12d201930028cddb29c6", "job_type": "imsCreateWholeImageByInstanceJob", "begin_time": "2024-11-06T06:28:14.425Z", "end_time": "2024-11-06T06:37:03.742Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "17b7bdeb-2e72-43a0-a202-d36ce344e902" } } 当任务类型为imsCreateWholeImageByBackupJob，云备份或云服务器备份创建整机镜像时，响应示例如下： { "job_id": "9a175ac892fa13420193002961972392", "job_type": "imsCreateWholeImageByBackupJob", "begin_time": "2024-11-06T06:28:52.245Z", "end_time": "2024-11-06T06:28:58.399Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "ea0d5dce-ddb2-4f6f-83e3-55da065347fd" } } 当任务类型为imsNativeImportImageJob，注册镜像时，响应示例如下： { "job_id": "9a175ac692fa12540193005389023059", "job_type": "imsNativeImportImageJob", "begin_time": "2024-11-06T07:14:54.848Z", "end_time": "2024-11-06T07:19:54.848Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_id": "af8ea1dc-02f2-4019-8fa9-c9952a0077ce" } } 当任务类型为imsNativeExportImageJob，导出镜像时，响应示例如下： { "job_id": "9a175ac892fa134201930039db1a27b1", "job_type": "imsNativeExportImageJob", "begin_time": "2024-11-06T06:46:51.929Z", "end_time": "2024-11-06T06:49:53.657Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_id": "1ab4df10-fe18-48b7-91c9-53695fcd9df5" } } 当任务类型为imsAddImageMembersJob，添加镜像成员时，响应示例如下： { "job_id": "9a175ac692fa12540193002a6d4b2720", "job_type": "imsAddImageMembersJob", "begin_time": "2024-11-06T06:30:00.778Z", "end_time": "2024-11-06T06:30:03.179Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "results": [ { "image_id": "30e55148-deb9-4923-adb9-91618de16ba0", "status": "success" } ] } } 当任务类型为imsDelImageMembersJob，删除镜像成员时，响应示例如下： { "job_id": "9a175ac792fa12d20193002da96f2ac2", "job_type": "imsDelImageMembersJob", "begin_time": "2024-11-06T06:33:32.781Z", "end_time": "2024-11-06T06:33:34.181Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "results": [] } } 当任务类型为imsUpdateImageMembersJob，修改镜像成员时，响应示例如下： { "job_id": "9a175ac692fa12540193005c340f321c", "job_type": "imsUpdateImageMembersJob", "begin_time": "2024-11-06T07:24:22.925Z", "end_time": "2024-11-06T07:24:23.773Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "results": [ { "image_id": "6596628c-42d4-4ff1-8660-8ea5ae61f243", "status": "success" } ] } } 当任务类型为当任务类型为imsCopyImageInRegionJob，Region内复制镜像时，响应示例如下： { "job_id": "9a175ac892fa13420193001c2e62205a", "job_type": "imsCopyImageInRegionJob", "begin_time": "2024-11-06T06:14:27.168Z", "end_time": "2024-11-06T06:16:38.446Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "30e55148-deb9-4923-adb9-91618de16ba0" } } 当任务类型为imsCrossRegionCopyImageJob，跨Region复制镜像时，响应示例如下： { "job_id": "9a175ac792fa12d20193001f2a2c2641", "job_type": "imsCrossRegionCopyImageJob", "begin_time": "2024-11-06T06:17:42.699Z", "end_time": "2024-11-06T06:20:22.419Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "d998b96f-b7e3-4be9-b0c2-9773e592977d" } } 当任务类型为imsVolumesToSysDataImagesJob，数据盘创建数据盘镜像时，响应示例如下： { "job_id": "9a175ac792fa12d201930031febf2bdd", "job_type": "imsVolumesToSysDataImagesJob", "begin_time": "2024-11-06T06:38:16.765Z", "end_time": "2024-11-06T06:48:16.765Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "sub_jobs_result": [ { "job_id": "9a175ac792fa12d20193003205b22be1", "job_type": "imsCopyVolumeToImageJob", "begin_time": "2024-11-06T06:38:18.545Z", "end_time": "2024-11-06T06:48:16.765Z", "status": "SUCCESS", "error_code": null, "fail_reason": null, "entities": { "image_name": "test", "image_id": "bfb2de92-e7b9-4820-9522-416d8f2c812a" } } ], "sub_jobs_list": [ "9a175ac792fa12d20193003205b22be1" ] } }

响应消息 响应参数 根据job_type的取值不同，响应消息的结构会有所差异，更多响应示例请参见响应示例。 参数 参数类型 描述 status String 任务状态，目前取值如下： SUCCESS：表示该任务执行已经结束，任务执行成功。 FAIL：表示该任务执行已经结束，任务执行失败。 RUNNING：表示该任务正在执行。 INIT：表示该任务还未执行，正在初始化。 job_id String 任务ID。 job_type String 任务类型。 imsCreateImageByInstance：云服务器创建镜像 imsImportImageJob：外部镜像文件创建镜像 imsImportOvaImageJob：外部Ova镜像文件创建镜像 imsVolumeCreateImageJob：数据盘创建系统盘镜像 imsVolumesToSysDataImagesJob：数据盘创建数据盘镜像 imsImportDataImageJob：外部镜像文件创建数据盘镜像 imsCreateWholeImageByInstanceJob：云服务器创建整机镜像 imsCreateWholeImageByBackupJob：云备份或云服务器备份创建整机镜像 imsNativeImportImageJob：注册镜像 imsNativeExportImageJob：导出镜像 imsAddImageMembersJob：添加镜像成员 imsDelImageMembersJob：删除镜像成员 imsUpdateImageMembersJob：修改镜像成员 imsCopyImageInRegionJob：Region内复制镜像 imsCrossRegionCopyImageJob：跨Region复制镜像 begin_time String 任务开始执行时间。格式为UTC时间。 end_time String 任务结束时间。格式为UTC时间。 error_code String 错误码。 fail_reason String 失败原因。 entities Object 任务自定义属性。 任务正常时，返回镜像的ID；任务异常时，返回错误码和信息。 详情请参见表2。 表2 entities字段数据结构说明 参数 参数类型 描述 image_id String 镜像ID。 当job_type取值为以下任务类型时，会返回该参数。 imsCreateImageByInstance imsImportImageJob imsVolumeCreateImageJob imsImportDataImageJob imsCreateWholeImageByInstanceJob imsCreateWholeImageByBackupJob imsNativeImportImageJob imsNativeExportImageJob imsCopyImageInRegionJob imsCrossRegionCopyImageJob current_task String 当前任务名称。 image_name String 镜像名称。 process_percent Double 任务执行进度。 results Array of result objects 批量任务执行结果。详情请参见表3。 sub_jobs_result Array of objects 子任务执行结果。详情请参见表4。 sub_jobs_list Array of string 子任务id列表。 addition_error_code string 添加错误码 addition_error_msg string 添加错误消息 error_code string 错误码 error string 错误消息 alarm_code string 告警代码 表3 results字段数据结构说明 参数 参数类型 描述 image_id String 镜像ID。 当job_type取值为以下任务类型时，会返回该参数。 imsAddImageMembersJob imsUpdateImageMembersJob project_id String 项目ID。 status String 任务状态。 表4 sub_jobs_result字段数据结构说明 参数 参数类型 描述 status String 子任务状态，取值如下： SUCCESS：表示该任务执行已经结束，任务执行成功。 FAIL：表示该任务执行已经结束，任务执行失败。 RUNNING：表示该任务正在执行。 INIT：表示该任务还未执行，正在初始化。 job_id String 子任务ID。 job_type String 子任务类型。 begin_time String 子任务开始执行时间。格式为UTC时间。 end_time String 子任务结束时间。格式为UTC时间。 error_code String 错误码。 fail_reason String 失败原因。 entities Object 子任务自定义属性。详情请参见表5 任务正常时，返回镜像的ID。 任务异常时，返回错误码和信息。 表5 sub_jobs_result.entities字段数据结构说明 参数 参数类型 描述 image_id String 镜像ID。 当job_type取值为以下任务类型时，会返回该参数。 imsImportOvaImageJob imsVolumesToSysDataImagesJob image_name String 镜像名称。

URI PUT /v3/{project_id}/instances/{instance_id}/db-users/{db_user_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。标识实例的唯一标识。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 db_user_id 是 String 参数解释： 数据库用户ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字、中划线组成，且长度为36个字符的UUID。 默认取值： 不涉及。

请求示例 修改数据库用户为user。 PUT https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/da304cd5bbb944de828759bc7be3d3fein01/db-users/24c0c455-1f0e-448b-acb2-6e184b4ffcfa { "db_username" : "user", "db_user_password" : "password" }

响应示例 状态码： 200 { "metadata_locks" : [ { "thread_id" : "4096619", "lock_status" : "GRANTED", "lock_mode" : "MDL_SHARED_READ", "lock_type" : "Table metadata lock", "lock_duration" : "MDL_TRANSACTION", "table_schema" : "test_zyr", "table_name" : "test2", "user" : "root", "time" : "40", "host" : "das server", "database" : "test_zyr", "command" : "Sleep", "state" : "", "sql" : null, "trx_exec_time" : "341", "block_process" : [ ], "wait_process" : [ ] } ], "count" : 1 }