← Cloudflare Workers KV / kv / reference
Команды Wrangler для KV
kv namespace
Управляйте пространствами имён Workers KV.
kv namespace create
Создайте новое пространство имён
npx wrangler kv namespace create [NAMESPACE][NAMESPACE]stringобязательноИмя нового пространства имён
--previewbooleanРабота с пространством имён предварительного просмотра
--use-remotebooleanИспользуйте удалённую привязку при добавлении только что созданного ресурса в конфигурацию
--update-configbooleanАвтоматически обновлять файл конфигурации, добавляя в него новый ресурс
--bindingstringИмя привязки этого ресурса в вашем Worker
Глобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
kv namespace list
Вывести список всех пространств имен KV, связанных с идентификатором вашего аккаунта
npx wrangler kv namespace listГлобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
kv namespace delete
Удалить указанное пространство имён.
npx wrangler kv namespace delete [NAMESPACE][NAMESPACE]stringИмя пространства имён для удаления
--bindingstringИмя привязки к пространству имён, из которого выполняется удаление
--namespace-idstringИдентификатор namespace для удаления
--previewbooleanРабота с пространством имён предварительного просмотра
--skip-confirmationbooleanпсевдоним: --yпо умолчанию: falseПропустить подтверждение
Глобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
kv namespace rename
Переименование пространства имён KV
npx wrangler kv namespace rename [OLD-NAME][OLD-NAME]stringТекущее имя пространства имён, которое нужно переименовать
--namespace-idstringИдентификатор namespace для переименования
--new-namestringобязательноНовое имя пространства имён
Глобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
kv key
Управляйте парами «ключ-значение» в пространстве имён Workers KV.
kv key put
Запишите одну пару ключ/значение в указанное пространство имён
npx wrangler kv key put [KEY] [VALUE][KEY]stringобязательноКлюч для записи
[VALUE]stringЗначение для записи
--pathstringЧтение значения из файла по указанному пути
--bindingstringИмя привязки к пространству имён, в которое выполняется запись
--namespace-idstringИдентификатор namespace, в который нужно записать
--previewbooleanРабота с пространством имён предварительного просмотра
--ttlnumberВремя, в течение которого записи должны быть видимы
--expirationnumberВремя от начала эпохи UNIX, после которого срок действия записи истекает
--metadatastringПроизвольный JSON, связанный с ключом
--localbooleanРабота с локальным хранилищем
--remotebooleanРабота с удалённым хранилищем
--persist-tostringКаталог для локального сохранения данных
Глобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
kv key list
Вывести список всех ключей в указанном пространстве имен
npx wrangler kv key list--bindingstringИмя привязки к пространству имён для получения списка
--namespace-idstringИдентификатор namespace для получения списка
--previewbooleanпо умолчанию: falseРабота с пространством имён предварительного просмотра
--prefixstringПрефикс для фильтрации выводимых ключей
--localbooleanРабота с локальным хранилищем
--remotebooleanРабота с удалённым хранилищем
--persist-tostringКаталог для локального сохранения данных
Глобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
kv key get
Чтение одного значения по ключу из указанного пространства имён
npx wrangler kv key get [KEY][KEY]stringобязательноЗначение ключа для получения.
--textbooleanпо умолчанию: falseДекодировать возвращаемое значение как строку UTF-8
--bindingstringИмя привязки к пространству имён, из которого выполняется получение
--namespace-idstringИдентификатор namespace, из которого нужно получить
--previewbooleanпо умолчанию: falseРабота с пространством имён предварительного просмотра
--localbooleanРабота с локальным хранилищем
--remotebooleanРабота с удалённым хранилищем
--persist-tostringКаталог для локального сохранения данных
Глобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
kv key delete
Удаление одной пары «ключ-значение» из указанного пространства имён
npx wrangler kv key delete [KEY][KEY]stringобязательноЗначение ключа для удаления.
--bindingstringИмя привязки к пространству имён, из которого выполняется удаление
--namespace-idstringИдентификатор namespace, из которого нужно удалить
--previewbooleanРабота с пространством имён предварительного просмотра
--localbooleanРабота с локальным хранилищем
--remotebooleanРабота с удалённым хранилищем
--persist-tostringКаталог для локального сохранения данных
Глобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
kv bulk
Управляйте несколькими парами «ключ-значение» в пространстве имён Workers KV пакетами.
kv bulk get
Возвращает несколько пар ключ-значение из пространства имён
npx wrangler kv bulk get [FILENAME][FILENAME]stringобязательноФайл с ключами для получения
--bindingstringИмя привязки к пространству имён, из которого выполняется получение
--namespace-idstringИдентификатор namespace, из которого нужно получить
--previewbooleanпо умолчанию: falseРабота с пространством имён предварительного просмотра
--localbooleanРабота с локальным хранилищем
--remotebooleanРабота с удалённым хранилищем
--persist-tostringКаталог для локального сохранения данных
Глобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
kv bulk put
Загрузите несколько пар «ключ-значение» в пространство имён
npx wrangler kv bulk put [FILENAME][FILENAME]stringобязательноФайл с парами ключ-значение для записи
--bindingstringИмя привязки к пространству имён, в которое выполняется запись
--namespace-idstringИдентификатор namespace, в который нужно записать
--previewbooleanРабота с пространством имён предварительного просмотра
--ttlnumberВремя, в течение которого записи должны быть видимы
--expirationnumberВремя от начала эпохи UNIX, после которого срок действия записи истекает
--metadatastringПроизвольный JSON, связанный с ключом
--localbooleanРабота с локальным хранилищем
--remotebooleanРабота с удалённым хранилищем
--persist-tostringКаталог для локального сохранения данных
Глобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
kv bulk delete
Удалить несколько пар ключ-значение из пространства имён
npx wrangler kv bulk delete [FILENAME][FILENAME]stringобязательноФайл с ключами для удаления
--forcebooleanпсевдоним: --fНе запрашивать подтверждение перед удалением
--bindingstringИмя привязки к пространству имён, из которого выполняется удаление
--namespace-idstringИдентификатор namespace, из которого нужно удалить
--previewbooleanРабота с пространством имён предварительного просмотра
--localbooleanРабота с локальным хранилищем
--remotebooleanРабота с удалённым хранилищем
--persist-tostringКаталог для локального сохранения данных
Глобальные флаги
--vbooleanпсевдоним: --versionПоказать номер версии
--cwdstringВыполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога
--configstringпсевдоним: --cПуть к файлу конфигурации Wrangler
--envstringпсевдоним: --eОкружение, которое используется для операций и для выбора файлов .env и .dev.vars
--env-filestringПуть к файлу .env для загрузки. Флаг можно указывать несколько раз, при этом значения из более ранних файлов переопределяются значениями из более поздних файлов
--experimental-provisionbooleanпсевдонимы: --x-provisionпо умолчанию: trueЭкспериментально: включите автоматическое выделение ресурсов
--experimental-auto-createbooleanпсевдоним: --x-auto-createпо умолчанию: trueАвтоматически создавать черновые привязки к новым ресурсам
--install-skillsbooleanпо умолчанию: falseПеред выполнением команды устанавливать Cloudflare skills для обнаруженных ИИ-агентов, пишущих код
--profilestringИспользуйте определённый профиль авторизации
Устаревшие функции
Ниже перечислены устаревшие команды Wrangler для Workers KV.
kv:... синтаксис устарел
Начиная с версии 3.60.0, Wrangler поддерживает kv ... синтаксис. Если вы используете версии ниже 3.60.0, команда соответствует kv:... синтаксис.
kv:... синтаксис считается устаревшим начиная с версии 3.60.0 и будет удалён в одной из последующих основных версий.
Например, команды, использующие kv ... синтаксис выглядит следующим образом:
wrangler kv namespace list
wrangler kv key get <KEY>
wrangler kv bulk put <FILENAME>Те же команды с использованием kv:... синтаксис выглядит следующим образом:
wrangler kv:namespace list
wrangler kv:key get <KEY>
wrangler kv:bulk put <FILENAME>