通过标签过滤查询备份策略

功能介绍

通过标签过滤查询备份策略。

URI

• URI格式

  POST /v2/{project_id}/backuppolicy/resource_instances/action

• 参数说明

  参数	是否必选	描述
  project_id	是	项目ID

请求

• 参数说明

  参数	是否必选	参数类型	描述
  tags	否	list<dict>	包含标签，标签的个数最多10个。
  key	是	string	键，标签之间的键不能重复。
  values	是	list<string>	值的集合，最多10个，且不能重复。
  tags_any	否	list<dict>	包含任一标签 tags不允许为空列表。 tags中最多包含10个key。 tags中key不允许重复。 结果返回包含任一标签的资源列表，key之间是或的关系，key-value结构中value是或的关系。
  key	是	string	键。
  values	是	list<string>	值的集合。
  not_tags	否	list<dict>	不包含标签 tags不允许为空列表。 tags中最多包含10个key。 tags中key不允许重复。 结果返回不包含所有标签的资源列表，key之间是与的关系，key-value结构中value是或的关系。
  key	是	string	键。
  values	是	list<string>	值的集合。
  not_tags_any	否	list<dict>	不包含任一标签 tags不允许为空列表。 tags中最多包含10个key。 tags中key不允许重复。 结果返回不包含任一标签的资源列表，key之间是或的关系，key-value结构张value是或的关系。
  key	是	string	键。
  values	是	list<string>	值的集合。
  matches	否	list<dict>	搜索条件，支持模糊搜索。
  key	是	string	搜索的字段名，目前只支持"resource_name"。
  value	是	string	搜索的值。
  limit	否	string	查询记录数（action为count时无此参数）如果action为filter默认为1000，limit最多为1000，不能为负数，最小值为1。
  offset	否	string	索引位置，偏移量（action为count时无此参数）从第一条数据偏移offset条数据后开始查询，如果action为filter默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。
  action	是	string	取值如下： "filter"：过滤查询 "count"：查询总数

• 请求示例

  {
    "limit": "10",
    "offset": "0",
    "tags":
        [
          {
             "key": "Tag001",
             "values":["Value001","Value002"]
           }
         ],
    "action":"filter"
  }

响应

• 要素说明

  参数	参数类型	描述
  total_count	integer	资源总数。
  resources	list<dict>	资源列表。
  resource_id	string	资源ID。
  resouce_detail	object	资源详情，用于扩展。
  resource_name	string	资源名称。
  tags	list<dict>	标签信息列表。
  key	string	键。
  value	string	值。
  message	string	出现错误时，返回的错误消息。
  code	string	出现错误时，返回的错误码。 错误码的具体含义请参考错误码。

• 响应样例

  {
    "total_count":10,
    "resources":[
      {
        "resource_name": "name",
        "resource_id": "0781095c-b8ab-4ce5-99f3-4c5f6ff75319",
        "resource_detail": null,
        "tags": [{
            "key":"key",
            "value":"value"
         }]
      }
    ]
  }

  或

  {
      "error": {
          "message": "XXXX",
          "code": "XXX"
      }
  }

状态码

• 正常

  200

• 异常

  状态码	说明
  400 Bad Request	服务器未能处理请求。
  401 Unauthorized	被请求的页面需要用户名和密码。
  403 Forbidden	对被请求页面的访问被禁止。
  404 Not Found	服务器无法找到被请求的页面。
  405 Method Not Allowed	请求中指定的方法不被允许。
  406 Not Acceptable	服务器生成的响应无法被客户端所接受。
  407 Proxy Authentication Required	用户必须首先使用代理服务器进行验证，这样请求才会被处理。
  408 Request Timeout	请求超出了服务器的等待时间。
  409 Conflict	由于冲突，请求无法被完成。
  500 Internal Server Error	请求未完成。服务异常。
  501 Not Implemented	请求未完成。服务器不支持所请求的功能。
  502 Bad Gateway	请求未完成。服务器从上游服务器收到一个无效的响应。
  503 Service Unavailable	请求未完成。系统暂时异常。
  504 Gateway Timeout	网关超时。

错误码

请参考错误码。