文档首页/ 安全云脑 SecMaster/ API参考/ 安全云脑 API V1/ 资产管理/ 更新资产信息 - ChangeResource

更新时间：2026-02-05 GMT+08:00

在线调试

CLI示例

查看PDF

更新资产信息 - ChangeResource

功能介绍

编辑资产，根据实际修改的属性更新，未修改的列不更新

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

PUT /v1/{project_id}/workspaces/{workspace_id}/sa/resources/{id}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取项目ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及
workspace_id	是	String	参数解释：工作空间id。约束限制：不涉及取值范围：不涉及默认取值：不涉及
id	是	String	资产的唯一标识id

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Language	是	String	参数解释：语言，参考值：zh-cn、en-us 约束限制：不涉及取值范围： zh-cn：中文环境 en-us：英文环境默认取值：不涉及
X-Auth-Token	是	String	参数解释：用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。获取用户Token 约束限制：不涉及取值范围：不涉及默认取值：不涉及
content-type	是	String	参数解释：内容类型 application/json;charset=UTF-8 普通API请求的类型约束限制：不涉及取值范围： application/json;charset=UTF-8 默认取值：不涉及

表3 请求Body参数
参数	是否必选	参数类型	描述
data_object	是	ResourceDetail object	资产详情

表4 ResourceDetail
参数	是否必选	参数类型	描述
id	是	String	资产id
name	是	String	资产名称
provider	是	String	资产来源，云服务名称(云上)，线下机房（IDC）
type	是	String	资产类型, 比如ECS/VPC/EVS/IP/URL等
checksum	否	String	资产详情校验码。
created	否	String	资产创建时间。
provisioning_state	否	String	资产操作状态。
environment	是	ResourceEnvironment object	资产所属环境
department	否	Department object	资产所属部门
governance_user	否	GovernanceUser object	资产治理责任人
level	否	Integer	0: 测试 1：一般 2：关键资产
properties	是	Properties object	资产详细属性。

表5 ResourceEnvironment
参数	是否必选	参数类型	描述
vendor_type	是	String	环境供应商
domain_id	是	String	HWC special，资产归属
region_id	否	String	HWC special，全局服务"global"，资产归属
project_id	否	String	HWC special，全局服务默认null，资产归属
ep_id	否	String	HWC special，资产归属的企业项目id。
ep_name	否	String	HWC special，资产归属的企业项目名称。
vendor_name	是	String	OCA special，包含资产探针或资产提供商
idc_name	是	String	OCA special，线下机房名称
idc_id	否	String	OCA special，线下机房id

表6 Department
参数	是否必选	参数类型	描述
id	否	String	资产所属部门名称id，若不填写为default
name	否	String	资产所属部门名称

表7 GovernanceUser
参数	是否必选	参数类型	描述
type	否	String	资产治理责任人类型
name	否	String	资产治理责任人名称，为空则忽略，不存在则创建

表8 Properties
参数	是否必选	参数类型	描述
hwc_ecs	否	HwcEcs object	云弹性云服务器详情
hwc_eip	否	HwcEip object	云弹性公网IP
hwc_vpc	否	HwcVpc object	云虚拟私有云
hwc_subnet	否	HwcSubnet object	云子网
hwc_rds	否	HwcRds object	云关系型数据库
hwc_domain	否	HwcDomain object	云域名
website	否	Website object	网站
oca_ip	否	OcaIp object	云外资产IP

表9 HwcEcs
参数	是否必选	参数类型	描述
id	是	String	弹性云服务器ID，格式为UUID。
name	是	String	弹性云服务器名称。
protected_status	是	String	主机安全开启状态：OPEN \| CLOSE
description	是	String	弹性云服务器的描述信息。
status	是	String	弹性云服务器状态。取值范围： ACTIVE、BUILD、ERROR、HARD_REBOOT、MIGRATING、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、VERIFY_RESIZE、DELETED
locked	是	Boolean	弹性云服务器是否为锁定状态。 true：锁定 false：未锁定
enterprise_project_id	否	String	弹性云服务器所属的企业项目ID。
user_id	是	String	创建弹性云服务器的用户ID，格式为UUID。
project_id	是	String	弹性云服务器所属项目id，格式为UUID。
host_id	是	String	弹性云服务器所在主机的主机ID。
host_name	是	String	弹性云服务器所在主机的主机名称。
host_status	是	String	云服务器所在主机状态。 UP：服务正常 UNKNOWN：状态未知 DOWN：服务异常 MAINTENANCE：维护状态空字符串：弹性云服务器无主机信息
addresses	是	Array of HwcEcsAddress objects	弹性云服务器的网络属性。
security_groups	是	Array of HwcEcsSecurityGroup objects	弹性云服务器所属安全组列表。
availability_zone	是	String	弹性云服务器所在可用区名称。
flavor	否	HwcEcsFlavor object	弹性云服务器规格信息。
volumes_attached	是	Array of HwcEcsVolume objects	挂载到弹性云服务器上的磁盘。
metadata	是	HwcEcsMetadata object	弹性云服务器元数据。
updated	是	String	弹性云服务器最近一次更新时间，例如开机、关机、重启等操作。时间格式例如：2019-05-22T03:30:52Z
created	是	String	弹性云服务器创建时间。时间格式例如：2019-05-22T03:19:19Z
key_name	否	String	弹性云服务器使用的密钥对名称。
scheduler_hints	否	HwcEcsSchedulerHint object	弹性云服务器调度信息。
hypervisor	否	HwcEcsHypervisor object	虚拟化信息。

**表10** HwcEcsAddress
参数	是否必选	参数类型	描述
version	是	String	IP地址版本。 “4”：代表IPv4。 “6”：代表IPv6。
addr	是	String	IP地址。
type	是	String	IP地址类型。 fixed：代表私有IP地址。 floating：代表浮动IP地址
mac_addr	是	String	MAC地址。
port_id	是	String	IP地址对应的端口ID。
vpc_id	是	String	所属虚拟私有云的ID。

**表11** HwcEcsSecurityGroup
参数	是否必选	参数类型	描述
id	是	String	安全组ID。
name	否	String	安全组名称或者UUID。

**表12** HwcEcsFlavor
参数	是否必选	参数类型	描述
id	是	String	云服务器规格ID。
name	是	String	云服务器规格名称。
disk	否	String	该云服务器规格对应要求系统盘大小，0为不限制。
vcpus	否	String	该云服务器规格对应的CPU核数。
ram	否	String	该云服务器规格对应的内存大小，单位为MB。

**表13** HwcEcsVolume
参数	是否必选	参数类型	描述
id	是	String	磁盘ID，格式为UUID。
delete_on_termination	否	String	删除云服务器时是否一并删除该磁盘。 true：是 false：否
boot_index	否	String	云硬盘启动顺序。 0为系统盘。非0为数据盘。
device	否	String	云硬盘挂载盘符，即磁盘挂载点。

