Resource nubes_zones_v2 · v1.0.0 · Service ID: 109 · Service Name: Управление DNS¶

Manual · Create params · Modify params · Output params · Operations · Example

Operations¶

create — Создание кластера. Параметры: Create params
create_record — # Операция create_record (добавление одной записи) ## Что делает операция create_record точечно добавляет одну DNS-запись в существующую зону. Если аналогичная запись уже есть, итоговый набор дополняется в рамках логики типа/имени. ## Когда использовать - нужно добавить одну новую запись без массовой переработки зоны; - нужно быстро внести точечное изменение.. См. nubes_zones_v2_record
delete — # Операция delete (удаление зоны) ## Что делает операция delete удаляет DNS-зону целиком вместе со всеми записями. ## Когда использовать - зона больше не нужна; - домен выводится из эксплуатации в рамках сервиса. ## Важная логика - удаляется вся зона, а не отдельные записи; - перед удалением стоит проверить, что домен действительно не используется.
delete_record — # Операция delete_record (удаление записей по имени) ## Что делает операция delete_record удаляет все записи с указанным именем (recordName), независимо от типа (A, TXT, CNAME и т.д.). ## Когда использовать - нужно полностью убрать конкретное имя из зоны; - требуется быстро очистить все варианты записи для одного имени. ## Важная логика - удаляются все типы записей для выбранного имени; - если нужно удалить только один тип записи, лучше использовать modify_record с нужным целевым состоянием.. См. nubes_zones_v2_record
modify — Изменение кластера. Параметры: Modify params
modify_record — # Операция modify_record (изменение конкретной записи) ## Что делает операция modify_record заменяет записи с указанным именем одной новой записью заданного типа и значения. ## Когда использовать - нужно исправить одну конкретную запись; - нужно заменить старые значения записи на новое целевое значение. ## Важная логика - существующие записи выбранного имени очищаются; - затем добавляется одна новая запись с переданными параметрами.. См. nubes_zones_v2_record
reconcile — # Операция reconcile (актуализация состояния зоны) ## Что делает операция reconcile подтягивает актуальное фактическое состояние DNS-зоны и синхронизирует его с данными инстанса. Операция техническая: она нужна для выравнивания состояния, а не для бизнес-изменений записей. ## Когда использовать - записи менялись вручную на DNS-серверах; - нужно обновить схему/состояние инстанса в личном кабинете; - нужно импортировать текущие записи в управляемое состояние. ## Важная логика - актуализируется список записей в данных инстанса; - стандартно ничего "нового" для клиента не добавляет и не удаляет само по себе, а приводит данные к реальности.