AllocateIpv6InternetBandwidth - IPv6 Gateway - Alibaba Cloud ドキュメントセンター

VPC 内の IPv6 アドレスにインターネット帯域幅を割り当て、インターネット通信を有効にします。帯域幅の割り当て後、IPv6 アドレスはインターネットへのアウトバウンド接続の開始と、インターネットからのインバウンド接続の受信の両方を行えます。

操作説明

以下のタイプの IPv6 アドレスにインターネット帯域幅を割り当てることができます。
- ECS インスタンスのエラスティックネットワークインターフェイス (ENI) に割り当てられた IPv6 アドレス。
- どのリソースインスタンスにも関連付けられていない未関連付けの IPv6 アドレス。
この操作を呼び出す前に、対象の IPv6 アドレスが既に存在することを確認してください。これは、VPC 内の ECS インスタンスに IPv6 アドレスが割り当てられているか、 AllocateIpv6Address を呼び出して未関連付けの IPv6 アドレスが作成されていることを意味します。
帯域幅の割り当て後、IPv6 アドレスはインターネットへのアウトバウンド接続の開始と、インターネットからのインバウンド接続の受信の両方を行えます。アウトバウンドのインターネットアクセスのみを許可するには、 CreateIpv6EgressOnlyRule を呼び出して IPv6 エグレスオンリールールを設定してください。
AllocateIpv6InternetBandwidth 操作では、同じ IPv6 アドレスに対するインターネット帯域幅の同時購入はサポートされていません。
シナリオ:
- ECS インスタンスのパブリックネットワークアクセス: ECS インスタンスがインターネットにアクセスしたり、IPv6 経由でサービスを提供したりできるようにします。
- 未関連付けのパブリックネットワークアクセス: IPv6 ゲートウェイルートテーブルと連携して、インターネットトラフィックをオンプレミスの IDC にルーティングします。
- アウトバウンドのみの通信: CreateIpv6EgressOnlyRule と連携して、アウトバウンドアクセスのみを許可し、インターネットからのインバウンド接続を拒否します。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vpc:AllocateIpv6InternetBandwidth

create

*Ipv6InternetBandwidth