**表14** HwcEcsMetadata
参数	是否必选	参数类型	描述
image_id	否	String	云服务器操作系统对应的镜像ID。
image_type	否	String	镜像类型，目前支持：公共镜像（gold）私有镜像（private）共享镜像（shared）
image_name	否	String	云服务器操作系统对应的镜像名称。
os_bit	否	String	操作系统位数，一般取值为“32”或者“64”。
os_type	否	String	操作系统类型，取值为：Linux、Windows。
vpc_id	否	String	云服务器所属的虚拟私有云ID。
resource_spec_code	否	String	云服务器对应的资源规格。
resource_type	否	String	云服务器对应的资源类型。取值为“1”，代表资源类型为云服务器。
agency_name	否	String	委托的名称。委托是由租户管理员在统一身份认证服务（Identity and Access Management，IAM）上创建的，可以为弹性云服务器提供访问云服务器的临时凭证。

**表15** HwcEcsSchedulerHint
参数	是否必选	参数类型	描述
group	否	Array of strings	云服务器组ID，UUID格式。云服务器组的ID可以从控制台或者参考查询云服务器组列表获取。
tenancy	否	Array of strings	在指定的专属主机或者共享主机上创建弹性云服务器。参数值为shared或者dedicated。
dedicated_host_id	否	Array of strings	专属主机的ID。说明：专属主机的ID仅在tenancy为dedicated时生效。

**表16** HwcEcsHypervisor
参数	是否必选	参数类型	描述
hypervisor_type	否	String	虚拟化类型。
csd_hypervisor	否	String	预留属性。

**表17** HwcEip
参数	是否必选	参数类型	描述
id	是	String	弹性公网IP唯一标识
alias	是	String	弹性公网IP名称
protected_status	是	String	DDoss或CFW开启状态：OPEN \| CLOSE
project_id	是	String	项目ID
enterprise_project_id	是	String	企业项目ID。
ip_version	是	Integer	IP版本信息取值范围： 4：公网IP地址为public_ip_address地址 6：公网IP地址为public_ipv6_address地址
public_ip_address	否	String	弹性公网IP或者IPv6端口的地址
public_ipv6_address	否	String	IPv4时无此字段，IPv6时为申请到的弹性公网IP
publicip_pool_name	否	String	弹性公网IP的网络类型, 包括公共池类型，如5_bgp/5_sbgp...，和用户购买的专属池。
publicip_pool_id	否	String	公网IP所属网络的ID，publicip_pool_name对应的网络ID
status	是	String	弹性公网IP的状态取值范围： FREEZED：冻结 BIND_ERROR：绑定失败 BINDING：绑定中 PENDING_DELETE：释放中 PENDING_CREATE：创建中 NOTIFYING：创建中 NOTIFY_DELETE：释放中 PENDING_UPDATE：更新中 DOWN：未绑定 ACTIVE：绑定 ELB：绑定ELB VPN：绑定VPN ERROR：失败
description	否	String	弹性公网IP描述信息
tags	否	Array of strings	功能说明：用户标签。（默认不显示）
type	否	String	弹性公网IP类型枚举值： EIP DUALSTACK DUALSTACK_SUBNET
vnic	否	HwcEipVnic object	公网IP绑定实例有PORT时，PORT的相关信息
bandwidth	否	HwcEipBandwidth object	公网IP绑定带宽信息
lock_status	否	String	记录公网IP当前的冻结状态约束：metadata类型，标识欠费冻结、公安冻结取值范围： police locked
associate_instance_type	否	String	公网IP绑定的实例类型取值范围： PORT NATGW ELB ELBV1 VPN null
associate_instance_id	否	String	公网IP绑定的实例ID
allow_share_bandwidth_types	否	Array of strings	表示此publicip可以加入的共享带宽类型列表，如果为空列表，则表示该 publicip不能加入任何共享带宽约束：publicip只能加入到有该带宽类型的共享带宽中
created_at	否	String	资产创建UTC时间格式：yyyy-MM-ddTHH:mm:ssZ
updated_at	否	String	资产更新UTC时间格式：yyyy-MM-ddTHH:mm:ssZ
public_border_group	否	String	表示中心站点资产或者边缘站点资产取值范围： center、边缘站点名称约束：publicip只能绑定该字段相同的资产

**表18** HwcEipVnic
参数	是否必选	参数类型	描述
private_ip_address	否	String	私网IP地址
device_id	否	String	端口所属设备ID
device_owner	否	String	设备所属取值范围：合法设备所属 network:dhcp network:VIP_PORT network:router_interface_distributed network:router_centralized_snat 约束：不支持设置和更新,由系统自动维护
vpc_id	否	String	虚拟私有云ID
port_id	否	String	端口ID
port_profile	否	String	端口profile信息
mac	否	String	端口MAC地址
vtep	否	String	VTEP IP
vni	否	String	VXLAN ID
instance_id	否	String	端口所属实例ID,例如RDS实例ID
instance_type	否	String	端口所属实例类型,例如“RDS”

**表19** HwcEipBandwidth
参数	是否必选	参数类型	描述
id	否	String	带宽ID
size	否	Integer	带宽大小取值范围：默认5Mbit/s~2000Mbit/s
share_type	否	String	带宽类型，标识是否是共享带宽取值范围： PER：独享带宽 WHOLE：共享带宽约束：其中IPv6暂不支持WHOLE类型带宽。
name	否	String	带宽名称

**表20** HwcVpc
参数	是否必选	参数类型	描述
id	是	String	VPC对应的唯一标识
name	是	String	VPC对应的名称
description	否	String	VPC的描述信息
protected_status	是	String	CFW开启或安全组规则配置状态：OPEN \| CLOSE
cidr	否	String	VPC下可用子网的范围取值范围： 10.0.0.0/8~10.255.255.240/28 172.16.0.0/12 ~ 172.31.255.240/28 192.168.0.0/16 ~ 192.168.255.240/28 不指定cidr时，默认值为“” 约束：必须是ipv4 cidr格式，例如:192.168.0.0/16
extend_cidrs	否	Array of strings	VPC的扩展网段约束：目前只支持ipv4
status	是	String	VPC对应的状态取值范围： PENDING：创建中 ACTIVE：创建成功
project_id	是	String	VPC所属的项目ID
enterprise_project_id	否	String	VPC所属的企业项目ID。取值范围：最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。“0”表示默认企业项目。
created_at	是	String	VPC创建时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
updated_at	是	String	VPC更新时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
cloud_resources	否	Array of HwcVpcCloudResource objects	VPC关联资产类型和数量取值范围：目前只返回VPC关联的routetable和virsubnet。virsubnet数量为ipv4和ipv6子网总数。
tags	否	Array of Tag objects	VPC的标签信息，详情参见Tag对象取值范围：0-10个标签键值对

**表21** HwcVpcCloudResource
参数	是否必选	参数类型	描述
resource_type	否	String	资产类型
resource_count	否	Integer	资产数量

**表22** HwcSubnet
参数	是否必选	参数类型	描述
id	是	String	安全组对应的唯一标识
name	是	String	安全组名称
description	否	String	安全组的描述信息
project_id	是	String	安全组所属的项目ID
created_at	是	String	安全组创建时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
updated_at	是	String	安全组更新时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
enterprise_project_id	否	String	安全组所属的企业项目ID。取值范围：最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。“0”表示默认企业项目。
security_group_rules	否	Array of HwcSubnetSecurityGroupRule objects	安全组规则

