DescribeCloudCenterInstances_云安全中心_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

您可以通过资产的实例 ID、实例名称、所属 VPC ID、地域、公网 IP 地址等条件搜索资产,还可以通过设置不同搜索条件之间的逻辑关系搜索符合多个搜索条件的资产。

流控信息

请求速率为20/1(s)。更多流控信息,请前往配额中心查看

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
yundun-sas:DescribeCloudCenterInstances
Get
Asset
acs:yundun-sas:{#regionId}:{#accountId}:asset/*

请求参数

字段名称字段详情
deprecatedRegionIdstring

要查询的实例所在地域的 ID。

示例值:cn-hangzhou参考取值来源:
    ListCloudVendorRegions
    GetSwitchRegionDetail
Criteriastring

设置搜索资产的条件。该参数 JSON 格式,输入参数时注意大小写。展开详情

示例值:[{"name":"riskStatus","value":"YES"},{"name":"internetIp","value":"1.2.XX.XX"}]参考取值来源:
    DescribeCriteria
    GetCloudAssetCriteria
MachineTypesstring

要查询的资产的类型。取值:展开详情

示例值:ecs
LogicalExpstring

设置多个搜索条件间生效的逻辑关系。默认 OR,取值:展开详情

示例值:OR
PageSizeinteger<int32>

设置分页查询时,每页显示的资产的数量。默认值为 20,表示每页显示 20 条资产信息。

示例值:100
CurrentPageinteger<int32>

设置从返回结果的第几页开始显示查询结果。默认值为 1,表示从第 1 页开始显示。

示例值:1
Importanceinteger<int32>

设置资产重要性。取值:展开详情

示例值:2
NoGroupTraceboolean

默认分组未分组是否要做国际化处理。默认 false,取值:展开详情

示例值:false
Langstring

设置请求和接收消息的语言类型,默认为 zh。取值:展开详情

示例值:zh参考取值来源:
    GetUserLang
UseNextTokenboolean

是否使用 NextToken 方式拉取资产列表数据。如果使用此参数 TotalCount 不再返回。取值:展开详情

示例值:false
NextTokenstring

使用 NextToken 方式下返回的 NextToken 值。第一次拉取传空。

示例值:E17B501887A2D3AA5E8360A6EFA3B***
ResourceDirectoryAccountIdinteger<int64>

资源目录成员账号主账号 ID。展开详情

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:1232428423234****
Flagsstring

资产厂商。多个资产厂商之间使用半角逗号(,)分隔。取值:展开详情

示例值:1,2,3

返回参数

字段名称字段详情
Successboolean

接口调用的结果状态。取值:展开详情

示例值:true
RequestIdstring

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

示例值:32A73759-4C0F-4801-BE98-901223ACEE9A
PageInfoobject

页面显示信息。

Instancesarray<object>

资产详细信息列表。

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
NoPermission
no permission诊断
400
RdCheckNoPermission
Resource directory account verification has no permission.诊断
403
NoPermission
caller has no permission诊断
500
ServerError
ServerError诊断
500
RdCheckInnerError
Resource directory account service internal error.诊断

变更历史

变更时间变更内容概要操作
2025-02-26
变更返回参数
2025-01-02
变更返回参数
2024-12-27
变更返回参数
2024-08-01
新增请求参数Flags
变更返回参数
2023-07-20
变更错误码400
变更错误码500
新增请求参数ResourceDirectoryAccountId
2023-07-04
新增请求参数UseNextToken
新增请求参数NextToken
变更返回参数

相关示例

通过设置搜索条件查询符合条件的资产信息,例如通过资产实例名称、资产实例所属区域等条件搜索指定资产
2022-01-10