Spec-Zone.ru › AWS CLI v2

[ aws . route53domains ]

renew-domain

Описание

Эта операция продлевает срок действия домена на указанное количество лет. Стоимость продления домена списывается с вашего счета Amazon Web Services.

Рекомендуется продлевать домен за несколько недель до даты истечения срока действия. Некоторые регистры TLD удаляют домены до даты истечения срока действия, если вы не продлили регистрацию достаточно заблаговременно. Более подробную информацию о продлении регистрации домена см. в разделе «Продление регистрации домена» в руководстве разработчика Amazon Route 53.

См. также: Документацию API AWS

Синтаксис

  renew-domain
--domain-name <value>
[--duration-in-years <value>]
--current-expiry-year <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--domain-name (строка)

Имя домена, который вы хотите продлить.

--duration-in-years (целое число)

Количество лет, на которое вы хотите продлить домен. Максимальное количество лет зависит от доменной зоны верхнего уровня. Диапазон допустимых значений для вашего домена см. в разделе «Домены, которые можно зарегистрировать с помощью Amazon Route 53» в руководстве разработчика Amazon Route 53.

По умолчанию: 1

--current-expiry-year (целое число)

Год, когда срок регистрации домена истекает. Это значение должно соответствовать текущей дате истечения срока действия домена.

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Передавать произвольные двоичные значения с помощью предоставленного JSON-значения невозможно, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если не указано значение или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, он проверит входные данные команды и вернёт пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладку логов.

--endpoint-url (строка)

Переопределить стандартный URL команды заданным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла с данными учетной записи.

--region (строка)

Используемый регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить вывод в цвете.

  • включено
  • выключено
  • автоматически

--no-sign-request (булево)

Не подписывать запросы. Данные учетных записей не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Образ сертификата CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое отображается как двоичный блок, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить постраничный вывод CLI.

--cli-auto-prompt (булево)

Автоматически запросить параметры CLI.

--no-cli-auto-prompt (булево)

Отключить автоматический запрос параметров CLI.

Примеры

Примечание

Для использования следующих примеров вам необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей консоли. См. раздел Использование кавычек со строками в руководстве пользователя AWS CLI.

Для продления домена

Следующая renew-domain команда продлевает указанный домен на пять лет. Чтобы получить значение для current-expiry-year, используйте команду get-domain-detail и преобразуйте значение ExpirationDate из формата Unix.

Эта команда выполняется только в регионе us-east-1. Если ваш регион по умолчанию настроен на us-east-1, параметр region можно опустить.

aws route53domains renew-domain \
    --region us-east-1 \
    --domain-name example.com \
    --duration-in-years 5 \
    --current-expiry-year 2020

Вывод:

{
    "OperationId": "3f28e0ac-126a-4113-9048-cc930example"
}

Чтобы подтвердить, что операция выполнена успешно, вы можете запустить get-operation-detail. Для получения дополнительной информации см. get-operation-detail.

Регистр каждой доменной зоны верхнего уровня (TLD), например .com или .org, контролирует максимальное количество лет, на которое можно продлить домен. Чтобы получить максимальный срок продления для вашего домена, см. раздел «Срок регистрации и продления» для вашей доменной зоны верхнего уровня в разделе «Домены, которые можно зарегистрировать с помощью Amazon Route 53» в руководстве разработчика Amazon Route 53.

Для получения дополнительной информации см. раздел «Продление регистрации домена» в руководстве разработчика Amazon Route 53.

Вывод

OperationId -> (строка)

Идентификатор для отслеживания выполнения запроса. Для запроса статуса операции используйте GetOperationDetail.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API