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

Anycast Elastic IP Address:UpdateAnycastEipAddressAssociations

最終更新日:Dec 06, 2025

エニーキャスト EIP インスタンスが複数のリージョンにあるバックエンドリソースに関連付けられている場合、アクセスポイントとオリジンサーバー間のマッピングを変更できます。UpdateAnycastEipAddressAssociations 操作を呼び出すことで、関連付けられているクラウドリソースインスタンス (指定されたオリジンサーバー) のアクセスポイントを追加または削除できます。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

eipanycast:UpdateAnycastEipAddressAssociations

update

*AnycastEipAddressAttachment

acs:eipanycast:{#regionId}:{#accountId}:anycast/{#AnycastId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

BindInstanceId

string

必須

関連付けるクラウドリソースインスタンスの ID。

lb-d7oxbixhxv1uupnon****

AnycastId

string

必須

エニーキャスト EIP インスタンスの ID。

aeip-bp1ix34fralt4ykf3****

ClientToken

string

任意

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

クライアントによって生成されますが、異なるリクエスト間で一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

説明

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

02fb3da4-130e-11e9-8e44-001****

DryRun

boolean

任意

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

  • true:チェックリクエストを送信し、関連付けは更新しません。システムは、必須パラメーターが指定されているか、リクエストのフォーマット、およびサービスの制限を確認します。チェックに失敗した場合、対応するエラーが返されます。チェックに成功した場合、DryRunOperation エラーコードが返されます。

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

false

PopLocationAddList

array<object>

任意

追加するアクセスエリアとアクセスポイントのリスト。

object

任意

追加するアクセスエリアとアクセスポイントのリスト。

PopLocation

string

任意

追加するアクセスエリアのアクセスポイント。

DescribeAnycastPopLocations 操作を呼び出して、サポートされているアクセスエリアのアクセスポイントに関する情報を照会できます。

us-west-1-pop

PopLocationDeleteList

array<object>

任意

削除するアクセスエリアとアクセスポイントのリスト。

object

任意

削除するアクセスエリア内のアクセスポイントのリスト。

説明

アクセスポイントに関連付けられているクラウドリソースインスタンスがデフォルトのオリジンサーバーである場合、そのアクセスエリアのアクセスポイントは削除できません。

PopLocation

string

任意

削除するアクセスエリア内のアクセスポイントのリスト。

説明

アクセスポイントに関連付けられているクラウドリソースインスタンスがデフォルトのオリジンサーバーである場合、そのアクセスエリアのアクセスポイントは削除できません。

eu-west-1-pop

AssociationMode

string

任意

関連付けモード。有効な値:

  • Default:このモードでは、関連付けるクラウドリソースインスタンスがデフォルトのオリジンサーバーとして設定されます。

  • Normal:このモードでは、関連付けるクラウドリソースインスタンスが通常のオリジンサーバーとして設定されます。

Default

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

RequestId

string

リクエスト ID。

4EC47282-1B74-4534-BD0E-403F3EE64CAF

成功レスポンス

JSONJSON

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 OperationFailed.SetNormalAssociationMode The only associated instance must be default mode.
400 OperationFailed.DeletedPopLocation The operation is failed because of added Pop Location is invalid.
400 OperationFailed.AddPopLocation The operation is failed because of added Pop Location is invalid.
400 ResourceNotFound.BindInstanceId The specified resource BindInstanceId is not found.
400 ResourceNotFound.AnycastId The specified resource AnycastId is not found.
400 IncorrectStatus.Anycast The status of the Anycast instance is invalid.
400 OperationFailed.Conflict Operation failed: The request was too frequent or there was a concurrency conflict. Please try again later.
400 OperationUnsupported.ServiceManaged Operation is forbidden because this instance belongs to Service manager.

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

変更履歴

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