全部產品
Search

搜尋本產品

    Cloud Config：GetResourceComplianceTimeline - 查詢資源合規檢測歷史

    文件中心

    Cloud Config：GetResourceComplianceTimeline - 查詢資源合規檢測歷史

    更新時間：Oct 10, 2025

    查詢指定資源的合規檢測歷史。合規檢測歷史是資源的一組合規評估記錄，包括合規檢測歷史上的點和合規檢測歷史的內容。

    介面說明

    在配置審計中，每個資源都有屬於自己的合規檢測歷史。當規則被觸發評估資源時，產生合規評估記錄，持續的合規評估形成了資源的合規檢測歷史。規則引發方式包括：配置變更、周期執行和手動執行。

    本文將提供一個樣本，查詢地區cn-hangzhou中資源new-bucket（儲存空間）的合規檢測歷史。返回結果顯示，資源的合規檢測歷史為1625200295276（北京時間：2021-07-02 12:31:35）和1625200228510（北京時間：2021-07-02 12:30:28）。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    config:GetResourceComplianceTimeline

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ResourceType

    string

    是

    資源類型。

    關於如何擷取類型，請參見 ListDiscoveredResources 。

    ACS::OSS::Bucket
    ResourceId

    string

    是

    資源 ID。

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

    new-bucket
    StartTime

    integer

    否

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

    1623211156000
    EndTime

    integer

    否

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

    1625821156000
    MaxResults

    integer

    否

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

    10
    Region

    string

    是

    地區 ID。

    cn-hangzhou
    NextToken

    string

    否

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

    IWBjqMYSy0is7zSMGu16****

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

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    8D53A78F-1EB8-4264-A554-72F07E34FAE6
    ResourceComplianceTimeline

    object

    資源合規檢測歷史。

    NextToken

    string

    查詢下一頁使用的 Token。

    5OVS5J4I1/UKTkHV5oNs****
    MaxResults

    integer

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

    10
    ComplianceList

    array<object>

    資源合規檢測歷史列表。

    object

    Tags

    string

    資源標籤。

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

    string

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

    100931896542****
    AvailabilityZone

    string

    資源可用性區域。

    cn-hangzhou-f
    ResourceType

    string

    資源類型。

    ACS::OSS::Bucket
    ResourceCreateTime

    integer

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

    1624961112000
    Region

    string

    地區 ID。

    cn-hangzhou
    Configuration

    string

    資源關聯的規則列表和規則合規詳情。

    {\"Compliance\":{\"complianceType\":\"COMPLIANT\",\"count\":1},\"ConfigRuleList\":[{\"accountId\":100931896542****,\"configRuleId\":\"cr-9524626622af003d****\",\"configRuleArn\":\"acs:config::100931896542****:rule/cr-9524626622af003d****\",\"configRuleName\":\"OSS儲存空間ACL禁止公用讀寫\",\"complianceType\":\"COMPLIANT\",\"riskLevel\":1,\"annotation\":\"\",\"invokingEventMessageType\":\"ScheduledNotification\"}]}
    CaptureTime

    integer

    記錄資源合規評估的時間戳記。單位：毫秒。

    1625200295276
    ConfigurationDiff

    string

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

    {\"OSS儲存空間ACL禁止公用讀寫\":[{\"accountId\":100931896542****,\"configRuleId\":\"cr-965f626622af003d****\",\"configRuleArn\":\"acs:config::100931896542****:rule/cr-965f626622af003d****\",\"configRuleName\":\"OSS儲存空間ACL禁止公用讀寫\",\"complianceType\":\"COMPLIANT\",\"riskLevel\":1,\"annotation\":\"\",\"invokingEventMessageType\":\"ScheduledNotification\"},{}]}
    ResourceId

    string

    資源 ID。

    new-bucket
    ResourceName

    string

    資源名稱。

    new-bucket
    ResourceStatus

    string

    資源狀態。資源狀態取決於各雲端服務對其的定義，該參數可能為空白。例如：

    • 當資源類型為 ACS::ECS::Instance 時，由於 ECS 執行個體有狀態，因此該參數為 Running 或 Stopped。

    • 當資源類型為 ACS::OSS::Bucket 時，由於 OSS Bucket 無狀態，因此該參數為空白。

    null

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "8D53A78F-1EB8-4264-A554-72F07E34FAE6",
  "ResourceComplianceTimeline": {
    "NextToken": "5OVS5J4I1/UKTkHV5oNs****",
    "MaxResults": 10,
    "ComplianceList": [
      {
        "Tags": "{\\\"\\\"hc\\\"\\\":[\\\"\\\"value2\\\"\\\"]}",
        "AccountId": "100931896542****",
        "AvailabilityZone": "cn-hangzhou-f",
        "ResourceType": "ACS::OSS::Bucket",
        "ResourceCreateTime": 1624961112000,
        "Region": "cn-hangzhou",
        "Configuration": "{\\\"Compliance\\\":{\\\"complianceType\\\":\\\"COMPLIANT\\\",\\\"count\\\":1},\\\"ConfigRuleList\\\":[{\\\"accountId\\\":100931896542****,\\\"configRuleId\\\":\\\"cr-9524626622af003d****\\\",\\\"configRuleArn\\\":\\\"acs:config::100931896542****:rule/cr-9524626622af003d****\\\",\\\"configRuleName\\\":\\\"OSS儲存空間ACL禁止公用讀寫\\\",\\\"complianceType\\\":\\\"COMPLIANT\\\",\\\"riskLevel\\\":1,\\\"annotation\\\":\\\"\\\",\\\"invokingEventMessageType\\\":\\\"ScheduledNotification\\\"}]}",
        "CaptureTime": 1625200295276,
        "ConfigurationDiff": "{\\\"OSS儲存空間ACL禁止公用讀寫\\\":[{\\\"accountId\\\":100931896542****,\\\"configRuleId\\\":\\\"cr-965f626622af003d****\\\",\\\"configRuleArn\\\":\\\"acs:config::100931896542****:rule/cr-965f626622af003d****\\\",\\\"configRuleName\\\":\\\"OSS儲存空間ACL禁止公用讀寫\\\",\\\"complianceType\\\":\\\"COMPLIANT\\\",\\\"riskLevel\\\":1,\\\"annotation\\\":\\\"\\\",\\\"invokingEventMessageType\\\":\\\"ScheduledNotification\\\"},{}]}",
        "ResourceId": "new-bucket",
        "ResourceName": "new-bucket",
        "ResourceStatus": "null"
      }
    ]
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 NoPermission You are not authorized to perform this operation. 您無權執行此操作。
    404 AccountNotExisted Your account does not exist.
    503 ServiceUnavailable The request has failed due to a temporary failure of the server. 服務不可用。

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

    變更歷史

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