特定のネットワーク構成要件を満たすために、指定された Elastic IP アドレス (EIP) を申請します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vpc:AllocateEipAddressPro |
create |
*Address
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
指定された EIP のリージョン ID。 DescribeRegions 操作の呼び出しにより、リージョン ID をクエリできます。 |
cn-hangzhou |
| IpAddress |
string |
任意 |
指定された EIP の IP アドレス。 IpAddress パラメーターと InstanceId パラメーターのいずれか一方のみを指定します。どちらも指定しない場合、システムがランダムに EIP を割り当てるようになっています。 |
192.0.XX.XX |
| InstanceId |
string |
任意 |
指定された EIP のインスタンス ID。 IpAddress パラメーターと InstanceId パラメーターのいずれか一方のみを指定します。どちらも指定しない場合、システムがランダムに EIP を割り当てるようになっています。 |
eip-25877c70gddh**** |
| Bandwidth |
string |
任意 |
指定された EIP のインターネット帯域幅の最大値。単位: Mbit/s。
デフォルト値: 5。 |
5 |
| Period |
integer |
任意 |
サブスクリプション期間。
InstanceChargeType が PrePaid にセットされている場合、このパラメーターは必須です。 InstanceChargeType が PostPaid にセットされている場合、このパラメーターは指定しないでください。 |
1 |
| ISP |
string |
任意 |
回線タイプ。有効な値:
BGP (マルチ ISP) および BGP (マルチ ISP) プロ版回線の詳細については、「EIP 回線タイプ」を参照してください。
|
BGP |
| Netmode |
string |
任意 |
ネットワークタイプ。値は public (デフォルト) に設定します。これはインターネットを示します。 |
public |
| AutoPay |
boolean |
任意 |
自動支払いを有効にするかどうかを指定します。有効な値:
InstanceChargeType が PrePaid にセットされている場合、このパラメーターは必須です。InstanceChargeType が PostPaid にセットされている場合、このパラメーターは空にできます。 |
true |
| PricingCycle |
string |
任意 |
サブスクリプションの課金サイクル。有効な値:
InstanceChargeType が PrePaid に設定されている場合、このパラメーターは必須です。InstanceChargeType が PostPaid に設定されている場合、このパラメーターは空にできます。 |
Month |
| InstanceChargeType |
string |
任意 |
指定された EIP の課金方法。有効な値:
InstanceChargeType が PrePaid にセットされている場合、InternetChargeType (インターネット課金方法) は PayByBandwidth にセットする必要があります。 InstanceChargeType が PostPaid にセットされている場合、InternetChargeType は PayByBandwidth または PayByTraffic にセットできます。 |
PostPaid |
| InternetChargeType |
string |
任意 |
指定された EIP のインターネット課金方法。有効な値:
InstanceChargeType が PrePaid にセットされている場合、InternetChargeType は PayByBandwidth にセットする必要があります。 InstanceChargeType が PostPaid にセットされている場合、InternetChargeType は PayByBandwidth または PayByTraffic にセットできます。 |
PayByBandwidth |
| ResourceGroupId |
string |
任意 |
指定された EIP が属するリソースグループの ID。 |
rg-resourcegroup**** |
| Tag |
array<object> |
任意 |
||
|
object |
任意 |
|||
| Key |
string |
任意 |
||
| Value |
string |
任意 |
||
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なる API 呼び出し間で一意であることを確認する必要があります。クライアントトークンには ASCII 文字のみを使用できます。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。各 API リクエストの RequestId は一意です。 |
0c593ea1-3bea-11e9-b96b-88e9fe6**** |
| SecurityProtectionTypes |
array |
任意 |
セキュリティ保護レベル。
|
|
|
string |
任意 |
セキュリティ保護レベル。
|
||
| PublicIpAddressPoolId |
string |
任意 |
IP アドレスプールの ID。 EIP はこの IP アドレスプールから割り当てられます。 デフォルトでは、IP アドレスプール機能は利用できません。この機能を使用するには、IP アドレスプール機能の権限クォータをクォータセンターで申請してください。詳細については、「クォータセンターでクォータを増やす」を参照してください。 |
pippool-2vc0kxcedhquybdsz**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
返される情報。 |
||
| RequestId |
string |
リクエスト ID。 |
4EC47282-1B74-4534-BD0E-403F3EE64CAF |
| OrderId |
integer |
注文 ID。 このパラメーターは、InstanceChargeType (指定された EIP の課金方法) が PrePaid (サブスクリプション) にセットされている場合に返されます。AutoPay が false (自動支払いが無効) にセットされている場合、ユーザーセンターの注文リスト に移動して支払いを完了してください。 |
20190000 |
| ResourceGroupId |
string |
リソースグループ ID。このパラメーターは、InstanceChargeType が PostPaid に設定されている場合にのみ返されます。 |
rg-resourcegroup**** |
| EipAddress |
string |
指定された EIP に割り当てる IP アドレス。このパラメーターは、InstanceChargeType が PostPaid にセットされている場合にのみ返されます。 |
192.0.XX.XX |
| AllocationId |
string |
EIP の ID。 |
eip-25877c70gddh**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
"OrderId": 20190000,
"ResourceGroupId": "rg-resourcegroup****",
"EipAddress": "192.0.XX.XX",
"AllocationId": "eip-25877c70gddh****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | FrequentPurchase.EIP | eip frequent purchase | |
| 400 | QuotaExceeded.Eip | Elastic IP address quota exceeded | |
| 400 | InvalidParameter | Specified value of "InternetChargeType" is not valid | |
| 400 | ReserveIpFail | Reserve eip failed. | |
| 400 | InvalidBandwidth.Malformed | The specified Bandwidth is invalid. | |
| 400 | INSTANCE_TYPE_NOT_SUPPORT | The instance type is invalid. | |
| 400 | QueryParameter.Illegal | query parameter illegal | |
| 400 | QuotaExceeded.LargeSpecEip | Elastic IP address with large spec quota exceeded. | |
| 400 | InvalidResourceGroupId | The specified ResourceGroupId does not exist. | リソースグループ ID が存在しません。 |
| 400 | Invalid.Reserve.Ip | The reserve ip is invalid. | |
| 400 | Ip.Allocated | The reserve ip has been allocated. | 予約済みの IP アドレスはすでに割り当て済みです。 |
| 400 | Ip.Keeped | The reserve ip been keeped in an hour. | |
| 400 | OperationFailed.AllocateUnfamiliarIp | The operation failed because only IP addresses used within the last seven days can be allocated. | 過去 7 日以内に使用された EIP のみ申請できます。 |
| 400 | INVALID_INSTANCE_STATUS | The instance status is invalid. | |
| 400 | OperationFailed.InstanceNotExist | Eip instanceId does not exist. | |
| 400 | InvalidStatus.ValueNotSupported | The specified status is not supported. | |
| 400 | OperationFailed.RiskControl | Risk control check failed. | 支払メソッドにセキュリティリスクが検出されました。メールまたはコンソールのメッセージに記載されたリンクから認証を完了し、注文を再送信してください。 |
| 400 | ResourceNotEnough.PublicIpAddressPool | The specified resource of PublicIpAddressPool is not enough. | |
| 400 | Mismatch.IpAndPublicIpAddressPool | The Ip and PublicIpAddressPool are mismatched. | |
| 400 | ResourceNotFound.PublicIpAddressPool | The specified resource of PublicIpAddressPool is not found. | |
| 400 | ResourceNotFound.Ip | The specified ip is not found. | 指定された IP アドレスは存在しません。 |
| 400 | OperationDenied.IpBelongToOtherUser | The operation is not allowed because of ip belong to other user. | IP アドレスが他のユーザーに属しているため、申請に失敗しました。 |
| 400 | IncorrectStatus.Ip | The status of ip is incorrect. | IP アドレスが無効な状態にあります。 |
| 400 | OperationFailed.IpIsLocked | The operation is failed because of ip is locked. | IP アドレスがロック済みであるため、申請に失敗しました。 |
| 400 | Mismatch.IpAndIsp | The specified IP address does not match the ISP. | |
| 400 | IncorrectStatus.PublicIpAddressPool | The status of PublicIpAddressPool is incorrect. | IP アドレスプールが無効な状態であるため、EIP を割り当てることはできません。 |
| 400 | IllegalParam.IpAddress | The specified IpAddress (%s) is illegal. | IP アドレスが無効です。 |
| 400 | OperationFailed.ResourceNotEnough | The resources you have applied for are insufficient. | リクエストされたリソースが不足しています。リソースの追加をリクエストするには、チケットを起票してください。 |
| 400 | Mismatch.EipSecurityProtectionTypeAndPoolSecurityProtectionType | The EipSecurityProtectionType and PoolSecurityProtectionType are mismatched. | EIP のセキュリティ保護タイプが、アドレスプールのセキュリティ保護タイプと一致しません。 |
| 400 | IllegalParam.Isp | The param of Isp [%s] is illegal. | ISP パラメーターが無効であるため、EIP を割り当てることはできません。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 不明なエラーにより、リクエストの処理に失敗しました。 |
| 403 | Forbidden | User not authorized to operate on the specified resource. | 指定されたリソースを管理する権限がありません。必須の権限を申請して、もう一度お試しください。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。