すべてのプロダクト
Search

このプロダクト

    Server Load Balancer:CreateAScripts

    ドキュメントセンター

    Server Load Balancer:CreateAScripts

    最終更新日:May 30, 2026

    スクリプトを作成します。

    操作説明

    前提条件

    • スタンダードエディションまたは WAF 強化エディションの ALB インスタンスが作成済みであることが必要です。 詳細については、「CreateLoadBalancer」をご参照ください。

    使用方法

    CreateAScripts は非同期操作です。 リクエストを送信すると、システムからリクエスト ID が返されますが、作成タスクはバックグラウンドで実行されるため、プログラマブルスクリプトはすぐには作成されません。 ListAScripts を呼び出して、プログラマブルスクリプトの作成ステータスを照会できます：

    • プログラマブルスクリプトが 作成中 の状態の場合、そのスクリプトは作成中です。

    • プログラマブルスクリプトが 利用可能 な状態の場合、作成済みです。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    alb:CreateAScripts

    create

    *LoadBalancer

    acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ClientToken

    string

    任意

    リクエストのべき等性を保証するためのクライアントトークンです。

    クライアント側で生成できます。この値はリクエスト間で一意にし、ASCII 文字のみを含める必要があります。

    5A2CFF0E-5718-45B5-9D4D-70B******
    DryRun

    boolean

    任意

    ドライランを実行するかどうかを指定します。有効な値：

    • true ：ドライランを実行します。AScript は作成されません。システムはリクエストの必須パラメーター、フォーマットの有効性、およびサービス制限をチェックします。リクエストがチェックに失敗した場合、エラーメッセージが返されます。リクエストがチェックに合格した場合、DryRunOperation エラーコードが返されます。

    • false (デフォルト) ：通常のリクエストを送信します。リクエストがチェックに合格すると、システムは HTTP 2xx ステータスコードを返し、操作を実行します。

    false
    ListenerId

    string

    必須

    リスナーIDです。

    lsn-6hfq3zs0x04ibn****
    AScripts

    array<object>

    任意

    作成する AScript の配列です。

    array<object>

    任意

    AScript の設定です。

    AScriptName

    string

    必須

    AScript の名前です。

    名前は 2〜128 文字の長さで、文字、数字、または漢字で始まる必要があります。数字、ピリオド (.)、アンダースコア (_)、ハイフン (-)、スペースを含めることができます。

    test
    Position

    string

    任意

    AScript を実行するタイミングを指定します。有効な値：

    • RequestHead (デフォルト) ：リクエストルールの前に実行されます。

    • RequestFoot ：リクエストルールの後に実行されます。

    • ResponseHead ：レスポンスルールの前に実行されます。

    RequestFoot
    Enabled

    boolean

    任意

    AScript を有効にするかどうかを指定します。有効な値：

    • true ：有効。

    • false (デフォルト) ：無効。

    false
    ScriptContent

    string

    必須

    AScript の内容です。

    if and(match_re($uri, '^/1.txt$'), $arg_type) { rewrite(concat('/1.', $arg_type), 'break') }
    ExtAttributes

    array<object>

    任意

    拡張属性です。

    object

    任意

    AttributeKey

    string

    任意

    属性キーです。

    有効な値は EsDebug のみです。リクエストに _es_dbg パラメーターが含まれ、その値が AttributeValue で指定されたシークレットキーと一致する場合、システムはレスポンスにデバッグヘッダーを追加します。このデバッグヘッダーにはルール実行ログが含まれます。

    EsDebug
    AttributeValue

    string

    任意

    属性値です。EsDebug 属性のシークレットキーとして使用されます。値は 1〜128 文字の長さで、大文字、小文字、数字を含めることができます。

    test123
    ExtAttributeEnabled

    boolean

    任意

    AScript の拡張属性を有効にするかどうかを指定します。有効な値：

    • true ：有効。

    • false (デフォルト) ：無効。

    true

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスデータ。

    JobId

    string

    非同期タスクの ID。

    5c607642-535e-4e06-9d77-df53049b****
    RequestId

    string

    リクエストの ID。

    BF0FE763-9603-558F-A55B-0F4******
    AScriptIds

    array<object>

    プログラマブルスクリプト ID のリスト。

    object

    プログラマブルスクリプト。

    AScriptId

    string

    プログラマブルスクリプトの ID。

    as-xvq5igaa7uv6vr****

    例

    成功レスポンス

    JSONJSON

    {
  "JobId": "5c607642-535e-4e06-9d77-df53049b****",
  "RequestId": "BF0FE763-9603-558F-A55B-0F4******",
  "AScriptIds": [
    {
      "AScriptId": "as-xvq5igaa7uv6vr****"
    }
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 IncorrectStatus.Listener The status of %s [%s] is incorrect.
    400 ResourceQuotaExceeded.AScriptsNum The quota of %s is exceeded for resource %s, usage %s/%s.
    400 ResourceQuotaExceeded.AScriptsTotalLinesNum The quota of %s is exceeded for resource %s, usage %s/%s.
    400 ResourceQuotaExceeded.AScriptLinesNum The quota of %s is exceeded for resource %s, usage %s/%s.

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

    変更履歴

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