連続elastic IPアドレス (EIP) に適用されます。
使用上の注意
AllocateEipSegmentAddress操作は非同期です。 リクエストを送信すると、システムはリクエストIDを返します。 ただし、操作はまだシステムバックグラウンドで実行されています。 DescribeEipSegment操作を呼び出して、隣接するEIPグループのステータスを照会できます。
- 隣接するEIPグループが [割り当て] 状態の場合、EIPは割り当てられています。 この場合、クエリ操作のみを実行でき、他の操作は実行できません。
- 隣接するEIPグループが割り当て済み状態の場合、EIPが割り当てられます。
デバッグ
リクエストパラメーター
| 項目 | データ型 | 必須／任意 | 例: | 説明 |
|---|---|---|---|---|
| ClientToken | String | 任意 | 02fb3da4-130e-11e9-8e44-001**** |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。 説明 このパラメーターを設定しない場合、システムは自動的にRequestIdをClientTokenとして使用します。 RequestIdは、APIリクエストごとに異なる場合があります。
|
| 操作 | String | 必須 | AllocateEipSegmentAddress |
実行する操作です。 値をAllocateEipSegmentAddressに設定します。 |
| 帯域幅 | String | 任意 | 5 |
EIPの最大帯域幅。 単位：Mbit/秒。
デフォルト値: 5 単位：Mbit/秒。 |
| RegionId | String | 必須 | cn-hangzhou |
隣接するEIPのリージョンID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。 |
| EipMask | String | 必須 | 28 |
隣接するEIPのサブネットマスクの長さ。 有効な値：
説明 システムによって割り当てられる連続EIPの数は、1つ、3つ、または4つのEIPが予約され得るので、要求された数よりも少なくなり得る。
|
| Netmode | String | 任意 | パブリック |
ネットワークタイプ。 有効な値：
説明 このネットワークタイプは、ホワイトリストに含まれているユーザーのみが使用できます。 このネットワークタイプを使用するには、ビジネスマネージャーに連絡してください。
|
| InternetChargeType | String | 任意 | 帯域幅課金 |
隣接するEIPの計測方法。 有効な値：
説明 Netmodeパラメーターがhybridに設定されている場合、InternetChargeTypeはPayByBandwidthにのみ設定できます。
|
| ResourceGroupId | String | 任意 | rg-bp67acfmxazb4ph **** |
リソースグループの ID です。 |
| Isp | String | 任意 | BGP |
ラインタイプ。 有効な値： BGP (デフォルト): BGP (マルチISP) 行。 すべてのリージョンでBGP (マルチISP) EIPをサポートしています。 BGP_PRO: BGP (マルチISP) プロライン。 BGP (Multi-ISP) Pro EIPは、中国 (香港) およびシンガポールのリージョンでのみサポートされています。 BGP (マルチISP) およびBGP (マルチISP) Proの詳細については、「EIPラインタイプ」をご参照ください。 単一ISP帯域幅の使用が許可されている場合は、次のいずれかの値を選択することもできます。
サービスがChina East 1 Financeにデプロイされている場合、このパラメーターは必須であり、値をBGP_FinanceCloudに設定する必要があります。 |
レスポンスパラメーター
| 項目 | データ型 | 例: | 説明 |
|---|---|---|---|
| RequestId | String | F7A6301A-64BA-41EC-8284-8F4838C15D1F |
リクエストの ID です。 |
| OrderId | Long | 2022 **** |
注文 ID。 |
| EipSegmentInstanceId | String | eipsg-2zett8ba055tbsxme **** |
隣接するEIPグループのID。 |
例
リクエストの例
http(s):// [エンドポイント]/?ClientToken=02fb3da4-130e-11e9-8e44-001 ****
&アクション=AllocateEipSegmentAddress
&帯域幅=5
&RegionId=cn-hangzhou
&EipMask=28
&Netmode=public
&InternetChargeType=PayByBandwidth
&ResourceGroupId=rg-bp67acfmxazb4ph ****
&Isp=BGP
&共通リクエストパラメータ正常に処理された場合のレスポンス例
XML 形式
HTTP/1.1 200 OK
Content-Type:application/xml
<AllocateEipSegmentAddressResponse>
<RequestId>F7A6301A-64BA-41EC-8284-8F4838C15D1F </RequestId>
<EipSegmentInstanceId>eipsg-2zett8ba055tbsxme ****</EipSegmentInstanceId>
</AllocateEipSegmentAddressResponse>JSON 形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "F7A6301A-64BA-41EC-8284-8F4838C15D1F\t" 、
"EipSegmentInstanceId" : "eipsg-2zett8ba055tbsxme ****"
}エラーコード
| HttpCode | エラーコード | エラーメッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidParameter | 指定された "Bandwidth" の値は無効です。 | 指定された帯域幅の値が無効な場合に返されるエラーメッセージ。 |
| 400 | InsufficientBalance | アカウントに十分な残高がありません。 | Alibaba Cloudアカウントに十分な残高がない場合に返されるエラーメッセージ。 Alibaba Cloudアカウントを追加して、もう一度お試しください。 |
| 400 | QuotaExceeded.Eip | Elastic IP アドレスの上限を超えました。 | EIPの数が上限に達した場合に返されるエラーメッセージ。 より多くのEIPを使用する場合は、NAT Gatewayの使用を推奨します。 |
| 400 | ReserveIpFail | Reserve eip に失敗しました。 | システムが指定されたEIPの予約に失敗した場合に返されるエラーメッセージ。 |
| 400 | InvalidRegion.NotSupport | 指定されたリージョンはサポートされていません。 | 指定されたリージョンで操作がサポートされていない場合に返されるエラーメッセージ。 |
| 400 | InvalidResourceGroupId | 指定されたResourceGroupIdは存在しません。 | 指定されたリソースグループIDが無効な場合に返されるエラーメッセージ。 |
| 400 | ORDER.QUANTITY_INVALID | ユーザークォータが制限を超えました。 | 作成したEIPの数が上限に達した場合に返されるエラーメッセージ。 クォータの増加を要求するには、クォータ管理ページに移動します。 |
| 400 | OrderError.EIP | アカウントが注文を作成できませんでした。 | システムが注文の生成に失敗した場合に返されるエラーメッセージ。 |
| 400 | OperationConflict | 以前のリクエストとの競合により、リクエストが拒否されました。 | リクエストが別のリクエストと競合している場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。 |
| 400 | Forbidden | 指定されたリソースでの操作が許可されていないユーザー。 | 指定されたリソースに対して操作を実行する権限がない場合に返されるエラーメッセージ。 必要な権限を取得し、もう一度お試しください。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。