ListResourceCategories - 获取资源分类列表

更新时间:2025-01-03 02:19:01

获取资源分类列表。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
操作访问级别资源类型条件关键字关联操作
bdrc:ListResourceCategoriesnone
*全部资源
*

请求语法

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

请求参数

名称类型必填描述示例值
名称类型必填描述示例值
MaxResultsinteger

本次请求所返回的最大记录条数

10
NextTokenstring

分页游标,如果有下一页,则该字段有返回值。说明 该参数只要返回数据,则说明还有下一页。您可以将返回的 NextToken 作为请求参数再次获得下一页的数据,直到返回为 Null,表示获取到了所有的数据。

cae**********699

返回参数

名称类型描述示例值
名称类型描述示例值
object

BaseResponse<ListResult>

Dataobject

返回数据

Contentarray<object>

本次请求所返回的记录集合

Contentobject
ResourceCategoryIdstring

资源分类 id,全局唯一

rc-123***7890
ResourceCategoryNamestring

资源名,namespace 内唯一

My***ResourceCategory
ResourceCategoryTypestring

资源分类类型 (DEFAULT: 默认分组,由系统创建,禁止删除, CUSTOM: 自定义分组,允许删除)

CUSTOM
ProductTypestring

适用的产品类型,为空时匹配全部产品

ecs
ResourceTypestring

适用的资源类型,为空时匹配全部资源

ACS::ECS::Instance
ResourceMatcherstring

资源匹配器,为空时不匹配任何资源

{\"type\":\"BOOL\",\"operator\":\"AND\",\"values\":[{\"type\":\"TAG\",\"key\":\"createdBy\",\"operator\":\"EQUAL\",\"values\":[\"me\"]}]}
ResourceCountarray<object>

各类型资源数量

ResourceCountobject
ResourceTypestring

资源类型

ACS::ECS::Instance
Countlong

各类型资源数量

1
NextTokenstring

用来表示当前调用返回读取到的位置,空代表数据已经读取完毕

eKDyCM0zFQ5op7jVMWmNNA==
MaxResultsinteger

本次请求所返回的最大记录条数

10
TotalCountlong

本次请求条件下的数据总量,此参数为可选参数,默认可不返回

5
RequestIdstring

请求的唯一标识

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"
}

错误码

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

  • 本页导读
  • 调试
  • 授权信息
  • 请求语法
  • 请求参数
  • 返回参数
  • 示例
  • 错误码
AI助理

点击开启售前

在线咨询服务

你好,我是AI助理

可以解答问题、推荐解决方案等