使用GetAggregateConfigRule查詢帳號組規則詳情-配置審計-阿里雲 - Cloud Config

查詢指定帳號群組內指定規則詳情。

介面說明

本文將提供一個範例，查詢帳號群組ca-7f00626622af0041****內規則cr-7f7d626622af0041****的詳情。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

config:GetAggregateConfigRule

get

*AggregateConfigRule

acs:config:*:{#accountId}:aggregateconfigrule/{#ConfigRuleId}

無

請求參數

名稱	類型	必填	描述	樣本值
ConfigRuleId	string	是	規則 ID。關於如何取得規則 ID，請參見 ListAggregateConfigRules 。	cr-7f7d626622af0041****
AggregatorId	string	是	帳號群組 ID。關於如何取得帳號群組 ID，請參見 ListAggregators 。	ca-7f00626622af0041****
Tag `deprecated`	array<object>	否	標籤。該輸入參數已棄用，請忽略，傳入不會生效。
	object	否	資源的標籤。該輸入參數已棄用，請忽略，傳入不會生效。最多支援綁定 20 個標籤。
Key	string	否	資源的標籤鍵。最多支援綁定 20 個標籤鍵。	key-1
Value	string	否	資源的標籤值。最多支援綁定 20 個標籤值。	value-1

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

返回參數

名稱	類型	描述	樣本值
	object	無。
RequestId	string	請求 ID。	811234F4-C3AB-4D15-B90B-F55016D1B5AA
ConfigRule	object	規則清單。
RiskLevel	integer	規則風險等級。取值： 1：高風險。 2：中風險。 3：低風險。	1
InputParameters	object	規則參數資訊。	{"tag1Key":"ECS","tag1Value":"test"}
Source	object	規則來源資訊。
SourceDetails	array<object>	規則來源詳情。
	object	無。
MessageType	string	規則觸發機制。取值： ConfigurationItemChangeNotification：組態變更。 ScheduledNotification：週期執行。	ConfigurationItemChangeNotification
EventSource	string	事件來源。說明目前僅支援配置審計事件：aliyun.config。	aliyun.config
MaximumExecutionFrequency	string	規則執行週期。取值： One_Hour：1 小時。 Three_Hours：3 小時。 Six_Hours：6 小時。 Twelve_Hours：12 小時。 TwentyFour_Hours：24 小時。	One_Hour
Owner	string	規則來源的歸屬。取值： CUSTOM_FC：自訂規則。 ALIYUN：規則範本。	ALIYUN
Identifier	string	規則識別碼。如果是規則範本，該參數為規則範本識別碼。如果是自訂規則，該參數為函式 ARN。	acs:fc:cn-hangzhou:100931896542****:services/ConfigService.LATEST/functions/specific-config
ConfigRuleState	string	規則執行狀態。取值： ACTIVE：套用中。 DELETING：刪除中。 EVALUATING：評估中。 INACTIVE：已停用。	ACTIVE
MaximumExecutionFrequency	string	規則執行週期。 One_Hour：1 小時。 Three_Hours：3 小時。 Six_Hours：6 小時。 Twelve_Hours：12 小時。 TwentyFour_Hours：24 小時。	One_Hour
ManagedRule	object	規則範本詳情。
SourceDetails	array<object>	規則範本來源詳情。
	object	規則來源詳情。
MessageType	string	規則觸發機制。取值： ConfigurationItemChangeNotification：組態變更。 ScheduledNotification：週期執行。	ConfigurationItemChangeNotification
EventSource	string	事件來源。說明目前僅支援配置審計事件：aliyun.config。	aliyun.config
MaximumExecutionFrequency	string	規則執行週期。 One_Hour：1 小時。 Three_Hours：3 小時。 Six_Hours：6 小時。 Twelve_Hours：12 小時。 TwentyFour_Hours：24 小時。	One_Hour
Description	string	規則範本描述。	ECS磁碟未因欠費或安全等原因而被鎖定，視為「合規」
Labels	array	規則範本標籤清單。
	string	規則範本標籤。	["RAM","USer"]
Identifier	string	規則範本識別碼。	ram-user-mfa-check
OptionalInputParameterDetails	object	規則範本可選參數詳情。	{}
ManagedRuleName	string	規則範本名稱。	RAM用戶開啟MFA
CompulsoryInputParameterDetails	object	規則範本必選參數詳情。	{}
ConfigRuleArn	string	規則範本 ARN。	acs:config::100931896542**:rule/cr-7f7d626622af0041**
Description	string	規則範本描述。	RAM用戶開啟MFA，視為「合規」
CreateBy	object	規則建立者資訊。
CompliancePackId	string	合規包 ID。	cp-541e626622af008****
AggregatorName	string	帳號群組名稱。	Test_Group
CompliancePackName	string	合規包名稱。	OSS合規基線
CreatorName	string	規則建立者名稱。	Alice
CreatorType	string	規則建立者類型。僅支援 `AGGREGATOR`（帳號群組）。	AGGREGATOR
CreatorId	string	規則建立者的帳號 ID。	100931896542****
AggregatorId	string	帳號群組 ID。	ca-04b3fd170e340007****
ConfigRuleName	string	規則名稱。	RAM用戶開啟MFA
ConfigRuleEvaluationStatus	object	規則執行狀態。
LastErrorCode	string	規則最近一次執行的錯誤碼。	TimeOut
LastSuccessfulEvaluationTimestamp	integer	規則最近一次呼叫成功的結束時間戳記。單位：毫秒。	1624932227486
FirstActivatedTimestamp	integer	規則首次啟用時間，使用 Unix 時間戳記，單位為毫秒。	1624932221993
FirstEvaluationStarted	boolean	規則是否已執行評估。取值： true：規則已執行評估。 false：規則未執行評估。	true
LastSuccessfulInvocationTimestamp	integer	規則最近一次呼叫成功的開始時間戳記。單位：毫秒。	1624932227476
LastErrorMessage	string	規則最近一次執行的錯誤訊息。	time out
LastFailedEvaluationTimestamp	integer	規則最近一次呼叫失敗的結束時間戳記。單位：毫秒。	1614687022000
LastFailedInvocationTimestamp	integer	規則最近一次呼叫失敗的開始時間戳記。單位：毫秒。	1614687022000
ConfigRuleId	string	規則 ID。	cr-7f7d626622af0041****
ModifiedTimestamp	integer	規則最近一次更新的時間戳記。單位：毫秒。	1614687022000
CreateTimestamp	integer	建立規則的時間戳記。單位：毫秒。	1604684022000
ResourceTypesScope	string	規則評估的資源類型。	ACS::RAM::User
ExcludeRegionIdsScope	string	規則對指定地域內資源無效，即不對該地域內資源執行評估。多個地域 ID 之間以半形逗號（,）分隔。	cn-hangzhou
RegionIdsScope	string	規則只評估所屬地域 ID 的資源。	global
ExcludeResourceIdsScope	string	規則評估排除的資源 ID。	23642660635687****
ResourceIdsScope	string	規則對指定資源 ID 生效。多個資源 ID 之間以半形逗號（,）分隔。	eip-8vbf3x310fn56ijfd****
ResourceGroupIdsScope	string	規則只評估所屬資源群組 ID 的資源。	rg-aekzdibsjjc****
ExcludeResourceGroupIdsScope	string	規則對指定資源群組 ID 中的資源無效，即不對該資源群組內的資源評估。多個資源群組 ID 之間以半形逗號（,）分隔。	rg-aekzdibsjjc****
TagKeyScope `deprecated`	string	已廢棄，請使用 `TagsScope` 欄位。規則只評估所屬標籤鍵的資源。	RAM
TagValueScope `deprecated`	string	已廢棄，請使用 `TagsScope` 欄位。規則只評估所屬標籤值的資源。	MFA
TagsScope	array<object>	標籤範圍。
	object
TagKey	string	標籤鍵。	key-1
TagValue	string	標籤值。	value-1
ExcludeTagsScope	array<object>	排除的標籤範圍。
	object
TagKey	string	標籤鍵。	key-2
TagValue	string	標籤值。	value-2
ConfigRuleTriggerTypes	string	規則觸發機制。取值： ConfigurationItemChangeNotification：組態變更。 ScheduledNotification：週期執行。	ConfigurationItemChangeNotification
TagKeyLogicScope	string	使用參數 `TagsScope` 建立的規則，取得詳情時不返回該欄位。用於取得使用已廢棄欄位 `TagKeyScope` 欄位（不推薦）建立的規則，例如：當參數 `TagKeyScope` 取值為 `ECS,OSS` 時，如果該參數為 `AND`，則表示規則僅對同時綁定標籤 `ECS` 和 `OSS` 的資源生效。取值： AND：與。 OR：或。	AND
FolderIdsScope	string	規則僅對指定資源目錄 ID 中成員帳號內的資源生效。	fd-ZtHsRH****
ExcludeFolderIdsScope	string	規則對指定資源目錄 ID 中成員帳號內的資源無效，即不對該資源目錄 ID 中成員帳號內的資源執行評估。	fd-pWmkqZ****
ExcludeAccountIdsScope	string	規則對指定成員帳號內的資源無效，即不對該帳號內的資源執行評估。	120886317861****
ResourceNameScope	string	規則僅對指定資源名稱的資源生效。	i-xxx
Compliance	object	規則合規統計結果。
ComplianceType	string	合規統計結果。取值： COMPLIANT：合規。 NON_COMPLIANT：不合規。 NOT_APPLICABLE：不適用。 INSUFFICIENT_DATA：無資料。	NON_COMPLIANT
Count	integer	合規統計結果對應的評估資源數量。	3
AccountId	integer	規則歸屬阿里雲帳號 ID。	120886317861****
ExtendContent	string	擴充內容，暫時僅用於配合 24 小時週期觸發設定觸發時間。	{"fixedHour":"12"}
Tags	array<object>	資源標籤。
	object	資源標籤。
TagKey	string	標籤鍵。	key-1
TagValue	string	標籤值。	value-1
AccountIdsScope	string	規則僅對指定成員帳號內的資源生效。多個成員帳號 ID 之間以半形逗號（,）分隔。	120886317861****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "811234F4-C3AB-4D15-B90B-F55016D1B5AA",
  "ConfigRule": {
    "RiskLevel": 1,
    "InputParameters": {
      "tag1Key": "ECS",
      "tag1Value": "test"
    },
    "Source": {
      "SourceDetails": [
        {
          "MessageType": "ConfigurationItemChangeNotification",
          "EventSource": "aliyun.config",
          "MaximumExecutionFrequency": "One_Hour"
        }
      ],
      "Owner": "ALIYUN",
      "Identifier": "acs:fc:cn-hangzhou:100931896542****:services/ConfigService.LATEST/functions/specific-config"
    },
    "ConfigRuleState": "ACTIVE",
    "MaximumExecutionFrequency": "One_Hour",
    "ManagedRule": {
      "SourceDetails": [
        {
          "MessageType": "ConfigurationItemChangeNotification",
          "EventSource": "aliyun.config",
          "MaximumExecutionFrequency": "One_Hour"
        }
      ],
      "Description": "ECS磁盘未因欠费或安全等原因而被锁定，视为“合规”。",
      "Labels": [
        "[\"RAM\",\"USer\"]"
      ],
      "Identifier": "ram-user-mfa-check",
      "OptionalInputParameterDetails": {},
      "ManagedRuleName": "RAM用户开启MFA",
      "CompulsoryInputParameterDetails": {}
    },
    "ConfigRuleArn": "acs:config::100931896542****:rule/cr-7f7d626622af0041****",
    "Description": "RAM用户开启MFA，视为“合规”。",
    "CreateBy": {
      "CompliancePackId": "cp-541e626622af008****",
      "AggregatorName": "Test_Group",
      "CompliancePackName": "OSS合规基线",
      "CreatorName": "Alice",
      "CreatorType": "AGGREGATOR",
      "CreatorId": "100931896542****",
      "AggregatorId": "ca-04b3fd170e340007****"
    },
    "ConfigRuleName": "RAM用户开启MFA",
    "ConfigRuleEvaluationStatus": {
      "LastErrorCode": "TimeOut",
      "LastSuccessfulEvaluationTimestamp": 1624932227486,
      "FirstActivatedTimestamp": 1624932221993,
      "FirstEvaluationStarted": true,
      "LastSuccessfulInvocationTimestamp": 1624932227476,
      "LastErrorMessage": "time out",
      "LastFailedEvaluationTimestamp": 1614687022000,
      "LastFailedInvocationTimestamp": 1614687022000
    },
    "ConfigRuleId": "cr-7f7d626622af0041****",
    "ModifiedTimestamp": 1614687022000,
    "CreateTimestamp": 1604684022000,
    "ResourceTypesScope": "ACS::RAM::User",
    "ExcludeRegionIdsScope": "cn-hangzhou",
    "RegionIdsScope": "global",
    "ExcludeResourceIdsScope": "23642660635687****",
    "ResourceIdsScope": "eip-8vbf3x310fn56ijfd****\n",
    "ResourceGroupIdsScope": "rg-aekzdibsjjc****",
    "ExcludeResourceGroupIdsScope": "rg-aekzdibsjjc****",
    "TagKeyScope": "RAM",
    "TagValueScope": "MFA",
    "TagsScope": [
      {
        "TagKey": "key-1",
        "TagValue": "value-1"
      }
    ],
    "ExcludeTagsScope": [
      {
        "TagKey": "key-2",
        "TagValue": "value-2"
      }
    ],
    "ConfigRuleTriggerTypes": "ConfigurationItemChangeNotification",
    "TagKeyLogicScope": "AND",
    "FolderIdsScope": "fd-ZtHsRH****",
    "ExcludeFolderIdsScope": "fd-pWmkqZ****",
    "ExcludeAccountIdsScope": "120886317861****",
    "ResourceNameScope": "i-xxx",
    "Compliance": {
      "ComplianceType": "NON_COMPLIANT",
      "Count": 3
    },
    "AccountId": 0,
    "ExtendContent": "{\"fixedHour\":\"12\"}",
    "Tags": [
      {
        "TagKey": "key-1",
        "TagValue": "value-1"
      }
    ],
    "AccountIdsScope": "120886317861****\n"
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
400	ConfigRuleNotExists	The ConfigRule does not exist.
400	NoPermission	You are not authorized to perform this operation.
400	Invalid.AggregatorId.Value	The specified AggregatorId is invalid.
404	AccountNotExisted	Your account does not exist.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.

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

變更歷史

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