すべてのプロダクト
Search
ドキュメントセンター

Virtual Private Cloud:CreateVSwitchCidrReservation

最終更新日:Sep 15, 2026

vSwitch 用の予約済み CIDR ブロックを作成します。

操作説明

この操作を呼び出して vSwitch 用の予約済み CIDR ブロックを作成する場合は、次の項目に注意してください。

  • VPC 内の予約済み IPv4 CIDR ブロックと予約済み IPv6 CIDR ブロックの最大値は、それぞれ 100 です。

  • 予約済み CIDR ブロックには、それが属する vSwitch のシステム予約済み IP アドレスを含めることはできません。
    • IPv4 CIDR ブロック: vSwitch の最初の IP アドレスと最後の 3 つの IP アドレスは、システム予約済み IP アドレスです。

    • IPv6 CIDR ブロック: vSwitch の最初の IP アドレスと最後の 9 つの IP アドレスは、システム予約済み IP アドレスです。

  • CreateVSwitchCidrReservation 操作は非同期です。リクエストを送信すると、システムはインスタンス ID を返しますが、vSwitch 用の予約済み CIDR ブロックはまだ作成されていません。システムはバックグラウンドで実行を継続します。 ListVSwitchCidrReservations を呼び出して、vSwitch 用の予約済み CIDR ブロックの作成ステータスを照会できます。
    • vSwitch 用の予約済み CIDR ブロックが Assigning 状態の場合、vSwitch 用の予約済み CIDR ブロックを割り当てる処理を行っています。

    • vSwitch 用の予約済み CIDR ブロックが Assigned 状態の場合、vSwitch 用の予約済み CIDR ブロックを割り当てる処理が完了しています。

今すぐお試しください

この 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:CreateVSwitchCidrReservation

create

*VSwitchCidrReservation。

