调用ListDiscoveredResources获取资源列表信息_配置审计(CloudConfig)-阿里云帮助中心

获取当前账号下跨地域聚合的资源列表信息。

接口说明

使用限制

因为配置审计仅支持部分阿里云服务和资源类型，所以资源清单中只展示部分资源。关于配置审计支持的云服务及资源类型，请参见配置审计支持的资源类型和资源关系。

使用说明

本文将提供一个示例，查询当前账号下的资源列表。返回结果显示，资源列表中的所有资源共 8 个。

调试

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

调试

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
config:ListDiscoveredResources	list	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
ResourceId	string	否	资源 ID。	eni-hp31cqoba96jagtz****
ResourceDeleted	integer	否	资源状态。取值： 0：已删除。如果您已在目标云产品中删除某个资源，则在配置审计的资源列表中显示该资源为已删除。 1（默认值）：保有中。如果您的资源被正常管理，则在配置审计的资源列表中显示该资源为保有中。	1
MaxResults	integer	是	单次请求返回结果的最大条数。取值范围：1~100。	10
ResourceTypes	string	否	资源类型。多个资源类型之间用半角逗号（,）分隔。	ACS::ECS::NetworkInterface
Regions	string	否	资源归属的地域 ID。多个地域 ID 之间用半角逗号（,）分隔。	cn-hangzhou
NextToken	string	否	当请求的返回结果被截断时，您可以使用`NextToken`再次发起请求，获取从当前截断位置之后的内容。	IWBjqMYSy0is7zSMGu16****
StartUpdateTimestamp	long	否	资源时间范围查询的开始时间，采用标准 UTC 时间戳。取值限制：必须是毫秒时间戳。不能大于 EndUpdateTimestamp，且与 EndUpdateTimestamp 间隔范围小于等于 30 天。 StartUpdateTimestamp 与 EndUpdateTimestamp 必须同时填写或同时不填写。	1722441600000
EndUpdateTimestamp	long	否	资源时间范围查询的截止时间，采用标准 UTC 时间戳。取值限制：必须是毫秒时间戳。不能小于 StartUpdateTimestamp，且与 StartUpdateTimestamp 间隔范围小于等于 30 天。 StartUpdateTimestamp 与 EndUpdateTimestamp 必须同时填写或同时不填写。	1724947200000
ExcludeResourceTypes	string	否	排除的资源类型，多资源类型用逗号分隔，与 ResourceTypes 字段冲突时，该字段具有更高优先级。	ACS::ECS::Instance,ACS::ECS::NetworkInterface

关于公共请求参数的详情，请参见公共参数。

返回参数

名称	类型	描述	示例值
	object	无。
DiscoveredResourceProfiles	object	资源列表。
DiscoveredResourceProfileList	array<object>	资源列表详情。
DiscoveredResourceProfile	object	无。
AccountId	long	资源拥有者的阿里云账号 ID。	161259599160****
AvailabilityZone	string	可用区。	cn-hangzhou-h
Region	string	地域 ID。	cn-hangzhou
ResourceCreationTime	long	资源创建时间戳。单位：毫秒。	1618675206000
ResourceDeleted	integer	资源状态。取值： 0：已删除。 1：保有中。	1
ResourceId	string	资源 ID。	eni-hp31cqoba96jagtz****
ResourceName	string	资源名称。	Cloud Firewall
ResourceStatus	string	资源状态。资源的状态取决于各云服务对其的定义，该参数可能为空。例如：当资源类型为 ACS::ECS::Instance 时，由于 ECS 实例有状态，因此该参数为 Running 或 Stopped。当资源类型为 ACS::OSS::Bucket 时，由于 OSS Bucket 无状态，因此该参数为空。	InUse
ResourceType	string	资源类型。	ACS::ECS::NetworkInterface
Tags	string	资源标签。	{\"key1\":[\"value2\"]}
UpdateTime	long	资源的最近一次更新时间，毫秒级时间戳。	1722441600000
Version	long	资源变更的版本。	1
MaxResults	integer	每页的最大记录数。	10
NextToken	string	查询下一页使用的 Token。	IWBjqMYSy0is7zSMGu16****
TotalCount	integer	资源总数。	8
RequestId	string	请求 ID。	C7817373-78CB-4F9A-8AFA-E7A88E9D64A2

示例

正常返回示例

JSON格式

{
  "DiscoveredResourceProfiles": {
    "DiscoveredResourceProfileList": [
      {
        "AccountId": 0,
        "AvailabilityZone": "cn-hangzhou-h",
        "Region": "cn-hangzhou",
        "ResourceCreationTime": 1618675206000,
        "ResourceDeleted": 1,
        "ResourceId": "eni-hp31cqoba96jagtz****",
        "ResourceName": "Cloud Firewall",
        "ResourceStatus": "InUse",
        "ResourceType": "ACS::ECS::NetworkInterface",
        "Tags": "{\\\"key1\\\":[\\\"value2\\\"]}",
        "UpdateTime": 1722441600000,
        "Version": 1
      }
    ],
    "MaxResults": 10,
    "NextToken": "IWBjqMYSy0is7zSMGu16****",
    "TotalCount": 8
  },
  "RequestId": "C7817373-78CB-4F9A-8AFA-E7A88E9D64A2"
}

错误码

HTTP status code	错误码	错误信息	描述
400	NoPermission	You are not authorized to perform this operation.	您无权执行此操作。
400	MemberNotBelongToMaster	The specified member does not belong to your organization.	-
404	AccountNotExisted	Your account does not exist.	-
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	服务不可用。

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