[Документация Yandex Cloud](../../../index.md) > [Yandex Virtual Private Cloud](../../index.md) > Справочник API > [REST (англ.)](../index.md) > [Subnet](index.md) > Create # Virtual Private Cloud API, REST: Subnet.Create Creates a subnet in the specified folder and network. Method starts an asynchronous operation that can be cancelled while it is in progress. ## HTTP request ``` POST https://vpc.api.yandexcloud.kz/vpc/v1/subnets ``` ## Body parameters {#yandex.cloud.vpc.v1.CreateSubnetRequest} ```json { "folderId": "string", "name": "string", "description": "string", "labels": "object", "networkId": "string", "zoneId": "string", "v4CidrBlocks": [ "string" ], "routeTableId": "string", "dhcpOptions": { "domainNameServers": [ "string" ], "domainName": "string", "ntpServers": [ "string" ] } } ``` #| ||Field | Description || || folderId | **string** ID of the folder to create a subnet in. To get folder ID use a [yandex.cloud.resourcemanager.v1.FolderService.List](../../../resource-manager/api-ref/Folder/list.md#List) request. The length must be less than or equal to 50. This field is required. || || name | **string** Name of the subnet. The name must be unique within the folder. The value must match the regular expression: ```|[a-zA-Z]([-_a-zA-Z0-9]{0,61}[a-zA-Z0-9])?```. || || description | **string** Description of the subnet. The length must be less than or equal to 256. || || labels | **object** (map<**string**, **string**>) Resource labels, `` key:value `` pairs. Each map key must match the regular expression: `[a-z][-_0-9a-z]*`. Each map value must match the regular expression: `[-_0-9a-z]*`. The length of each map key must be between 1 and 63. The length of each map value must be less than or equal to 63. The number of elements must be less than or equal to 64. || || networkId | **string** ID of the network to create subnet in. The length must be less than or equal to 50. This field is required. || || zoneId | **string** ID of the availability zone where the subnet resides. To get a list of available zones, use the [yandex.cloud.compute.v1.ZoneService.List](../../../compute/api-ref/Zone/list.md#List) request. The length must be less than or equal to 50. This field is required. || || v4CidrBlocks[] | **string** CIDR block. The range of internal addresses that are defined for this subnet. For example, 10.0.0.0/22 or 192.168.0.0/24. Minimum subnet size is /28, maximum subnet size is /16. || || routeTableId | **string** ID of route table the subnet is linked to. The length must be less than or equal to 50. || || dhcpOptions | **[DhcpOptions](#yandex.cloud.vpc.v1.DhcpOptions)** || |# ## DhcpOptions {#yandex.cloud.vpc.v1.DhcpOptions} #| ||Field | Description || || domainNameServers[] | **string** A list of DHCP servers for this subnet. || || domainName | **string** A domain name to us as a suffix when resolving host names in this subnet. || || ntpServers[] | **string** List of NTP servers for this subnet. || |# ## Response {#yandex.cloud.operation.Operation} **HTTP Code: 200 - OK** ```json { "id": "string", "description": "string", "createdAt": "string", "createdBy": "string", "modifiedAt": "string", "done": "boolean", "metadata": "object", // Includes only one of the fields `error`, `response` "error": { "code": "integer", "message": "string", "details": [ "object" ] }, "response": "object" // end of the list of possible fields } ``` An Operation resource. For more information, see [Operation](../../../api-design-guide/concepts/operation.md). #| ||Field | Description || || id | **string** ID of the operation. || || description | **string** Description of the operation. 0-256 characters long. || || createdAt | **string** (date-time) Creation timestamp. String in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. The range of possible values is from `0001-01-01T00:00:00Z` to `9999-12-31T23:59:59.999999999Z`, i.e. from 0 to 9 digits for fractions of a second. To work with values in this field, use the APIs described in the [Protocol Buffers reference](https://developers.google.com/protocol-buffers/docs/reference/overview). In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). || || createdBy | **string** ID of the user or service account who initiated the operation. || || modifiedAt | **string** (date-time) The time when the Operation resource was last modified. String in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. The range of possible values is from `0001-01-01T00:00:00Z` to `9999-12-31T23:59:59.999999999Z`, i.e. from 0 to 9 digits for fractions of a second. To work with values in this field, use the APIs described in the [Protocol Buffers reference](https://developers.google.com/protocol-buffers/docs/reference/overview). In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). || || done | **boolean** If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available. || || metadata | **object** Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any. || || error | **[Status](#google.rpc.Status)** The error result of the operation in case of failure or cancellation. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set. || || response | **object** The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is [google.protobuf.Empty](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Empty). If the original method is the standard Create/Update, the response should be the target resource of the operation. Any method that returns a long-running operation should document the response type, if any. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set. || |# ## Status {#google.rpc.Status} The error result of the operation in case of failure or cancellation. #| ||Field | Description || || code | **integer** (int32) Error code. An enum value of [google.rpc.Code](https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto). || || message | **string** An error message. || || details[] | **object** A list of messages that carry the error details. || |#