複数の EIP (elastic IP addresses) を Internet Shared Bandwidth インスタンスに関連付けます。
操作説明
- 本 API を呼び出して EIP を一括で共有帯域幅に追加する際、EIP は以下の条件を満たしている必要があります。
EIP の課金方法が従量課金であること。
EIP のリージョンが、追加先の共有帯域幅のリージョンと同一であること。
EIP の回線タイプが、追加先の共有帯域幅の回線タイプと一致すること。
- AddCommonBandwidthPackageIps API は非同期 API です。システムはまずリクエスト ID を返しますが、この時点では EIP はまだ共有帯域幅に正常に追加されておらず、バックグラウンドで追加タスクが実行中です。DescribeCommonBandwidthPackages を呼び出して、共有帯域幅と EIP の関連ステータスを確認できます。
共有帯域幅と EIP の関連ステータスが BINDING の場合、共有帯域幅と EIP が関連付け中の状態です。この状態では、照会操作のみ実行可能で、他の操作は実行できません。
共有帯域幅と EIP の関連ステータスが BINDED の場合、共有帯域幅と EIP の関連付けが完了したことを示します。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
Internet Shared Bandwidth インスタンスのリージョン ID です。 最新のリージョンリストを取得するには、DescribeRegions 操作を呼び出してください。 |
cn-shanghai |
| BandwidthPackageId |
string |
必須 |
Internet Shared Bandwidth インスタンスの ID です。 |
cbwp-2ze2ic1xd2qeqasdf**** |
| IpType |
string |
任意 |
IP タイプです。EIP を指定すると、EIP が共有帯域幅に追加されることを示します。 |
EIP |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意であることを保証する必要があります。トークンには ASCII 文字のみを使用できます。 説明
このパラメーターを指定しない場合、システムは自動的に リクエスト ID を クライアントトークン として使用します。各リクエストごとに リクエスト ID が異なる可能性があります。 |
123e4567-e89b-12d3-a456-426655440000 |
| IpInstanceIds |
array |
必須 |
Internet Shared Bandwidth インスタンスに関連付ける EIP のリストです。 一度に最大 10 個の EIP ID を指定できます。 |
|
|
string |
任意 |
Internet Shared Bandwidth インスタンスに関連付ける EIP のリストです。 一度に最大 10 個の EIP ID を指定できます。 |
eip-2zeerraiwb7uqwed**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーターです。 |
||
| RequestId |
string |
リクエスト ID です。 |
01FDDD49-C4B7-4D2A-A8E5-A93915C450A6 |
例
成功レスポンス
JSONJSON
{
"RequestId": "01FDDD49-C4B7-4D2A-A8E5-A93915C450A6"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | OperationDenied.SecurityProtectionTypesInconsistent | The operation is not allowed because of SecurityProtectionTypesInconsistent. | |
| 400 | InvalidIpInstanceId.NotFound | The specified Eip InstanceId does not exist in our records. | |
| 400 | EIP_ALREADY_IN_BANDWIDTHPACKAGE | The Eip already in bandwidthPackage. | |
| 400 | InvalidRegionId.NotFound | The specified RegionId does not exist in our records. | |
| 400 | InvalidBandwidthPackageId.NotFound | The specified bandwidthPackageId does not exist in our records. | |
| 400 | IpInstanceId.AlreadyInBandwidthPackage | The specified Eip InstanceId already in bandwidthPackage. | |
| 400 | IpInstanceId.BizStatusInvalid | The specified Eip BizStatus is Disable, Cannot add to bandwidthPackage. | |
| 400 | IpInstanceId.ChargeType.NotSupport | The specified Eip instance is PrePaid type, Cannot add to BandwidthPackage. | |
| 400 | BandwidthPackageId.InvalidBizStatus | The specified BandwidthPackageId has been FinancialLocked, Cannot add Ip. | |
| 400 | IpInstanceId.QuotaExceeded | The specified BandwidthPackageId has too many ip in it. exceed the quota , Cannot add more. | |
| 400 | EipOperation.TooFrequently | The specified Eip add into bandwidthPackage too frequently. please add later. | |
| 400 | IpInstanceId.InvalidIpInternetChargeType | The hybrid type eip not support add into bandwidthPackage of PayBytraffic type. | |
| 400 | TaskConflict | The operation is too frequent, TaskConflict. | |
| 400 | IncorrectStatus.Eip | Eip status error. | |
| 400 | OperationUnsupported.IpType | Ip type does not support the operation. | |
| 400 | ParamExclusive.IpInstanceIdAndBandwidthPackageId | %s | |
| 400 | InvalidBandwidthPackage.NotExist | Eip bandwidth package not exist. | |
| 400 | OperationFailed.DistibuteLock | Distibute lock fail. | |
| 400 | BandwidthPackageId.InvalidBandwidth | The hybrid type eip can not add into low bandwidth bandwidthPackage. | |
| 400 | OperationFailed.ZoneIdInconsistent | %s | |
| 400 | AttrMismatching.BandwidthPackageIpVersion | %s | |
| 400 | InvalidEIPStatus.BizDisabled | The EIP has been locked. | |
| 400 | Forbidden.FinancialLocked | The ip business status is invalid. | |
| 400 | Mismatch.CloudBoxCbwpZoneAndEipZone | The CbwpZone and EipZone are mismatched. | |
| 400 | InvalidInstanceId.NotFound | The InstanceId is not found. | |
| 400 | MissingParam.BandwidthPackageId | The parameter bandwidthPackageId is mandatory. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。