Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Terraform in Yandex Cloud
  • Getting started
  • Solution library
    • Overview
    • Release notes
          • vpc_address
          • vpc_default_security_group
          • vpc_gateway
          • vpc_network
          • vpc_private_endpoint
          • vpc_route_table
          • vpc_security_group
          • vpc_security_group_rule
          • vpc_subnet

In this article:

  • Example usage
  • Arguments & Attributes Reference
  • Import
  1. Terraform reference
  2. Resources
  3. Virtual Private Cloud
  4. Resources
  5. vpc_subnet

yandex_vpc_subnet (Resource)

Written by
Yandex Cloud
Updated at April 9, 2026
  • Example usage
  • Arguments & Attributes Reference
  • Import

Manages a subnet within the Yandex Cloud. For more information, see the official documentation.

  • How-to Guides
    • Cloud Networking
    • VPC Addressing

Example usageExample usage

//
// Create a new VPC Subnet.
//
resource "yandex_vpc_subnet" "my_subnet" {
  v4_cidr_blocks = ["10.2.0.0/16"]
  zone           = "ru-central1-a"
  network_id     = yandex_vpc_network.lab-net.id
}

resource "yandex_vpc_network" "lab-net" {
  name = "lab-network"
}

Arguments & Attributes ReferenceArguments & Attributes Reference

  • created_at (Read-Only) (String). The creation timestamp of the resource.
  • description (String). The resource description.
  • folder_id (String). The folder identifier that resource belongs to. If it is not provided, the default provider folder-id is used.
  • id (String).
  • labels (Map Of String). A set of key/value label pairs which assigned to resource.
  • name (String). The resource name.
  • network_id (Required)(String). ID of the network this subnet belongs to. Only networks that are in the distributed mode can have subnets.
  • route_table_id (String). The ID of the route table to assign to this subnet. Assigned route table should belong to the same network as this subnet.
  • v4_cidr_blocks (Required)(List Of String). A list of blocks of internal IPv4 addresses that are owned by this subnet. Provide this property when you create the subnet. For example, 10.0.0.0/22 or 192.168.0.0/16. Blocks of addresses must be unique and non-overlapping within a network. Minimum subnet size is /28, and maximum subnet size is /16. Only IPv4 is supported.
  • v6_cidr_blocks (Read-Only) (List Of String). An optional list of blocks of IPv6 addresses that are owned by this subnet.
  • zone (String). The availability zone where resource is located. If it is not provided, the default provider zone will be used.
  • dhcp_options [Block]. Options for DHCP client.
    • domain_name (String). Domain name.
    • domain_name_servers (List Of String). Domain name server IP addresses.
    • ntp_servers (List Of String). NTP server IP addresses.
  • timeouts [Block].
    • create (String).
    • delete (String).
    • update (String).

ImportImport

The resource can be imported by using their resource ID. For getting it you can use Yandex Cloud Web Console or Yandex Cloud CLI.

# terraform import yandex_vpc_subnet.<resource Name> <resource Id>
terraform import yandex_vpc_subnet.my_subnet ...

Was the article helpful?

Previous
vpc_security_group_rule
Next
dataproc_cluster
© 2026 Direct Cursus Technology L.L.C.