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

Virtual Private Cloud:CreateVSwitchCidrReservation

最終更新日:Jul 17, 2026

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

操作説明

この操作を呼び出して vSwitch の予約済み CIDR ブロックを作成する際は、以下の点にご注意ください。

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

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

    • IPv6 CIDR ブロック: vSwitch の最初の 9 つおよび最後の 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

必須

予約済み 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

説明

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

IPv4

VSwitchCidrReservationMask

string

任意

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

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

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

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

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

28

VSwitchCidrReservationCidr

string

任意

vSwitch の予約済み CIDR ブロック。マスク長も指定できます。

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

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

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

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

192.168.1.64/28

VSwitchCidrReservationType

string

任意

vSwitch の予約済み CIDR ブロックのタイプ。有効な値: prefix。これは、IP アドレスが CIDR ブロック単位で割り当てられることを示すプレフィックスです。

説明

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

prefix

ClientToken

string

任意

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

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

説明

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

123e4567-e89b-12d3-a456-426655440000

DryRun

boolean

任意

実際のリクエストを実行せずに、ドライランのみを実行するかどうかを指定します。有効な値:

  • true: vSwitch の予約済み CIDR ブロックを作成せずにチェックリクエストを送信します。システムは、必須のパラメーターが指定されているか、リクエストフォーマットが有効か、およびサービスの制限を超えていないかを確認します。チェックに失敗した場合、対応するエラーが返されます。チェックに成功した場合、DryRunOperation エラーコードが返されます。

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

false

RegionId

string

必須

vSwitch のリージョン ID。

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

cn-hangzhou

レスポンスフィールド

フィールド

説明

object

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

VSwitchCidrReservationId

string

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

vcr-bp1m12saqteraw3rp****

RequestId

string

リクエスト ID。

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

成功レスポンス

JSONJSON

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

エラーコード

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. ネットワークインターフェースコントローラー (NIC) に関連付けられた 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 この VPC は一部の高度な機能をサポートしていません。サポートが必要な場合はチケットを提出してください。
400 QuotaExceeded.CidrReservationCount The quota of VSwitchCidrReservation is exceeded. 作成した CidrReservation の数が制限を超えています。
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 は、vSwitch マスクより 2 以上大きい値である必要があります。
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. %s のクォータ制限により操作が失敗したためエラーが発生しました。予約済み CIDR ブロックのマスクが、現在の IP プレフィックスのデフォルトマスク %s/%s を超えています。
400 IllegalParam.ReservedType IpPrefixNumber is only supported with Prefix reserved type. IpPrefixNumber は Prefix 予約タイプでのみサポートされます。
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 と併用できません。

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

変更履歴

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