acs:vpc:{#regionId}:{#accountId}:vswitchcidrreservation/*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

Tag

array<object>

任意

リソースのタグ。

object

任意

タグのフォーマット情報。

Key

string

任意

リソースのタグキー。最大 20 個のタグキーを指定できます。このパラメーターを指定する場合、値は空の文字列にできません。

タグキーの長さは最大 128 文字です。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

FinanceDept

Value

string

任意

リソースのタグ値。最大 20 個のタグ値を指定できます。値は空の文字列にできます。

タグ値の長さは最大 128 文字です。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

FinanceJoshua

VSwitchId

string

必須

vSwitch 用の予約済み CIDR ブロックが属する vSwitch の ID。

vsw-25navfgbue4g****

VSwitchCidrReservationName

string

任意

vSwitch 用の予約済み CIDR ブロックの名前。

名前の長さは 1~128 文字で、英字または漢字で始める必要があります。数字、アンダースコア (_)、ハイフン (-) を含めることができます。http:// または https:// で始めることはできません。

ReservationName

VSwitchCidrReservationDescription

string

任意

vSwitch 用の予約済み CIDR ブロックの説明。このパラメーターを空のままにすると、デフォルト値は空になります。

説明の長さは 1~256 文字で、英字または漢字で始める必要があります。http:// または https:// で始めることはできません。

ReservationDescription

IpVersion

string

任意

vSwitch 用の予約済み CIDR ブロックの IP バージョン。有効な値:

  • IPv4 (デフォルト)

  • IPv6

説明

vSwitch 用の IPv4 予約済み CIDR ブロックを作成する場合は、このパラメーターを指定する必要はありません。vSwitch 用の IPv6 予約済み CIDR ブロックを作成する場合は、このパラメーターが必須です。

IPv4

VSwitchCidrReservationMask

string

任意

vSwitch 用の予約済み CIDR ブロックのマスク。

  • IpVersion が IPv4 に設定されている場合、vSwitch 用の予約済み CIDR ブロックのプレフィックス長は、vSwitch の IPv4 CIDR ブロックのマスクより 2 ビット以上長く、28 を超えることはできません。

  • IpVersion が IPv6 に設定されている場合、vSwitch 用の予約済み CIDR ブロックのプレフィックス長は、vSwitch の IPv6 CIDR ブロックのマスクより長く、80 を超えることはできません。

説明
  • VSwitchCidrReservationMask パラメーターまたは VSwitchCidrReservationCidr パラメーターのいずれかを指定する必要があります。

  • 予約済み CIDR ブロックには、それが属する vSwitch のシステム予約済み IP アドレスを含めることはできません。

28

VSwitchCidrReservationCidr

string

任意

vSwitch 用の予約済み CIDR ブロック。

  • IpVersion が IPv4 に設定されている場合、vSwitch 用の予約済み CIDR ブロックは vSwitch の IPv4 CIDR ブロックの真部分集合である必要があり、プレフィックス長は 28 を超えることはできません。

  • IpVersion が IPv6 に設定されている場合、vSwitch 用の予約済み CIDR ブロックは vSwitch の IPv6 CIDR ブロックの真部分集合である必要があり、プレフィックス長は 80 を超えることはできません。

説明
  • VSwitchCidrReservationMask パラメーターまたは VSwitchCidrReservationCidr パラメーターのいずれかを指定する必要があります。

  • 予約済み CIDR ブロックには、それが属する vSwitch のシステム予約済み IP アドレスを含めることはできません。

192.168.1.64/28

VSwitchCidrReservationType

string

任意

vSwitch 用の予約済み CIDR ブロックのタイプ。有効な値: prefix (IP アドレスが CIDR ブロックごとに割り当てられるプレフィックスであることを示します)。

説明

ユーザーまたはクラウドサービスの呼び出し時に CIDR ブロックをエラスティックネットワークインターフェイスコントローラー (NIC) に自動的に割り当てる場合、CIDR ブロックは予約済み CIDR ブロックから割り当てる必要があります。予約済み CIDR ブロック内の IP アドレスが枯渇すると、システムはエラーを返します。

プレフィックス

IpPrefixNumber

integer

任意

予約する IP プレフィックスの予期される数。有効な値: 1~32。

1

ClientToken

string

任意

リクエストのべき等性を確保するために使用されるクライアントトークン。

クライアントを使用してトークンを生成できますが、異なるリクエストの呼び出し間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。

説明

このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は API リクエストごとに異なる場合があります。

123e4567-e89b-12d3-a456-426655440000

DryRun

boolean

任意

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

  • true: ドライランを実行します。システムは必須パラメーター、リクエストフォーマット、およびビジネス制限をチェックします。チェックに失敗すると、対応するエラーが返されます。チェックに成功すると、DryRunOperation エラーコードが返されます。

  • false (デフォルト): 通常のリクエストを送信します。チェックに成功すると、HTTP 2xx 状態コードが返され、vSwitch 用の予約済み CIDR ブロックが作成されます。

false

RegionId

string

必須

vSwitch のリージョン ID。

DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。

cn-hangzhou

レスポンスフィールド

フィールド

型

説明

例

object

vSwitch 用の予約済み CIDR ブロックのインスタンス ID。

RequestId

string

リクエスト ID。

54B48E3D-DF70-471B-AA93-08E683A1B45

VSwitchCidrReservationId

string

vSwitch 用の予約済み CIDR ブロックのインスタンス ID。

vcr-bp1m12saqteraw3rp****

例

成功レスポンス

JSONJSON

{
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "VSwitchCidrReservationId": "vcr-bp1m12saqteraw3rp****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 IllegalParamFormat IllegalParamFormat パラメーターのフォーマットが正しくありません。
400 IllegalParamFormat.VSwitchCidrReservationCidr The param format of VSwitchCidrReservationCidr is illegal. VSwitchCidrReservationCidr パラメーターのフォーマットが無効です。
400 ResourceNotFound.VSwitch The specified resource of VSwitch is not found. 指定された vSwitch インスタンスが存在しません。
400 UnsupportedFeature.ReservedType The specified ReservedType is not supported. 指定された ReservedType はサポートされていません。
400 UnsupportedFeature.VSwitchIpv6 The ipv6 feature of switch is not supported. 指定された vSwitch で IPv6 が有効になっていません。
400 OperationFailed.VSwitchCidrReservationCidr The specified VSwitchCidrReservationCidr conflicts with existed cidr reservation or vswitch cidr. 指定された VSwitchCidrReservationCidr が既存の VSwitchCidrReservation CIDR ブロックと競合しています。
400 MissingParam.CidrReservationMaskOrCidrReservationCidr Either VSwitchCidrReservationMask or VSwitchCidrReservationCidr should be specified. VSwitchCidrReservationMask パラメーターと VSwitchCidrReservationCidr パラメーターの両方を空にすることはできません。いずれか一方を指定して、もう一度お試しください。
400 UnsupportedRegion UnsupportedRegion 現在のリージョンでは、プレフィックスリストルートの操作はサポートされていません。
400 UnsupportedFeature.VpcAdvancedFeature UnsupportedFeature.VpcAdvancedFeature 指定された vSwitch が属する VPC は高度な特徴をサポートしていません。別の vSwitch を使用して再試行してください。
400 QuotaExceeded.CidrReservationCount The quota of VSwitchCidrReservation is exceeded. VSwitchCidrReservation インスタンスの数がクォータを超えています。
400 Conflict.CidrReservationMaskAndCidrReservationCidr The specified VSwitchCidrReservationMask and VSwitchCidrReservationCidr is conflict. 指定された VSwitchCidrReservationMask が VSwitchCidrReservationCidr と競合しています。API ドキュメントのメトリックの説明に基づいてパラメーターを変更し、リトライしてください。
400 OperationFailed.CidrNotEnoughInVSwitch No enough cidr to allocate in this vswitch. 指定された vSwitch に CidrReservation を割り当てるための十分な CIDR ブロックがありません。
400 OperationFailed.SystemReservedIpContained The specified VSwitchCidrReservationCidr cannot contain system reserved IP addresses. 指定された VSwitchCidrReservationCidr にシステム予約済み IP アドレスを含めることはできません。
400 OperationFailed.AlreadyUsedIpContained The specified VSwitchCidrReservationCidr cannot contain already used IP addresses. 指定された予約済み CIDR ブロックに、すでに使用中の IP アドレスを含めることはできません。
400 IncorrectStatus.VSWITCH The status of the specified VSwitch is invalid. vSwitch が異常な状態です。
400 IllegalParam.VSwitchCidrReservationMask The specified VSwitchCidrReservationMask must be at least 2 bits greater than the vSwitch mask. VSwitchCidrReservationMask パラメーターが無効です。API リファレンスのパラメーター説明に基づいて値を変更し、リトライしてください。
400 QuotaExceeded.VSwitchCidrReservationMask The operation is failed because of %s. The mask of the reserved subnet cidr exceeds the current default mask of IP Prefix, %s/%s. VSwitchCidrReservationMask がクォータを超えています。API リファレンスのパラメーター説明に基づいて値を変更し、リトライしてください。
400 IllegalParam.ReservedType IpPrefixNumber is only supported with Prefix reserved type. IpPrefixNumber は、プレフィックス予約タイプでのみサポートされています。
400 MissingParam.VSwitchCidrReservationParam One of IpPrefixNumber, VSwitchCidrReservationMask, or VSwitchCidrReservationCidr must be specified. IpPrefixNumber、VSwitchCidrReservationMask、または VSwitchCidrReservationCidr のいずれかを指定する必要があります。
400 Conflict.VSwitchCidrReservationParam IpPrefixNumber cannot be used together with VSwitchCidrReservationCidr or VSwitchCidrReservationMask. IpPrefixNumber を VSwitchCidrReservationCidr または VSwitchCidrReservationMask と併用することはできません。

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

変更履歴

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