**表23** HwcSubnetSecurityGroupRule
参数	是否必选	参数类型	描述
id	是	String	安全组规则对应的唯一标识取值范围：带“-”的标准UUID格式
description	否	String	安全组规则的描述信息
security_group_id	是	String	安全组规则所属的安全组ID
direction	是	String	安全组规则的出入控制方向取值范围： ingress 表示入方向 egress 表示出方向
protocol	是	String	协议类型取值范围：icmp、tcp、udp、icmpv6或IP协议号约束：为空表示支持所有协议。协议为icmpv6时，网络类型应该为IPv6；协议为icmp时，网络类型应该为IPv4
ethertype	是	String	IP地址协议类型取值范围：IPv4，IPv6 约束：不填默认值为IPv4
multiport	是	String	端口取值范围取值范围：支持和单端口(80)，连续端口(1-30)以及不连续端口(22,3389,80)
action	是	String	安全组规则生效策略取值范围： allow表示允许 deny表示拒绝约束：默认值为deny
priority	是	Integer	优先级取值范围：1~100，1代表最高优先级
remote_group_id	否	String	远端安全组ID，表示该安全组内的流量允许或拒绝取值范围：租户下存在的安全组ID 约束：与remote_ip_prefix，remote_address_group_id功能互斥
remote_ip_prefix	否	String	远端IP地址，当direction是egress时，为虚拟机访问端的地址当direction是ingress时，为访问虚拟机的地址取值范围：IP地址，或者cidr格式约束：与remote_group_id、remote_address_group_id互斥
remote_address_group_id	否	String	远端地址组ID 取值范围：租户下存在的地址组ID 约束：与remote_ip_prefix，remote_group_id功能互斥
created_at	是	String	安全组规则创建时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
updated_at	是	String	安全组规则更新时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
project_id	是	String	安全组规则所属项目ID

**表24** HwcRds
参数	是否必选	参数类型	描述
id	是	String	实例ID。
name	是	String	创建的实例名称。
protected_status	是	String	DBSS开启状态：OPEN \| CLOSE
status	是	String	实例状态。取值：值为“BUILD”，表示实例正在创建。值为“ACTIVE”，表示实例正常。值为“FAILED”，表示实例异常。值为“FROZEN”，表示实例冻结。值为“MODIFYING”，表示实例正在扩容。值为“REBOOTING”，表示实例正在重启。值为“RESTORING”，表示实例正在恢复。值为“MODIFYING INSTANCE TYPE”，表示实例正在转主备。值为“SWITCHOVER”，表示实例正在主备切换。值为“MIGRATING”，表示实例正在迁移。值为“BACKING UP”，表示实例正在进行备份。值为“MODIFYING DATABASE PORT”，表示实例正在修改数据库端口。值为“STORAGE FULL”，表示实例磁盘空间满。
alias	否	String	实例的备注信息。
private_ips	否	Array of strings	实例内网IP地址列表。弹性云服务器创建成功后该值存在，其他情况下为空字符串。
private_dns_names	否	Array of strings	实例内网域名列表。实例创建成功后，需要手动申请内网域名，否则查询内网域名为空。
public_ips	否	Array of strings	实例外网IP地址列表。
port	是	Integer	数据库端口号。 RDS for MySQL数据库端口设置范围为1024～65535（其中12017和33071被RDS系统占用不可设置）。 RDS for PostgreSQL数据库端口修改范围为2100～9500。 RDS for SQL Server实例的端口设置范围为1433和2100~9500（其中5355和5985不可设置。对于2017 EE、2017 SE、2017 Web版，5050、5353和5986不可设置）。当不传该参数时，默认端口如下： RDS for MySQL默认3306。 RDS for PostgreSQL默认5432。 RDS for SQL Server默认1433。
enable_ssl	是	Boolean	实例开启SSL标志。取值为“true”：表示实例已开启SSL。取值为“false”：表示实例未开启SSL。
type	是	String	实例类型，取值为“Single”，“Ha”或“Replica”, "Enterprise"，分别对应于单机实例、主备实例、只读实例、分布式实例（企业版）。
ha	是	HwcRdsHa object	HA信息，获取HA实例时返回。
region	是	String	实例所在区域。
datastore	是	HwcRdsDatastore object	数据库信息。
created	是	String	创建时间，格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如偏移1个小时显示为+0100。说明：创建时返回值为空，数据库实例创建成功后该值不为空。
updated	否	String	更新时间，格式与“created”字段对应格式完全相同。说明：创建时返回值为空，数据库实例创建成功后该值不为空。
db_user_name	否	String	默认用户名。
vpc_id	是	String	虚拟私有云ID。
subnet_id	是	String	子网的网络ID信息。
security_group_id	是	String	安全组ID。
flavor_ref	是	String	规格码。
cpu	是	String	CPU大小。例如，1表示1U。
mem	是	String	内存大小（单位：GB）。
volume	是	HwcRdsVolume object	Volume信息。
tags	否	Array of Tag objects	标签列表，没有标签默认为空数组。
enterprise_project_id	否	String	企业项目标签ID。
project_id	是	String	项目ID
switch_strategy	是	String	数据库切换策略。取值为“reliability”或“availability”，分别对应于可靠性优先和可用性优先。
read_only_by_user	是	Boolean	用户设置的实例只读状态。仅支持RDS for MySQL引擎。 true，表示该实例被设置为只读状态。 false，表示该实例未被设置为只读状态。
backup_strategy	是	HwcRdsBackupStrategy object	备份策略。
maintenance_window	是	String	可维护时间窗，为UTC时间。
nodes	是	Array of HwcRdsNode objects	主备实例信息
related_instance	是	Array of HwcRdsRelatedInstance objects	所关联的数据库实例列表。
disk_encryption_id	否	String	磁盘加密密钥ID。
time_zone	是	String	时区。
backup_used_space	否	Double	备份空间使用量，单位GB。该字段仅用于查询指定RDS for SQL Server单个实例信息时返回。
storage_used_space	是	Double	磁盘空间使用量，单位GB。该字段仅用于查询指定RDS for SQL Server单个实例信息时返回。
associated_with_ddm	是	Boolean	是否已被DDM实例关联。
max_iops	是	Long	实例磁盘的最大IOPS值。当前该字段仅对于SQL Server引擎实例返回。
expiration_time	是	String	实例的到期时间，格式为“yyyy-mm-ddThh:mm:ssZ”。仅包周期场景返回。

**表25** HwcRdsHa
参数	是否必选	参数类型	描述
replication_mode	是	String	备机同步参数。取值：非空。 RDS for MySQL为“async”或“semisync”。 RDS for PostgreSQL为“async”或“sync”。 RDS for Microsoft SQL Server为“sync”。说明： “async”为异步模式。 “semisync”为半同步模式。 “sync”为同步模式。

**表26** HwcRdsDatastore
参数	是否必选	参数类型	描述
type	是	String	数据库引擎，不区分大小写： MySQL PostgreSQL SQLServer
version	是	String	数据库版本。
complete_version	否	String	数据库完整版本号。仅在数据库引擎是“PostgreSQL”时返回。

**表27** HwcRdsVolume
参数	是否必选	参数类型	描述
type	是	String	磁盘类型。
size	是	Integer	磁盘大小。

