テンプレートまたは Function Compute を使用したカスタムルールからルールを作成し、リソースのコンプライアンスをチェックします。ルールを作成すると、Cloud Config は初回評価を実行し、その後、ルールのトリガーに基づいて後続の評価を自動的に実行します。手動で評価を実行することも可能です。
操作説明
制限事項
1 つのアカウントにつき最大 200 個のルールを作成できます。
背景情報
Cloud Config では、2 つの方法でルールを作成できます。
-
テンプレートからルールを作成
ルールテンプレートは、Cloud Config が Function Compute で提供する事前定義済みのルール関数です。ルールテンプレートを使用すると、ルールを迅速に作成できます。詳細については、「ルールの定義と仕組み」をご参照ください。
-
Function Compute を使用してカスタムルールを作成
カスタムルールでは、Function Compute の関数を使用してルールコードをホストします。Cloud Config の事前定義済みルールテンプレートがコンプライアンス要件を満たさない場合、独自の関数コードを記述して、複雑なシナリオでのコンプライアンスをチェックできます。詳細については、「カスタムルールの定義と仕組み」をご参照ください。
注意事項
このトピックでは、required-tags テンプレートからルールを作成する方法を説明します。レスポンスでは、ルールが正常に作成されたことが確認され、その ID は cr-5772ba41209e007b**** です。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
config:CreateConfigRule |
create |
*Rule
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
TagKeyScope
deprecated
|
string |
任意 |
このパラメーターは非推奨です。代わりに このルールは、指定されたタグキーを持つリソースにのみ適用されます。 説明
このパラメーターはマネージドルールにのみ適用されます。 |
ECS |
TagValueScope
deprecated
|
string |
任意 |
このパラメーターは非推奨です。代わりに このルールは、指定されたタグ値を持つリソースにのみ適用されます。 説明
このパラメーターはルールテンプレートにのみ適用されます。 |
test |
| TagKeyLogicScope |
string |
任意 |
このパラメーターは、非推奨の 有効な値:
|
AND |
| TagsScope |
array<object> |
任意 |
タグの範囲。 |
|
|
object |
任意 |
|||
| TagKey |
string |
任意 |
タグキー。 |
key-1 |
| TagValue |
string |
任意 |
タグ値。 |
value-1 |
| ExcludeTagsScope |
array<object> |
任意 |
除外するタグの範囲。 |
|
|
object |
任意 |
|||
| TagKey |
string |
任意 |
タグキー。 |
key-2 |
| TagValue |
string |
任意 |
タグ値。 |
value-2 |
| Description |
string |
任意 |
ルールの説明。 |
最多可以定义6组标签。如果资源同时具有指定的所有标签,则视为“合规”。 |
| SourceOwner |
string |
必須 |
作成するルールのタイプ。有効な値:
|
ALIYUN |
| MaximumExecutionFrequency |
string |
任意 |
ルールが実行される頻度。有効な値:
説明
このパラメーターは、ConfigRuleTriggerTypes を ScheduledNotification に設定した場合に必須です。 |
One_Hour |
| Conditions |
string |
任意 |
カスタム条件ルールの条件 (JSON 形式)。 |
{"ComplianceConditions":"{\"operator\":\"and\",\"children\":[{\"operator\":\"StringEquals\",\"featurePath\":\"$.Status\",\"desired\":\"1\",\"featureSource\":\"CONFIGURATION\"}]}"} |
| RegionIdsScope |
string |
任意 |
このルールは、指定されたリージョン内のリソースにのみ適用されます。複数のリージョン ID はコンマ (,) で区切ります。 説明
このパラメーターはルールテンプレートにのみ適用されます。 |
cn-hangzhou |
| ExcludeRegionIdsScope |
string |
任意 |
このルールは、指定されたリージョン内のリソースには適用されません。これらのリージョン内のリソースのコンプライアンスは評価されません。複数のリージョン ID はコンマ (,) で区切ります。 |
cn-shanghai |
| ResourceGroupIdsScope |
string |
任意 |
このルールは、指定されたリソースグループ内のリソースにのみ適用されます。複数のリソースグループ ID はコンマ (,) で区切ります。 説明
このパラメーターはルールテンプレートにのみ適用されます。 |
rg-aekzc7r7rhx**** |
| ExcludeResourceGroupIdsScope |
string |
任意 |
このルールは、指定されたリソースグループ内のリソースには適用されません。これらのリソースグループ内のリソースのコンプライアンスは評価されません。複数のリソースグループ ID はコンマ (,) で区切ります。 |
rg-bnczc6r7rml**** |
| InputParameters |
object |
任意 |
ルールの入力パラメーター。 ルールの入力パラメーターは、GetManagedRule 操作を呼び出すことで取得できます。 入力パラメーターの形式は |
{"key1":"value1","key2":"value2"} |
| ResourceIdsScope |
string |
任意 |
このルールは指定されたリソースに適用されます。複数のリソース ID はコンマ (,) で区切ります。 |
lb-5cmbowstbkss9ta03**** |
| ExcludeResourceIdsScope |
string |
任意 |
このルールは、指定されたリソースには適用されません。これらのリソースのコンプライアンスは評価されません。複数のリソース ID はコンマ (,) で区切ります。 説明
このパラメーターはルールテンプレートにのみ適用されます。 |
lb-t4nbowvtbkss7t326**** |
| SourceIdentifier |
string |
必須 |
ルールの識別子。
|
required-tags |
| ConfigRuleTriggerTypes |
string |
必須 |
ルールを呼び出すトリガー。有効な値:
説明
ルールに複数のトリガーがある場合は、コンマ (,) で区切ります。 |
ConfigurationItemChangeNotification |
| ConfigRuleName |
string |
必須 |
ルールの名前。 |
存在所有指定标签 |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントで一意のトークンを生成します。 |
1594295238-f9361358-5843-4294-8d30-b5183fac**** |
| ResourceTypesScope |
array |
必須 |
評価するリソースタイプ。複数のリソースタイプはコンマ (,) で区切ります。 |
ACS::ECS::Instance |
|
string |
任意 |
評価するリソースタイプ。複数のリソースタイプはコンマ (,) で区切ります。 |
ACS::ECS::Instance |
|
| RiskLevel |
integer |
必須 |
ルールのリスクレベル。有効な値:
|
1 |
| ExtendContent |
string |
任意 |
拡張コンテンツ。このパラメーターは、24 時間の評価サイクルのトリガー時間を指定します。 |
{"fixedHour":"13"} |
| Tag |
array<object> |
任意 |
作成するルールのタグ。 |
|
|
object |
任意 |
リソースのタグ。 最大 20 個のタグをアタッチできます。 |
||
| Key |
string |
任意 |
リソースのタグキー。 最大 20 個のタグキーをアタッチできます。 |
key-1 |
| Value |
string |
任意 |
リソースのタグ値。 最大 20 個のタグ値をアタッチできます。 |
value-1 |
| ResourceNameScope |
string |
任意 |
このルールは、指定された名前を持つリソースにのみ適用されます。 |
i-xxx |
共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
なし |
||
| ConfigRuleId |
string |
ルール ID。 |
cr-5772ba41209e007b**** |
| RequestId |
string |
リクエスト ID。 |
6EC7AED1-172F-42AE-9C12-295BC2ADB751 |
例
成功レスポンス
JSONJSON
{
"ConfigRuleId": "cr-5772ba41209e007b****",
"RequestId": "6EC7AED1-172F-42AE-9C12-295BC2ADB751"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | ExceedMaxRuleCount | The maximum number of rules is exceeded. | |
| 400 | ConfigRuleNotExists | The ConfigRule does not exist. | |
| 400 | ConfigRuleExists | The ConfigRule already exists. | |
| 404 | AccountNotExisted | Your account does not exist. | |
| 503 | ServiceUnavailable | The request has failed due to a temporary failure of the server. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。