Elastic IP アドレス (EIP) を作成します。

注意点

API を呼び出す前に、EIP の課金方法と価格の内容を十分に確認してください。 詳しくは、「 課金方法」をご参照ください。

この API を呼び出した後、使用可能ステータスの EIP は指定のリージョンに割り当てられます。 EIP は 、ICMP 、TCP 、UDP プロトコルをサポートしています。IGMP および SCTP プロトコルはサポートしていません。

デバッグ

OpenAPI Explorer を使用して、デバッグ操作を実行し、SDK コード例を生成します。

リクエストパラメーター

パラメーター データ型 必須/省略可能 値の例 説明
Action String 必須 AllocateEipAddress

この操作の名前です。 値：AllocateEipAddress

RegionId String 必須 cn-hangzhou

インスタンスが属するリージョンの ID。 リージョン ID を照会するには、DescribeRegions を呼び出します。

AutoPay Boolean 省略可能 false

自動支払いの有無を示します。 このパラメーターは未記入のままにします。
帯域幅 String 省略可能 5

任意。 EIP のピーク帯域幅。 単位：Mbit/s。 既定値：5
ClientToken String 省略可能 02fb3da4-130e-11e9-8e44-001****

任意。 リクエストのべき等性を保証するために使用されるクライアントトークン。 このパラメーターの値はクライアントによって生成されます。 多様なリクエストにおいて一意な値で、長さは 1 〜 64 ASCII 文字です。

ISP String 省略可能 BGP

任意。 回線のタイプ。 既定値：BGP.

  • 単一回線帯域幅のホワイトリストが有効になっている場合、China Telecom、または China Unicom、または China Mobile が提供する単一回線 EIP を有効化するために、ISP パラメーターをそれぞれ ChinaTelecom 、または ChinaUnicom 、または ChinaMobile に設定することができます。
  • 杭州リージョンを選択した金融クラウドユーザーは必須のパラメーターです。 値：BGP_FinanceCloud
InstanceChargeType String 省略可能 PostPaid

EIP の課金方法。 値： PostPaid (従量課金) InternetChargeType のパラメーター値は、PayByTrafficである必要があります。 従量課金の課金方法に関する詳細については、「従量課金」をご参照ください。

InternetChargeType String 省略可能 PayByTraffic

任意。 EIP の課金方法。 値：トラフィック課金 (トラフィックにもとづいた課金方法) 詳細については、「 トラフィック課金」をご参照ください。

Netmode String 省略可能 Public

任意。 ネットワークタイプ。 既定値： Public
期間 Integer No 1

購入期間。 このパラメーターは未記入のままにします。
PricingCycle String 省略可能 Month

サブスクリプションの課金サイクル。 このパラメーターは未記入のままにします。
ResourceGroupId String 省略可能 rg-acfmxazffggds****

任意。 エンタープライズリソースグループの ID です。

レスポンスパラメーター

パラメーター データ型 値の例 説明
EipAddress String 12.xx.xx.78

作成された EIP。
AllocationId String eip-25877c70gddh****

EIP の ID 。
OrderId Long 10

InstanceChargeType が PrePaid に設定されている場合にのみ返されるオーダーナンバー。
RequestId String 4EC47282-1B74-4534-BD0E-403F3EE64CAF

リクエスト ID 。
ResourceGroupId String rg-acfmxazfdgdg****

エンタープライズリソースグループの ID 。

例

リクエストの例


http(s)://[Endpoint]/? Action=AllocateEipAddress
&RegionId=cn-hangzhou
&<CommonParameters>

レスポンスの例

XML 形式 

<AllocateEipAddressResponse>
      <AllocationId>eip-25877c70gfdkh****</AllocationId>
      <EipAddress>123.xx.xx.206</EipAddress>
      <RequestId>B6B9F518-60F8-4D81-9242-1207B356754D</RequestId>
</AllocateEipAddressResponse>

JSON 形式 

{
	"RequestId":"B6B9F518-60F8-4D81-9242-1207B356754D",
	"EipAddress":"123.xx.xx.206",
	"AllocationId":"eip-25877c70gfdkh****"
}

エラー

HTTP ステータスコード エラーコード エラーメッセージ 説明
403 Forbbiden 指定されたリソースで操作する権限のないユーザー。 あなたはこのドメインを操作する権限がありません。
400 QuotaExceeded.Eip Elastic IP アドレスのクォータを超えました EIP のクォータに達しています。 クォータを増やすには、チケットを起票し、サポートセンターへお問い合わせください。 または、 NAT Gateway を使用して新たな IP アドレスを取得することを推奨します。
400 InvalidParameter "InternetChargeType" に指定された値は無効です InternetChargeType パラメーター値が無効です。
400 InvalidParameter 指定された "Bandwidth" の値が無効です。 指定された帯域幅の値は無効です。
400 QuotaExceeded.Eip Elastic IP アドレスのクォータを超えました。 EIP のクォータを超えています。 クォータを増やすには、チケットを起票し、サポートセンターへお問い合わせください。 または、NAT Gateway を使用して新たな IP アドレスを取得することを推奨します。
400 ReserveIpFail Reserve eip に失敗しました。 EIP を確保する操作に失敗しました。
400 InvalidRegion.NotSupport 指定されたリージョンはサポートされていません。 指定されたリージョンはこの操作をサポートしていません。

エラーコードについては、「APIエラーセンター」をご参照ください。