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 February 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.

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.