Spec-Zone.ru › AWS CLI v2

[ aws . iot ]

создание-сертификата-из-csr

Описание

Создаёт сертификат X.509 на основе предоставленного запроса на подписание сертификата (CSR).

Требуется разрешение на доступ к действию CreateCertificateFromCsr.

Примечание

Запрос на подписание сертификата (CSR) должен содержать открытый ключ, представляющий собой ключ RSA длиной не менее 2048 бит или ключ ECC с кривыми NIST P-256, NIST P-384 или NIST P-521. Список поддерживаемых сертификатов см. в разделе Поддерживаемые алгоритмы подписи сертификатов для IoT.

Примечание

Использование одного и того же запроса на подписание сертификата (CSR) приводит к созданию отдельного сертификата.

Вы можете создать несколько сертификатов в группе, создав директорию, скопировав несколько файлов .csr в эту директорию и указав эту директорию в командной строке. Приведённые ниже команды демонстрируют, как создать группу сертификатов на основе группы запросов на подписание сертификатов. В следующих командах предполагается, что набор запросов на подписание сертификатов находится в директории my-csr-directory:

В Linux и OS X, команда имеет вид:

$ ls my-csr-directory/ | xargs -I {} aws iot create-certificate-from-csr --certificate-signing-request file://my-csr-directory/{}

Эта команда перечисляет все запросы на подписание сертификатов в my-csr-directory и передаёт имя каждого файла запроса команде aws iot create-certificate-from-csr AWS CLI для создания сертификата для соответствующего запроса.

Вы также можете запустить aws iot create-certificate-from-csr часть команды параллельно, чтобы ускорить процесс создания сертификатов:

$ ls my-csr-directory/ | xargs -P 10 -I {} aws iot create-certificate-from-csr --certificate-signing-request file://my-csr-directory/{}

В Windows PowerShell, команда для создания сертификатов для всех запросов на подписание сертификатов в директории my-csr-directory имеет вид:

> ls -Name my-csr-directory | %{aws iot create-certificate-from-csr --certificate-signing-request file://my-csr-directory/$_}

В командной строке Windows, команда для создания сертификатов для всех запросов на подписание сертификатов в директории my-csr-directory имеет вид:

> forfiles /p my-csr-directory /c "cmd /c aws iot create-certificate-from-csr --certificate-signing-request file://@path"

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

Синтаксис

  create-certificate-from-csr
--certificate-signing-request <value>
[--set-as-active | --no-set-as-active]
[--certificate-pem-outfile <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]

Параметры

--certificate-signing-request (строка)

Запрос на подписание сертификата (CSR).

--set-as-active | --no-set-as-active (булево)

Указывает, активен ли сертификат.

--certificate-pem-outfile (строка) Сохраняет содержимое вывода команды certificatePem в указанный файл.

--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 (строка)

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

--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 (строка)

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

  • on
  • off
  • auto

--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-auto-prompt (булево)

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

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

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

Примеры

Примечание

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

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

Для создания сертификата устройства из запроса на подписание сертификата (CSR)

Следующий create-certificate-from-csr пример создаёт сертификат устройства из запроса на подписание сертификата (CSR). Вы можете использовать команду openssl для создания CSR.

aws iot create-certificate-from-csr \
    --certificate-signing-request=file://certificate.csr

Вывод:

{
    "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9",
        "certificateId": "c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9",
        "certificatePem": "<certificate-text>"
}

Дополнительная информация доступна в разделе CreateCertificateFromCSR в Справочнике по API AWS IoT.

Вывод

certificateArn -> (строка)

Amazon Resource Name (ARN) сертификата. Вы можете использовать ARN как субъект для операций политики.

certificateId -> (строка)

Идентификатор сертификата. Операции управления сертификатами используют только certificateId.

certificatePem -> (строка)

Данные сертификата в формате PEM.

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

Spec-Zone.ru

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