Spec-Zone.ru › AWS CLI v2

[ aws . lightsail ]

создать-базу-данных

Описание

Создаёт новую базу данных в Amazon Lightsail.

Операция create relational database поддерживает контроль доступа на основе тегов через теги запроса. Дополнительная информация доступна в руководстве разработчика Amazon Lightsail.

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

Синтаксис

  create-relational-database
--relational-database-name <value>
[--availability-zone <value>]
--relational-database-blueprint-id <value>
--relational-database-bundle-id <value>
--master-database-name <value>
--master-username <value>
[--master-user-password <value>]
[--preferred-backup-window <value>]
[--preferred-maintenance-window <value>]
[--publicly-accessible | --no-publicly-accessible]
[--tags <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]

Параметры

--relational-database-name (строка)

Имя для нового ресурса базы данных Lightsail.

Ограничения:

  • Должно содержать от 2 до 255 буквенно-цифровых символов или дефисов.
  • Первый и последний символ должны быть буквой или цифрой.

--availability-zone (строка)

Зона доступности, в которой следует создать новую базу данных. Используйте формат us-east-2a (регистрозависимый).

Список зон доступности можно получить, используя операцию get regions. Не забудьте добавить параметр include relational database Availability Zones в свой запрос.

--relational-database-blueprint-id (строка)

Идентификатор шаблона для новой базы данных. Шаблон описывает основную версию движка базы данных.

Список идентификаторов шаблонов баз данных можно получить, используя операцию get relational database blueprints.

--relational-database-bundle-id (строка)

Идентификатор пакета для новой базы данных. Пакет описывает характеристики производительности базы данных.

Список идентификаторов пакетов баз данных можно получить, используя операцию get relational database bundles.

--master-database-name (строка)

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

MySQL

Имя базы данных, которое нужно создать при создании ресурса базы данных Lightsail. Если этот параметр не указан, база данных в ресурсе базы данных не создается.

Ограничения:

  • Должно содержать от 1 до 64 букв или цифр.
  • Должно начинаться с буквы. Последующие символы могут быть буквами, символами подчеркивания или цифрами (0-9).
  • Не может быть ключевым словом, зарезервированным указанным движком базы данных. Более подробную информацию о зарезервированных словах в MySQL см. в статьях «Ключевые слова и зарезервированные слова» для MySQL 5.6 , MySQL 5.7 и MySQL 8.0 .
PostgreSQL

Имя базы данных, которое нужно создать при создании ресурса базы данных Lightsail. Если этот параметр не указан, в ресурсе базы данных создаётся база данных с именем postgres.

Ограничения:

  • Должно содержать от 1 до 63 букв или цифр.
  • Должно начинаться с буквы. Последующие символы могут быть буквами, символами подчеркивания или цифрами (0-9).
  • Не может быть ключевым словом, зарезервированным указанным движком базы данных. Дополнительную информацию о зарезервированных словах в PostgreSQL см. в статьях «SQL Key Words» для PostgreSQL 9.6 , PostgreSQL 10 , PostgreSQL 11 и PostgreSQL 12 .

--master-username (строка)

Имя пользователя-админа.

MySQL

Ограничения:

  • Необходимо для MySQL.
  • Должно содержать от 1 до 16 букв или цифр. Можно использовать символы подчеркивания.
  • Первый символ должен быть буквой.
  • Не должно совпадать с зарезервированным словом для выбранного движка базы данных. Дополнительную информацию о зарезервированных словах в MySQL 5.6 или 5.7 см. в статьях «Ключевые слова и зарезервированные слова» для MySQL 5.6 , MySQL 5.7 или MySQL 8.0 .
PostgreSQL

Ограничения:

  • Необходимо для PostgreSQL.
  • Должно содержать от 1 до 63 букв или цифр. Можно использовать символы подчеркивания.
  • Первый символ должен быть буквой.
  • Не должно совпадать с зарезервированным словом для выбранного движка базы данных. Дополнительную информацию о зарезервированных словах в MySQL 5.6 или 5.7 см. в статьях «Ключевые слова и зарезервированные слова» для PostgreSQL 9.6 , PostgreSQL 10 , PostgreSQL 11 и PostgreSQL 12 .

--master-user-password (строка)

Пароль пользователя-админа. Пароль может содержать любые печатные ASCII-символы, кроме «/», «"» или «@». Он не должен содержать пробелов.

MySQL

Ограничения: Должно содержать от 8 до 41 символа.

PostgreSQL

Ограничения: Должно содержать от 8 до 128 символов.

