4.4 资源历史
4.4.1 查询资源历史
功能介绍
查询资源与资源关系的变更历史
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/resource-manager/domains/{domain_id}/resources/{resource_id}/history
表4-64 路径参数
参数 是否必选 参数类型 描述
domain_id 是 String 帐号ID
最大长度：36 resource_id 是 String 资源ID
最大长度：256
表4-65 Query 参数
参数 是否必选 参数类型 描述
marker 否 String 分页参数，通过上一个请求中返
回的marker信息作为输入，获 取当前页
最小长度：4 最大长度：400
limit 否 Integer 最大的返回数量
最小值：1 最大值：200
earlier_time 否 Long 指定查询范围的起始时间点，如 果不设置此参数，默认为最早的 时间
later_time 否 Long 指定查询范围的结束时间点，如
果不设置此参数，默认为当前时 间
chronological
_order 否 String 指定返回数据的时间顺序，默认
为倒序
请求参数
无
响应参数
状态码： 200
表4-66 响应 Body 参数
参数 参数类型 描述
items Array of HistoryItem objects
资源历史列表
page_info PageInfo
object 分页对象
表4-67 HistoryItem
参数 参数类型 描述
domain_id String 用户id
参数 参数类型 描述 resource_id String 资源id resource_type String 资源类型
capture_time String 该资源在RMS系统捕获时间 status String 资源状态
relations Array of ResourceRela tion objects
资源关系列表
resource ResourceEnti
ty object 资源对象
表4-68 ResourceRelation
参数 参数类型 描述
relation_type String 关系类型 from_resource
_type String 源资源类型
to_resource_ty
pe String 目的资源类型
from_resource
_id String 源资源ID
to_resource_id String 目的资源ID
表4-69 ResourceEntity
参数 参数类型 描述
id String 资源id
name String 资源名称
provider String 云服务名称
type String 资源类型
region_id String 区域id
project_id String Openstack中的项目id project_name String Openstack中的项目名称 ep_id String 企业项目id
参数 参数类型 描述
ep_name String 企业项目名称 checksum String 资源详情校验码 created String 资源创建时间 updated String 资源更新时间 provisioning_s
tate String 资源操作状态
tags Map<String,St
ring> 资源Tag properties Map<String,O
bject> 资源详细属性
表4-70 PageInfo
参数 参数类型 描述
current_count Integer 当前页的资源数量 最小值：0
最大值：200 next_marker String 下一页的marker
状态码： 400
表4-71 响应 Body 参数
参数 参数类型 描述
error_code String 错误码 error_msg String 错误消息内容
状态码： 403
表4-72 响应 Body 参数
参数 参数类型 描述
error_code String 错误码 error_msg String 错误消息内容
状态码： 500
表4-73 响应 Body 参数
参数 参数类型 描述
error_code String 错误码 error_msg String 错误消息内容
请求示例
GET /v1/resource-manager/domains/{domain_id}/resources/{resource_id}/history?
earlier_time=1595865600000&later_time=1603875761000&limit=10
响应示例
状态码： 200 操作成功
● 示例 1
[ { "domain_id" : "9548dff51b6849fab3d7353d631158ee", "resource_id" : "6af96128-d58d-426c-91e0-b38144c0f112", "resource_type" : "ecs.cloudservers",
"capture_time" : "2020-10-12T07:44:40.167Z", "status" : "ResourceChanged.UPDATE", "relations" : [ {
"relation_type" : "contains",
"from_resource_type" : "ecs.cloudservers", "to_resource_type" : "vpc.publicips",
"from_resource_id" : "6af96128-d58d-426c-91e0-b38144c0f112", "to_resource_id" : "3813d6d3-ef88-47b1-b343-cdf6390c6dcb"
}, {
"relation_type" : "isAttachedTo",
"from_resource_type" : "ecs.cloudservers", "to_resource_type" : "evs.volumes",
"from_resource_id" : "6af96128-d58d-426c-91e0-b38144c0f112", "to_resource_id" : "0075ed19-59dd-49be-961d-117bb6fbfd3e"
}, {
"relation_type" : "isAssociatedWith", "from_resource_type" : "ecs.cloudservers", "to_resource_type" : "vpc.securityGroups",
"from_resource_id" : "6af96128-d58d-426c-91e0-b38144c0f112", "to_resource_id" : "8cca3002-00af-4812-a853-b7a6fbee06a4"
}, {
"relation_type" : "isAttachedTo",
"from_resource_type" : "ecs.cloudservers", "to_resource_type" : "evs.volumes",
"from_resource_id" : "6af96128-d58d-426c-91e0-b38144c0f112", "to_resource_id" : "f4a107eb-4c6d-4dc8-88d8-de337923956f"
}, {
"relation_type" : "isContainedIn", "from_resource_type" : "ecs.cloudservers", "to_resource_type" : "vpc.vpcs",
"from_resource_id" : "6af96128-d58d-426c-91e0-b38144c0f112", "to_resource_id" : "ff13d70d-17e5-4ec8-945a-c874e0db99d3"
} ],
"resource" : {
"id" : "6af96128-d58d-426c-91e0-b38144c0f112", "name" : "david-test-cce-49831-bh9ax",
"provider" : "ecs",
"type" : "cloudservers", "region_id" : "cn-north-6",
"project_id" : "15caceb7599f4ee3a770dbb70ad69b2b", "project_name" : "cn-north-6",
"ep_id" : "0",
"ep_name" : "default",
"checksum" : "30482e7e4f2fc6e9842689c5d498cd13862def3c7369e9216af87c2198557b28", "created" : "2020-10-12T07:44:10Z",
"updated" : "2020-10-12T07:44:38Z", "provisioning_state" : "Succeeded", "tags" : {
"CCE-Dynamic-Provisioning-Node" : "80fbd7d5-0c5e-11eb-bc0e-0255ac101e85"
},
"properties" : { "accessIpv4" : "",
"hostName" : "david-test-cce-49831-bh9ax", "addresses" : [ {
"OsExtIpsType" : "fixed",
"OsExtIpsPortId" : "a7bfdd6f-3a56-4bbb-b37e-1b9ccac1ac96", "addr" : "192.168.238.230",
"version" : 4,
"OsExtIpsMacAddr" : "fa:16:3e:99:ec:b1"
} ] },
"accessIpv6" : "", "metadata" : { "chargingMode" : "0", "meteringImageType" : "gold",
"imageName" : "CCE_images_EulerOS-Node-CCE20.7.1.B003-v1.17.9-r0-amd64-f8389e5c3d65dc7b5bf8f10924d2fc16e35588fc-20200808144721",
"meteringImageId" : "e8b32b27-a103-4a1f-b955-5d6be46ae9da", "meteringResourcesPerCode" : "si3.large.2.linux",
"vpcId" : "ff13d70d-17e5-4ec8-945a-c874e0db99d3", "osBit" : "64"
},
"OsExtStsVmState" : "active", "configDrive" : "",
"OsExtStsPowerState" : 1,
"hostId" : "7f007da24f79bc37782d3440e3d4faa374c0eb555c1dfc98b687c996", "securityGroup" : [ {
"name" : "david-test-cce-cce-node-8x31o", "id" : "8cca3002-00af-4812-a853-b7a6fbee06a4"
} ],
"ExtVolumesAttached" : [ { "bootIndex" : "0",
"id" : "f4a107eb-4c6d-4dc8-88d8-de337923956f", "device" : "/dev/vda"
}, {
"bootIndex" : "-1",
"id" : "0075ed19-59dd-49be-961d-117bb6fbfd3e", "device" : "/dev/vdb"
} ],
"userId" : "07729a673f8026624f3ec006f3b3cda9", "flavor" : {
"OsDcfDiskConfig" : "MANUAL", "hostStatus" : "UP",
"OsSrvUsgLaunchedAt" : "2020-10-12T07:44:23.000000", "OsExtAz" : "cn-north-6a",
"progress" : 0, "locked" : false, "OS-EXT-SRV-ATTR" : {
"hostName" : "david-test-cce-49831-bh9ax", "kernelId" : "",
"ramdiskId" : "",
"reservationId" : "r-l8y8evjo",
"instanceName" : "instance-000b2c2d", "host" : "cn-north-6a-pod01.cn-north-6", "rootDeviceName" : "/dev/vda", "hypervisorHostName" : "nova001@83", "launchIndex" : 0
},
"status" : "ACTIVE"
}} ]
● 示例 2
{ "current_count" : 1, "next_marker" :
"CAESJjE2MDI0ODg2Nzc1NDYtNWY4NDA5NjU4YmI5MDUxZDBhMWEzMmJjGgQCXWaw"
}
状态码
状态码 描述
200 操作成功
400 输入参数不合法
403 用户认证失败
500 服务器内部错误
错误码
请参见错误码。