Spec-Zone.ru › AWS CLI v2

[ aws . lightsail ]

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

Описание

Создаёт новую базу данных из существующего снимка базы данных в Amazon Lightsail.

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

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

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

Синтаксис

  create-relational-database-from-snapshot
--relational-database-name <value>
[--availability-zone <value>]
[--publicly-accessible | --no-publicly-accessible]
[--relational-database-snapshot-name <value>]
[--relational-database-bundle-id <value>]
[--source-relational-database-name <value>]
[--restore-time <value>]
[--use-latest-restorable-time | --no-use-latest-restorable-time]
[--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 в свой запрос.

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

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

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

Имя снимка базы данных, из которого нужно создать новую базу данных.

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

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

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

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

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

Имя исходной базы данных.

--restore-time (метка времени)

Дата и время восстановления базы данных.

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

  • Должно быть до последнего восстановимого времени базы данных.
  • Не может быть указано, если параметр use latest restorable time имеет значение true.
  • Указывается в формате UTC (Всемирное координированное время).
  • Указывается в формате Unix time. Например, если вы хотите использовать время восстановления 1 октября 2018 года в 20:00 UTC, то введите значение 1538424000 как время восстановления.

--use-latest-restorable-time | --no-use-latest-restorable-time (логическое)

Указывает, восстанавливается ли ваша база данных из последнего времени резервного копирования. Значение true восстанавливает из последнего времени резервного копирования.

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

Ограничения: Не может быть указано, если параметр restore time задан.

--tags (список)

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

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

(структура)

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

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

ключ -> (строка)

Ключ тега.

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

значение -> (строка)

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

Ограничения: Значения тегов принимают максимум 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 в справочном руководстве по AWS CLI.

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

Чтобы создать управляемую базу данных из снимка

Следующий create-relational-database-from-snapshot пример создает управляемую базу данных из указанного снимка в указанной области AWS и зоне доступности, используя стандартный пакет базы данных стоимостью $15 USD. Примечание: Указанный пакет должен быть равен или больше по спецификациям, чем пакет исходной базы данных, используемой для создания снимка.

aws lightsail create-relational-database-from-snapshot \
    --relational-database-snapshot-name Database-Oregon-1-1566839359 \
    --relational-database-name Database-1 \
    --availability-zone us-west-2a \
    --relational-database-bundle-id micro_1_0 \
    --no-publicly-accessible

Вывод:

{
    "operations": [
        {
            "id": "ad6d9193-9d5c-4ea1-97ae-8fe6de600b4c",
            "resourceName": "Database-1",
            "resourceType": "RelationalDatabase",
            "createdAt": 1569867916.938,
            "location": {
                "availabilityZone": "us-west-2a",
                "regionName": "us-west-2"
            },
            "isTerminal": false,
            "operationType": "CreateRelationalDatabaseFromSnapshot",
            "status": "Started",
            "statusChangedAt": 1569867918.643
        }
    ]
}

Вывод

операции -> (список)

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

(структура)

Описывает операцию 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 -> (строка)

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

Spec-Zone.ru

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