云服务器内容精选

华为云首页用户手册

VPC资源标签管理

虚拟私有云 VPC-查询VPC资源实例:响应示例

响应示例 action为filter { "resources": [ { "resource_detail": null, "resource_id": "cdfs_cefs_wesas_12_dsad", "resource_name": "resouece1", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value1" } ] } ], "total_count": 1000} action为count { "total_count": 1000}

虚拟私有云 VPC VPC资源标签管理
虚拟私有云 VPC-查询VPC资源实例:请求参数

请求参数表2 请求参数参数名称类型是否必选说明 tags Array of tag objects 否包含标签，最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。 limit Integer 否查询记录数（action为count时无此参数）如果action为filter默认为1000，limit最多为1000，不能为负数，最小值为1 offset Integer 否（索引位置），从offset指定的下一条数据开始查询。查询第一页数据时，不需要传入此参数，查询后续页码数据时，将查询前一页数据时响应体中的值带入此参数（action为count时无此参数）如果action为filter默认为0，必须为数字，不能为负数 action String 是操作标识（仅限于filter，count）：filter（过滤），count(查询总条数) 如果是filter就是分页查询，如果是count只需按照条件将总条数返回即可。 matches Array of match objects 否搜索字段，key为要匹配的字段，当前仅支持resource_name。value为匹配的值。此字段为固定字典值。表3 tag字段数据结构说明名称是否必选参数类型说明 key 是 String 键。最大长度128个unicode字符。 key不能为空。(搜索时不对此参数做校验) values 是 Array of strings 值列表。每个值最大长度255个unicode字符，如果values为空列表，则表示any_value。 value之间为或的关系：能查到匹配任意一个value的资源，如，资源A有val1的tag，B有val2的tag，用values={val1,val2}能过滤查询到资源A和B。表4 match字段数据结构说明名称是否必选参数类型说明 key 是 String 键。当前仅限定为resource_name value 是 String 值。每个值最大长度255个unicode字符。

虚拟私有云 VPC VPC资源标签管理
虚拟私有云 VPC-查询VPC资源实例:请求示例

请求示例过滤查询VPC资源实例，action为filter，从第1条数据开始查询，单次查询最多返回100条，用matches和tags过滤查询。 POST https://{Endpoint}/v2.0/{project_id}/vpcs/resource_instances/action{ "offset": "0", "limit": "100", "action": "filter", "matches": [ { "key": "resource_name", "value": "resource1" } ], "tags": [ { "key": "key1", "values": [ "value1", "value2" ] } ]} 过滤计数VPC资源实例，action为count，用matches和tags过滤计数。 POST https://{Endpoint}/v2.0/{project_id}/vpcs/resource_instances/action{ "action": "count", "tags": [ { "key": "key1", "values": [ "value1", "value2" ] }, { "key": "key2", "values": [ "value1", "value2" ] } ], "matches": [ { "key": "resource_name", "value": "resource1" } ]}

虚拟私有云 VPC VPC资源标签管理
虚拟私有云 VPC-查询VPC资源实例:响应参数

响应参数表5 响应参数名称参数类型说明 resources Array of resource objects resource对象列表，请参见表6。 total_count Integer 总记录数表6 resource对象名称参数类型说明 resource_id String 资源ID resource_detail Object 资源详情。资源对象，用于扩展。默认为空 tags Array of tag objects 标签列表，没有标签默认为空数组，参见表7 resource_name String 资源名称，没有默认为空字符串表7 tag字段数据结构说明名称是否必选参数类型说明 key 是 String 键。最大长度128个unicode字符。 key不能为空。(搜索时不对此参数做校验) value 是 String 值列表。每个值最大长度255个unicode字符，如果values为空列表，则表示any_value。 value之间为或的关系：能查到匹配任意一个value的资源，如，资源A有val1的tag，B有val2的tag，用values={val1,val2}能过滤查询到资源A和B。

虚拟私有云 VPC VPC资源标签管理