создать-базу-данных
Описание
Создаёт новую базу данных в 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 (строка)
Значение этого параметра отличается в зависимости от используемого движка базы данных.
Имя базы данных, которое нужно создать при создании ресурса базы данных Lightsail. Если этот параметр не указан, база данных в ресурсе базы данных не создается.
Ограничения:
- Должно содержать от 1 до 64 букв или цифр.
- Должно начинаться с буквы. Последующие символы могут быть буквами, символами подчеркивания или цифрами (0-9).
- Не может быть ключевым словом, зарезервированным указанным движком базы данных. Более подробную информацию о зарезервированных словах в MySQL см. в статьях «Ключевые слова и зарезервированные слова» для MySQL 5.6 , MySQL 5.7 и MySQL 8.0 .
Имя базы данных, которое нужно создать при создании ресурса базы данных Lightsail. Если этот параметр не указан, в ресурсе базы данных создаётся база данных с именем postgres.
Ограничения:
- Должно содержать от 1 до 63 букв или цифр.
- Должно начинаться с буквы. Последующие символы могут быть буквами, символами подчеркивания или цифрами (0-9).
- Не может быть ключевым словом, зарезервированным указанным движком базы данных. Дополнительную информацию о зарезервированных словах в PostgreSQL см. в статьях «SQL Key Words» для PostgreSQL 9.6 , PostgreSQL 10 , PostgreSQL 11 и PostgreSQL 12 .
--master-username (строка)
Имя пользователя-админа.
Ограничения:
- Необходимо для MySQL.
- Должно содержать от 1 до 16 букв или цифр. Можно использовать символы подчеркивания.
- Первый символ должен быть буквой.
- Не должно совпадать с зарезервированным словом для выбранного движка базы данных. Дополнительную информацию о зарезервированных словах в MySQL 5.6 или 5.7 см. в статьях «Ключевые слова и зарезервированные слова» для MySQL 5.6 , MySQL 5.7 или MySQL 8.0 .
Ограничения:
- Необходимо для PostgreSQL.
- Должно содержать от 1 до 63 букв или цифр. Можно использовать символы подчеркивания.
- Первый символ должен быть буквой.
- Не должно совпадать с зарезервированным словом для выбранного движка базы данных. Дополнительную информацию о зарезервированных словах в MySQL 5.6 или 5.7 см. в статьях «Ключевые слова и зарезервированные слова» для PostgreSQL 9.6 , PostgreSQL 10 , PostgreSQL 11 и PostgreSQL 12 .
--master-user-password (строка)
Пароль пользователя-админа. Пароль может содержать любые печатные ASCII-символы, кроме «/», «"» или «@». Он не должен содержать пробелов.
Ограничения: Должно содержать от 8 до 41 символа.
Ограничения: Должно содержать от 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 -> (строка)
isTerminal -> (булево)
operationDetails -> (строка)
Debian-1GB-Ohio-1).operationType -> (строка)
status -> (строка)
statusChangedAt -> (временная метка)
1479816991.349).errorCode -> (строка)
errorDetails -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.