**表28** Tag
参数	是否必选	参数类型	描述
key	是	String	键。最大长度128个unicode字符。 key不能为空。(搜索时不对此参数做字符集校验)，key不能为空或者空字符串，不能为空格，校验和使用之前先trim 前后半角空格。
values	是	Array of strings	值列表。每个值最大长度255个unicode字符，校验和使用之前先trim 前后半角空格。 value可为空数组但不可缺省。如果values为空列表，则表示any_value（查询任意value）。value之间为或的关系。

**表29** HwcRdsBackupStrategy
参数	是否必选	参数类型	描述
start_time	否	String	备份时间段。自动备份将在该时间段内触发。当前时间指UTC时间。
keep_days	否	Integer	已生成的备份文件可以保存的天数。取值范围：0～732。为0时，表示未设置自动备份策略或备份策略已关闭。如果需要延长保留时间请联系客服人员申请，自动备份最长可以保留2562天。

**表30** HwcRdsNode
参数	是否必选	参数类型	描述
id	是	String	节点ID。
name	是	String	节点名称。
role	是	String	节点类型，取值为“master”、“slave”或“readreplica”，分别对应于主节点、备节点和只读节点。
status	是	String	节点状态。
availability_zone	是	String	可用区。

**表31** HwcRdsRelatedInstance
参数	是否必选	参数类型	描述
id	是	String	关联实例id。
type	是	String	关联实例类型。 “replica_of”对应于“主实例”。 “replica”对应于“只读实例”。

**表32** HwcDomain
参数	是否必选	参数类型	描述
domain_name	是	String	域名名称
expire_date	是	String	域名到期时间，eg：2023-01-10
status	是	String	域名服务状态
audit_status	是	String	域名实名认证状态。取值范围： NONAUDIT：未实名认证 SUCCEED：已实名认证 FAILED：实名认证失败 AUDITING：实名认证审核中
audit_unpass_reason	是	String	域名实名认证失败原因
transfer_status	否	String	过户状态
reg_type	是	String	注册类型取值范围： PERSONAL：个人 COMPANY：企业
privacy_protection	是	String	是否开启隐私保护
name_server	是	Array of strings	域名服务器列表
credential_type	是	String	证件类型
credential_id	是	String	证件号码
registrar	是	String	域名所属注册商
contact	是	Array of HwcDomainContact objects	联系人信息

**表33** HwcDomainContact
参数	是否必选	参数类型	描述
email	是	String	邮箱地址
register	是	String	域名所有者
contact_name	是	String	联系人
phone_num	是	String	联系电话
province	是	String	省份
city	是	String	城市
address	是	String	通讯地址
zip_code	是	String	邮编

**表34** Website
参数	是否必选	参数类型	描述
value	是	String	网站url
main_domain	是	String	主域名
protected_status	是	String	WAF开启状态：OPEN \| CLOSE
is_public	是	Boolean	外网或内网 true：外网 false: 内网
remark	否	String	网站备注
name_server	是	Array of strings	网站服务器列表
extend_properties	否	WebsiteExtendProperties object	其它属性

**表35** WebsiteExtendProperties
参数	是否必选	参数类型	描述
mac_addr	否	String	mac地址

**表36** OcaIp
参数	是否必选	参数类型	描述
value	是	String	资产值
version	是	String	资产类型： ipv4、ipv6
network	是	OcaIpNetwork object	网络信息
remark	否	String	资产备注
name	否	String	资产名称，默认为资产值
relative_value	否	String	相对值，如资产为ipv4，则为对应的ipv6
server_room	是	String	机房
server_rack	是	String	机柜
data_center	是	OcaIpDataCenter object	数据中心
mac_addr	否	String	mac地址
important	否	String	重要等级0 ：不重要 1：重要
extend_properties	否	OcaIpExtendProperties object	其它三方属性

**表37** OcaIpNetwork
参数	是否必选	参数类型	描述
is_public	是	Boolean	外网或内网 true：外网 false: 内网
partition	否	String	网络分区：OM/PSZ/DMZ
plane	否	String	网络平面（线下有自己的代号）
vxlan_id	否	String	虚拟网络ID

**表38** OcaIpDataCenter
参数	是否必选	参数类型	描述
latitude	否	Float	纬度
longitude	否	Float	经度
city_code	是	String	城市编码
country_code	是	String	国家编码

**表39** OcaIpExtendProperties
参数	是否必选	参数类型	描述
device	否	OcaIpDevice object	设备信息
system	否	OcaIpSystem object	系统信息
services	否	Array of OcaIpService objects	应用信息

**表40** OcaIpDevice
参数	是否必选	参数类型	描述
type	否	String	设备类型
model	否	String	设备型号
vendor	否	OcaIpVendor object	设备供应商

**表41** OcaIpSystem
参数	是否必选	参数类型	描述
family	否	String	系统类型
name	否	String	系统名称
version	否	String	系统版本
vendor	否	OcaIpVendor object	系统供应商

**表42** OcaIpService
参数	是否必选	参数类型	描述
port	否	Integer	应用对应端口
protocol	否	String	协议
name	否	String	应用名称
version	否	String	应用版本
vendor	否	OcaIpVendor object	应用供应商

**表43** OcaIpVendor
参数	是否必选	参数类型	描述
name	否	String	供应名称
is_xc	否	Boolean	供应商是否是国产

响应参数

状态码：200

**表44** 响应Body参数
参数	参数类型	描述
code	String	错误码
message	String	错误信息
data	ChangeResourceRequestBody object	资产详情

**表45** ChangeResourceRequestBody
参数	参数类型	描述
data_object	ResourceDetail object	资产详情

**表46** ResourceDetail
参数	参数类型	描述
id	String	资产id
name	String	资产名称
provider	String	资产来源，云服务名称(云上)，线下机房（IDC）
type	String	资产类型, 比如ECS/VPC/EVS/IP/URL等
checksum	String	资产详情校验码。
created	String	资产创建时间。
provisioning_state	String	资产操作状态。
environment	ResourceEnvironment object	资产所属环境
department	Department object	资产所属部门
governance_user	GovernanceUser object	资产治理责任人
level	Integer	0: 测试 1：一般 2：关键资产
properties	Properties object	资产详细属性。

**表47** ResourceEnvironment
参数	参数类型	描述
vendor_type	String	环境供应商
domain_id	String	HWC special，资产归属
region_id	String	HWC special，全局服务"global"，资产归属
project_id	String	HWC special，全局服务默认null，资产归属
ep_id	String	HWC special，资产归属的企业项目id。
ep_name	String	HWC special，资产归属的企业项目名称。
vendor_name	String	OCA special，包含资产探针或资产提供商
idc_name	String	OCA special，线下机房名称
idc_id	String	OCA special，线下机房id

**表48** Department
参数	参数类型	描述
id	String	资产所属部门名称id，若不填写为default
name	String	资产所属部门名称

**表49** GovernanceUser
参数	参数类型	描述
type	String	资产治理责任人类型
name	String	资产治理责任人名称，为空则忽略，不存在则创建

**表50** Properties
参数	参数类型	描述
hwc_ecs	HwcEcs object	云弹性云服务器详情
hwc_eip	HwcEip object	云弹性公网IP
hwc_vpc	HwcVpc object	云虚拟私有云
hwc_subnet	HwcSubnet object	云子网
hwc_rds	HwcRds object	云关系型数据库
hwc_domain	HwcDomain object	云域名
website	Website object	网站
oca_ip	OcaIp object	云外资产IP

