CreateVpc - Virtual Private Cloud - Alibaba Cloud ドキュメントセンター

仮想プライベートネットワーク (VPC) を作成します。

操作説明

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

VPC にはプライマリ IPv4 CIDR ブロックを 1 つだけ設定できます。IPv4 セカンダリ CIDR ブロックを追加してアドレス空間を拡張できます。
VPC の作成後、元の IPv4 CIDR ブロックを拡張または縮小できます。現在の CIDR ブロック内の IP アドレスがすでに使用されており、かつ変更後の CIDR ブロックの範囲外である場合、変更は失敗します。
各 VPC は、クラウドリソースに対して最大 300,000 のプライベートネットワークアドレスをサポートします。このクォータはアップグレードできません。
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 はまだ完全には作成されていません。作成のためのバックエンドタスクは進行中です。 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 ブロックを指定できます。フォーマットの詳細については、「仮想プライベートネットワーク (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)。説明アカウントが単一 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 の少なくとも一方を指定する必要があります。	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 が 100.64.0.0/10 と重複しています。
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 を作成したり、セカンダリ 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.	割り当てに使用できる CIDR ブロックが不足しています。VPC のアドレス空間が枯渇しているか、候補の CIDR ブロックに 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 と一致しません。
400	IllegalParam.CidrBlock	The param of CidrBlock [%s] is illegal.	CidrBlock パラメーターが無効です。
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 プールが存在しません。

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

変更履歴

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