虚拟专用网络 VPN-查询资源实例列表:请求消息

时间:2025-02-12 15:09:46

请求消息

  • 请求参数
    表3 请求参数

    名称

    类型

    是否必选

    描述

    without_any_tag

    Boolean

    • 功能说明:该字段为true时查询所有不带标签的资源,此时忽略 “tags”字段。该字段为false或者未提供该参数时,该条件不生效,即返回所有资源或按"tags","matches"等条件过滤。

    tags

    Array of Tag objects

    • 功能说明:标签列表。
    • 约束:最多填写20个。

    matches

    Array of Match objects

    • 功能说明:搜索字段,包含key和value。key为要匹配的字段,如resource_name等。value为匹配的值。key为固定字典值。
    表4 Tag

    名称

    类型

    是否必选

    描述

    key

    String

    • 功能说明:标签的键。
    • 取值范围:1-128个字符。

    values

    Array of String

    • 功能说明:标签的值列表。如果values为空列表,则表示any_value。value之间为或的关系。
    • 取值范围:0-255个字符。
    • 约束:最多填写20个。
    表5 Match

    名称

    类型

    是否必选

    描述

    key

    String

    • 功能说明:匹配的键。
    • 取值范围:resource_name。

    value

    String

    • 功能说明:匹配的值。
    • 取值范围:0-255个字符。
  • 请求样例
    POST https://{Endpoint}/v5/{project_id}/{resource_type}/resource-instances/filter{    "tags": [{            "key": "key1",            "values": [                "value1",                "value2"            ]        },        {            "key": "key2",            "values": [                "value1",                "value2"            ]        }    ],    "matches": [{        "key": "resource_name",        "value": "resource1"    }],    "without_any_tag": "false"}
support.huaweicloud.com/api-vpn/vpn_api_0061.html