**表51** HwcEcs
参数	参数类型	描述
id	String	弹性云服务器ID，格式为UUID。
name	String	弹性云服务器名称。
protected_status	String	主机安全开启状态：OPEN \| CLOSE
description	String	弹性云服务器的描述信息。
status	String	弹性云服务器状态。取值范围： ACTIVE、BUILD、ERROR、HARD_REBOOT、MIGRATING、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、VERIFY_RESIZE、DELETED
locked	Boolean	弹性云服务器是否为锁定状态。 true：锁定 false：未锁定
enterprise_project_id	String	弹性云服务器所属的企业项目ID。
user_id	String	创建弹性云服务器的用户ID，格式为UUID。
project_id	String	弹性云服务器所属项目id，格式为UUID。
host_id	String	弹性云服务器所在主机的主机ID。
host_name	String	弹性云服务器所在主机的主机名称。
host_status	String	云服务器所在主机状态。 UP：服务正常 UNKNOWN：状态未知 DOWN：服务异常 MAINTENANCE：维护状态空字符串：弹性云服务器无主机信息
addresses	Array of HwcEcsAddress objects	弹性云服务器的网络属性。
security_groups	Array of HwcEcsSecurityGroup objects	弹性云服务器所属安全组列表。
availability_zone	String	弹性云服务器所在可用区名称。
flavor	HwcEcsFlavor object	弹性云服务器规格信息。
volumes_attached	Array of HwcEcsVolume objects	挂载到弹性云服务器上的磁盘。
metadata	HwcEcsMetadata object	弹性云服务器元数据。
updated	String	弹性云服务器最近一次更新时间，例如开机、关机、重启等操作。时间格式例如：2019-05-22T03:30:52Z
created	String	弹性云服务器创建时间。时间格式例如：2019-05-22T03:19:19Z
key_name	String	弹性云服务器使用的密钥对名称。
scheduler_hints	HwcEcsSchedulerHint object	弹性云服务器调度信息。
hypervisor	HwcEcsHypervisor object	虚拟化信息。

**表52** HwcEcsAddress
参数	参数类型	描述
version	String	IP地址版本。 “4”：代表IPv4。 “6”：代表IPv6。
addr	String	IP地址。
type	String	IP地址类型。 fixed：代表私有IP地址。 floating：代表浮动IP地址
mac_addr	String	MAC地址。
port_id	String	IP地址对应的端口ID。
vpc_id	String	所属虚拟私有云的ID。

**表53** HwcEcsSecurityGroup
参数	参数类型	描述
id	String	安全组ID。
name	String	安全组名称或者UUID。

**表54** HwcEcsFlavor
参数	参数类型	描述
id	String	云服务器规格ID。
name	String	云服务器规格名称。
disk	String	该云服务器规格对应要求系统盘大小，0为不限制。
vcpus	String	该云服务器规格对应的CPU核数。
ram	String	该云服务器规格对应的内存大小，单位为MB。

**表55** HwcEcsVolume
参数	参数类型	描述
id	String	磁盘ID，格式为UUID。
delete_on_termination	String	删除云服务器时是否一并删除该磁盘。 true：是 false：否
boot_index	String	云硬盘启动顺序。 0为系统盘。非0为数据盘。
device	String	云硬盘挂载盘符，即磁盘挂载点。

**表56** HwcEcsMetadata
参数	参数类型	描述
image_id	String	云服务器操作系统对应的镜像ID。
image_type	String	镜像类型，目前支持：公共镜像（gold）私有镜像（private）共享镜像（shared）
image_name	String	云服务器操作系统对应的镜像名称。
os_bit	String	操作系统位数，一般取值为“32”或者“64”。
os_type	String	操作系统类型，取值为：Linux、Windows。
vpc_id	String	云服务器所属的虚拟私有云ID。
resource_spec_code	String	云服务器对应的资源规格。
resource_type	String	云服务器对应的资源类型。取值为“1”，代表资源类型为云服务器。
agency_name	String	委托的名称。委托是由租户管理员在统一身份认证服务（Identity and Access Management，IAM）上创建的，可以为弹性云服务器提供访问云服务器的临时凭证。

**表57** HwcEcsSchedulerHint
参数	参数类型	描述
group	Array of strings	云服务器组ID，UUID格式。云服务器组的ID可以从控制台或者参考查询云服务器组列表获取。
tenancy	Array of strings	在指定的专属主机或者共享主机上创建弹性云服务器。参数值为shared或者dedicated。
dedicated_host_id	Array of strings	专属主机的ID。说明：专属主机的ID仅在tenancy为dedicated时生效。

**表58** HwcEcsHypervisor
参数	参数类型	描述
hypervisor_type	String	虚拟化类型。
csd_hypervisor	String	预留属性。

**表59** HwcEip
参数	参数类型	描述
id	String	弹性公网IP唯一标识
alias	String	弹性公网IP名称
protected_status	String	DDoss或CFW开启状态：OPEN \| CLOSE
project_id	String	项目ID
enterprise_project_id	String	企业项目ID。
ip_version	Integer	IP版本信息取值范围： 4：公网IP地址为public_ip_address地址 6：公网IP地址为public_ipv6_address地址
public_ip_address	String	弹性公网IP或者IPv6端口的地址
public_ipv6_address	String	IPv4时无此字段，IPv6时为申请到的弹性公网IP
publicip_pool_name	String	弹性公网IP的网络类型, 包括公共池类型，如5_bgp/5_sbgp...，和用户购买的专属池。
publicip_pool_id	String	公网IP所属网络的ID，publicip_pool_name对应的网络ID
status	String	弹性公网IP的状态取值范围： FREEZED：冻结 BIND_ERROR：绑定失败 BINDING：绑定中 PENDING_DELETE：释放中 PENDING_CREATE：创建中 NOTIFYING：创建中 NOTIFY_DELETE：释放中 PENDING_UPDATE：更新中 DOWN：未绑定 ACTIVE：绑定 ELB：绑定ELB VPN：绑定VPN ERROR：失败
description	String	弹性公网IP描述信息
tags	Array of strings	功能说明：用户标签。（默认不显示）
type	String	弹性公网IP类型枚举值： EIP DUALSTACK DUALSTACK_SUBNET
vnic	HwcEipVnic object	公网IP绑定实例有PORT时，PORT的相关信息
bandwidth	HwcEipBandwidth object	公网IP绑定带宽信息
lock_status	String	记录公网IP当前的冻结状态约束：metadata类型，标识欠费冻结、公安冻结取值范围： police locked
associate_instance_type	String	公网IP绑定的实例类型取值范围： PORT NATGW ELB ELBV1 VPN null
associate_instance_id	String	公网IP绑定的实例ID
allow_share_bandwidth_types	Array of strings	表示此publicip可以加入的共享带宽类型列表，如果为空列表，则表示该 publicip不能加入任何共享带宽约束：publicip只能加入到有该带宽类型的共享带宽中
created_at	String	资产创建UTC时间格式：yyyy-MM-ddTHH:mm:ssZ
updated_at	String	资产更新UTC时间格式：yyyy-MM-ddTHH:mm:ssZ
public_border_group	String	表示中心站点资产或者边缘站点资产取值范围： center、边缘站点名称约束：publicip只能绑定该字段相同的资产

