GetResourceCategory - 获取单个资源分类_数据灾备中心(BDRC)-阿里云帮助中心

获取单个资源分类。

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
bdrc:GetResourceCategory	get	全部资源 ``	无	无

请求语法

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

请求参数

名称	类型	必填	描述	示例值
ResourceCategoryId	string	是	资源分类 ID	rc-123***7890

返回参数

名称	类型	描述	示例值
	object	BaseResponse<ListResult>
Data	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>	各类型资源数量
ResourceCount	object
ResourceType	string	资源类型	ACS::ECS::Instance
Count	long	各类型资源数量	1
RequestId	string	请求的唯一标识	AE43C4CB-8074-5EBD-9806-8CA6D12800B1

示例

正常返回示例

JSON格式

{
  "Data": {
    "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
      }
    ]
  },
  "RequestId": "AE43C4CB-8074-5EBD-9806-8CA6D12800B1"
}

错误码

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