acs:vpc:{#regionId}:{#accountId}:ipv6bandwidth/*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	IPv6 ゲートウェイのリージョン ID。 DescribeRegions 操作を呼び出してリージョン ID をクエリできます。	cn-huhehaote
Ipv6GatewayId	string	任意	IPv6 ゲートウェイの ID。	ipv6gw-uf6hcyzu65v98v3du****
Ipv6AddressId	string	必須	IPv6 アドレスの ID。	ipv6-2zen5j4axcp5l5qyy****
InternetChargeType	string	任意	IPv6 インターネット帯域幅の課金方法。有効な値: PayByTraffic: データ転送量課金。 PayByBandwidth (デフォルト): 帯域幅課金。	PayByBandwidth
Bandwidth	integer	必須	IPv6 アドレスのインターネット帯域幅。単位: Mbit/s。 InternetChargeType が PayByTraffic に設定されている場合、有効な値は 1 ～ 1000 です。 InternetChargeType が PayByBandwidth に設定されている場合、有効な値は 1 ～ 2000 です。	200
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。ClientToken の値には ASCII 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として使用します。RequestId は API リクエストごとに異なる場合があります。	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。有効な値: true: ルートテーブルを関連付けずにドライランを実行します。システムは AccessKey ペア、Resource Access Management (RAM) ユーザーの権限付与、および必須パラメーターをチェックします。チェックに失敗した場合、対応するエラーが返されます。チェックに成功した場合、エラーコード `DryRunOperation` が返されます。 false (デフォルト): 通常のリクエストを送信し、チェックに成功した後、2xx HTTP 状態コードが返され、プレフィックスリストをルートテーブルに関連付けるルーティングが実行されます。	false
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。ClientToken の値には ASCII 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは API 呼び出しの RequestId を ClientToken として自動的に使用します。RequestId は API 呼び出しごとに異なる場合があります。	123e4567-e89b-12d3-a456-426655440000
RegionId	string	必須	IPv6 ゲートウェイのリージョン ID。 DescribeRegions 操作を呼び出してリージョン ID をクエリできます。	cn-huhehaote

レスポンスフィールド

フィールド	型	説明	例
	object
Ipv6AddressId	string	IPv6 アドレスの ID。	ipv6-2zen5j4axcp5l5qyy****
RequestId	string	リクエスト ID。	6972A26E-99B1-4367-9890-FBDEBB0F5E7D
InternetBandwidthId	string	インターネット帯域幅を割り当てた後に IPv6 ゲートウェイに関連付けられたインターネット帯域幅のインスタンス ID。	ipv6bw-uf6hcyzu65v98v3du****

例

成功レスポンス

JSONJSON

{
  "Ipv6AddressId": "ipv6-2zen5j4axcp5l5qyy****",
  "RequestId": "6972A26E-99B1-4367-9890-FBDEBB0F5E7D",
  "InternetBandwidthId": "ipv6bw-uf6hcyzu65v98v3du****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	IllegalParam.Bandwidth	The param of %s is illegal.	指定された Bandwidth パラメーターが無効です。API リファレンスのメトリックの説明に基づいてパラメーター値を変更し、リトライしてください。
400	MissingParam.Ipv6InstanceId	The param of Ipv6InstanceId is missing.	Ipv6InstanceId パラメーターが指定されていません。
400	InvalidIpv6Instance.NotFound	The specified Ipv6AddressId or Ipv6InternetBandwidthId is not found.
400	IllegalParam.ChargeType	The param of %s is illegal.	ChargeType パラメーターが無効です。
400	IllegalParam.InternetChargeType	The param of %s is illegal.	指定された InternetChargeType が無効です。API ドキュメントのメトリックの説明を参照し、パラメーターを修正してリトライしてください。
400	OperationUnsupported.PrePaid	%s is unsupported.	IPv6 インターネット帯域幅はサブスクリプション請求書をサポートしていません。API リファレンスのメトリックの説明に従ってパラメーターを変更し、リトライしてください。
400	OperationFailed.Ipv6GatewayDisMatchIpv6Address	The operation is failed because of %s.	指定された IPv6 アドレスと IPv6 ゲートウェイが同じ VPC 内にありません。入力内容を確認してください。
400	OperationFailed.InternetBandwidthAlreadyExisted	The operation is failed because of %s.	指定された IPv6 インスタンスにはすでにインターネット帯域幅が有効になっています。再度有効にしないでください。
400	OperationFailed.Ipv6GatewayNotExist	The operation is failed because of %s.	指定された IPv6 アドレスの VPC に IPv6 ゲートウェイインスタンスが存在しません。この操作を実行する前に IPv6 ゲートウェイを作成してください。
400	IncorrectStatus.Ipv6Instance	The status of %s [%s] is incorrect.	指定された IPv6 インスタンスはトランジション状態です。しばらくしてから再試行してください。
400	IllegalParam.Ipv6Address	The param of %s is illegal.	指定された IPv6 アドレスが無効です。入力が正しいかどうかを確認してください。
400	UnsupportedFeature.InternetChargeTypeOnFreeIpv6Address	The feature of %s is not supported.	現在の IPv6 インスタンスはフローティング状態であり、指定された課金方法をサポートしていません。API リファレンスのメトリックの説明に記載されているとおりにパラメーターを変更し、リトライしてください。
400	UnsupportedFeature.InternetChargeTypeOnStaticIsp	The feature of %s is not supported.	現在の IPv6 インスタンスはシングル ISP インスタンスであり、指定された課金方法をサポートしていません。API リファレンスのメトリックの説明に記載されているとおりにパラメーターを変更し、リトライしてください。
400	OperationUnsupported.ULA	%s is unsupported.	現在の操作は ULA アドレスをサポートしていません。
400	OperationFailed.OpenCdtServiceFirst	The operation is failed because of %s.	指定された課金方法では Cloud Data Transfer (CDT) を有効化する必要があります。CDT を有効化してから再度お試しください。
400	OperationFailed.UpgradeCdtServiceFirst	The operation is failed because of cdt is not upgraded.	指定されたインスタンスタイプには Cloud Data Transfer (CDT) の課金スペックアップが必要です。CDT をスペックアップしてから再試行してください。
400	OperationUnsupported.PrivateGUA	This operation does not support private GUA addresses.	現在の操作は非公開 GUA アドレスをサポートしていません。
400	OperationDenied.UnSupportedBindTypeCloudInstance	Internet bandwidth cannot be allocated to the IPv6 address bound to the cloud service instance.	クラウドサービスインスタンスにアタッチされた IPv6 アドレスでは、インターネット帯域幅を有効にできません。
404	ResourceNotFound.Ipv6Address	The specified resource of %s is not found.	指定された Ipv6Address が存在しません。入力が正しいかどうかを確認してください。

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

変更履歴

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