ListResourceCategories - 获取资源分类列表_数据灾备中心(BDRC)-阿里云帮助中心

获取资源分类列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

bdrc:ListResourceCategories

none

*全部资源

*

无

请求语法

GET /api/v1/resource-categories/list HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
MaxResults	integer	否	本次请求所返回的最大记录条数	10
NextToken	string	否	分页游标，如果有下一页，则该字段有返回值。说明该参数只要返回数据，则说明还有下一页。您可以将返回的 NextToken 作为请求参数再次获得下一页的数据，直到返回为 Null，表示获取到了所有的数据。	cae**********699
ResourceCategoryId	string	否		rc-123****7890

返回参数

名称	类型	描述	示例值
	object	BaseResponse<ListResult>
Data	object	返回数据
Content	array	本次请求所返回的记录集合
	object
ResourceCategoryId	string	资源分类 id，全局唯一	rc-123***7890
ResourceCategoryName	string	资源名，namespace 内唯一	My***ResourceCategory
ResourceCategoryType	string	资源分类类型 (DEFAULT: 默认分组，由系统创建，禁止删除, CUSTOM: 自定义分组，允许删除)	CUSTOM
ProductType	string	适用的产品类型，为空时匹配全部产品	ecs
ResourceType	string	适用的资源类型，为空时匹配全部资源	ACS::ECS::Instance
ResourceMatcher	string	资源匹配器，为空时不匹配任何资源	{\"type\":\"BOOL\",\"operator\":\"AND\",\"values\":[{\"type\":\"TAG\",\"key\":\"createdBy\",\"operator\":\"EQUAL\",\"values\":[\"me\"]}]}
ResourceCount	array	各类型资源数量
	object
ResourceType	string	资源类型	ACS::ECS::Instance
Count	integer	各类型资源数量	1
NextToken	string	用来表示当前调用返回读取到的位置，空代表数据已经读取完毕	eKDyCM0zFQ5op7jVMWmNNA==
MaxResults	integer	本次请求所返回的最大记录条数	10
TotalCount	integer	本次请求条件下的数据总量，此参数为可选参数，默认可不返回	5
RequestId	string	请求的唯一标识	AE43C4CB-8074-5EBD-9806-8CA6D12800B1

示例

正常返回示例

JSON格式

{
  "Data": {
    "Content": [
      {
        "ResourceCategoryId": "rc-123***7890",
        "ResourceCategoryName": "My***ResourceCategory",
        "ResourceCategoryType": "CUSTOM",
        "ProductType": "ecs",
        "ResourceType": "ACS::ECS::Instance",
        "ResourceMatcher": "{\\\"type\\\":\\\"BOOL\\\",\\\"operator\\\":\\\"AND\\\",\\\"values\\\":[{\\\"type\\\":\\\"TAG\\\",\\\"key\\\":\\\"createdBy\\\",\\\"operator\\\":\\\"EQUAL\\\",\\\"values\\\":[\\\"me\\\"]}]}",
        "ResourceCount": [
          {
            "ResourceType": "ACS::ECS::Instance",
            "Count": 1
          }
        ]
      }
    ],
    "NextToken": "eKDyCM0zFQ5op7jVMWmNNA==",
    "MaxResults": 10,
    "TotalCount": 5
  },
  "RequestId": "AE43C4CB-8074-5EBD-9806-8CA6D12800B1"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。