全部产品
Search

搜索本产品

    配置审计：ListDiscoveredResources - 获取资源列表信息

    文档中心

    配置审计：ListDiscoveredResources - 获取资源列表信息

    更新时间：Nov 07, 2024

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

    接口说明

    使用限制

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

    使用说明

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

    调试

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

    授权信息

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

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

    请求参数

    名称类型必填描述示例值
    ResourceIdstring否

    资源 ID。

    		eni-hp31cqoba96jagtz****
    ResourceDeletedinteger否

    资源状态。取值：

    • 0：已删除。如果您已在目标云产品中删除某个资源，则在配置审计的资源列表中显示该资源为已删除。
    • 1（默认值）：保有中。如果您的资源被正常管理，则在配置审计的资源列表中显示该资源为保有中。
    		1
    MaxResultsinteger是

    单次请求返回结果的最大条数。取值范围：1~100。

    		10
    ResourceTypesstring否

    资源类型。多个资源类型之间用半角逗号（,）分隔。

    		ACS::ECS::NetworkInterface
    Regionsstring否

    资源归属的地域 ID。多个地域 ID 之间用半角逗号（,）分隔。

    		cn-hangzhou
    NextTokenstring否

    当请求的返回结果被截断时，您可以使用NextToken再次发起请求，获取从当前截断位置之后的内容。

    		IWBjqMYSy0is7zSMGu16****
    StartUpdateTimestamplong否

    资源时间范围查询的开始时间，采用标准 UTC 时间戳。取值限制：

    • 必须是毫秒时间戳。
    • 不能大于 EndUpdateTimestamp，且与 EndUpdateTimestamp 间隔范围小于等于 30 天。
    • StartUpdateTimestamp 与 EndUpdateTimestamp 必须同时填写或同时不填写。
    		1722441600000
    EndUpdateTimestamplong否

    资源时间范围查询的截止时间，采用标准 UTC 时间戳。取值限制：

    • 必须是毫秒时间戳。
    • 不能小于 StartUpdateTimestamp，且与 StartUpdateTimestamp 间隔范围小于等于 30 天。
    • StartUpdateTimestamp 与 EndUpdateTimestamp 必须同时填写或同时不填写。
    		1724947200000
    ExcludeResourceTypesstring否

    排除的资源类型，多资源类型用逗号分隔，与 ResourceTypes 字段冲突时，该字段具有更高优先级。

    		ACS::ECS::Instance,ACS::ECS::NetworkInterface

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

    返回参数

    名称类型描述示例值
    object

    无。

    DiscoveredResourceProfilesobject

    资源列表。

    DiscoveredResourceProfileListarray<object>

    资源列表详情。

    DiscoveredResourceProfileobject

    无。

    AccountIdlong

    资源拥有者的阿里云账号 ID。

    		161259599160****
    AvailabilityZonestring

    可用区。

    		cn-hangzhou-h
    Regionstring

    地域 ID。

    		cn-hangzhou
    ResourceCreationTimelong

    资源创建时间戳。单位：毫秒。

    		1618675206000
    ResourceDeletedinteger

    资源状态。取值：

    • 0：已删除。
    • 1：保有中。
    		1
    ResourceIdstring

    资源 ID。

    		eni-hp31cqoba96jagtz****
    ResourceNamestring

    资源名称。

    		Cloud Firewall
    ResourceStatusstring

    资源状态。资源的状态取决于各云服务对其的定义，该参数可能为空。例如：

    • 当资源类型为 ACS::ECS::Instance 时，由于 ECS 实例有状态，因此该参数为 Running 或 Stopped。
    • 当资源类型为 ACS::OSS::Bucket 时，由于 OSS Bucket 无状态，因此该参数为空。
    		InUse
    ResourceTypestring

    资源类型。

    		ACS::ECS::NetworkInterface
    Tagsstring

    资源标签。

    		{\"key1\":[\"value2\"]}
    UpdateTimelong

    资源的最近一次更新时间，毫秒级时间戳。

    		1722441600000
    Versionlong

    资源变更的版本。

    		1
    MaxResultsinteger

    每页的最大记录数。

    		10
    NextTokenstring

    查询下一页使用的 Token。

    		IWBjqMYSy0is7zSMGu16****
    TotalCountinteger

    资源总数。

    		8
    RequestIdstring

    请求 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错误码错误信息描述
    400NoPermissionYou are not authorized to perform this operation.您无权执行此操作。
    400MemberNotBelongToMasterThe specified member does not belong to your organization.-
    404AccountNotExistedYour account does not exist.-
    503ServiceUnavailableThe request has failed due to a temporary failure of the server.服务不可用。

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