すべてのプロダクト
Search

このプロダクト

    Edge Security Acceleration:UpdateOriginPool

    ドキュメントセンター

    Edge Security Acceleration:UpdateOriginPool

    最終更新日:Jun 25, 2026

    オリジンアドレスプールIDで指定した単一のオリジンアドレスプールを変更します。

    今すぐお試しください

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

    update

    *Site

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Id

    integer

    必須

    オリジンアドレスプールID。 ListOriginPools オペレーションを呼び出してIDを取得できます。

    1038520525196928
    Enabled

    boolean

    任意

    オリジンアドレスプールを有効にするかどうかを指定します。有効な値：

    • true：有効。

    • false：無効。

    true
    Origins

    array<object>

    任意

    オリジンアドレスプールに追加するオリジンサーバー情報。複数のオリジンサーバーを渡すには配列を使用します。

    array<object>

    任意

    オリジンアドレスプールに追加するオリジンサーバー情報。

    Name

    string

    任意

    オリジンサーバー名。名前はオリジンアドレスプール内で一意である必要があります。

    origin1
    Address

    string

    任意

    www.example.comなどのオリジンサーバーのアドレス。

    www.example.com
    Enabled

    boolean

    任意

    オリジンサーバーを有効にするかどうかを指定します。有効な値：

    • true：有効。

    • false：無効。

    true
    Header

    any

    任意

    Back-to-Originリクエストに含まれるリクエストヘッダー。Hostのみサポートされています。

    { "Host": [ "example.com" ] }
    Weight

    integer

    任意

    重み。値は0から100の整数です。

    50
    Type

    string

    任意

    オリジンサーバーのタイプ。有効な値：

    • ip_domain：IPアドレスまたはドメイン名ベースのオリジンサーバー。

    • OSS：OSSアドレスベースのオリジンサーバー。

    • S3：AWS S3オリジンサーバー。

    OSS
    AuthConf

    object

    任意

    認証情報。オリジンサーバーがOSS、S3、またはその他の認証が必要なオリジンサーバーの場合、このパラメーターは必須です。

    AuthType

    string

    任意

    認証タイプ。有効な値：

    • public：パブリック読み取り/書き込み。オリジンサーバーがパブリック読み取り/書き込みアクセスのOSSまたはS3の場合に使用します。

    • private_same_account：プライベート同一アカウント。オリジンサーバーが同一アカウントのプライベート認証のOSSの場合に使用します。

    • private_cross_account：プライベートクロスアカウント。オリジンサーバーがクロスアカウントのプライベート認証のOSSの場合に使用します。

    • private：オリジンサーバーがプライベート認証のS3の場合に使用します。

    public
    AccessKey

    string

    任意

    プライベート認証に必要なAccessKey。

    yourAccessKeyID
    SecretKey

    string

    任意

    プライベート認証に必要なSecretKey。

    yourAccessKeySecret
    Version

    string

    任意

    オリジンサーバーがAWS S3の場合に必要な署名バージョン。

    v2
    Region

    string

    任意

    オリジンサーバーがAWS S3の場合に必要なオリジンサーバーのリージョン。

    us-east-1

    IpVersionPolicy

    string

    任意

    Back-to-Originリクエストに使用するIPプロトコルバージョン。有効な値：

    • round_robin：デフォルトポリシー。IPv4またはIPv6オリジンサーバーをランダムにポーリングします。

    • ipv4_first：IPv4オリジンサーバーを優先的に使用します。

    • ipv6_first：IPv6オリジンサーバーを優先的に使用します。

    • follow：クライアントが使用するIPバージョンに優先的に従います。

    round_robin
    SiteId

    integer

    必須

    サイトID。 ListSites オペレーションを呼び出してIDを取得できます。

    216558609793952

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスのスキーマ

    RequestId

    string

    リクエストID。

    15C66C7B-671A-4297-9187-2C4477247A74
    Id

    integer

    オリジンアドレスプールID。

    1038520525196928

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
  "Id": 1038520525196928
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParameter The specified parameter is invalid.
    400 SourceNumberExceedLimit The number of sources in the origin pool exceeds the quota limit.
    400 InternalException Failed to call the service. Try again later or contact technical support.
    400 OriginPoolNotExist The specified origin pool does not exist or does not belong to your account or website. Check and try again.
    400 Instance.NotOnline Your plan is unavailable due to an overdue payment. Complete the payment first.
    400 OriginPoolNameConflict The specified origin pool name already exists or its hostname conflicts with a load balancer name. Try again with a unique name.
    400 SourceAddressInvalid Invalid origin address. Check whether the IP address or domain name is in the valid format.
    400 LockFailed The system is handling requests you previously submitted. Try again later.
    400 InvalidParameter.AddressConflict Duplicate origin addresses. Make sure that each origin address for the same pool is unique.
    400 SourceCircleExist The host record of the resource to be operated on is already the source station of another resource, or the source station of the current resource has been added as a host record. To avoid loopback, modify the host record or source station and retry.
    400 SourceInBlackList The source is in the black list.
    400 InvalidParameter.SourceIpInBlacklist The provided origin is an invalid private IP address. Please verify and resubmit.
    400 InvalidParameter.PrivateIpAsSourceUnsupported The provided origin is an invalid private IP address. Please verify and resubmit.
    400 OriginPool.TypeNotSupport The origin address pool type is not supported.
    400 OriginPool.CheckQuotaFailed Failed to check source pool quota for site, please try again later.
    404 SiteNotFound The website does not exist or does not belong to you.

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

    変更履歴

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