すべてのプロダクト
Search

このプロダクト

    IPv6 Gateway:AllocateIpv6InternetBandwidth

    ドキュメントセンター

    IPv6 Gateway:AllocateIpv6InternetBandwidth

    最終更新日:Jun 18, 2026

    AllocateIpv6InternetBandwidth 操作を呼び出して、VPC 内の IPv6 アドレスにインターネット帯域幅を割り当てる操作を行い、パブリックネットワーク通信を有効にします。帯域幅が割り当てられると、IPv6 アドレスはインターネットへのアウトバウンドアクセスを開始でき、インターネットからアクセスされることもできます。

    操作説明

    • 以下のタイプの IPv6 アドレスにパブリックインターネット帯域幅を割り当てることができます:

      • ECS インスタンスの Elastic Network Interface (ENI) に割り当てられた IPv6 アドレス。

      • リソースインスタンスにアタッチされていない未関連の IPv6 アドレス。

    • この操作を呼び出す前に、ターゲットの IPv6 アドレスが既に存在していることを確認してください。これは、VPC 内の ECS インスタンスに IPv6 アドレスが割り当てられているか、 AllocateIpv6Address を呼び出して未関連の IPv6 アドレスが作成されていることを意味します。

    • 帯域幅が割り当てられると、IPv6 アドレスはインターネットへのアウトバウンド接続を開始でき、インターネットからのインバウンド接続を受信できます。インターネットへのアウトバウンドアクセスのみを許可するには、 CreateIpv6EgressOnlyRule を呼び出して IPv6 エグレス専用ルールを設定してください。

    • AllocateIpv6InternetBandwidth 操作は、同じ IPv6 パブリックインターネット帯域幅の同時購入をサポートしていません。

    • シナリオ:

      • ECS インスタンスの IPv6 パブリックネットワークアクセス: ECS インスタンスが IPv6 経由でインターネットにアクセスしたり、サービスを提供したりできるようにします。

      • 未関連の 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 として自動的に使用します。API リクエストごとに RequestId は異なります。

    123e4567-e89b-12d3-a456-426655440000
    DryRun

    boolean

    任意

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

    • true: ドライランを実行し、プレフィックスリストとルートテーブルの関連付けは行いません。システムは AccessKey ペア、Resource Access Management (RAM) ユーザーの権限付与、および必須パラメーターを確認します。確認が失敗した場合、対応するエラーが返されます。確認が成功した場合、エラーコード DryRunOperation が返されます。

    • false (デフォルト): 通常のリクエストを送信します。確認が成功した場合、2xx HTTP 状態コードが返され、プレフィックスリストがルートテーブルに関連付けられます。

    false
    ClientToken

    string

    任意

    客户端 Token，用于保证请求的幂等性。

    从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

    説明

    若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。

    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非法，请参考API文档参数说明修改后重试
    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. 您所指定的Ipv6Address和Ipv6Gateway不在同一VPC内，请确认您的输入是否正确
    400 OperationFailed.InternetBandwidthAlreadyExisted The operation is failed because of %s. 您当前操作的Ipv6实例已开通公网带宽，请勿重复开通
    400 OperationFailed.Ipv6GatewayNotExist The operation is failed because of %s. 您当前操作的Ipv6地址所在的VPC不存在Ipv6Gateway实例，请创建Ipv6Gateway再进行该操作
    400 IncorrectStatus.Ipv6Instance The status of %s [%s] is incorrect. 您指定的Ipv6Instance实例处于非稳态，请稍后重试
    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. 您当前指定的计费类型需开通CDT计费，请开通CDT后重试
    400 OperationFailed.UpgradeCdtServiceFirst The operation is failed because of cdt is not upgraded. 您当前指定购买的实例类型需升级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 ip 不能开通公网带宽。
    500 OperationFailed.QueryAccountInfo Query account info failed when create order. 下单时查询账号信息失败
    500 OperationFailed.SaleValidate Validate sale condition with subArticle failed.
    500 SystemBusy The system is busy. Please try again later. 当前系统繁忙，请稍后重试。
    404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
    404 ResourceNotFound.Ipv6Address The specified resource of %s is not found. 您指定的Ipv6Address不存在，请检查您的输入是否正确

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

    変更履歴

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