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

Edge Security Acceleration:CreateSiteDeliveryTask

最終更新日:Jun 26, 2026

リアルタイムログ配信タスクを作成します。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

esa:CreateSiteDeliveryTask

create

*Site

acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

BusinessType

string

必須

ビジネスタイプ。有効値:

  • dcdn_log_access_l1 (デフォルト):アクセスログ。

  • dcdn_log_er:エッジ関数ログ。

  • dcdn_log_waf:WAF 保護ログ。

  • dcdn_log_ipa:レイヤー 4 加速ログ。

dcdn_log_access_l1

SiteId

integer

必須

サイト ID。ListSites 操作からこの値を取得できます。

12312312112***

DataCenter

string

任意

データセンター。有効値:

  • cn:中国本土。

  • oversea:中国本土以外のリージョン。

cn

TaskName

string

必須

タスク名。

dcdn-test-task

FieldName

string

必須

配信するログフィールド。コンマ (,) で区切ります。

user_agent,ip_adress,ip_port

DeliveryType

string

必須

送信先タイプ。有効値:

  • sls:Log Service。

  • http:HTTP サービス。

  • aws3:Amazon S3。

  • oss:Object Storage Service (OSS)。

  • kafka:Kafka サービス。

  • aws3cmpt:Amazon S3 互換サービス。

sls

DiscardRate

number

任意

破棄レート。デフォルト:0。

0.0

S3Delivery

object

任意

ログを Amazon S3 または S3 互換サービスに配信するためのパラメーター。

Region

string

任意

サービスリージョン。

cn-beijing

BucketPath

string

任意

バケットパス。

logriver-test/log

AccessKey

string

任意

Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID。

yourAccessKeyID

SecretKey

string

任意

AccessKey Secret。

LDSIKh***

Endpoint

string

任意

サーバーエンドポイント。S3Cmpt が true の場合に必須です。

説明

S3 互換サービスの場合、バケット名とエンドポイントを組み合わせたドメインの DNS 解決を構成します。例えば、Endpoint が example.com で Bucket が demo の場合、ログは demo.example.com に配信されます。

https://s3.oss-cn-hangzhou.aliyuncs.com

PrefixPath

string

任意

ストレージパスのプレフィックス。

logriver-test/log

S3Cmpt

boolean

任意

サービスが S3 互換であるかどうか。

true

ServerSideEncryption

boolean

任意

VertifyType

string

任意

OssDelivery

object

任意

ログを OSS に配信するためのパラメーター。

Region

string

任意

OSS バケットのリージョン。

cn-shanghai

Aliuid

string

任意

Alibaba Cloud アカウント ID。

1234***

BucketName

string

任意

バケット名。

test_rlog

PrefixPath

string

任意

OSS バケットに保存されるログのオブジェクトキーのプレフィックス。

test/

HttpDelivery

object

任意

ログを HTTP サーバーに配信するためのパラメーター。

DestUrl

string

任意

送信先の HTTP サーバーの URL。

http://xxx.aliyun.com/v1/log/upload

StandardAuthOn

boolean

任意

標準認証を使用するかどうか。

true

StandardAuthParam

object

任意

標準認証パラメーター。

PrivateKey

string

任意

秘密鍵。

***

ExpiredTime

integer

任意

暗号化タイムアウト期間。

説明

0 より大きい必要があります。推奨値:300 以上。

300

UrlPath

string

任意

標準認証の URI パス。

v1/log/upload

MaxBatchSize

integer

任意

バッチごとの最大ログエントリ数。

1000

MaxBatchMB

integer

任意

最大配信サイズ (MB)。

5

MaxRetry

integer

任意

最大リトライ回数。

3

TransformTimeout

integer

任意

タイムアウト期間 (秒)。

10

LogBodyPrefix

string

任意

ログ本文のプレフィックス。

cdnVersion:1.0

LogBodySuffix

string

任意

ログ本文のサフィックス。

cdnVersion:1.0

Compress

string

任意

圧縮メソッド。デフォルト:非圧縮。

gzip

HeaderParam

object

任意

カスタム HTTP リクエストヘッダー。

object

任意

StaticValue

string

任意

QueryParam

object

任意

カスタムクエリパラメーター。

object

任意

StaticValue

string

任意

LogSplit

boolean

任意

LastLogSplit

boolean

任意

LogSplitWords

string

任意

KafkaDelivery

object

任意

ログを Kafka クラスターに配信するためのパラメーター。

Topic

string

任意

Kafka トピック。

dqc_test2

UserAuth

boolean

任意

ユーザー認証を有効にするかどうか。

true

MachanismType

string

任意

暗号化メソッド。

plain

UserName

string

任意

ユーザー名。

xxx

Password

string

任意

暗号化用のパスワード。

***

Brokers

array

任意

ブローカーサーバーアドレス。

string

任意

Kafka ブローカーサーバー。

192.168.xxx.xxx:9902

Compress

string

任意

圧縮メソッド。

lz4

Balancer

string

任意

負荷分散メソッド。

kafka.LeastBytes

SlsDelivery

object

任意

ログを Log Service に配信するためのパラメーター。

SLSRegion

string

任意

Log Service プロジェクトのリージョン。

cn-hangzhou

SLSProject

string

任意

Log Service プロジェクト名。

dcdn-test20240417

SLSLogStore

string

任意

Log Service Logstore 名。

accesslog-test

FilterVer

string

任意

レスポンスフィールド

フィールド

説明

object

レスポンスボディ。

RequestId

string

リクエスト ID。

9358E852-992D-5BC7-8BD7-975CA02773A8

TaskName

string

タスク名。

er-oss

SiteId

integer

サイト ID。ListSites 操作からこの値を取得できます。

123456****

DataCenter

string

データセンター。有効値:

  • cn:中国本土。

  • Overseas:中国本土以外のリージョン。

cn

成功レスポンス

JSONJSON

{
  "RequestId": "9358E852-992D-5BC7-8BD7-975CA02773A8",
  "TaskName": "er-oss",
  "SiteId": 0,
  "DataCenter": "cn"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParameter The specified parameter is invalid.
400 RealTimeLog.ProjectExistError The real-time log delivery task name already exists. Check the task name and try again.
400 InternalError An internal exception occurred, please try again later.
403 RealTimeLog.KafkaBrokersExceedError The number of Kafka Broker addresses for real-time log delivery has reached the upper limit (50).
403 RealTimeLog.S3EndpointInvalidError Invalid S3 information for the delivery task. Check your configurations and try again.
403 RealTimeLog.StatusQuotaError The maximum number of real-time log delivery tasks has been reached. Check your plan quota and upgrade the plan to request a quota increase.
403 EsaService.NotOpen ESA service has not opend.

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

変更履歴

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