すべてのプロダクト
Search

このプロダクト

    Virtual Private Cloud:CreateVpc

    ドキュメントセンター

    Virtual Private Cloud:CreateVpc

    最終更新日:Jun 26, 2026

    仮想非公開クラウド (VPC) を作成します。

    操作説明

    この操作を呼び出して VPC を作成する際は、以下の項目に注意してください:

    • VPC にはプライマリ IPv4 CIDR ブロックを 1 つのみ設定できます。アドレス空間を拡張するために、IPv4 セカンダリ CIDR ブロックを追加できます。

    • VPC の作成後、元の IPv4 CIDR ブロックを拡張または縮小できます。現在の CIDR ブロック内の IP アドレスが既に使用されており、ターゲット CIDR ブロックの範囲外にある場合、変更は失敗します。

    • 各 VPC は、クラウドリソース用に最大 300,000 個のプライベートネットワーク IP アドレスをサポートします。このクォータはアップグレードできません。

    • VPC の作成後、vRouter とルートテーブルが自動的に作成されます。

    • 各 VPC は最大 3 つのユーザー CIDR ブロックをサポートします。ユーザー CIDR ブロックが重複する場合、マスクが短い CIDR ブロックが効果を持ちます。たとえば、10.0.0.0/16 と 10.0.0.0/24 の両方が指定された場合、10.0.0.0/16 が効果を持ちます。

    • CreateVpc は非同期操作です。リクエストを呼び出すと、システムはインスタンス ID を返しますが、VPC はまだ作成されていません。VPC を作成するノードはバックグラウンドで実行されます。 DescribeVpcAttribute を呼び出して VPC の作成ステータスをクエリできます:

      • VPC が Creating 状態の場合、VPC は作成中です。

      • VPC が Created 状態の場合、VPC は作成済みです。

    • CreateVpc は、クォータ制限に従い、同じリージョンでのデフォルト以外の VPC の同時作成をサポートします。

    今すぐお試しください

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

    create

    *VPC

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    VPC のリージョン ID。

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

    cn-hangzhou
    CidrBlock

    string

    任意

    VPC の CIDR ブロック。

    • 仮想非公開クラウド (VPC) のプライマリ IPv4 CIDR ブロックとして、RFC 1918 で指定された IPv4 アドレスを使用することを推奨します。サブネットマスクは 16～28 ビットの長さである必要があります。例: 10.0.0.0/16、172.16.0.0/16、192.168.0.0/16。

    • 100.64.0.0/10、224.0.0.0/4、127.0.0.0/8、169.254.0.0/16、またはそれらのサブネット以外のカスタム CIDR ブロックを仮想非公開クラウド (VPC) のプライマリ IPv4 CIDR ブロックとして使用することもできます。

    172.16.0.0/12
    Ipv6CidrBlock

    string

    任意

    VPC の IPv6 CIDR ブロック。VPC で IPv6 を有効にすると、システムが IPv6 CIDR ブロックを割り当てます。IPv6 CIDR ブロックを指定するには、まず AllocateVpcIpv6Cidr を呼び出して IPv6 CIDR ブロックを予約し、それを渡す必要があります。

    2408:XXXX:0:6a::/56
    VpcName

    string

    任意

    VPC の名前。

    名前は 1～128 文字で、http:// または https:// で始めることはできません。

    abc
    EnableIpv6

    boolean

    任意

    IPv6 を有効にするかどうかを指定します。有効な値:

    • false (デフォルト): 無効。

    • true: 有効。

    false
    Description

    string

    任意

    VPC の説明。

    説明は 1～256 文字で、http:// または https:// で始めることはできません。

    This is my first Vpc
    ResourceGroupId

    string

    任意

    リソースグループ ID。

    リソースグループの詳細については、リソースグループとはを参照してください。

    rg-acfmxazb4ph6aiy****
    Tag

    array<object>

    任意

    リソースのタグ。

    object

    任意

    タグ。

    Key

    string

    任意

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

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

    FinanceDept
    Value

    string

    任意

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

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

    FinanceJoshua
    DryRun

    boolean

    任意

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

    • true: VPC を作成せずにドライランを実行します。システムは必須パラメーター、リクエストフォーマット、およびサービス制限を確認します。ドライランに失敗した場合、エラーメッセージが返されます。ドライランに成功した場合、DryRunOperation エラーコードが返されます。

    • false (デフォルト): 法線リクエストを実行し、リクエストを送信します。ドライランに成功した場合、HTTP 2xx 状態コードが返され、システムは VPC の作成を続行します。

    false
    UserCidr

    string

    任意

    ユーザー CIDR ブロック。複数の CIDR ブロックはコンマ (,) で区切ります。最大 3 つの CIDR ブロックを指定できます。

    ユーザー CIDR ブロックの詳細については、仮想非公開クラウド (VPC) よくある質問 の ユーザー CIDR ブロックとは セクションを参照してください。

    192.168.0.0/12
    ClientToken

    string

    任意

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

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

    説明

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

    123e4567-e89b-12d3-a456-426655440000
    Ipv6Isp

    string

    任意

    VPC の IPv6 CIDR ブロックのタイプ。有効な値:

    • BGP (デフォルト): Alibaba Cloud BGP IPv6。

    • ChinaMobile: China Mobile (シングル ISP)。

    • ChinaUnicom: China Unicom (シングル ISP)。

    • ChinaTelecom: China Telecom (シングル ISP)。

    説明

    アカウントが China Telecom シングル ISP 帯域幅ホワイトリストに含まれている場合、このパラメーターを ChinaTelecom (China Telecom)、ChinaUnicom (China Unicom)、または ChinaMobile (China Mobile) に設定できます。

    BGP
    Ipv4IpamPoolId

    string

    任意

    IPv4 IPAM プールインスタンスのインスタンス ID。

    ipam-pool-sycmt3p2a9v63i****
    Ipv4CidrMask

    integer

    任意

    IPAM プールから VPC に CIDR ブロックを割り当てるために使用されるサブネットマスク。

    説明

    IPAM プールを指定して VPC を作成する場合、CidrBlock または Ipv4CidrMask の少なくとも 1 つを指定する必要があります。

    12
    EnableDnsHostname

    boolean

    任意

    DNS ホスト名特徴を有効にするかどうかを指定します。有効な値:

    • false (デフォルト): 無効。

    • true: 有効。

    false
    Ipv6IpamPoolId

    string

    任意

    IPv6 IPAM プールインスタンスのインスタンス ID。

    ipam-pool-bp1aq51kkfh477z03****
    Ipv6CidrMask

    integer

    任意

    IPAM プールから VPC に IPv6 CIDR ブロックを割り当てるために使用されるサブネットマスク。

    56

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    作成された VPC の ID。

    VpcId

    string

    作成された VPC の ID。

    vpc-bp15zckdt37pq72zv****
    VRouterId

    string

    VPC の作成後に自動的に作成された vRouter の ID。

    vrt-bp1lhl0taikrteen8****
    RequestId

    string

    リクエスト ID。

    0ED8D006-F706-4D23-88ED-E11ED28DCAC0
    RouteTableId

    string

    VPC の作成後に自動的に作成されたルートテーブルの ID。

    vtb-bp145q7glnuzdv****
    ResourceGroupId

    string

    リソースグループ ID。

    rg-acfmxazb4ph6aiy****

    例

    成功レスポンス

    JSONJSON

    {
  "VpcId": "vpc-bp15zckdt37pq72zv****",
  "VRouterId": "vrt-bp1lhl0taikrteen8****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "RouteTableId": "vtb-bp145q7glnuzdv****",
  "ResourceGroupId": "rg-acfmxazb4ph6aiy****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 TOKEN_PROCESSING Action is processing.
    400 InvokeError instance quota rule invoke error. ルールデータの取得に失敗しました。後でもう一度お試しください。
    400 InvalidParameter Specified CIDR block is not valid
    400 ResourceNotAvailable Resource you requested is not available in this region or zone.
    400 InvalidVpcName.Malformed Specified VPC name is not valid.
    400 InvalidVpcDiscription.Malformed Specified VPC description is not valid.
    400 QuotaExceeded.Vpc VPC quota exceeded. VPCのクォータ上限に達しました。
    400 ResourceNotAvailable.Vpc Resource you requested is not available in this region or zone.
    400 InvalidUserCidr.Quota Specified UserCidr number is greater than 3.
    400 InvalidUserCidr.Malformed Specified UserCidr overlapping in of 100.64.0.0/10. UserCidr が無効な状態です。
    400 InvalidResourceGroupId The specified ResourceGroupId does not exist. リソースグループ ID が存在しません。
    400 IllegalParam.Ipv6CidrBlock %s
    400 OperationFailed.IPv6CidrNotReserved %s
    400 MissingParam.EnableIpv6 %s
    400 OperationUnsupported.Ipv6Feature %s
    400 System.ServiceBusy System is busy, please try later.
    400 IllegalParam.UserCidr UserCidr is not a valid or strict address. UserCidr パラメーターが無効です。
    400 OperationUnsupported.ResourceGroupId ResourceGroup is not supported in this region. 操作はサポートされていません。金融クラウドではリソースグループ ID はサポートされていません。
    400 IllegalParam.EnableIpv6 %s
    400 InvalidIpv6CidrBlock.Malformed Specified Ipv6CidrBlock is not valid.
    400 UnsupportedFeature.Ipv6Isp The Ipv6Isp feature is not supported. 指定された Ipv6Isp の特徴はサポートされていません。
    400 ResourceNotEnough.Ipv6Cidr The specified resource of Ipv6Cidr is not enough. 指定された IPv6 CIDR ブロックのリソースが不足しています。
    400 UnsupportedFeature.IPAM VPCs cannot be created by using IPAM. このリージョンでは IPAM の特徴はサポートされていません。
    400 IllegalParam.Ipv4CidrMask The specified Ipv4CidrMask is illegal. 指定された Ipv4CidrMask が無効です。
    400 IllegalParam.IpamPool The specified IPAM pool cannot be empty. IPAM プールを空にできません。
    400 OperationDenied.RequestRegionInvalid The operation is not allowed because the request is not invoked in the region of the IPAM pool. アドレスプールが存在するリージョンからのリクエストではないため、操作は拒否されました。
    400 OperationDenied.IpamPoolNotInRegion The operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC. リージョン属性を持たない IPAM プールから VPC を作成したり、VPC にセカンダリ CIDR ブロックを追加したりできないため、操作が拒否されました。
    400 MissingParam.CidrOrCidrMask The CIDR or CIDR Mask must be input. IPAM プールからリソースを作成する場合は、Cidr または CidrMask を指定してください。
    400 OperationDenied.CidrInExcludeCidrs The operation is not allowed because the input CIDR is within the illegal CIDRs. 指定された CIDR ブロックが無効な CIDR ブロックの有効値の範囲内にあるため、操作は拒否されました。
    400 OperationDenied.AvailableCidrInsufficient The operation is not allowed because available CIDR is insufficient. VPC に割り当て可能な CIDR 空間がありません。
    400 UnsupportedFeature.Ipam IPAM is not supported in this region.
    400 OperationDenied.CidrUnavailableInPool The operation is not allowed because the CIDR is unavailable in the IPAM pool. CIDR ブロックが IPAM プールで利用できないため、操作は拒否されました。
    400 IllegalParam.CidrBlockMask The param of CidrBlock Mask [%s] is illegal. CidrBlock マスクが無効です。
    400 UnsupportedFeature.VpcDnsHostname The feature of vpc dns hostname is unsupported. VPC プライベートドメイン名前解決のソリューションは現在のリージョンでは有効ではありません。
    400 OperationDenied.MaskOfCidrIsNotAllowed The input mask or mask of the input CIDR is not allowed. 指定されたマスクまたは CIDR ブロックのマスクが許可された有効値内にありません。
    400 IllegalParam.Ipv6Isp The specified Ipv6Isp is illegal. 指定された Ipv6Isp パラメーターが無効です。
    400 IllegalParam.CidrMask The input CIDR mask is illegal. 指定された CIDR ブロックマスクが無効です。
    400 InvalidRegionId.NotFound Specified value of "regionId" is not supported.
    400 UnsupportedFeature.DhcpOptionsSet The feature of dhcp options set is unsupported. DHCP オプションセット関連の特徴は現在のリージョンでは効果がありません。
    400 OperationDenied.CidrMaskTooLarge The operation is denied because the CIDR mask %s is larger than the allocationMaxNetmask %s of the pool. Cidr パラメーターまたは CidrMask パラメーターのマスクが、IPAM プールのコンプライアンスルールの最大ネットワークマスク長を超えています。
    400 OperationDenied.CidrMaskTooSmall The operation is denied because the CIDR mask %s is less than the allocationMinNetmask %s of the pool. Cidr パラメーターまたは CidrMask パラメーターのマスクが、IPAM プールのコンプライアンスルールの最小ネットワークマスク長より小さいです。
    400 Mismatch.ParamIpv6IspAndIpamPoolIpv6Isp The specified IPv6 ISP %s does not match the IPAM pool's IPv6 ISP %s. 指定された IPv6 ISP %s が IPAM プールの IPv6 ISP %s と一致しません。
    500 InternalError The request processing has failed due to some unknown error.
    403 Forbidden User not authorized to operate on the specified resource. EIP は現在の呼び出し元に属していません。この EIP を呼び出す権限があるかどうかを確認してください。
    404 ResourceNotFound.IpamPool The dependent IPAM pool is not found. 依存リソースの IPAM プールが存在しません。

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

    変更履歴

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