← Cloudflare DNS / dns / manage-dns-records / how-to

Пакетное изменение записей

Cloudflare позволяет применить сразу несколько изменений к записям зоны одним действием. Вы можете использовать панель управления чтобы удалить DNS-записи или обновить их статус прокси массово, или использовать API чтобы выполнить дальнейшие пакетные операции.

Пакетное изменение DNS-записей доступно на всех тарифных планах.

Количество записей, с которыми можно работать за одно действие, зависит от плана вашей зоны:

• Free: 200
• Pro: 3,500
• Business: 3,500
• Enterprise: 3,500

A,AAAA, а также CNAME записи могут быть проксируется. Статус прокси DNS-записи влияет на как Cloudflare отвечает на DNS-запросы к этой записи.

1. На панели управления Cloudflare перейдите к разделу DNS-записи страницу.

   Перейдите в Записи ↗

2. Выберите DNS-записи, для которых нужно задать статус прокси. Обратите внимание, что только A, AAAA, а также CNAME записи можно проксировать.

3. Выберите Редактирование записей.

4. Выберите статус прокси, который нужно применить к выбранным записям.

5. Выберите Save для подтверждения.

Для записей можно указать только Proxied или DNS only массово. Это означает, что если в выборку входят как проксируемые записи, так и записи только DNS, у одних статус прокси изменится, а у других сохранится исходное значение:

1. На панели управления Cloudflare перейдите к разделу DNS-записи страницу.

   Перейдите в Записи ↗

2. Выберите DNS-записи, которые нужно удалить.

3. Выберите Удаление записей.

4. В Удаление DNS-записей приглашении введите DELETE и выберите Удалить для подтверждения.

Пакетные изменения DNS-записей эндпоинт позволяет запускать выполнение DELETES, PATCHES, PUTS, а также POSTS в одном запросе.

Теги и комментарии также поддерживаются при пакетных изменениях.

Операции, которые вы указываете в /batch тела запроса всегда выполняются в следующем порядке:

1. Удаляет
2. PATCH-запросы
3. Puts
4. POST-запросы

В каждом из этих четырёх списков отдельные действия выполняются в том порядке DNS-записей, который вы указали. Если хотя бы одно действие завершается ошибкой, изменения не применяются, и API возвращает первую обнаруженную ошибку.

Для каждой операции, указанной в /batch тела запроса учитывайте необходимую информацию и то, как будут вести себя неуказанные поля:

• deletes: только id обязателен для каждого объекта записи. Вы можете сохранить дополнительные параметры, такие как name для удобства чтения, но любые другие поля, кроме id в этом случае будет игнорироваться.
• patches: помимо каждой записи id, вам следует указать поля, которые нужно обновить. Все не указанные поля останутся без изменений.
• puts: необходимо указать каждую запись id, content, name, а также type. Также укажите все остальные поля, для которых нужно задать значение, отличное от значения по умолчанию. Все не указанные поля примут значение по умолчанию для каждого тип записи. Эта операция работает как перезапись, поэтому она всегда затрагивает все поля записи.
• posts: поскольку вы создаёте новую запись, id не обязателен. Определения полей см. в Create DNS Record эндпоинт и выберите нужный тип записи в спецификации тела запроса.

В этом примере proxied поле для первой записи, указанной в разделе "puts" примет значение по умолчанию (false).

{
    "deletes": [
        {
            "id": "2bff0ebc4df64beaa44b0dca93e37a28"
        },
        {
            "id": "31d1d6e79ce04b8d93cbc5a13401d728"
        }
    ],
    "patches": [
        {
            "id": "62276440f783445380480484648c1017",
            "content": "192.0.2.46"
        },
        {
            "id": "c942d948dc2343b9b97aed78479c9fb9",
            "name": "update.example.com",
            "proxied": true
        }
    ],
    "puts": [
        {
            "id": "a50364543094428abde0f14061d42b0e",
            "content": "192.0.2.50",
            "name": "change.example.com",
						"type": "A",
            "ttl:": 1
        },
        {
            "id": "3bce0920f19d43949498bd067b05dfa9",
            "content": "192.0.2.45",
            "name": "no-change.example.com",
						"type": "A",
            "proxied": false,
            "ttl:": 3000
        }
    ],
    "posts": [
        {
            "name": "@",
            "type": "A",
            "content": "192.0.2.41",
            "proxied": false,
            "ttl": 3000
        },
        {
            "name": "a.example.com",
            "type": "A",
            "content": "192.0.2.42",
            "proxied": true
        }
    ]
}