获取云产品资产结构列表
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用前面加 * 表示。
- 对于不支持资源级授权的操作,用
全部资源表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| yundun-sas:ListCloudAssetSchemas | list | *全部资源 * |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| PageSize | integer | 否 | 分页查询时,每页显示的白名单规则数量。默认值为 10,表示每页显示 10 条白名单规则。 | 10 |
| CurrentPage | integer | 否 | 分页查询时,设置当前页面的页码。默认值为 1。 | 1 |
| CloudAssetTypes | array<object> | 否 | 云资产的资产类型信息列表。 | |
| object | 否 | 云资产的资产类型信息。 | ||
| AssetType | integer | 否 | 资产的类型。取值:
| 0 |
| AssetSubType | integer | 否 | 云产品的子类型。 资产的类型-子类型。取值:
| 0 |
| Vendor | integer | 否 | 服务器厂商。取值:
| 0 |
| DataNames | array | 否 | 资产数据名称列表。 | |
| string | 否 | 资产数据名称。 | ACS_ECS_Disk | |
| AssociatedDataOnly | boolean | 否 | 是否过滤出可以关联其他资产的属性。 | true |
| Lang | string | 否 | 请求和接收消息的语言类型,默认值 zh。取值:
| zh |
返回参数
示例
正常返回示例
JSON格式
{
"Success": true,
"RequestId": "F8B6F758-BCD4-597A-8A2C-DA5A552C****",
"PageInfo": {
"CurrentPage": 1,
"PageSize": 10,
"TotalCount": 54,
"Count": 10
},
"CloudAssetSchemas": [
{
"DataName": "ACS_ECS_Disk",
"Vendor": 0,
"AssetType": 0,
"AssetSubType": 1,
"Properties": "[{\\\"associatedData\\\":[{\\\"assetSubType\\\":100,\\\"assetType\\\":0,\\\"dataName\\\":\\\"ACS_ECS_Instance\\\",\\\"properties\\\":[{\\\"name\\\":\\\"InstanceId\\\",\\\"path\\\":\\\"InstanceId\\\"}],\\\"vendor\\\":0}],\\\"description\\\":\\\"The ID of the instance to which the disk is attached.\\\",\\\"example\\\":\\\"i-bp67acfmxazb4q****\\\",\\\"name\\\":\\\"InstanceId\\\",\\\"type\\\":\\\"STRING\\\",\\\"withAssociatedData\\\":true},{\\\"description\\\":\\\"Disk name\\\",\\\"example\\\":\\\"testDiskName\\\",\\\"name\\\":\\\"DiskName\\\",\\\"type\\\":\\\"STRING\\\"},{\\\"description\\\":\\\"Only encrypted disks\\\",\\\"example\\\":\\\"false\\\",\\\"name\\\":\\\"Encrypted\\\",\\\"type\\\":\\\"BOOLEAN\\\"},{\\\"description\\\":\\\"Disk status\\\",\\\"example\\\":\\\"In_use\\\",\\\"name\\\":\\\"Status\\\",\\\"type\\\":\\\"STRING\\\"},{\\\"description\\\":\\\"Disk category\\\",\\\"example\\\":\\\"cloud_ssd\\\",\\\"name\\\":\\\"Category\\\",\\\"type\\\":\\\"STRING\\\"},{\\\"description\\\":\\\"Disk type\\\",\\\"example\\\":\\\"system\\\",\\\"name\\\":\\\"Type\\\",\\\"type\\\":\\\"STRING\\\"},{\\\"description\\\":\\\"Specifies whether to set an automatic snapshot policy for the disk.\\\",\\\"example\\\":\\\"false\\\",\\\"name\\\":\\\"EnableAutomatedSnapshotPolicy\\\",\\\"type\\\":\\\"BOOLEAN\\\"},{\\\"description\\\":\\\"The ID of the automatic snapshot policy.\\\",\\\"example\\\":\\\"sp-bp67acfmxazb4p****\\\",\\\"name\\\":\\\"AutoSnapshotPolicyId\\\",\\\"type\\\":\\\"STRING\\\"},{\\\"description\\\":\\\"Disk, local disk, or elastic ephemeral disk ID\\\",\\\"example\\\":\\\"d-bp18um4r4f2fve24****\\\",\\\"name\\\":\\\"DiskId\\\",\\\"type\\\":\\\"STRING\\\"}]"
}
]
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | AccountIdNotExist | AccountId not exist | 账户不存在,请检查您的账户信息是否正确。 |
| 400 | NoPermission | no permission | 无此服务的访问权限。 |
| 403 | NoPermission | caller has no permission | 当前操作未被授权,请联系主账号在RAM控制台进行授权后再执行操作。 |
| 500 | ServerError | ServerError | 服务故障,请稍后重试! |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2025-11-19 | 新增 OpenAPI | 查看变更详情 |