**表60** HwcEipVnic
参数	参数类型	描述
private_ip_address	String	私网IP地址
device_id	String	端口所属设备ID
device_owner	String	设备所属取值范围：合法设备所属 network:dhcp network:VIP_PORT network:router_interface_distributed network:router_centralized_snat 约束：不支持设置和更新,由系统自动维护
vpc_id	String	虚拟私有云ID
port_id	String	端口ID
port_profile	String	端口profile信息
mac	String	端口MAC地址
vtep	String	VTEP IP
vni	String	VXLAN ID
instance_id	String	端口所属实例ID,例如RDS实例ID
instance_type	String	端口所属实例类型,例如“RDS”

**表61** HwcEipBandwidth
参数	参数类型	描述
id	String	带宽ID
size	Integer	带宽大小取值范围：默认5Mbit/s~2000Mbit/s
share_type	String	带宽类型，标识是否是共享带宽取值范围： PER：独享带宽 WHOLE：共享带宽约束：其中IPv6暂不支持WHOLE类型带宽。
name	String	带宽名称

**表62** HwcVpc
参数	参数类型	描述
id	String	VPC对应的唯一标识
name	String	VPC对应的名称
description	String	VPC的描述信息
protected_status	String	CFW开启或安全组规则配置状态：OPEN \| CLOSE
cidr	String	VPC下可用子网的范围取值范围： 10.0.0.0/8~10.255.255.240/28 172.16.0.0/12 ~ 172.31.255.240/28 192.168.0.0/16 ~ 192.168.255.240/28 不指定cidr时，默认值为“” 约束：必须是ipv4 cidr格式，例如:192.168.0.0/16
extend_cidrs	Array of strings	VPC的扩展网段约束：目前只支持ipv4
status	String	VPC对应的状态取值范围： PENDING：创建中 ACTIVE：创建成功
project_id	String	VPC所属的项目ID
enterprise_project_id	String	VPC所属的企业项目ID。取值范围：最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。“0”表示默认企业项目。
created_at	String	VPC创建时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
updated_at	String	VPC更新时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
cloud_resources	Array of HwcVpcCloudResource objects	VPC关联资产类型和数量取值范围：目前只返回VPC关联的routetable和virsubnet。virsubnet数量为ipv4和ipv6子网总数。
tags	Array of Tag objects	VPC的标签信息，详情参见Tag对象取值范围：0-10个标签键值对

**表63** HwcVpcCloudResource
参数	参数类型	描述
resource_type	String	资产类型
resource_count	Integer	资产数量

**表64** HwcSubnet
参数	参数类型	描述
id	String	安全组对应的唯一标识
name	String	安全组名称
description	String	安全组的描述信息
project_id	String	安全组所属的项目ID
created_at	String	安全组创建时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
updated_at	String	安全组更新时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
enterprise_project_id	String	安全组所属的企业项目ID。取值范围：最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。“0”表示默认企业项目。
security_group_rules	Array of HwcSubnetSecurityGroupRule objects	安全组规则

**表65** HwcSubnetSecurityGroupRule
参数	参数类型	描述
id	String	安全组规则对应的唯一标识取值范围：带“-”的标准UUID格式
description	String	安全组规则的描述信息
security_group_id	String	安全组规则所属的安全组ID
direction	String	安全组规则的出入控制方向取值范围： ingress 表示入方向 egress 表示出方向
protocol	String	协议类型取值范围：icmp、tcp、udp、icmpv6或IP协议号约束：为空表示支持所有协议。协议为icmpv6时，网络类型应该为IPv6；协议为icmp时，网络类型应该为IPv4
ethertype	String	IP地址协议类型取值范围：IPv4，IPv6 约束：不填默认值为IPv4
multiport	String	端口取值范围取值范围：支持和单端口(80)，连续端口(1-30)以及不连续端口(22,3389,80)
action	String	安全组规则生效策略取值范围： allow表示允许 deny表示拒绝约束：默认值为deny
priority	Integer	优先级取值范围：1~100，1代表最高优先级
remote_group_id	String	远端安全组ID，表示该安全组内的流量允许或拒绝取值范围：租户下存在的安全组ID 约束：与remote_ip_prefix，remote_address_group_id功能互斥
remote_ip_prefix	String	远端IP地址，当direction是egress时，为虚拟机访问端的地址当direction是ingress时，为访问虚拟机的地址取值范围：IP地址，或者cidr格式约束：与remote_group_id、remote_address_group_id互斥
remote_address_group_id	String	远端地址组ID 取值范围：租户下存在的地址组ID 约束：与remote_ip_prefix，remote_group_id功能互斥
created_at	String	安全组规则创建时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
updated_at	String	安全组规则更新时间取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ss
project_id	String	安全组规则所属项目ID

**表66** HwcRds
参数	参数类型	描述
id	String	实例ID。
name	String	创建的实例名称。
protected_status	String	DBSS开启状态：OPEN \| CLOSE
status	String	实例状态。取值：值为“BUILD”，表示实例正在创建。值为“ACTIVE”，表示实例正常。值为“FAILED”，表示实例异常。值为“FROZEN”，表示实例冻结。值为“MODIFYING”，表示实例正在扩容。值为“REBOOTING”，表示实例正在重启。值为“RESTORING”，表示实例正在恢复。值为“MODIFYING INSTANCE TYPE”，表示实例正在转主备。值为“SWITCHOVER”，表示实例正在主备切换。值为“MIGRATING”，表示实例正在迁移。值为“BACKING UP”，表示实例正在进行备份。值为“MODIFYING DATABASE PORT”，表示实例正在修改数据库端口。值为“STORAGE FULL”，表示实例磁盘空间满。
alias	String	实例的备注信息。
private_ips	Array of strings	实例内网IP地址列表。弹性云服务器创建成功后该值存在，其他情况下为空字符串。
private_dns_names	Array of strings	实例内网域名列表。实例创建成功后，需要手动申请内网域名，否则查询内网域名为空。
public_ips	Array of strings	实例外网IP地址列表。
port	Integer	数据库端口号。 RDS for MySQL数据库端口设置范围为1024～65535（其中12017和33071被RDS系统占用不可设置）。 RDS for PostgreSQL数据库端口修改范围为2100～9500。 RDS for SQL Server实例的端口设置范围为1433和2100~9500（其中5355和5985不可设置。对于2017 EE、2017 SE、2017 Web版，5050、5353和5986不可设置）。当不传该参数时，默认端口如下： RDS for MySQL默认3306。 RDS for PostgreSQL默认5432。 RDS for SQL Server默认1433。
enable_ssl	Boolean	实例开启SSL标志。取值为“true”：表示实例已开启SSL。取值为“false”：表示实例未开启SSL。
type	String	实例类型，取值为“Single”，“Ha”或“Replica”, "Enterprise"，分别对应于单机实例、主备实例、只读实例、分布式实例（企业版）。
ha	HwcRdsHa object	HA信息，获取HA实例时返回。
region	String	实例所在区域。
datastore	HwcRdsDatastore object	数据库信息。
created	String	创建时间，格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如偏移1个小时显示为+0100。说明：创建时返回值为空，数据库实例创建成功后该值不为空。
updated	String	更新时间，格式与“created”字段对应格式完全相同。说明：创建时返回值为空，数据库实例创建成功后该值不为空。
db_user_name	String	默认用户名。
vpc_id	String	虚拟私有云ID。
subnet_id	String	子网的网络ID信息。
security_group_id	String	安全组ID。
flavor_ref	String	规格码。
cpu	String	CPU大小。例如，1表示1U。
mem	String	内存大小（单位：GB）。
volume	HwcRdsVolume object	Volume信息。
tags	Array of Tag objects	标签列表，没有标签默认为空数组。
enterprise_project_id	String	企业项目标签ID。
project_id	String	项目ID
switch_strategy	String	数据库切换策略。取值为“reliability”或“availability”，分别对应于可靠性优先和可用性优先。
read_only_by_user	Boolean	用户设置的实例只读状态。仅支持RDS for MySQL引擎。 true，表示该实例被设置为只读状态。 false，表示该实例未被设置为只读状态。
backup_strategy	HwcRdsBackupStrategy object	备份策略。
maintenance_window	String	可维护时间窗，为UTC时间。
nodes	Array of HwcRdsNode objects	主备实例信息
related_instance	Array of HwcRdsRelatedInstance objects	所关联的数据库实例列表。
disk_encryption_id	String	磁盘加密密钥ID。
time_zone	String	时区。
backup_used_space	Double	备份空间使用量，单位GB。该字段仅用于查询指定RDS for SQL Server单个实例信息时返回。
storage_used_space	Double	磁盘空间使用量，单位GB。该字段仅用于查询指定RDS for SQL Server单个实例信息时返回。
associated_with_ddm	Boolean	是否已被DDM实例关联。
max_iops	Long	实例磁盘的最大IOPS值。当前该字段仅对于SQL Server引擎实例返回。
expiration_time	String	实例的到期时间，格式为“yyyy-mm-ddThh:mm:ssZ”。仅包周期场景返回。

