request-certificate

Описание

Запрашивает сертификат ACM для использования с другими сервисами Amazon Web Services. Для запроса сертификата ACM необходимо указать полное доменное имя (FQDN) в параметре DomainName. Также можно указать дополнительные FQDN в параметре SubjectAlternativeNames.

Если запрашивается частный сертификат, валидация домена не требуется. Если запрашивается публичный сертификат, каждое указанное доменное имя должно быть валидировано, чтобы подтвердить, что вы владеете или контролируете домен. Вы можете использовать валидацию DNS или валидацию по электронной почте. Рекомендуется использовать валидацию DNS. ACM выдает публичные сертификаты после получения одобрения от владельца домена.

После успешного выполнения действия RequestCertificate, проходит задержка в несколько секунд, прежде чем вы сможете получить информацию о новом сертификате.

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

Синтаксис

  request-certificate
--domain-name <value>
[--validation-method <value>]
[--subject-alternative-names <value>]
[--idempotency-token <value>]
[--domain-validation-options <value>]
[--options <value>]
[--certificate-authority-arn <value>]
[--tags <value>]
[--key-algorithm <value>]
[--managed-by <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 (строка)

--validation-method (строка)

--subject-alternative-names (список)

Синтаксис:

"string" "string" ...

--idempotency-token (строка)

--domain-validation-options (список)

Сокращенный синтаксис:

DomainName=string,ValidationDomain=string ...

Синтаксис JSON:

[
  {
    "DomainName": "string",
    "ValidationDomain": "string"
  }
  ...
]

--options (структура)

Сокращенный синтаксис:

CertificateTransparencyLoggingPreference=string

Синтаксис JSON:

{
  "CertificateTransparencyLoggingPreference": "ENABLED"|"DISABLED"
}

--certificate-authority-arn (строка)

--tags (список)

Сокращенный синтаксис:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--key-algorithm (строка)

--managed-by (строка)

--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
• text
• table
• yaml
• yaml-stream

--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 версии 1, а двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку 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.

Примеры

Для запроса нового сертификата ACM

Следующая request-certificate команда запрашивает новый сертификат для домена www.example.com с помощью проверки по DNS:

aws acm request-certificate --domain-name www.example.com --validation-method DNS

Вы можете ввести маркер идемпотентности, чтобы различать вызовы к request-certificate:

aws acm request-certificate --domain-name www.example.com --validation-method DNS --idempotency-token 91adc45q

Вы можете ввести одно или несколько альтернативных имен субъекта, чтобы запросить сертификат, который будет защищать более одного домена apex:

aws acm request-certificate --domain-name example.com --validation-method DNS --idempotency-token 91adc45q --subject-alternative-names www.example.net

Вы можете ввести альтернативное имя, которое также может использоваться для доступа к вашему веб-сайту:

aws acm request-certificate --domain-name example.com --validation-method DNS --idempotency-token 91adc45q --subject-alternative-names www.example.com

Вы можете использовать символ звёздочки (*) в качестве подстановочного знака, чтобы создать сертификат для нескольких поддоменов в том же домене:

aws acm request-certificate --domain-name example.com --validation-method DNS --idempotency-token 91adc45q --subject-alternative-names *.example.com

Вы также можете ввести несколько альтернативных имен:

aws acm request-certificate --domain-name example.com --validation-method DNS --subject-alternative-names b.example.com c.example.com d.example.com

Если вы используете электронную почту для проверки, вы можете ввести параметры проверки домена, чтобы указать домен, на который будет отправлено письмо проверки:

aws acm request-certificate --domain-name example.com --validation-method EMAIL --subject-alternative-names www.example.com --domain-validation-options DomainName=example.com,ValidationDomain=example.com

Следующая команда отказывается от протоколирования прослеживаемости сертификатов при запросе нового сертификата:

aws acm request-certificate --domain-name www.example.com --validation-method DNS --options CertificateTransparencyLoggingPreference=DISABLED --idempotency-token 184627

Вывод

CertificateArn -> (строка)