---
title: "Ресурс selectel_global_router_dedicated_subnet_v1"
sidebar_label: "selectel_global_router_dedicated_subnet_v1"
description: "Creates and manages a global router subnet that connects a dedicated server private subnet to a global router in the Global Router service using public API v1"
sidebar_position: 40
---

# Ресурс selectel\_global\_router\_dedicated\_subnet\_v1

:::info

Эта инструкция — копия документации Selectel Terraform-провайдера в [Terraform Registry](https://registry.terraform.io/providers/selectel/selectel/latest/docs).

:::

Creates and manages a global router subnet that connects an existing dedicated server private subnet to a global router in the Global Router service using public API v1. Learn how to [add a private subnet in the control panel](/dedicated/networks/private-networks-and-subnets/#add-private-subnet-to-control-panel).

For more information about dedicated server networks, see the [official Selectel documentation](/dedicated/networks/about-networks/). For more information about global routers, see the [official Selectel documentation](/global-router/).

## Example Usage \{#example-usage}

```hcl
resource "selectel_global_router_dedicated_subnet_v1" "global_router_dedicated_subnet_1" {
  network_id        = selectel_global_router_dedicated_network_v1.global_router_dedicated_network_1.id
  cidr              = "10.10.10.0/24"
  gateway           = "10.10.10.13"
  service_addresses = ["10.10.10.253", "10.10.10.254"]
  name              = "my_super_dedicated_subnet"
  tags              = ["blue", "red"]
}
```

## Argument Reference \{#argument-reference}

* `name` - (Required) Name of the global router subnet.
* `network_id` - (Required) Unique identifier of the global router network, that was created for the dedicated server network to which the subnet belongs. Retrieved from the [selectel\_global\_router\_dedicated\_network\_v1](/terraform/selectel-provider-reference/resources/global_router_dedicated_network_v1) resource. Changing this deletes the global router subnet and connected static routes and recreates them with the new argument value.
* `cidr` - (Required) Subnet IP address range in CIDR notation. To get subnet CIDR, in the [Control panel](https://my.selectel.ru/servers/network/networks), go to **Dedicated servers** ⟶ the **Private subnets** tab ⟶ copy the subnet CIDR. Changing this deletes the global router subnet and connected static routes and recreates them with the new argument value.
* `gateway` - (Optional) Subnet IP address that will be used as gateway on the global router. This IP address must be available. If not specified, the first IP address in the subnet range will be used. Changing this deletes the global router subnet and connected static routes and recreates them with the new argument value.
* `service_addresses` - (Optional) Two subnet IP addresses that will be reserved as service ones. These IP addresses must be available. If not specified, the last two IP addresses in subnet range will be reserved. Changing this deletes the global router subnet and connected static routes and recreates them with the new argument value.
* `tags` — (Optional) List of global router subnet tags.

## Attributes Reference \{#attributes-reference}

* `id` - Unique identifier of the global router subnet.
* `name` - Name of the global router subnet.
* `network_id` - Unique identifier of the global router network to which the subnet belongs.
* `cidr` - Subnet IP address range in CIDR notation.
* `gateway` - Subnet IP address that is used as gateway on the global router.
* `service_addresses` - Two subnet IP addresses that are reserved as service ones.
* `tags` - List of subnet tags.
* `created_at` - Time when the global router subnet was created.
* `updated_at` - Time when the global router subnet was updated.
* `status` - Global router subnet status.
* `account_id` - Selectel account ID.
* `netops_subnet_id` - Option for internal usage.
* `sv_subnet_id` - Option for internal usage.

## Import \{#import}

You can import a global router subnet:

```shell
export OS_DOMAIN_NAME=<account_id>
export OS_USERNAME=<username>
export OS_PASSWORD=<password>
export INFRA_REGION=<selectel_pool>
terraform import selectel_global_router_dedicated_subnet_v1.global_router_dedicated_subnet_1 <subnet_id>
```

where:

* `<account_id>` — Selectel account ID. The account ID is in the top right corner of the [Control panel](https://my.selectel.ru/). Learn more about [Registration](/account/registration/).

* `<username>` — Name of the service user. To get the name, in the [Control panel](https://my.selectel.ru/iam/users_management/users?type=service), go to **Identity & Access Management** ⟶ **User management** ⟶ the **Service users** tab ⟶ copy the name of the required user. Learn more about [Service users](/access-control/access-management/).

* `<password>` — Password of the service user.

* `<selectel_pool>` — Pool where the subnet is located, for example, `MSK-1`. To get information about the pool, in the [Control panel](https://my.selectel.ru/network/localnetwork/l3/), go to **Products** ⟶ **Global Router** ⟶ the global router page. The pool is on the subnet's network card.

* `<subnet_id>` — Unique identifier of the global router subnet, for example, `4784d52d-bc14-4329-af1b-6fa6e81994d2`. To get the subnet ID in the [Control panel](https://my.selectel.ru/network/localnetwork/l3/), go to **Products** ⟶ **Global Router** ⟶ the global router page ⟶ the subnet network card. The subnet ID is in the **UUID** column.