**表67** HwcRdsHa
参数	参数类型	描述
replication_mode	String	备机同步参数。取值：非空。 RDS for MySQL为“async”或“semisync”。 RDS for PostgreSQL为“async”或“sync”。 RDS for Microsoft SQL Server为“sync”。说明： “async”为异步模式。 “semisync”为半同步模式。 “sync”为同步模式。

**表68** HwcRdsDatastore
参数	参数类型	描述
type	String	数据库引擎，不区分大小写： MySQL PostgreSQL SQLServer
version	String	数据库版本。
complete_version	String	数据库完整版本号。仅在数据库引擎是“PostgreSQL”时返回。

**表69** HwcRdsVolume
参数	参数类型	描述
type	String	磁盘类型。
size	Integer	磁盘大小。

**表70** Tag
参数	参数类型	描述
key	String	键。最大长度128个unicode字符。 key不能为空。(搜索时不对此参数做字符集校验)，key不能为空或者空字符串，不能为空格，校验和使用之前先trim 前后半角空格。
values	Array of strings	值列表。每个值最大长度255个unicode字符，校验和使用之前先trim 前后半角空格。 value可为空数组但不可缺省。如果values为空列表，则表示any_value（查询任意value）。value之间为或的关系。

**表71** HwcRdsBackupStrategy
参数	参数类型	描述
start_time	String	备份时间段。自动备份将在该时间段内触发。当前时间指UTC时间。
keep_days	Integer	已生成的备份文件可以保存的天数。取值范围：0～732。为0时，表示未设置自动备份策略或备份策略已关闭。如果需要延长保留时间请联系客服人员申请，自动备份最长可以保留2562天。

**表72** HwcRdsNode
参数	参数类型	描述
id	String	节点ID。
name	String	节点名称。
role	String	节点类型，取值为“master”、“slave”或“readreplica”，分别对应于主节点、备节点和只读节点。
status	String	节点状态。
availability_zone	String	可用区。

**表73** HwcRdsRelatedInstance
参数	参数类型	描述
id	String	关联实例id。
type	String	关联实例类型。 “replica_of”对应于“主实例”。 “replica”对应于“只读实例”。

**表74** HwcDomain
参数	参数类型	描述
domain_name	String	域名名称
expire_date	String	域名到期时间，eg：2023-01-10
status	String	域名服务状态
audit_status	String	域名实名认证状态。取值范围： NONAUDIT：未实名认证 SUCCEED：已实名认证 FAILED：实名认证失败 AUDITING：实名认证审核中
audit_unpass_reason	String	域名实名认证失败原因
transfer_status	String	过户状态
reg_type	String	注册类型取值范围： PERSONAL：个人 COMPANY：企业
privacy_protection	String	是否开启隐私保护
name_server	Array of strings	域名服务器列表
credential_type	String	证件类型
credential_id	String	证件号码
registrar	String	域名所属注册商
contact	Array of HwcDomainContact objects	联系人信息

**表75** HwcDomainContact
参数	参数类型	描述
email	String	邮箱地址
register	String	域名所有者
contact_name	String	联系人
phone_num	String	联系电话
province	String	省份
city	String	城市
address	String	通讯地址
zip_code	String	邮编

**表76** Website
参数	参数类型	描述
value	String	网站url
main_domain	String	主域名
protected_status	String	WAF开启状态：OPEN \| CLOSE
is_public	Boolean	外网或内网 true：外网 false: 内网
remark	String	网站备注
name_server	Array of strings	网站服务器列表
extend_properties	WebsiteExtendProperties object	其它属性

**表77** WebsiteExtendProperties
参数	参数类型	描述
mac_addr	String	mac地址

**表78** OcaIp
参数	参数类型	描述
value	String	资产值
version	String	资产类型： ipv4、ipv6
network	OcaIpNetwork object	网络信息
remark	String	资产备注
name	String	资产名称，默认为资产值
relative_value	String	相对值，如资产为ipv4，则为对应的ipv6
server_room	String	机房
server_rack	String	机柜
data_center	OcaIpDataCenter object	数据中心
mac_addr	String	mac地址
important	String	重要等级0 ：不重要 1：重要
extend_properties	OcaIpExtendProperties object	其它三方属性

**表79** OcaIpNetwork
参数	参数类型	描述
is_public	Boolean	外网或内网 true：外网 false: 内网
partition	String	网络分区：OM/PSZ/DMZ
plane	String	网络平面（线下有自己的代号）
vxlan_id	String	虚拟网络ID

**表80** OcaIpDataCenter
参数	参数类型	描述
latitude	Float	纬度
longitude	Float	经度
city_code	String	城市编码
country_code	String	国家编码

**表81** OcaIpExtendProperties
参数	参数类型	描述
device	OcaIpDevice object	设备信息
system	OcaIpSystem object	系统信息
services	Array of OcaIpService objects	应用信息

**表82** OcaIpDevice
参数	参数类型	描述
type	String	设备类型
model	String	设备型号
vendor	OcaIpVendor object	设备供应商

**表83** OcaIpSystem
参数	参数类型	描述
family	String	系统类型
name	String	系统名称
version	String	系统版本
vendor	OcaIpVendor object	系统供应商

**表84** OcaIpService
参数	参数类型	描述
port	Integer	应用对应端口
protocol	String	协议
name	String	应用名称
version	String	应用版本
vendor	OcaIpVendor object	应用供应商

