ACLチェック詳細のステータスを変更します。
操作説明
QPS 制限
このAPIの1ユーザーあたりのQPS 制限は、1 秒あたり10 回です。制限を超えるとAPI 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。このAPIを適切に呼び出してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
yundun-cloudfirewall:UpdateAclCheckDetailStatus |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Lang |
string |
任意 |
言語。 列挙値:
|
zh |
| TaskId |
string |
必須 |
ACLチェックタスクID。 |
task-c92d4544ef7b6a42 |
| Uuid |
string |
必須 |
ACLチェック詳細におけるACLポリシーの一意の識別子。 |
bbbb43c9-a931-4d89-9939-86d509139a20 |
| Status |
string |
必須 |
変更後のステータス。 列挙値:
|
Pending |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエストID。 |
850A84D6************00090125EEB1 |
| CheckRecord |
object |
ACLチェックレコード。 |
|
| Acls |
array<object> |
ACLチェック結果のリスト。 |
|
|
array<object> |
ACLチェック結果。 |
||
| Acl |
object |
ACL チェック結果です。 |
|
| Direction |
string |
アクセス制御ポリシーのトラフィック方向です。 有効な値:
|
in |
| Order |
integer |
アクセス制御ポリシーの優先度です。 優先度の値は 1 から始まります。値が小さいほど優先度が高くなります。 |
desc |
| SourceType |
string |
ポリシー内の送信元アドレスのタイプです。有効な値:
|
net |
| ApplicationName |
string |
アクセス制御ポリシーでサポートされるアプリケーションタイプです。有効な値:
説明
利用可能なアプリケーションタイプは |
ANY |
| HitTimes |
integer |
ポリシーのヒット数です。 |
1 |
| Description |
string |
ポリシーの説明です。 |
test_policy |
| SourceGroupType |
string |
ポリシー内の送信元アドレス帳のタイプです。有効な値:
|
ip |
| DnsResultTime |
integer |
DNS 解決の UNIX タイムスタンプ (秒) です。 |
1579261141 |
| DnsResult |
string |
DNS 解決の結果です。 |
192.168.0.1/32 |
| Proto |
string |
アクセス制御ポリシー内のトラフィックのプロトコルタイプです。有効な値:
説明
このパラメータを指定しない場合、すべてのプロトコルタイプが照会されます。 |
ANY |
| DestinationGroupType |
string |
ポリシー内の宛先アドレス帳のタイプです。有効な値:
|
domain |
| Destination |
string |
アクセス制御ポリシー内の宛先アドレスです。このパラメータはあいまい検索に対応しています。このパラメータの値は
説明
このパラメータを指定しない場合、すべてのタイプの宛先アドレスが照会されます。 |
kms.cn-shanghai.aliyuncs.com |
| HitLastTime |
integer |
ポリシーが最後にヒットした UNIX タイムスタンプ (秒) です。 |
1579261141 |
| DestPortGroup |
string |
The type of the destination port for traffic in the policy. Valid values:
|
port |
| AclUuid |
string |
ポリシーの UUID です。 |
1e8ed1b2-cebc-4b95-a9cc-0cb7ce2c0c2c |
| DestPortType |
string |
ポリシー内の宛先ポートのタイプです。有効な値:
|
port |
| Source |
string |
ポリシー内の送信元アドレスです。 有効な値:
|
10.71.94.24 |
| DestinationType |
string |
ポリシー内の宛先アドレスのタイプです。 有効な値:
|
group |
| DestPort |
string |
ポリシー内のトラフィックの宛先ポートです。 |
22/22 |
| IpVersion |
integer |
Cloud Firewall で保護されるアセットの IP バージョンです。有効な値:
|
4 |
| AclAction |
string |
ポリシーに一致するトラフィックに対して実行されるアクションです。有効な値:
|
log |
| Release |
string |
ポリシーが有効かどうかを示します。有効な値:
|
true |
| ApplicationId |
string |
ポリシー内のトラフィックのアプリケーション ID です。 |
HTTP |
| DestinationGroupCidrs |
array |
ポリシーの宛先アドレス帳内の CIDR ブロックのリストです。 |
|
|
string |
宛先アドレス帳内の CIDR ブロックです。 |
192.168.0.1/32 |
|
| DestPortGroupPorts |
array |
宛先ポートアドレス帳内のポートのリストです。 |
|
|
string |
宛先ポートアドレス帳内のポートです。 |
22/22 |
|
| SourceGroupCidrs |
array |
ポリシーの送信元アドレス帳内の CIDR ブロックのリストです。 |
|
|
string |
ポリシーの送信元アドレス帳内の CIDR ブロックです。 |
192.168.0.1/32 |
|
| ApplicationNameList |
array |
ポリシーでサポートされるアプリケーションタイプのリストです。 |
|
|
string |
ポリシーでサポートされるアプリケーションタイプです。 |
SSH |
|
| SpreadCnt |
integer |
ポリシーが消費するルールエントリ数です。単一のポリシーが消費するエントリ数は、次の式で算出されます:送信元 CIDR ブロック数 × 宛先アドレス数 (CIDR ブロック、ロケーション、またはドメイン名) × アプリケーション数 × ポート範囲数。 |
10 |
| CreateTime |
integer |
ポリシーが作成された時刻です。値は UNIX タイムスタンプです。単位:秒。 |
1761062400 |
| ModifyTime |
integer |
ポリシーが最後に変更された時刻です。値は UNIX タイムスタンプです。単位:秒。 |
1761062400 |
| RepeatType |
string |
ポリシーの有効期間の繰り返しタイプです。有効な値:
|
None |
| RepeatDays |
array |
ポリシーが繰り返される曜日または月の日付の配列です。
説明
説明
|
|
|
integer |
ポリシーが繰り返される曜日または月の日付です。
説明
説明
|
1 |
|
| RepeatStartTime |
string |
繰り返しの開始時刻 (HH:mm 形式) です。時刻は 00 分または 30 分である必要があり、終了時刻の 30 分以上前である必要があります。 説明
このパラメータは、 |
08:00 |
| RepeatEndTime |
string |
繰り返しの終了時刻 (HH:mm 形式) です。時刻は 00 分または 30 分である必要があり、開始時刻の 30 分以上後である必要があります。 説明
このパラメータは、 |
23:30 |
| StartTime |
integer |
照会の開始時刻です。値は UNIX タイムスタンプです。単位:秒。 |
1736130347 |
| EndTime |
integer |
照会の終了時刻です。値は UNIX タイムスタンプです。単位:秒。 |
1752754426 |
| AddressListCount |
integer |
アドレス帳内のアドレス数です。 |
1 |
| GroupUuid |
string |
アドレス帳の UUID です。 説明
詳細については、「 |
5a96a798-9b73-47f7-831e-1d7aa3c987a9 |
| AutoAddTagEcs |
integer |
指定したタグに一致する新規 ECS インスタンスのパブリック IP アドレスがアドレス帳に自動追加されるかどうかを示します。これは、新規購入したインスタンスと、タグが更新されて一致するようになった既存インスタンスの両方に適用されます。 |
0 |
| GroupName |
string |
アドレス帳の名前です。 |
subscribe |
| ReferenceCount |
integer |
アドレス帳の参照回数です。 |
1 |
| GroupType |
string |
アドレス帳のタイプです。有効な値:
|
port |
| TagRelation |
string |
複数の ECS タグ間の論理関係です。 |
and |
| TagList |
array<object> |
ECS タグのリストです。 |
|
|
object |
ECS タグです。 |
||
| TagValue |
string |
ECS タグの値です。 |
tfTestAcc0 |
| TagKey |
string |
ECS タグのキーです。 |
produce |
| AddressList |
array |
アドレス帳内のアドレスのリストです。 |
|
|
string |
アドレス帳内のアドレスです。 |
183.2.201.71/32,60.28.235.22/32,210.51.58.107/32,60.28.235.81/32,210.51.58.51/32,60.28.235.52/32,1.1.1.1/32,154.212.141.143/32,167.94.146.55/32,185.226.197.47/32,101.251.238.174/32 |
|
| NatGatewayId |
string |
NAT ゲートウェイの ID です。 |
ngw-gw85zno51npz7lgc04z89 |
| DomainResolveType |
integer |
ポリシーのドメイン名解決方式です。有効な値:
|
0 |
| VpcFirewallId |
string |
VPC ファイアウォールのインスタンス ID です。 |
cen-cw4z051hr8x53qniv5 |
| AclStatus |
string |
ポリシーチェックのステータスです。 |
configuring |
| AclAssessmentDetail |
string |
ポリシーの評価の詳細です。 |
No traffic hit policy. |
| RecordAssessmentDetail |
string |
このACLチェックレコードの評価詳細。 |
Due to business offline or other reasons, the number of hits of the object policy in a period of time is 0. |
| CheckName |
string |
ACLチェック名。有効な値:
|
PolicyHitCountZero |
| Description |
string |
ルールの説明。 |
dwd_mysql_lingwan_faxing_chat_config_di |
| LastCheckTime |
string |
最後のチェックのタイムスタンプ。単位: 秒。 |
1724982259 |
| Level |
string |
リスクレベル。 |
High |
| PolicyTotalCount |
integer |
ポリシーの合計数。 |
1 |
| TaskId |
string |
ACLチェックタスクID。 |
task-c92d4544ef7b6a42 |
例
成功レスポンス
JSONJSON
{
"RequestId": "850A84D6************00090125EEB1",
"CheckRecord": {
"Acls": [
{
"Acl": {
"Direction": "in",
"Order": 0,
"SourceType": "net",
"ApplicationName": "ANY",
"HitTimes": 1,
"Description": "test_policy",
"SourceGroupType": "ip",
"DnsResultTime": 1579261141,
"DnsResult": "192.168.0.1/32",
"Proto": "ANY",
"DestinationGroupType": "domain",
"Destination": "kms.cn-shanghai.aliyuncs.com",
"HitLastTime": 1579261141,
"DestPortGroup": "port",
"AclUuid": "1e8ed1b2-cebc-4b95-a9cc-0cb7ce2c0c2c",
"DestPortType": "port",
"Source": "10.71.94.24",
"DestinationType": "group",
"DestPort": "22/22",
"IpVersion": 4,
"AclAction": "log",
"Release": "true",
"ApplicationId": "HTTP",
"DestinationGroupCidrs": [
"192.168.0.1/32"
],
"DestPortGroupPorts": [
"22/22"
],
"SourceGroupCidrs": [
"192.168.0.1/32"
],
"ApplicationNameList": [
"SSH"
],
"SpreadCnt": 10,
"CreateTime": 1761062400,
"ModifyTime": 1761062400,
"RepeatType": "None",
"RepeatDays": [
1
],
"RepeatStartTime": "08:00",
"RepeatEndTime": "23:30",
"StartTime": 1736130347,
"EndTime": 1752754426,
"AddressListCount": 1,
"GroupUuid": "5a96a798-9b73-47f7-831e-1d7aa3c987a9",
"AutoAddTagEcs": 0,
"GroupName": "subscribe",
"ReferenceCount": 1,
"GroupType": "port",
"TagRelation": "and",
"TagList": [
{
"TagValue": "tfTestAcc0",
"TagKey": "produce"
}
],
"AddressList": [
"183.2.201.71/32,60.28.235.22/32,210.51.58.107/32,60.28.235.81/32,210.51.58.51/32,60.28.235.52/32,1.1.1.1/32,154.212.141.143/32,167.94.146.55/32,185.226.197.47/32,101.251.238.174/32"
],
"NatGatewayId": "ngw-gw85zno51npz7lgc04z89",
"DomainResolveType": 0,
"VpcFirewallId": "cen-cw4z051hr8x53qniv5"
},
"AclStatus": "configuring",
"AclAssessmentDetail": "No traffic hit policy."
}
],
"RecordAssessmentDetail": "Due to business offline or other reasons, the number of hits of the object policy in a period of time is 0.\n",
"CheckName": "PolicyHitCountZero",
"Description": "dwd_mysql_lingwan_faxing_chat_config_di",
"LastCheckTime": "1724982259",
"Level": "High",
"PolicyTotalCount": 1,
"TaskId": "task-c92d4544ef7b6a42"
}
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | ErrorAclCheckNotExist | ACL check not exist. | |
| 400 | ErrorAclCheckDetailNotExist | ACL check detail not exist. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。