Операции с DNS-записями

Добавить DNS-запись

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Сети.
Нажмите на имя нужной сети в списке.
Перейдите на вкладку Подсети.
Нажмите на имя нужной подсети.
Перейдите на вкладку IP-адреса и нажмите на имя нужного IP-адреса.
Перейдите к редактированию настроек DNS и задайте значения следующих параметров:
- FQDN — доменное имя, которое будет назначено виртуальной машине, например, example.com;
- TTL — TTL для создаваемой DNS-записи в секундах, минутах или часах;
- PTR — укажите, нужно или нет создавать PTR-запись.
Нажмите кнопку Сохранить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя сети:
bash
```
1
mws vpc network list
```

Узнайте имя подсети:

1
mws vpc subnet list --network <имя сети>

Узнайте имя IP-адреса:

1
mws vpc address list --network <имя сети>

Выполните команду:

1
mws vpc address update <имя IP-адреса> \
2
  --network <имя сети> \
3
  --dns '
4
    name: <доменное имя>
5
    ttl: <TTL DNS-записи>
6
    ptr: <true — создать PTR-запись, false — не создавать>
7
  '

1
kind: vpc/v1/address
2
metadata:
3
    id: projects/<имя проекта>/networks/<имя сети>/addresses/<имя IP-адреса>
4
    name: <имя IP-адреса>
5
    createTime: "2025-07-09T13:48:06Z"
6
    updateTime: "2025-10-08T08:30:04Z"
7
    generation: 4
8
    usages:
9
        - usageType: attach
10
          name: c0df6510-12b1-4740-a154-78394fca4732attach
11
          resource: compute/projects/<имя проекта>/virtualMachines/<имя ВМ, которой назначен IP-адрес>
12
        - usageType: use
13
          name: nat-gw
14
          resource: vpc/projects/<имя проекта>/networks/<имя сети>/oneToOneNats/имя ВМ, которой назначен IP-адрес>-nat
15
    etag: f21a1a34321047298b9b77138a0a2020
16
spec:
17
    subnet: vpc/projects/<имя проекта>/networks/n-jifron/<имя сети>/<имя подсети>
18
    dns:
19
        - name: <доменное имя>
20
          ttl: <TTL DNS-записи>
21
          ptr: <true — создать PTR-запись, false — не создавать>
22
status:
23
    ready:
24
        state: PROCESSING
25
    ipAddress: <IP-адрес>

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя сети:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

Узнайте имя подсети:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/subnets \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

Узнайте имя IP-адреса:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses/<имя IP-адреса> \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json" \
4
-d '{
5
  "metadata": {
6
    "id": "projects/<имя проекта>/networks/<имя сети>/addresses/<имя IP-адреса>"
7
  },
8
  "spec": {
9
    "version": "IPV4",
10
    "subnet": "vpc/projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>",
11
    "dns": [
12
      {
13
        "name": "<доменное имя>",
14
        "ttl": "<TTL DNS-записи>",
15
        "ptr": <true — создать PTR-запись, false — не создавать>
16
      }
17
    ]
18
  }
19
}'

Отредактировать DNS-запись

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Сети.
Нажмите на имя нужной сети в списке.
Перейдите на вкладку Подсети.
Нажмите на имя нужной подсети.
Перейдите на вкладку IP-адреса и нажмите на имя нужного IP-адреса.
Перейдите к редактированию настроек DNS и измените значения параметров:
- FQDN — доменное имя, которое будет назначено виртуальной машине, например, example.com;
- TTL — TTL для создаваемой DNS-записи в секундах, минутах или часах;
- PTR — укажите, нужно или нет создавать PTR-запись.
Нажмите кнопку Сохранить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя сети:
bash
```
1
mws vpc network list
```

Узнайте имя подсети:

1
mws vpc subnet list --network <имя сети>

Узнайте имя IP-адреса:

1
mws vpc address list --network <имя сети>

Выполните команду:

1
mws vpc address update <имя IP-адреса> \
2
  --network <имя сети> \
3
  --dns '
4
    name: <доменное имя>
5
    ttl: <TTL DNS-записи>
6
    ptr: <true — создать PTR-запись, false — не создавать>
7
  ' \
8
  --dns '
9
    name: <доменное имя новой DNS-записи>
10
    ttl: <TTL новой DNS-записи>
11
    ptr: <true — создать PTR-запись, false — не создавать>
12
  '

Если команда выполнена успешно, в ответе будет выведена обновленная информация о DNS-записи.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя сети:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

Узнайте имя подсети:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/subnets \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

Узнайте имя IP-адреса:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses/<имя IP-адреса>?updateOnly=true \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json" \
4
-d '{
5
  "metadata": {
6
    "id": "projects/<имя проекта>/networks/<имя сети>/addresses/<имя IP-адреса>"
7
  },
8
  "spec": {
9
    "version": "IPV4",
10
    "subnet": "vpc/projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>",
11
    "dns": [
12
      {
13
        "name": "<доменное имя>",
14
        "ttl": "<TTL DNS-записи>",
15
        "ptr": <true — создать PTR-запись, false — не создавать>
16
      },
17
      {
18
        "name": "<доменное имя для новой DNS-записи>",
19
        "ttl": "<TTL новой DNS-записи>",
20
        "ptr": <true — создать PTR-запись, false — не создавать>
21
      }
22
    ]
23
  }
24
}'

Удалить DNS-запись

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите VPC → Сети.
Нажмите на имя нужной сети в списке.
Перейдите на вкладку Подсети.
Нажмите на имя нужной подсети.
Перейдите на вкладку IP-адреса и нажмите на имя нужного IP-адреса.
Перейдите к редактированию настроек DNS и удалите DNS-запись.
Нажмите кнопку Сохранить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя сети:
bash
```
1
mws vpc network list
```

Узнайте имя подсети:

1
mws vpc subnet list --network <имя сети>

Узнайте имя IP-адреса:

1
mws vpc address list --network <имя сети>

Выполните команду:
bash
```
1
mws vpc address update <имя IP-адреса> \
2
  --network <имя сети> \
3
  --body '
4
    spec:
5
      dns: []
6
  '
```
Если команда была выполнена успешно, в ответе не будет информации о DNS-записях.

Если для нужного IP-адреса было добавлено несколько DNS-записей, передайте в запросе только те, которые нужно сохранить. В этом случае в ответе будет содержаться информация только о DNS-записях, которые не были удалены.

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя сети:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

Узнайте имя подсети:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/subnets \
2
  -H "Authorization: Bearer <IAM-токен>" \
3
  -H "Content-Type: application/json"

Узнайте имя IP-адреса:

1
curl -X GET https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses \
2
  -H "Authorization: Bearer <IAM-токен>"

Если для нужного IP-адреса была одна DNS-запись, передайте в поле dns пустой объект:

1
curl -X POST https://vpc.mwsapis.ru/vpc/v1/projects/<имя проекта>/networks/<имя сети>/addresses/<имя IP-адреса>?updateOnly=true \
2
-H "Authorization: Bearer <IAM-токен>" \
3
-H "Content-Type: application/json" \
4
-d '{
5
  "metadata": {
6
    "id": "projects/<имя проекта>/networks/<имя сети>/addresses/<имя IP-адреса>"
7
  },
8
  "spec": {
9
    "version": "IPV4",
10
    "subnet": "vpc/projects/<имя проекта>/networks/<имя сети>/subnets/<имя подсети>",
11
    "dns": []
12
  }
13
}'

Если для нужного IP-адреса было добавлено несколько DNS-записей, передайте в запросе только те, которые нужно сохранить.