- tocdepth
2
Методы API для управления зонами DNS
Endpoint для запросов — https://console.cloud.ru/api/clouddns
.
Примеры запросов смотрите в разделе Инструкции.
Подсказка
Актуальную спецификацию можно скачать
и использовать в привычном инструменте.
Перед началом работы
Уточните Service Instance ID (parentId
) вида d55b938f-47de-4d2a-b03f-331fdaf947cf
.
Этот идентификатор можно скопировать в сервисе Cloud DNS в разделе Зоны.
Он отображается:
В поле Service Instance ID.
В URL-адресе после наименования сервиса.
https://console.cloud.ru/projects/e0e00.../cloud-dns/d55b9...
В примере выше d55b9...
— идентификатор Service Instance ID (parentId
).
Набор методов для управления зонами DNS
Метод API |
HTTP-метод |
Описание |
---|---|---|
Get zones |
GET |
Возвращает список всех созданных зон DNS |
Get zones/{id} |
GET |
Возвращает информацию об указанной зоне DNS |
Create |
POST |
Создает зону |
Update |
PATCH |
Обновляет параметры зоны |
Delete |
DELETE |
Удаляет зону |
- GET /v1/zones
- Query Parameters
parentId (string) – обязательное поле. Указывается идентификатор родительского сервисного инстанса.
- Status Codes
200 OK – A successful response.
- Response JSON Object
items (array) – список зон.
items[].createdAt (string) – время создания зоны.
items[].delegated (boolean) – указывает на то, что зона делегирована.
items[].id (string) – идентификатор зоны.
items[].lastCheck (string) – время последней проверки зоны.
items[].name (string) – наименование зоны.
items[].parentId (string) – идентификатор владельца ключа.
items[].updatedAt (string) – время последнего обновления зоны.
items[].valid (boolean) – указывает на то, что зона проверена и готова к использованию.
items[].validationText (string) – уникальный текст для валидации зоны.
- POST /v1/zones
- Request JSON Object
name (string) – обязательное поле. Наименование зоны (FQDN).
parentId (string) – обязательное поле. Указывается идентификатор родительского сервисного инстанса.
- Status Codes
200 OK – A successful response.
- Response JSON Object
createdAt (string) – время создания зоны.
delegated (boolean) – указывает на то, что зона делегирована.
id (string) – идентификатор зоны.
lastCheck (string) – время последней проверки зоны.
name (string) – наименование зоны.
parentId (string) – идентификатор владельца ключа.
updatedAt (string) – время последнего обновления зоны.
valid (boolean) – указывает на то, что зона проверена и готова к использованию.
validationText (string) – уникальный текст для валидации зоны.
- GET /v1/zones/{id}
- Parameters
id (string) – обязательное поле. Идентификатор зоны.
- Status Codes
200 OK – A successful response.
- Response JSON Object
createdAt (string) – время создания зоны.
delegated (boolean) – указывает на то, что зона делегирована.
id (string) – идентификатор зоны.
lastCheck (string) – время последней проверки зоны.
name (string) – наименование зоны.
parentId (string) – идентификатор владельца ключа.
updatedAt (string) – время последнего обновления зоны.
valid (boolean) – указывает на то, что зона проверена и готова к использованию.
validationText (string) – уникальный текст для валидации зоны.
- DELETE /v1/zones/{id}
- Parameters
id (string) – обязательное поле. Идентификатор зоны.
- Status Codes
200 OK – A successful response.
- PUT /v1/zones/{zone.id}
- Parameters
zone.id (string) – идентификатор зоны.
- Request JSON Object
zone (object) – обязательное поле. Обновленная зона.
zone.createdAt (string) – время создания зоны.
zone.delegated (boolean) – указывает на то, что зона делегирована.
zone.id (string) – идентификатор зоны.
zone.lastCheck (string) – время последней проверки зоны.
zone.name (string) – наименование зоны.
zone.parentId (string) – идентификатор владельца ключа.
zone.updatedAt (string) – время последнего обновления зоны.
zone.valid (boolean) – указывает на то, что зона проверена и готова к использованию.
zone.validationText (string) – уникальный текст для валидации зоны.
- Status Codes
200 OK – A successful response.
- Response JSON Object
createdAt (string) – время создания зоны.
delegated (boolean) – указывает на то, что зона делегирована.
id (string) – идентификатор зоны.
lastCheck (string) – время последней проверки зоны.
name (string) – наименование зоны.
parentId (string) – идентификатор владельца ключа.
updatedAt (string) – время последнего обновления зоны.
valid (boolean) – указывает на то, что зона проверена и готова к использованию.
validationText (string) – уникальный текст для валидации зоны.
- PATCH /v1/zones/{zone.id}
- Parameters
zone.id (string) – идентификатор зоны.
- Request JSON Object
updateMask (string) – обязательное поле. Маска для обновления зоны.
zone (object) – обязательное поле. Обновленная зона.
zone.createdAt (string) – время создания зоны.
zone.delegated (boolean) – указывает на то, что зона делегирована.
zone.id (string) – идентификатор зоны.
zone.lastCheck (string) – время последней проверки зоны.
zone.name (string) – наименование зоны.
zone.parentId (string) – идентификатор владельца ключа.
zone.updatedAt (string) – время последнего обновления зоны.
zone.valid (boolean) – указывает на то, что зона проверена и готова к использованию.
zone.validationText (string) – уникальный текст для валидации зоны.
- Status Codes
200 OK – A successful response.
- Response JSON Object
createdAt (string) – время создания зоны.
delegated (boolean) – указывает на то, что зона делегирована.
id (string) – идентификатор зоны.
lastCheck (string) – время последней проверки зоны.
name (string) – наименование зоны.
parentId (string) – идентификатор владельца ключа.
updatedAt (string) – время последнего обновления зоны.
valid (boolean) – указывает на то, что зона проверена и готова к использованию.
validationText (string) – уникальный текст для валидации зоны.
Была ли статья полезной?
для Dev & Test