--preferred-backup-window (строка)

Диапазон времени в течение дня, в который создаются автоматические резервные копии для новой базы данных, если автоматические резервные копии включены.

По умолчанию используется 30-минутный интервал, случайным образом выбранный из 8-часового блока времени для каждой AWS-региона. Дополнительную информацию о предпочтительных временных блоках резервного копирования для каждой региона см. в руководстве по работе с резервными копиями в документации Amazon Relational Database Service.

Ограничения:

  • Должно быть в формате hh24:mi-hh24:mi. Пример: 16:00-16:30
  • Указано в формате Coordinated Universal Time (UTC).
  • Не должно конфликтовать с предпочтительным временным интервалом технического обслуживания.
  • Должно быть не менее 30 минут.

--preferred-maintenance-window (строка)

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

По умолчанию используется 30-минутный интервал, случайным образом выбранный из 8-часового блока времени для каждой AWS-региона, на случайный день недели.

Ограничения:

  • Должно быть в формате ddd:hh24:mi-ddd:hh24:mi.
  • Допустимые дни: Пн, Вт, Ср, Чт, Пт, Сб, Вс.
  • Должно быть не менее 30 минут.
  • Указано в формате Coordinated Universal Time (UTC).
  • Пример: Tue:17:00-Tue:17:30

--publicly-accessible | --no-publicly-accessible (логическое значение)

Указывает параметры доступа к новой базе данных. Значение true указывает на базу данных, доступную для ресурсов за пределами вашей учетной записи Lightsail. Значение false указывает на базу данных, доступную только для ваших ресурсов Lightsail в той же области, что и база данных.

--tags (список)

Ключи и необязательные значения тегов для добавления к ресурсу при создании.

Используйте действие TagResource, чтобы добавить теги к ресурсу после его создания.

(структура)

Описание ключа тега и необязательного значения, назначенного ресурсу Amazon Lightsail.

Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.

key -> (строка)

Ключ тега.

Ограничения: Ключи тегов принимают максимум 128 букв, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

value -> (строка)

Значение тега.

Ограничения: Значения тегов принимают максимум 256 букв, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

Краткая синтаксическая запись:

key=string,value=string ...

Синтаксис JSON:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--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.

Создание управляемой базы данных

Следующий create-relational-database пример создаёт управляемую базу данных в указанном регионе AWS и зоне доступности, используя СУБД MySQL 5.6 (mysql_5_6) и стандартный пакет базы данных на $15 USD (micro_1_0). Управляемая база данных предварительно заполняется именем пользователя-мастером и не доступна для общего доступа.

aws lightsail create-relational-database \
    --relational-database-name Database-1 \
    --availability-zone us-west-2a \
    --relational-database-blueprint-id mysql_5_6 \
    --relational-database-bundle-id micro_1_0 \
    --master-database-name dbmaster \
    --master-username user \
    --no-publicly-accessible

Вывод:

{
    "operations": [
        {
            "id": "b52bedee-73ed-4798-8d2a-9c12df89adcd",
            "resourceName": "Database-1",
            "resourceType": "RelationalDatabase",
            "createdAt": 1569450017.244,
            "location": {
                "availabilityZone": "us-west-2a",
                "regionName": "us-west-2"
            },
            "isTerminal": false,
            "operationType": "CreateRelationalDatabase",
            "status": "Started",
            "statusChangedAt": 1569450018.637
        }
    ]
}

Вывод

operations -> (список)

Массив объектов, описывающих результат действия, такой как статус запроса, отметка времени запроса и ресурсы, затронутые запросом.

(структура)

Описывает операцию API.

id -> (строка)

Идентификатор операции.

resourceName -> (строка)

Имя ресурса.

resourceType -> (строка)

Тип ресурса.

createdAt -> (временная метка)

Отметка времени, когда операция была инициирована (1479816991.349).

location -> (структура)

Регион и зона доступности Amazon Web Services.

availabilityZone -> (строка)

Зона доступности. Следует формату us-east-2a (регистрозависимый).

regionName -> (строка)

Имя региона Amazon Web Services.

isTerminal -> (булево)

Булево значение, указывающее, является ли операция терминальной.

operationDetails -> (строка)

Подробности об операции (Debian-1GB-Ohio-1).

operationType -> (строка)

Тип операции.

status -> (строка)

Статус операции.

statusChangedAt -> (временная метка)

Отметка времени, когда статус был изменен (1479816991.349).

errorCode -> (строка)

Код ошибки.

errorDetails -> (строка)

Подробности об ошибке.

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

Spec-Zone.ru

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