すべてのプロダクト
Search
ドキュメントセンター

Cloud Firewall:UpdateAclCheckDetailStatus

最終更新日:Jun 18, 2026

ACLチェック詳細のステータスを変更します。

操作説明

QPS 制限

このAPIの1ユーザーあたりのQPS 制限は、1 秒あたり10 回です。制限を超えるとAPI 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。このAPIを適切に呼び出してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-cloudfirewall:UpdateAclCheckDetailStatus

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Lang

string

任意

言語。

列挙値:

  • en :

    英語

  • zh :

    中国語(デフォルト)

zh

TaskId

string

必須

ACLチェックタスクID。

task-c92d4544ef7b6a42

Uuid

string

必須

ACLチェック詳細におけるACLポリシーの一意の識別子。

bbbb43c9-a931-4d89-9939-86d509139a20

Status

string

必須

変更後のステータス。

列挙値:

  • Pending :

    保留中

  • Ignored :

    無視済み

  • Processed :

    処理済み

Pending

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエストID。

850A84D6************00090125EEB1

CheckRecord

object

ACLチェックレコード。

Acls

array<object>

ACLチェック結果のリスト。

array<object>

ACLチェック結果。

Acl

object

ACL チェック結果です。

Direction

string

アクセス制御ポリシーのトラフィック方向です。

有効な値:

  • in:インバウンドトラフィック。

  • out:アウトバウンドトラフィック。

in

Order

integer

アクセス制御ポリシーの優先度です。

優先度の値は 1 から始まります。値が小さいほど優先度が高くなります。

desc

SourceType

string

ポリシー内の送信元アドレスのタイプです。有効な値:

  • net:送信元 CIDR ブロック。

  • group:送信元アドレス帳。

  • location:送信元リージョン。

net

ApplicationName

string

アクセス制御ポリシーでサポートされるアプリケーションタイプです。有効な値:

  • FTP

  • HTTP

  • HTTPS

  • Memcache

  • MongoDB

  • MQTT

  • MySQL

  • RDP

  • Redis

  • SMTP

  • SMTPS

  • SSH

  • SSL_No_Cert

  • SSL

  • VNC

説明

利用可能なアプリケーションタイプは Proto の値によって異なります。ProtoTCP の場合、上記のすべてのアプリケーションタイプがサポートされます。ApplicationNameApplicationNameList の両方を指定した場合は、ApplicationNameList が優先されます。

ANY

HitTimes

integer

ポリシーのヒット数です。

1

Description

string

ポリシーの説明です。

test_policy

SourceGroupType

string

ポリシー内の送信元アドレス帳のタイプです。有効な値:

  • ip:IP アドレスまたは CIDR ブロックを含むアドレス帳。

  • tag:指定したタグに一致する ECS インスタンスの IP アドレスを含むアドレス帳。

  • domain:1 つ以上のドメイン名を含むアドレス帳。

  • threat:悪意のある IP アドレスまたはドメイン名を含む脅威インテリジェンスアドレス帳。

  • backsrc:Anti-DDoS または WAF インスタンスの back-to-source アドレスを含む back-to-source アドレス帳。

ip

DnsResultTime

integer

DNS 解決の UNIX タイムスタンプ (秒) です。

1579261141

DnsResult

string

DNS 解決の結果です。

192.168.0.1/32

Proto

string

アクセス制御ポリシー内のトラフィックのプロトコルタイプです。有効な値:

  • TCP

  • UDP

  • ICMP

  • ANY:すべてのプロトコルタイプ。

説明

このパラメータを指定しない場合、すべてのプロトコルタイプが照会されます。

ANY

DestinationGroupType

string

ポリシー内の宛先アドレス帳のタイプです。有効な値:

  • ip:IP アドレスまたは CIDR ブロックを含むアドレス帳。

  • tag:指定したタグに一致する ECS インスタンスの IP アドレスを含むアドレス帳。

  • domain:1 つ以上のドメイン名を含むアドレス帳。

  • threat:悪意のある IP アドレスまたはドメイン名を含む脅威インテリジェンスアドレス帳。

  • backsrc:Anti-DDoS または WAF インスタンスの back-to-source アドレスを含む back-to-source アドレス帳。

domain

Destination

string

アクセス制御ポリシー内の宛先アドレスです。このパラメータはあいまい検索に対応しています。このパラメータの値は DestinationType の値によって異なります。

  • DestinationTypenet に設定した場合、このパラメータの値は CIDR ブロックです。例:10.0.3.0/24。

  • DestinationTypedomain に設定した場合、このパラメータの値はドメイン名です。例:aliyun。

  • DestinationTypegroup に設定した場合、このパラメータの値はアドレス帳の名前です。例:db_group。

  • DestinationTypelocation に設定されている場合、このパラメーターの値はロケーションです。ロケーションコードの詳細については、AddControlPolicy をご参照ください。例: ["BJ11", "ZB"]。

説明

このパラメータを指定しない場合、すべてのタイプの宛先アドレスが照会されます。

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: A single port or a port range.

  • group: A port address book.

port

AclUuid

string

ポリシーの UUID です。

1e8ed1b2-cebc-4b95-a9cc-0cb7ce2c0c2c

DestPortType

string

ポリシー内の宛先ポートのタイプです。有効な値:

  • port:単一ポートまたはポート範囲。

  • group:ポートアドレス帳。

port

Source

string

ポリシー内の送信元アドレスです。