**表85** OcaIpVendor
参数	参数类型	描述
name	String	供应名称
is_xc	Boolean	供应商是否是国产

请求示例

https://{endpoint}/v1/{project_id}/workspaces/{workspace_id}/sa/resources/{id}

{
  "data_object" : {
    "id" : "OCAo*****23",
    "name" : "test**01",
    "provider" : "oca",
    "type" : "device",
    "checksum" : "a1b2*****90",
    "created" : "2025-10-14T14:39:07Z",
    "provisioning_state" : "Succeeded",
    "environment" : {
      "vendor_type" : "OCA",
      "domain_id" : "ac74*****f4",
      "region_id" : "region_a",
      "project_id" : "1564*****a6",
      "ep_id" : "0000*****00",
      "ep_name" : "default",
      "vendor_name" : "on**v2",
      "idc_name" : "Be**-A",
      "idc_id" : "id**01"
    },
    "governance_user" : {
      "name" : "li**om"
    },
    "level" : 1,
    "properties" : { }
  }
}

响应示例

状态码：200

资产更新返回对象

{
  "code" : "00000000",
  "message" : "",
  "data" : {
    "data_object" : {
      "id" : "OCAo*****55",
      "name" : "on-p*****00",
      "provider" : "oca",
      "type" : "device",
      "checksum" : "a1b2*****90",
      "created" : "2025-03-15T08:20:00Z",
      "provisioning_state" : "Succeeded",
      "environment" : {
        "vendor_type" : "OCA",
        "domain_id" : "ac74*****f4",
        "project_id" : "1564*****a6",
        "region_id" : "region_a",
        "ep_id" : "0000*****00",
        "ep_name" : "default",
        "vendor_name" : "on-p*****v3",
        "idc_name" : "Be**-A",
        "idc_id" : "id**01"
      },
      "governance_user" : {
        "name" : "li**om"
      },
      "level" : 1,
      "properties" : { }
    }
  }
}

SDK代码示例

SDK代码示例如下。

      
       
         
         
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.secmaster.v1.region.SecMasterRegion;
import com.huaweicloud.sdk.secmaster.v1.*;
import com.huaweicloud.sdk.secmaster.v1.model.*;

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;

public class ChangeResourceSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        SecMasterClient client = SecMasterClient.newBuilder()
                .withCredential(auth)
                .withRegion(SecMasterRegion.valueOf("<YOUR REGION>"))
                .build();
        ChangeResourceRequest request = new ChangeResourceRequest();
        request.withWorkspaceId("{workspace_id}");
        request.withId("{id}");
        ChangeResourceRequestBody body = new ChangeResourceRequestBody();
        GovernanceUser governanceUserDataObject = new GovernanceUser();
        governanceUserDataObject.withName("li**om");
        ResourceEnvironment environmentDataObject = new ResourceEnvironment();
        environmentDataObject.withVendorType("OCA")
            .withDomainId("ac74*****f4")
            .withRegionId("region_a")
            .withProjectId("1564*****a6")
            .withEpId("0000*****00")
            .withEpName("default")
            .withVendorName("on**v2")
            .withIdcName("Be**-A")
            .withIdcId("id**01");
        ResourceDetail dataObjectbody = new ResourceDetail();
        dataObjectbody.withId("OCAo*****23")
            .withName("test**01")
            .withProvider("oca")
            .withType("device")
            .withChecksum("a1b2*****90")
            .withCreated(LocalDate.parse("2025-10-14T14:39:07Z", DateTimeFormatter.ofPattern("yyyy-MM-dd")))
            .withProvisioningState("Succeeded")
            .withEnvironment(environmentDataObject)
            .withGovernanceUser(governanceUserDataObject)
            .withLevel(1);
        body.withDataObject(dataObjectbody);
        request.withBody(body);
        try {
            ChangeResourceResponse response = client.changeResource(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        

      
     

      
       
         
         
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdksecmaster.v1.region.secmaster_region import SecMasterRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdksecmaster.v1 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = SecMasterClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(SecMasterRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ChangeResourceRequest()
        request.workspace_id = "{workspace_id}"
        request.id = "{id}"
        governanceUserDataObject = GovernanceUser(
            name="li**om"
        )
        environmentDataObject = ResourceEnvironment(
            vendor_type="OCA",
            domain_id="ac74*****f4",
            region_id="region_a",
            project_id="1564*****a6",
            ep_id="0000*****00",
            ep_name="default",
            vendor_name="on**v2",
            idc_name="Be**-A",
            idc_id="id**01"
        )
        dataObjectbody = ResourceDetail(
            id="OCAo*****23",
            name="test**01",
            provider="oca",
            type="device",
            checksum="a1b2*****90",
            created="2025-10-14T14:39:07Z",
            provisioning_state="Succeeded",
            environment=environmentDataObject,
            governance_user=governanceUserDataObject,
            level=1
        )
        request.body = ChangeResourceRequestBody(
            data_object=dataObjectbody
        )
        response = client.change_resource(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        

      
     

      
       
         
         
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    secmaster "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/secmaster/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/secmaster/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/secmaster/v1/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := secmaster.NewSecMasterClient(
        secmaster.SecMasterClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ChangeResourceRequest{}
	request.WorkspaceId = "{workspace_id}"
	request.Id = "{id}"
	nameGovernanceUser:= "li**om"
	governanceUserDataObject := &model.GovernanceUser{
		Name: &nameGovernanceUser,
	}
	regionIdEnvironment:= "region_a"
	projectIdEnvironment:= "1564*****a6"
	epIdEnvironment:= "0000*****00"
	epNameEnvironment:= "default"
	idcIdEnvironment:= "id**01"
	environmentDataObject := &model.ResourceEnvironment{
		VendorType: "OCA",
		DomainId: "ac74*****f4",
		RegionId: &regionIdEnvironment,
		ProjectId: &projectIdEnvironment,
		EpId: &epIdEnvironment,
		EpName: &epNameEnvironment,
		VendorName: "on**v2",
		IdcName: "Be**-A",
		IdcId: &idcIdEnvironment,
	}
	checksumDataObject:= "a1b2*****90"
	createdDataObject:= "2025-10-14T14:39:07Z"
	provisioningStateDataObject:= "Succeeded"
	levelDataObject:= int32(1)
	dataObjectbody := &model.ResourceDetail{
		Id: "OCAo*****23",
		Name: "test**01",
		Provider: "oca",
		Type: "device",
		Checksum: &checksumDataObject,
		Created: &createdDataObject,
		ProvisioningState: &provisioningStateDataObject,
		Environment: environmentDataObject,
		GovernanceUser: governanceUserDataObject,
		Level: &levelDataObject,
	}
	request.Body = &model.ChangeResourceRequestBody{
		DataObject: dataObjectbody,
	}
	response, err := client.ChangeResource(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        

      
     

更多编程语言的SDK代码示例，请参见API Explorer的代码示例页签，可生成自动对应的SDK代码示例。

状态码

状态码	描述
200	资产更新返回对象

错误码

请参见错误码。

父主题：资产管理

上一篇：获取资产详情 - ShowResource

下一篇：导入资产 - ImportResource

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问