全部產品
Search

搜尋本產品

    Cloud Config：GetAggregateResourceConfigurationTimeline - 查詢帳號組資源配置變更歷史

    文件中心

    Cloud Config：GetAggregateResourceConfigurationTimeline - 查詢帳號組資源配置變更歷史

    更新時間：Oct 10, 2025

    查詢指定帳號組內指定資源的配置變更歷史。配置審計記錄資源的每一次配置變更和資源關係變更，並整理為配置變更歷史。您開通配置審計服務後，配置審計開始記錄資源的配置變更和資源關係變更歷史，並預設儲存10年。

    介面說明

    配置審計為您提供每個監控範圍內資源的配置變更歷史，具體如下：

    • 對於您開通配置審計服務時已保有的資源，配置變更歷史的起點是服務開通時間。

    • 對於您開通配置審計服務後建立的資源，配置變更歷史的起點是資源建立時間。配置審計每 10 分鐘記錄一次資源的配置變更。當資源的配置變更時，會在配置變更歷史出現一個節點，顯示該時間點的資源配置詳情、變更詳情，以及該變更涉及的操作事件。

    本文將提供一個樣本，查詢帳號組ca-5885626622af0008****內的成員帳號100931896542****的地區cn-hangzhou中資源new-bucket（儲存空間）的配置變更歷史。返回結果顯示，資源的配置變更歷史為1624961112000（北京時間：2021-06-29 18:05:12）。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    config:GetAggregateResourceConfigurationTimeline

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ResourceId

    string

    是

    資源 ID。

    關於如何擷取資源 ID，請參見 ListAggregateDiscoveredResources 。

    new-bucket
    StartTime

    integer

    否

    開始時間戳。預設查詢發起調用前 30 天的時間。單位：毫秒。

    1623211156000
    EndTime

    integer

    否

    結束時間戳記。預設查詢發起調用時的時間。單位：毫秒。

    1625821156000
    MaxResults

    integer

    否

    單次請求返回結果的最大條數。取值範圍：1~100。

    10
    ResourceType

    string

    是

    資源類型。

    關於如何擷取資源類型，請參見 ListAggregateDiscoveredResources 。

    ACS::OSS::Bucket
    Region

    string

    是

    資源歸屬的地區 ID。

    關於如何擷取資源歸屬的地區 ID，請參見 ListAggregateDiscoveredResources 。

    cn-hangzhou
    AggregatorId

    string

    是

    帳號組 ID。

    關於如何擷取帳號組 ID，請參見 ListAggregators 。

    ca-5885626622af0008****
    NextToken

    string

    否

    當請求的返回結果被截斷時，您可以使用NextToken再次發起請求，擷取從當前截斷位置之後的內容。

    IWBjqMYSy0is7zSMGu16****
    ResourceAccountId

    integer

    否

    必填，帳號組內待查詢資源所屬的阿里雲帳號 ID。

    100931896542****

    關於公用請求參數的詳情，請參見公用參數。

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    ED9CD1B3-286C-4E05-A765-5E1E0B9BC2AB
    ResourceConfigurationTimeline

    object

    資源配置變更歷史。

    NextToken

    string

    查詢下一頁使用的 Token。

    IWBjqMYSy0is7zSMGu16****
    MaxResults

    integer

    單次請求返回結果的最大條數。

    10
    ConfigurationList

    array<object>

    資源配置變更歷史列表。

    object

    無。

    Tags

    string

    資源標籤。

    {\"\"hc\"\":[\"\"value2\"\"]}
    AccountId

    integer

    資源歸屬的阿里雲帳號 ID。

    100931896542****
    ResourceEventType

    string

    資源變更事件的類型。取值：

    • DISCOVERED：配置審計新發現的資源事件。

    • DISCOVERED_REVISED：配置審計新發現的通過周期訂正任務產生的資源事件。

    • MODIFY：修改資源事件。

    • MODIFY_REVISED：通過周期訂正任務產生的修改資源事件。

    • REMOVE：刪除資源事件。

    說明

    • 配置審計為了保障資源完整，通過周期訂正任務對資料進行周期性對齊，產生新發現資源事件，該事件發生的頻率較低。

    • 通過周期訂正任務產生資源事件的時間為任務發現時間，該時間晚於資源的實際變更時間。

    DISCOVERED
    AvailabilityZone

    string

    可用性區域。

    cn-hangzhou-h
    ResourceType

    string

    資源類型。

    ACS::OSS::Bucket
    ResourceCreateTime

    string

    建立資源的時間戳記。單位：毫秒。

    1624961112000
    Region

    string

    地區 ID。

    cn-hangzhou
    CaptureTime

    string

    記錄資源變更快照的時間戳記。單位：毫秒。

    1624961156000
    ConfigurationDiff

    string

    觸發本次評估的資源變更細節。

    {\"AccessControlList\":[null,{\"Grant\":\"private\"}],\"ServerSideEncryptionRule\":[null,{\"SSEAlgorithm\":\"None\"}],\"CreationDate\":[null,\"2021-06-29T10:05:12.000Z\"],\"Owner\":[null,{\"DisplayName\":\"100931896542****\",\"ID\":\"100931896542****\"}],\"BucketPolicy\":[null,{\"LogPrefix\":\"\",\"LogBucket\":\"\"}],\"StorageClass\":[null,\"Standard\"],\"ExtranetEndpoint\":[null,\"oss-cn-hangzhou.aliyuncs.com\"],\"DataRedundancyType\":[null,\"LRS\"],\"AllowEmptyReferer\":[null,\"true\"],\"IntranetEndpoint\":[null,\"oss-cn-hangzhou-internal.aliyuncs.com\"],\"Name\":[null,\"new-bucket\"],\"Location\":[null,\"oss-cn-hangzhou\"]}
    ResourceId

    string

    資源 ID。

    new-bucket
    ResourceName

    string

    資源名稱。

    new-bucket

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "ED9CD1B3-286C-4E05-A765-5E1E0B9BC2AB",
  "ResourceConfigurationTimeline": {
    "NextToken": "IWBjqMYSy0is7zSMGu16****",
    "MaxResults": 10,
    "ConfigurationList": [
      {
        "Tags": "{\\\"\\\"hc\\\"\\\":[\\\"\\\"value2\\\"\\\"]}",
        "AccountId": 0,
        "ResourceEventType": "DISCOVERED",
        "AvailabilityZone": "cn-hangzhou-h",
        "ResourceType": "ACS::OSS::Bucket",
        "ResourceCreateTime": "1624961112000",
        "Region": "cn-hangzhou",
        "CaptureTime": "1624961156000",
        "ConfigurationDiff": "{\\\"AccessControlList\\\":[null,{\\\"Grant\\\":\\\"private\\\"}],\\\"ServerSideEncryptionRule\\\":[null,{\\\"SSEAlgorithm\\\":\\\"None\\\"}],\\\"CreationDate\\\":[null,\\\"2021-06-29T10:05:12.000Z\\\"],\\\"Owner\\\":[null,{\\\"DisplayName\\\":\\\"100931896542****\\\",\\\"ID\\\":\\\"100931896542****\\\"}],\\\"BucketPolicy\\\":[null,{\\\"LogPrefix\\\":\\\"\\\",\\\"LogBucket\\\":\\\"\\\"}],\\\"StorageClass\\\":[null,\\\"Standard\\\"],\\\"ExtranetEndpoint\\\":[null,\\\"oss-cn-hangzhou.aliyuncs.com\\\"],\\\"DataRedundancyType\\\":[null,\\\"LRS\\\"],\\\"AllowEmptyReferer\\\":[null,\\\"true\\\"],\\\"IntranetEndpoint\\\":[null,\\\"oss-cn-hangzhou-internal.aliyuncs.com\\\"],\\\"Name\\\":[null,\\\"new-bucket\\\"],\\\"Location\\\":[null,\\\"oss-cn-hangzhou\\\"]}",
        "ResourceId": "new-bucket",
        "ResourceName": "new-bucket"
      }
    ]
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 NoPermission You are not authorized to perform this operation. 您無權執行此操作。
    400 Invalid.AggregatorId.Value The specified AggregatorId is invalid. 帳號組ID不存在或無許可權使用該帳號組。
    400 Invalid.ResourceOwnerId.Value The specified ResourceOwnerId is invalid. 該帳號不存在或不在目標帳號組內。
    404 AccountNotExisted Your account does not exist.
    503 ServiceUnavailable The request has failed due to a temporary failure of the server. 服務不可用。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。