有効な値:

  • SourceTypenet に設定した場合、Source の値は送信元 CIDR ブロックです。

    例:10.2.4.0/24

  • SourceTypegroup に設定した場合、Source の値は送信元アドレス帳の名前です。

    例:db_group

10.71.94.24

DestinationType

string

ポリシー内の宛先アドレスのタイプです。

有効な値:

  • net:宛先 CIDR ブロック。

  • group:宛先アドレス帳。

  • domain:宛先ドメイン名。

group

DestPort

string

ポリシー内のトラフィックの宛先ポートです。

22/22

IpVersion

integer

Cloud Firewall で保護されるアセットの IP バージョンです。有効な値:

  • 4:IPv4 (デフォルト)。

  • 6:IPv6。

4

AclAction

string

ポリシーに一致するトラフィックに対して実行されるアクションです。有効な値:

  • accept:トラフィックを許可します。

  • drop:トラフィックを破棄します。

  • log:トラフィックを監視します。

log

Release

string

ポリシーが有効かどうかを示します。有効な値:

  • true:ポリシーは有効です。

  • false:ポリシーは無効です。

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

ポリシーの有効期間の繰り返しタイプです。有効な値:

  • Permanent:常時。

  • None:単発。

  • Daily:毎日。

  • Weekly:毎週。

  • Monthly:毎月。

None

RepeatDays

array

ポリシーが繰り返される曜日または月の日付の配列です。

  • RepeatTypePermanentNone、または Daily に設定した場合、RepeatDays は空の配列です。例:[]

  • RepeatTypeWeekly に設定した場合、RepeatDays は空にできません。例:[0, 6]

説明

RepeatTypeWeekly に設定した場合、RepeatDays に重複する値を含めることはできません。

  • RepeatTypeMonthly に設定した場合、RepeatDays は空にできません。例:[1, 31]

説明

RepeatTypeMonthly に設定した場合、RepeatDays に重複する値を含めることはできません。

integer

ポリシーが繰り返される曜日または月の日付です。

  • RepeatTypePermanentNone、または Daily に設定した場合、RepeatDays は空の配列です。例:[]

  • RepeatTypeWeekly に設定した場合、RepeatDays は空にできません。例:[0, 6]

説明

RepeatTypeWeekly に設定した場合、RepeatDays に重複する値を含めることはできません。

  • RepeatTypeMonthly に設定した場合、RepeatDays は空にできません。例:[1, 31]

説明

RepeatTypeMonthly に設定した場合、RepeatDays に重複する値を含めることはできません。

1

RepeatStartTime

string

繰り返しの開始時刻 (HH:mm 形式) です。時刻は 00 分または 30 分である必要があり、終了時刻の 30 分以上前である必要があります。

説明

このパラメータは、RepeatTypeDailyWeekly、または Monthly の場合にのみ返されます。

08:00

RepeatEndTime

string

繰り返しの終了時刻 (HH:mm 形式) です。時刻は 00 分または 30 分である必要があり、開始時刻の 30 分以上後である必要があります。

説明

このパラメータは、RepeatTypeDailyWeekly、または Monthly の場合にのみ返されます。

23:30

StartTime

integer

照会の開始時刻です。値は UNIX タイムスタンプです。単位:秒。

1736130347

EndTime

integer

照会の終了時刻です。値は UNIX タイムスタンプです。単位:秒。

1752754426

AddressListCount

integer

アドレス帳内のアドレス数です。

1

GroupUuid

string

アドレス帳の UUID です。

説明

詳細については、「DescribeAddressBook」をご参照ください。

5a96a798-9b73-47f7-831e-1d7aa3c987a9

AutoAddTagEcs

integer

指定したタグに一致する新規 ECS インスタンスのパブリック IP アドレスがアドレス帳に自動追加されるかどうかを示します。これは、新規購入したインスタンスと、タグが更新されて一致するようになった既存インスタンスの両方に適用されます。

0

GroupName

string

アドレス帳の名前です。

subscribe

ReferenceCount

integer

アドレス帳の参照回数です。

1

GroupType

string

アドレス帳のタイプです。有効な値:

  • ip:IP アドレス帳。

  • domain:ドメインアドレス帳。

  • port:ポートアドレス帳。

  • tag:ECS タグベースのアドレス帳。

  • allCloud:クラウドサービスアドレス帳。

  • threat:脅威インテリジェンスアドレス帳。

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:FQDN ベースの解決。

  • 1:動的 DNS ベースの解決。

  • 2:FQDN と動的 DNS ベースの解決の組み合わせ。

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: トラフィックヒットのないポリシー。

  • PolicySourceDestinationSame: ソースと宛先が同じ無効なポリシー。

  • PolicyDuplicate: 重複する冗長ポリシー。

  • PolicyConflict: ビジネス競合ポリシー。

  • DefaultPolicyNotDeny: デフォルトポリシーがすべて拒否のホワイトリストメカニズムではない。

  • PolicyPortHighRisk: 高リスクポートを通じたトラフィックを許可するポリシー。

  • PolicyTooLoose: 過度に許可的な制御ポリシー。

  • AddressBookIpSeparated: 重複、オーバーラップ、または分散したIPアドレス帳。

  • AddressBookPortSeparated: 重複、オーバーラップ、または分散したポートアドレス帳。

  • AddressBookDomainValid: ドメインアドレス帳の有効性チェック。

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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。