すべてのプロダクト
Search

このプロダクト

    :UpdateRulesAttribute

    ドキュメントセンター

    :UpdateRulesAttribute

    最終更新日:Oct 10, 2025

    複数の転送ルールのプロパティをバッチで更新します。

    操作説明

    UpdateRulesAttribute は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。転送ルールのプロパティはすぐには更新されません。ListRules 操作を呼び出して、転送ルールの更新ステータスをクエリできます。

    • 複数の転送ルールが Configuring 状態の場合、そのプロパティはバッチで更新されています。

    • 複数の転送ルールが Available 状態の場合、そのプロパティは更新されます。

    • 転送ルールは、次の最大数の条件 (RuleConditions) とアクション (RuleActions) をサポートします。

      • 条件: Basic Edition インスタンスの場合は 5、Standard Edition インスタンスの場合は 10、WAF 対応インスタンスの場合は 10。

      • アクション: Basic Edition インスタンスの場合は 3、Standard Edition インスタンスの場合は 5、WAF 対応インスタンスの場合は 5。

    今すぐお試しください

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

    update

    *LoadBalancer

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

    *ServerGroup

    acs:alb:{#regionId}:{#accountId}:servergroup/{#ServerGroupId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ClientToken

    string

    任意

    リクエストのべき等性を保証するために使用されるクライアントトークン。

    クライアントトークンが異なるリクエスト間で一意であることを確認してください。クライアントトークンには ASCII 文字のみを含めることができます。

    説明

    このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。各 API リクエストの RequestId は異なります。

    123e4567-e89b-12d3-a456-42665544***
    Rules

    array<object>

    必須

    転送ルールのリスト。

    array<object>

    必須

    転送ルール。

    Priority

    integer

    任意

    転送ルールの優先度。

    80
    RuleName

    string

    任意

    転送ルールの名前。

    rule_111
    RuleActions

    array

    任意

    転送ルールのアクションのリスト。

    array<object>

    必須

    転送ルールのアクション。

    FixedResponseConfig

    object

    任意

    固定レスポンスを返すアクションの設定。

    Content

    string

    任意

    コンテンツ。

    dssacav
    ContentType

    string

    任意

    コンテンツタイプ。

    text/plain
    HttpCode

    string

    任意

    HTTP ステータスコード。

    200
    ForwardGroupConfig

    object

    任意

    リクエストをサーバーグループに転送するアクションの設定。

    ServerGroupTuples

    array

    任意

    宛先サーバーグループのリスト。

    object

    任意

    宛先サーバーグループ。

    ServerGroupId

    string

    任意

    サーバーグループ ID。

    sgp-3kbj35ay7cvi******
    Weight

    integer

    任意

    重み。

    100
    ServerGroupStickySession

    object

    任意

    サーバーグループ間のセッション維持。

    Enabled

    boolean

    任意

    セッション維持を有効にするかどうかを指定します。

    true
    Timeout

    integer

    任意

    タイムアウト期間。

    100
    InsertHeaderConfig

    object

    任意

    ヘッダーを挿入するアクションの設定。

    CoverEnabled

    boolean

    任意

    リクエストヘッダーの値を上書きするかどうかを指定します。

    False
    Key

    string

    任意

    HTTP ヘッダー。

    key
    Value

    string

    任意

    HTTP ヘッダーのコンテンツ。

    value
    ValueType

    string

    任意

    値のタイプ。

    SystemDefined
    Order

    integer

    必須

    優先度。

    1
    RedirectConfig

    object

    任意

    リダイレクトアクションの設定。

    Host

    string

    任意

    リクエストがリダイレクトされる宛先ホスト。

    test.alb.com
    HttpCode

    string

    任意

    リダイレクトメソッド。

    301
    Path

    string

    任意

    リクエストがリダイレクトされる宛先パス。

    /
    Port

    string

    任意

    リクエストがリダイレクトされる宛先ポート。

    443
    Protocol

    string

    任意

    リクエストがリダイレクトされる宛先プロトコル。

    HTTPS
    Query

    string

    任意

    リクエストがリダイレクトされる宛先クエリ文字列。

    ${query}
    RewriteConfig

    object

    任意

    書き換えアクションの設定。

    Host

    string

    任意

    ホスト名。

    ${host}
    Path

    string

    任意

    パス。

    /
    Query

    string

    任意

    クエリ。

    ${query}
    Type

    string

    必須

    転送ルールアクションのタイプ。

    ForwardGroup
    TrafficLimitConfig

    object

    任意

    速度制限の設定。

    QPS

    integer

    任意

    1 秒あたりのクエリ数 (QPS)。

    1000
    PerIpQps

    integer

    任意

    単一 IP アドレスの QPS 数。

    100
    TrafficMirrorConfig

    object

    任意

    トラフィックミラーリングの設定。

    TargetType

    string

    任意

    ミラー宛先のタイプ。

    ForwardGroupMirror
    MirrorGroupConfig

    object

    任意

    トラフィックがミラーリングされるサーバーグループ。

    ServerGroupTuples

    array

    任意

    トラフィックがミラーリングされるサーバーグループ。

    object

    任意

    トラフィックがミラーリングされるサーバーグループ。

    ServerGroupId

    string

    任意

    サーバーグループ ID。

    sgp-vlnjo1rhw0vc******
    RemoveHeaderConfig

    object

    任意

    特定の HTTP ヘッダーを削除するための設定。

    Key

    string

    任意

    HTTP ヘッダーのキー。

    key
    CorsConfig

    object

    任意

    オリジン間リソース共有 (CORS) の設定。

    AllowOrigin

    array

    任意

    許可されたオリジン。

    string

    任意

    許可されたオリジン。

    *
    AllowMethods

    array

    任意

    クロスオリジンリクエストで許可される HTTP メソッド。

    string

    任意

    クロスオリジンリクエストで許可される HTTP メソッド。有効な値:

    • GET

    • POST

    • PUT

    • DELETE

    • HEAD

    • OPTIONS

    • PATCH

    GET
    AllowHeaders

    array

    任意

    クロスオリジンリクエストで許可されるヘッダーのリスト。

    string

    任意

    クロスオリジンリクエストで許可されるヘッダー。

    test
    ExposeHeaders

    array

    任意

    クライアントに公開できるヘッダーのリスト。

    string

    任意

    クライアントに公開できるヘッダー。

    test
    AllowCredentials

    string

    任意

    クロスオリジンリクエストで資格情報を許可するかどうかを指定します。

    off
    MaxAge

    integer

    任意

    ブラウザでのプリフライトリクエストの最大キャッシュ期間。

    60
    RuleConditions

    array

    任意

    転送ルール条件のリスト。

    array<object>

    必須

    転送ルール条件。

    CookieConfig

    object

    任意

    Cookie ベースの条件の設定。

    Values

    array

    任意

    Cookie のキーと値のペアのリスト。

    object

    任意

    Cookie のキーと値のペア。

    Key

    string

    任意

    Cookie のキー。

    key
    Value

    string

    任意

    Cookie の値。

    value
    HeaderConfig

    object

    任意

    ヘッダーベースの条件の設定。

    Key

    string

    任意

    HTTP ヘッダーのキー。

    key
    Values

    array

    任意

    HTTP ヘッダー値のリスト。

    string

    任意

    HTTP ヘッダー値。

    value
    HostConfig

    object

    任意

    ホストベースの条件の設定。

    Values

    array

    任意

    ホスト名のリスト。

    string

    任意

    ホスト名。

    www.example.com
    MethodConfig

    object

    任意

    メソッドベースの条件の設定。

    Values

    array

    任意

    HTTP リクエストメソッドのリスト。

    string

    任意

    HTTP リクエストメソッド。

    PUT
    PathConfig

    object

    任意

    パスベースの条件の設定。

    Values

    array

    任意

    パス条件のリスト。

    string

    任意

    パス条件。

    /test
    QueryStringConfig

    object

    任意

    クエリ文字列ベースの条件の設定。

    Values

    array

    任意

    クエリ文字列のキーと値のペアのリスト。

    object

    任意

    クエリ文字列のキーと値のペア。

    Key

    string

    任意

    クエリ文字列のキー。

    account
    Value

    string

    任意

    クエリ文字列の値。

    on
    ResponseHeaderConfig

    object

    任意

    レスポンスヘッダーベースの条件の設定。

    Key

    string

    任意

    レスポンスヘッダーのキー。

    test
    Values

    array

    任意

    レスポンスヘッダーの値。

    string

    任意

    レスポンスヘッダーの値。

    value
    ResponseStatusCodeConfig

    object

    任意

    レスポンスステータスコードベースの条件の設定。

    Values

    array

    任意

    レスポンスステータスコード。

    string

    任意

    レスポンスステータスコード。

    200
    Type

    string

    任意

    条件のタイプ。

    Header
    SourceIpConfig

    object

    任意

    ソース IP アドレスに基づいてサービストラフィックを照合するための設定。

    Values

    array

    任意

    1 つ以上の IP アドレスまたは CIDR ブロック。

    string

    任意

    IP アドレスまたは CIDR ブロック。

    192.168.1.1
    RuleId

    string

    必須

    転送ルール ID。

    rule-n4hfecmmtmfl******
    DryRun

    boolean

    任意

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

    • true: ドライランを実行します。システムは、必須パラメーター、リクエストフォーマット、およびサービス制限を確認します。リクエストがドライランに失敗すると、エラーメッセージが返されます。リクエストがドライランに成功すると、DryRunOperation エラーコードが返されます。この場合、転送ルールのプロパティは更新されません。

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

    false

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答スキーマ

    RequestId

    string

    リクエスト ID。

    365F4154-92F6-4AE4-92F8-7FF34B540710
    JobId

    string

    非同期タスクの ID。

    72dcd26b-f12d-4c27-b3af-18f6aed5****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 OperationDenied.IpGroupCanNotUsedForMirrorAction The operation is not allowed because of %s.
    400 IncorrectStatus.Rule The status of %s [%s] is incorrect.
    400 OperationDenied.SameGroupForForwardAndMirrorAction The operation is not allowed because of %s.
    400 OperationDenied.GRPCServerGroup The operation is not allowed because of %s.
    400 Conflict.Priority There is already %s having the same configuration with %s.
    400 ResourceQuotaExceeded.ServerGroupAttachedNum The quota of %s is exceeded for resource %s, usage %s/%s.
    400 ResourceQuotaExceeded.LoadBalancerServersNum The quota of %s is exceeded for resource %s, usage %s/%s.
    400 ResourceQuotaExceeded.ServerAddedNum The quota of %s is exceeded for resource %s, usage %s/%s.
    400 QuotaExceeded.RuleWildcardsNum The quota of %s is exceeded, usage %s/%s.
    400 QuotaExceeded.RuleMatchEvaluationsNum The quota of %s is exceeded, usage %s/%s.
    400 QuotaExceeded.RuleActionsNum The quota of %s is exceeded, usage %s/%s.
    400 Mismatch.Protocol The %s is mismatched for %s and %s.
    400 Mismatch.VpcId The %s is mismatched for %s and %s.
    400 OperationDenied.ServiceManagedResource The operation is not allowed because the current resource of %s is managed resource.
    400 OperationDenied.ListenerIdInconsistent The operation is not allowed because of ListenerIdInconsistent.
    400 IllegalParam.Priority The param of Priority is illegal.
    400 OperationDenied.MirrorActionSupportHttpGroupOnly The operation is not allowed because of MirrorActionSupportHttpGroupOnly.
    400 OperationDenied.ProtocolMustSameForForwardGroupAction The operation is not allowed because of ProtocolMustSameForForwardGroupAction.
    404 ResourceNotFound.Rule The specified resource %s is not found.
    404 ResourceNotFound.ServerGroup The specified resource %s is not found.

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

    変更履歴

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