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

Virtual Private Cloud:CreateVSwitchCidrReservation

最終更新日:Apr 27, 2026

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

操作説明

概要

以下の点にご注意ください。

  • VPC 内の各 vSwitch に対して、最大で 10 個の予約済み IPv4 CIDR ブロックおよび 10 個の予約済み IPv6 CIDR ブロックを作成できます。

  • vSwitch の予約済み CIDR ブロックを作成した後、その CIDR ブロックには、当該 vSwitch が属する VPC のサブネットゲートウェイの IP アドレスを含めることはできません。

  • CreateVSwitchCidrReservation は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。タスクのステータスは、ListVSwitchCidrReservations を呼び出して確認できます。

    • vSwitch のステータスが Assigning の場合、予約済み CIDR ブロックが作成中です。

    • vSwitch のステータスが Assigned の場合、予約済み CIDR ブロックが作成済みです。

  • vSwitch の予約済み IPv4 CIDR ブロックを作成する場合、vSwitch の最初の IP アドレスおよび最後の 3 つの IP アドレスはシステムによって予約されます。これらの 4 つの IP アドレスは割り当てられません。

  • vSwitch の予約済み IPv6 CIDR ブロックを作成する場合、vSwitch の最初の IP アドレスおよび最後の 9 つの IP アドレスはシステムによって予約されます。これらの 10 の IP アドレスは割り当てられません。たとえば、CIDR ブロックが 192.168.1.0/24 の vSwitch に対して予約済み IPv4 CIDR ブロックを作成する場合、次の IP アドレスを予約済み CIDR ブロックに含めることはできません:192.168.1.0、192.168.1.253、192.168.1.254、192.168.1.255。

今すぐお試しください

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

任意

リソースに追加するタグ N のキーです。最大 20 個のタグキーを指定できます。タグキーは空文字列にすることはできません。

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

FinanceDept

Value

string

任意

リソースに追加するタグ N の値です。最大 20 個のタグ値を指定できます。タグ値は空文字列にすることもできます。

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

FinanceJoshua

VSwitchId

string

必須

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

vsw-25navfgbue4g****

VSwitchCidrReservationName

string

任意

予約済み CIDR ブロックの名前です。

名前の長さは 2~128 文字で、数字、アンダースコア (_)、ハイフン (-) を使用できます。先頭は英字である必要があります。

ReservationName

VSwitchCidrReservationDescription

string

任意

予約済み CIDR ブロックの説明です。デフォルトではこのパラメーターは空です。

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

ReservationDescription

IpVersion

string

任意

予約済み CIDR ブロックの IP バージョンです。有効な値は次のとおりです。

  • IPv4 (デフォルト)

  • IPv6

IPv4

VSwitchCidrReservationMask

string

任意

予約済み CIDR ブロックのサブネットマスクです。

  • IpVersionIPv4 に設定されている場合、CIDR ブロックのサブネットマスク長は、vSwitch の IPv4 サブネットマスク長より大きく、かつ 28 以下である必要があります。

  • IpVersionIPv6 に設定されている場合、CIDR ブロックのサブネットマスク長は、vSwitch の IPv6 サブネットマスク長より大きく、かつ 80 以下である必要があります。

説明

VSwitchCidrReservationMask および VSwitchCidrReservationCidr のいずれか一方を指定する必要があります。

28

VSwitchCidrReservationCidr

string

任意

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

  • IpVersionIPv4 に設定されている場合、予約済み CIDR ブロックは vSwitch の IPv4 CIDR ブロックの真部分集合である必要があり、予約済み CIDR ブロックのサブネットマスク長は 28 以下である必要があります。

  • IpVersionIPv6 に設定されている場合、予約済み CIDR ブロックは vSwitch の IPv6 CIDR ブロックの真部分集合である必要があり、予約済み CIDR ブロックのサブネットマスク長は 80 以下である必要があります。

説明

VSwitchCidrReservationMask および VSwitchCidrReservationCidr のいずれか一方を指定する必要があります。

192.168.1.64/28

VSwitchCidrReservationType

string

任意

予約済み CIDR ブロックのタイプです。値を prefix に設定します。

説明

ユーザーまたはクラウドサービスが ENI (Elastic Network Interface) に CIDR ブロックを割り当てる場合、その CIDR ブロックは予約済み CIDR ブロックから割り当てる必要があります。予約済み CIDR ブロックの容量が枯渇している場合は、エラーが返されます。

prefix

ClientToken

string

任意

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

クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意になるようにする必要があります。トークンには ASCII 文字のみを使用できます。

説明

このパラメーターを指定しない場合、システムは自動的に リクエスト IDクライアントトークン として使用します。リクエスト ID は各リクエストごとに異なる可能性があります。

123e4567-e89b-12d3-a456-426655440000

DryRun

boolean

任意

実際のリクエストを実行せずにドライランのみを実施するかどうかを指定します。有効な値は次のとおりです。

  • true:実際のリクエストを実行せずにドライランのみを実施します。システムは、パラメーター値の欠落、リクエスト構文の誤り、サービス制限など、潜在的な問題についてリクエストをチェックします。ドライランに失敗した場合は、エラーメッセージが返されます。ドライランに成功した場合は、DryRunOperation エラーコードが返されます。

  • false (デフォルト):ドライランを実施し、実際のリクエストも実行します。ドライランに成功した場合は、2xx HTTP ステータスコードが返され、操作が実行されます。

false

RegionId

string

必須

vSwitch がデプロイされているリージョンの ID です。

最新のリージョンリストを照会するには、DescribeRegions 操作を呼び出してください。

cn-hangzhou

レスポンスフィールド

フィールド

説明

object

予約済み CIDR ブロックの ID です。

VSwitchCidrReservationId

string

予約済み 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.
400 ResourceNotFound.VSwitch The specified resource of VSwitch is not found.
400 UnsupportedFeature.ReservedType The specified ReservedType is not supported.
400 UnsupportedFeature.VSwitchIpv6 The ipv6 feature of switch is not supported.
400 OperationFailed.VSwitchCidrReservationCidr The specified VSwitchCidrReservationCidr conflicts with existed cidr reservation or vswitch cidr.
400 MissingParam.CidrReservationMaskOrCidrReservationCidr Either VSwitchCidrReservationMask or VSwitchCidrReservationCidr should be specified.
400 UnsupportedRegion UnsupportedRegion
400 UnsupportedFeature.VpcAdvancedFeature UnsupportedFeature.VpcAdvancedFeature
400 QuotaExceeded.CidrReservationCount The quota of VSwitchCidrReservation is exceeded.
400 Conflict.CidrReservationMaskAndCidrReservationCidr The specified VSwitchCidrReservationMask and VSwitchCidrReservationCidr is conflict.
400 OperationFailed.CidrNotEnoughInVSwitch No enough cidr to allocate in this vswitch.
400 OperationFailed.SystemReservedIpContained The specified VSwitchCidrReservationCidr cannot contain system reserved IP addresses.
400 OperationFailed.AlreadyUsedIpContained The specified VSwitchCidrReservationCidr cannot contain already used IP addresses.
400 IncorrectStatus.VSWITCH The status of the specified VSwitch is invalid.
400 IllegalParam.VSwitchCidrReservationMask The specified VSwitchCidrReservationMask must be at least 2 bits greater than the vSwitch mask.
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.

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

変更履歴

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