查询用户在云厂商中的资源
功能介绍
查询用户在云厂商中的资源。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1/multicloud-resources
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
vendor |
是 |
String |
参数解释: 厂商信息。 约束限制: 不涉及。 取值范围:
默认取值: 不涉及。 |
type |
否 |
String |
参数解释: 资源类型。 约束限制: 不涉及。 取值范围: 资源类型较多,根据实际业务选择资源类型、常用资源类型如下:
默认取值: 不涉及。 |
limit |
是 |
Integer |
参数解释: 分页查询每页显示的条目数量。 约束限制: 不涉及。 取值范围: 自定义,在1-500范围。 默认取值: 不涉及。 |
offset |
否 |
String |
参数解释: 分页查询偏移量,表示从此偏移量开始查询。 约束限制: 不涉及。 取值范围: 0-2147483647。 默认取值: 0。 |
resource_id_list |
否 |
Array of strings |
参数解释: 云广商下资源id组成的列表。 约束限制: 不涉及。 取值范围: 资源id列表,最大值100。 默认取值: 不涉及。 |
name_list |
否 |
Array of strings |
参数解释: 云广商下的资源名称组成的列表。 约束限制: 不涉及。 取值范围: 列表,最大值100。 默认取值: 不涉及。 |
region_id_list |
否 |
Array of strings |
参数解释: 云广商下的区域id组成的列表。 约束限制: 不涉及。 取值范围: 区域id列表,最大值100。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
data |
Array of data objects |
多云资源列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
参数解释: CloudCMDB分配的uuid。 取值范围: 不涉及。 |
resource_id |
String |
参数解释: 在云厂商上存的资源id。 取值范围: 不涉及。 |
name |
String |
参数解释: 资源名称。 取值范围: 不涉及。 |
vendor |
String |
参数解释: 厂商。 取值范围:
|
type |
String |
参数解释: 资源类型。 取值范围: 不涉及。 |
datasource |
String |
参数解释: 云厂商账户id。 取值范围: 不涉及。 |
region_id |
String |
参数解释: 区域id。 取值范围: 不涉及。 |
properties |
Map<String,Object> |
参数解释: 资源详细属性。 取值范围: 不涉及。 |
create_time |
String |
参数解释: 资源创建时间。 取值范围: 不涉及。 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释: 错误码。 取值范围: 长度8~36之间。 |
error_msg |
String |
参数解释: 错误描述。 取值范围: 长度2~512之间。 |
请求示例
查询用户在云厂商中的资源。
GET https://{Endpoint} /v1/multicloud-resources?vendor=ALI&limit=10&offset=0&type=ACS::VPC::RouteTable
响应示例
状态码:200
查询资源信息成功。
{ "data" : [ { "id" : "67f62e99a9f251796893d83a", "resource_id" : "8bbaa2e3-5e70-47f5-ba86-60a2829e34fd", "name" : "ali-1-勿删", "vendor" : "ALI", "type" : "ACS::ECS::Instance", "datasource" : "1719089422411430", "region_id" : "cn-hangzhou", "zone_id" : "", "agent_id" : "74130352f93141efa4c10ae1a1d0f14a", "agent_state" : "FAILED", "inner_ip" : "192.168.1.140", "properties" : { "ip_addresses" : [ "192.168.1.140" ], "tags" : [ ] }, "ingest_properties" : { "vpc_id" : null }, "is_associate_group" : null, "associated_group_list" : null, "create_time" : "2025-04-09T08:11:00.000+00:00" }, { "id" : "67f62e99a9f251796893d82a", "resource_id" : "e31a3ac6-2515-4954-96cd-538f749449bd", "name" : "ecs-2-勿删", "vendor" : "ALI", "type" : "ACS::ECS::Instance", "datasource" : "1719089422411430", "region_id" : "cn-hangzhou", "zone_id" : "", "agent_id" : "a89925d906d44a2184f7756f060bef5c", "agent_state" : "ONLINE", "inner_ip" : "192.168.1.177", "properties" : { "ip_addresses" : [ "192.168.1.177" ], "tags" : [ ] }, "ingest_properties" : { "vpc_id" : "02b3d1ce-ae7e-4be6-9444-288bfe12e620" }, "is_associate_group" : null, "associated_group_list" : null, "create_time" : "2025-04-09T03:18:00.000+00:00" } ] }
状态码
状态码 |
描述 |
---|---|
200 |
查询资源信息成功。 |
400 |
查询资源信息失败。 |
错误码
请参见错误码。