すべてのプロダクト
Search

このプロダクト

    Web Application Firewall:CreateLogDeliveryConfig

    ドキュメントセンター

    Web Application Firewall:CreateLogDeliveryConfig

    最終更新日:Mar 17, 2026

    ハイブリッドクラウド環境における Web Application Firewall (WAF) インスタンス向けのログ配信構成を作成します。

    今すぐお試しください

    この 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-waf:CreateLogDeliveryConfig

    create

    *All Resource

    *
    • acs:ResourceGroupId
    		 なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    必須

    WAF インスタンスの ID です。

    説明

    WAF インスタンスの ID を照会するには、DescribeInstance 操作を呼び出してください。

    waf_elasticity-cn-0xldbqt****
    DeliveryName

    string

    必須

    ログ配信構成の名前です。

    test1
    DeliveryType

    string

    必須

    ログ配信構成の種別です。有効な値は以下のとおりです。

    • syslog：syslog サービスへログを配信します。

    • kafka：Kafka サービスへログを配信します。

    syslog
    DeliveryDetail

    string

    必須

    ログ配信構成の詳細です。この値は、一連のパラメーターから生成された JSON 文字列です。

    説明

    パラメーターの内容は DeliveryType の値によって異なります。「ログ配信構成の詳細に関するパラメーター」をご参照ください。

    { "rfcVersion": "rfc3164", "protocol": "tcp", "servers": [ { "address": "1.1.1.1", "port": 20 } ] }
    RegionId

    string

    任意

    WAF インスタンスが配置されているリージョンです。有効な値は以下のとおりです。

    • cn-hangzhou：中国本土

    • ap-southeast-1：中国本土以外

    cn-hangzhou
    ResourceManagerResourceGroupId

    string

    任意

    Alibaba Cloud リソースグループの ID です。

    rg-acfm***q

    ログ配信構成の詳細

    syslog サービスへのログ配信 (syslog)

    パラメーター

    名前型必須例説明
    serversArrayはい[{"address":"11.11.XX.XX","port":8000}]syslog サービスのリモートアドレスです。DeliveryType が syslog の場合、アドレスは 1 つだけ指定できます。アドレスには以下のパラメーターが含まれます。
    - address：サーバーのドメイン名または IP アドレスです。IPv4 および IPv6 アドレスに対応しています。必須パラメーターです。
    - port：サーバーポートです。必須パラメーターです。

    rfcVersionStringいいえrfc3164syslog の RFC バージョンです。有効な値は以下のとおりです。
    - rfc3164（デフォルト）：RFC 3164
    - rfc5424：RFC 5424

    protocolStringはいtcpsyslog のプロトコルです。有効な値は以下のとおりです。
    - tcp：TCP
    - udp：UDP

    {
	"InstanceId": "waf_v2_public_cn-n*******",
	"DeliveryName": "test1",
	"DeliveryType": "syslog",
	"DeliveryDetail": "{\"rfcVersion\":\"rfc3164\",\"protocol\":\"tcp\",\"servers\":[{\"address\":\"11.11.XX.XX\",\"port\":8000}]}"
}

    Kafka サービスへのログ配信 (kafka)

    パラメーター

    名前型必須例説明
    serversArrayはい[{"address":"a.com","port":8000}]Kafka サービスのリモートアドレスです。DeliveryType が kafka の場合、最大で 3 つのアドレスを指定できます。各アドレスには以下のパラメーターが含まれます。
    - address：サーバーのドメイン名または IP アドレスです。IPv4 および IPv6 アドレスに対応しています。必須パラメーターです。
    - port：サーバーポートです。必須パラメーターです。

    kafkaTopicStringはいtestKafka のトピック ID またはトピック名です。
    protocolStringはいPLAINTEXTKafka のセキュリティプロトコルです。有効な値は以下のとおりです。
    - PLAINTEXT（デフォルト）：PLAINTEXT
    - SASL_PLAINTEXT：SASL_PLAINTEXT
    - SASL_SSL：SASL_SSL


    saslUserNameStringいいえuser123Kafka サービスの SASL 認証に使用するユーザー名です。protocol が SASL_PLAINTEXT または SASL_SSL の場合は、このパラメーターを指定する必要があります。
    saslPasswordStringいいえuser***Kafka サービスの SASL 認証に使用するパスワードです。protocol が SASL_PLAINTEXT または SASL_SSL の場合は、このパラメーターを指定する必要があります。
    pemCertStringいいえCertKafka サービス用のカスタム証明書です。証明書は PEM 形式である必要があります。
    compressionCodecStringいいえnoneKafka の圧縮方式です。有効な値は以下のとおりです。
    - none（デフォルト）：圧縮なし
    - gzip：Gzip
    - zstd：Zstandard
    - lz4：LZ4
    - snappy：Snappy




    {
	"InstanceId": "waf_v2_public_cn-n*********",
	"DeliveryName": "test2",
	"DeliveryType": "kafka",
	"DeliveryDetail": "{\"kafkaTopic\":\"topictest1\",\"protocol\":\"SASL_PLAINTEXT\",\"servers\":[{\"address\":\"a.com\",\"port\":1000},{\"address\":\"ba.com\",\"port\":1000},{\"address\":\"c.com\",\"port\":1000}],\"saslUserName\":\"user123\",\"saslPassword\":\"user****\"}"
}

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    DeliveryName

    string

    ログ配信構成の名前です。

    test1
    RequestId

    string

    リクエストの ID です。

    26E46541-7AAB-5565-801D-F14DBDC5****

    例

    成功レスポンス

    JSONJSON

    {
  "DeliveryName": "test1",
  "RequestId": "26E46541-7AAB-5565-801D-F14DBDC5****"
}

    エラーコード

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

    変更履歴

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