すべてのプロダクト
Search

このプロダクト

    Cloud Firewall:DescribeAclCheck

    ドキュメントセンター

    Cloud Firewall:DescribeAclCheck

    最終更新日:Jun 09, 2026

    アクセスコントロールリスト (ACL) チェックの詳細を取得します。

    操作説明

    QPS 制限

    この API には、ユーザー 1 人あたり 1 秒あたり 10 クエリ (QPS) の制限があります。この制限を超える呼び出しはスロットリングされます。

    今すぐお試しください

    この 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:DescribeAclCheck

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Lang

    string

    任意

    レスポンスの言語。

    列挙値:

    • en :

      英語

    • zh :

      中国語 (デフォルト)

    zh
    TaskId

    string

    必須

    タスク ID。

    132
    PageNo

    integer

    必須

    ページ番号。

    1
    PageSize

    integer

    必須

    ページあたりのエントリ数。

    10

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID です。

    25E655B0-CAED-53D4-8054-F983126****
    CheckRecord

    object

    チェックレコードです。

    AclTotalCount

    integer

    チェック時のアクセス制御ポリシーの総数です。

    10
    RecordAssessmentDetail

    string

    ACL チェックの評価詳細です。

    It is recommended to remove the invalid policy, while helping to save the specification.

    CheckName

    string

    ACL チェックの名前です。

    PolicyHitCountZero
    Description

    string

    ACL チェック項目の説明です。

    Due to business offline or other reasons, the number of hits of the object policy in a period of time is 0.

    LastCheckTime

    string

    最終チェックの時刻 (秒単位の UNIX タイムスタンプ) です。

    1724982259
    Level

    string

    リスクレベルです。

    High
    TaskId

    string

    タスク ID です。

    task-c92d4544ef7b6a42
    Acls

    array<object>

    ACL チェック結果です。

    array<object>

    ACL チェック結果です。

    Acl

    object

    ACL チェック結果です。

    Direction

    string

    インターネットトラフィックの方向です。有効な値は次のとおりです：

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

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

    out
    Order

    integer

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

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

    1
    SourceType

    string

    アクセス制御ポリシーの送信元アドレスのタイプです。有効な値は次のとおりです：

    • net：送信元 CIDR ブロック

    • group：送信元アドレス帳

    • location：送信元リージョン

    group
    ApplicationName

    string

    VPC ファイアウォールのアクセス制御ポリシーでサポートされるアプリケーションタイプです。代わりに ApplicationNameList パラメーターを使用することを推奨します。有効な値は次のとおりです：

    • HTTP

    • HTTPS

    • MySQL

    • SMTP

    • SMTPS

    • RDP

    • VNC

    • SSH

    • Redis

    • MQTT

    • MongoDB

    • Memcache

    • SSL

    • ANY：すべてのアプリケーションタイプ

    ANY
    HitTimes

    integer

    アクセス制御ポリシーのヒット数です。

    1
    Description

    string

    アクセス制御ポリシーの説明です。

    test_policy
    SourceGroupType

    string

    アクセス制御ポリシーの送信元アドレス帳のタイプです。有効な値は次のとおりです：

    • ip：1 つ以上の IP アドレスまたは CIDR ブロックを含むアドレス帳。

    • tag：特定のタグを持つ ECS インスタンスのパブリック IP アドレスを含むアドレス帳。

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

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

    • backsrc：1 つ以上の Anti-DDoS または WAF インスタンスのバックツーソース IP アドレスを含むバックツーソースアドレス帳。

    ip
    DnsResultTime

    integer

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

    1579261141
    DnsResult

    string

    DNS 解決の結果です。

    192.0.XX.XX
    Proto

    string

    アクセス制御ポリシーのトラフィックのプロトコルタイプです。有効な値は次のとおりです：

    • TCP

    • UDP

    • ICMP

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

    説明

    TCP
    DestinationGroupType

    string

    アクセス制御ポリシーの宛先アドレス帳のタイプです。有効な値は次のとおりです：

    • ip：1 つ以上の CIDR ブロックを含む IP アドレス帳。

    • tag：特定のタグを持つ ECS インスタンスのパブリック IP アドレスを含む ECS タグベースのアドレス帳。

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

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

    • backsrc：1 つ以上の Anti-DDoS または WAF インスタンスのバックツーソース IP アドレスを含むバックツーソースアドレス帳。

    domain
    Destination

    string

    アクセス制御ポリシーの宛先アドレスです。このパラメーターの値は、DestinationType の値によって異なります。

    • DestinationType の値が net の場合、このパラメーターの値は CIDR ブロックです。例：10.0.3.0/24。

    • DestinationType の値が domain の場合、このパラメーターの値はドメイン名です。例：aliyun。

    • DestinationType の値が group の場合、このパラメーターの値はアドレス帳の名前です。例：db_group。

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

    説明

    このパラメーターを省略した場合、すべての宛先アドレスタイプが対象となります。

    kms.cn-shanghai.aliyuncs.com
    HitLastTime

    integer

    ポリシーが最後にヒットした時刻 (秒単位の UNIX タイムスタンプ) です。

    1579261141
    DestPortGroup

    string

    宛先ポートアドレス帳の名前です。

    • port: Port

    • group: Port address book

    my_port_group

    AclUuid

    string

    アクセス制御ポリシーの一意の ID です。

    997b38e0-01fa-4db7-8d30-02ebf6fdb747
    DestPortType

    string

    アクセス制御ポリシーの宛先ポートのタイプです。有効な値は次のとおりです：

    • port：ポート

    • group：ポートアドレス帳

    port
    Source

    string

    アクセス制御ポリシーの送信元アドレスです。このパラメーターの値は、SourceType の値によって異なります。

    • SourceType が net の場合、このパラメーターの値は CIDR ブロックです。例：192.0.XX.XX/24。

    • SourceType が group の場合、このパラメーターの値は送信元アドレス帳の名前です。例：db_group。

    • SourceType が location の場合、このパラメーターの値はロケーションです。詳細については、AddControlPolicy をご参照ください。例：["BJ11", "ZB"]。

    172.28.7.167
    DestinationType

    string

    アクセス制御ポリシーの宛先アドレスのタイプです。有効な値は次のとおりです：

    • net：宛先 CIDR ブロック

    • group：宛先アドレス帳

    • domain：宛先ドメイン名

    • location：宛先リージョン

    domain
    DestPort

    string

    アクセス制御ポリシーで使用される宛先ポートです。

    80/80
    IpVersion

    integer

    IP バージョンです。有効な値は次のとおりです：

    • 4：IPv4

    • 6：IPv6

    4
    AclAction

    string

    アクセス制御ポリシーに一致するトラフィックに対して実行されるアクションです。有効な値は次のとおりです：

    • accept：許可

    • drop：拒否

    • log：監視

    log
    Release

    string

    アクセス制御ポリシーのステータスです。有効な値は次のとおりです：

    • true：有効

    • false：無効

    true
    ApplicationId

    string

    アクセス制御ポリシーで使用されるアプリケーションの ID です。

    plugin_idp4_ciam
    DestinationGroupCidrs

    array

    宛先アドレス帳の CIDR ブロックです。

    string

    宛先アドレス帳の CIDR ブロックです。

    192.0.XX.XX/32
    DestPortGroupPorts

    array

    宛先ポートアドレス帳のポートです。

    string

    宛先ポートアドレス帳のポートです。

    80/80
    SourceGroupCidrs

    array

    送信元アドレス帳の CIDR ブロックです。

    string

    送信元アドレス帳の CIDR ブロックです。

    111.48.54.39/32
    ApplicationNameList

    array

    アクセス制御ポリシーでサポートされるアプリケーションタイプです。有効な値は次のとおりです：

    • FTP

    • HTTP

    • HTTPS

    • Memcache

    • MongoDB

    • MQTT

    • MySQL

    • RDP

    • Redis

    • SMTP

    • SMTPS

    • SSH

    • SSL

    • VNC

    • ANY (すべてのアプリケーションタイプを示します)

    string

    VPC ファイアウォールのアクセス制御ポリシーでサポートされるアプリケーションタイプです。有効な値は次のとおりです：

    • FTP

    • HTTP

    • HTTPS

    • MySQL

    • SMTP

    • SMTPS

    • RDP

    • VNC

    • SSH

    • Redis

    • MQTT

    • MongoDB

    • Memcache

    • SSL

    ANY
    SpreadCnt

    integer

    ポリシーが消費する仕様ユニットの数です。値は、送信元アドレスの数 × 宛先アドレスの数 × ポート範囲の数 × アプリケーションの数という式で計算されます。

    10
    CreateTime

    integer

    ポリシーが作成された時刻 (秒単位の UNIX タイムスタンプ) です。

    1761062400
    ModifyTime

    integer

    ポリシーが最後に変更された時刻 (秒単位の UNIX タイムスタンプ) です。

    1761062400
    RepeatType

    string

    ポリシーの繰り返しタイプです。有効な値は次のとおりです：

    • Permanent (デフォルト)：ポリシーは常に有効です。

    • None：ポリシーは一度だけ有効です。

    • Daily：ポリシーは毎日繰り返されます。

    • Weekly：ポリシーは毎週繰り返されます。

    • Monthly：ポリシーは毎月繰り返されます。

    Permanent
    RepeatDays

    array

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

    説明

    RepeatType が Weekly の場合、有効な値は 0～6 です。週は日曜日から始まります。RepeatType が Monthly の場合、有効な値は 1～31 です。

    integer

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

    説明

    RepeatType が Weekly の場合、有効な値は 0～6 です。週は日曜日から始まります。RepeatType が Monthly の場合、有効な値は 1～31 です。

    6
    RepeatStartTime

    string

    ポリシーが有効になる時刻です (例：08:00)。時刻は正時または 30 分単位で指定し、繰り返しの終了時刻より少なくとも 30 分早くする必要があります。

    説明

    RepeatType が Permanent または None の場合、このパラメーターは空になります。RepeatType が Daily、Weekly、または Monthly の場合、このパラメーターは必須です。時刻は HH:mm 形式 (例：08:00、23:30) です。

    08:00

    RepeatEndTime

    string

    ポリシーが無効になる時刻です (例：23:30)。時刻は正時または 30 分単位で指定し、繰り返しの開始時刻より少なくとも 30 分遅くする必要があります。

    説明

    RepeatType が Permanent または None の場合、このパラメーターは空になります。RepeatType が Daily、Weekly、または Monthly の場合、このパラメーターは必須です。時刻は HH:mm 形式 (例：08:00、23:30) です。

    23:30
    StartTime

    integer

    ポリシーの有効期間の開始時刻 (秒単位の UNIX タイムスタンプ) です。

    1730318400
    EndTime

    integer

    ポリシーの有効期間の終了時刻です。これは秒単位の UNIX タイムスタンプです。時刻は正時または 30 分単位で、開始時刻より少なくとも 30 分遅くする必要があります。

    説明

    RepeatType が Permanent の場合、このパラメーターは空になります。RepeatType が None、Daily、Weekly、または Monthly の場合は必須です。

    1758334822
    AddressListCount

    integer

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

    1
    GroupUuid

    string

    アドレス帳の一意の ID です。

    この ID は、アドレス帳の削除など、他の操作に必要です。ID は、DescribeAddressBook を呼び出して取得します。

    b91d86c3-2b52-4534-aae9-8d0339b12a48
    AutoAddTagEcs

    integer

    タグに一致する新しい ECS インスタンスのパブリック IP アドレスをアドレス帳に自動的に追加するかどうかを示します。新しい ECS インスタンスには、指定されたタグを持つ新規購入インスタンスと、タグが一致するように変更された既存のインスタンスが含まれます。

    0
    GroupName

    string

    アドレス帳の名前です。

    Zhong Kui Open White List
    ReferenceCount

    integer

    このアドレス帳を参照するポリシーの数です。

    1
    GroupType

    string

    アドレス帳のタイプです。有効な値は次のとおりです：

    • ip：IP アドレス帳

    • domain：ドメインアドレス帳

    • port：ポートアドレス帳

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

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

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

    ip
    TagRelation

    string

    複数の ECS タグ間の論理関係です。有効な値は次のとおりです：

    • and：ECS インスタンスは、指定されたすべてのタグを持つ必要があります。

    • or：ECS インスタンスは、指定されたタグのいずれかを持つ必要があります。

    or
    TagList

    array<object>

    ECS タグです。

    object

    ECS タグです。

    TagValue

    string

    ECS タグの値です。

    tfTestAcc0
    TagKey

    string

    ECS タグのキーです。

    ss
    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-2ze4w62zbdkwjmoqeokgl
    DomainResolveType

    integer

    アクセス制御ポリシーにおけるドメイン名の DNS 解決方法です。有効な値は次のとおりです：

    • 0：FQDN ベースの解決

    • 1：ダイナミック DNS

    • 2：FQDN ベースおよびダイナミック DNS

    FQDN
    VpcFirewallId

    string

    VPC ファイアウォールのインスタンス ID です。

    vfw-925514970c2c4bcab222
    Addresses

    array<object>

    アドレスとその備考です。

    object

    アドレスとその備考です。

    Address

    string

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

    192.0.XX.XX/32
    Note

    string

    備考です。

    Reviewed
    AclStatus

    string

    ACL チェックのステータスです。

    列挙値:

    • Pending :

      ポリシーは処理待ちです。

    • Ignored :

      ポリシーは無視されます。

    • Processed :

      ポリシーは処理済みです。

    Pending
    AclAssessmentDetail

    string

    アクセス制御ポリシーの評価詳細です。

    No traffic hit policy.

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "25E655B0-CAED-53D4-8054-F983126****",
  "CheckRecord": {
    "AclTotalCount": 10,
    "RecordAssessmentDetail": "It is recommended to remove the invalid policy, while helping to save the specification.\n",
    "CheckName": "PolicyHitCountZero",
    "Description": "Due to business offline or other reasons, the number of hits of the object policy in a period of time is 0.\n",
    "LastCheckTime": "1724982259",
    "Level": "High",
    "TaskId": "task-c92d4544ef7b6a42",
    "Acls": [
      {
        "Acl": {
          "Direction": "out",
          "Order": 1,
          "SourceType": "group",
          "ApplicationName": "ANY",
          "HitTimes": 1,
          "Description": "test_policy",
          "SourceGroupType": "ip",
          "DnsResultTime": 1579261141,
          "DnsResult": "192.0.XX.XX",
          "Proto": "TCP",
          "DestinationGroupType": "domain",
          "Destination": "kms.cn-shanghai.aliyuncs.com",
          "HitLastTime": 1579261141,
          "DestPortGroup": "my_port_group\n",
          "AclUuid": "997b38e0-01fa-4db7-8d30-02ebf6fdb747",
          "DestPortType": "port",
          "Source": "172.28.7.167",
          "DestinationType": "domain",
          "DestPort": "80/80",
          "IpVersion": 4,
          "AclAction": "log",
          "Release": "true",
          "ApplicationId": "plugin_idp4_ciam",
          "DestinationGroupCidrs": [
            "192.0.XX.XX/32"
          ],
          "DestPortGroupPorts": [
            "80/80"
          ],
          "SourceGroupCidrs": [
            "111.48.54.39/32"
          ],
          "ApplicationNameList": [
            "ANY"
          ],
          "SpreadCnt": 10,
          "CreateTime": 1761062400,
          "ModifyTime": 1761062400,
          "RepeatType": "Permanent",
          "RepeatDays": [
            6
          ],
          "RepeatStartTime": "08:00\n",
          "RepeatEndTime": "23:30",
          "StartTime": 1730318400,
          "EndTime": 1758334822,
          "AddressListCount": 1,
          "GroupUuid": "b91d86c3-2b52-4534-aae9-8d0339b12a48",
          "AutoAddTagEcs": 0,
          "GroupName": "Zhong Kui Open White List",
          "ReferenceCount": 1,
          "GroupType": "ip",
          "TagRelation": "or",
          "TagList": [
            {
              "TagValue": "tfTestAcc0",
              "TagKey": "ss"
            }
          ],
          "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-2ze4w62zbdkwjmoqeokgl",
          "DomainResolveType": 0,
          "VpcFirewallId": "vfw-925514970c2c4bcab222",
          "Addresses": [
            {
              "Address": "192.0.XX.XX/32",
              "Note": "Reviewed"
            }
          ]
        },
        "AclStatus": "Pending",
        "AclAssessmentDetail": "No traffic hit policy."
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ErrorAclCheckNotExist ACL check not exist.

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

    変更履歴

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