создать-базу-данных-кластер

Описание

Создаёт новый кластер Amazon DocumentDB.

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

Синтаксис

  create-db-cluster
[--availability-zones <value>]
[--backup-retention-period <value>]
--db-cluster-identifier <value>
[--db-cluster-parameter-group-name <value>]
[--vpc-security-group-ids <value>]
[--db-subnet-group-name <value>]
--engine <value>
[--engine-version <value>]
[--port <value>]
[--master-username <value>]
[--master-user-password <value>]
[--preferred-backup-window <value>]
[--preferred-maintenance-window <value>]
[--tags <value>]
[--storage-encrypted | --no-storage-encrypted]
[--kms-key-id <value>]
[--pre-signed-url <value>]
[--enable-cloudwatch-logs-exports <value>]
[--deletion-protection | --no-deletion-protection]
[--global-cluster-identifier <value>]
[--storage-type <value>]
[--manage-master-user-password | --no-manage-master-user-password]
[--master-user-secret-kms-key-id <value>]
[--source-region <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]

Параметры

--availability-zones (список)

Синтаксис:

"string" "string" ...

--backup-retention-period (целое число)

--db-cluster-identifier (строка)

--db-cluster-parameter-group-name (строка)

--vpc-security-group-ids (список)

Синтаксис:

"string" "string" ...

--db-subnet-group-name (строка)

--engine (строка)

--engine-version (строка)

--port (целое число)

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

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

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

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

--tags (список)

Идентификатор ключа KMS для зашифрованного кластера.

Идентификатор ключа KMS — это имя Amazon Resource Name (ARN) для ключа шифрования KMS. Если вы создаёте кластер с использованием той же учётной записи Amazon Web Services, что и ключ шифрования KMS, используемый для шифрования нового кластера, вы можете использовать псевдоним ключа KMS вместо ARN ключа шифрования KMS.

Если ключ шифрования не указан в KmsKeyId :

• Если параметр StorageEncrypted равен true , Amazon DocumentDB использует ваш ключ шифрования по умолчанию.

KMS создаёт ключ шифрования по умолчанию для вашей учётной записи Amazon Web Services. У каждой области Amazon Web Services у вашей учётной записи Amazon Web Services есть свой ключ шифрования по умолчанию.

Список типов журналов, которые нужно включить для экспорта в Amazon CloudWatch Logs. Можно включить журналы аудита или профилирования. Дополнительные сведения см. в разделах Аудит событий Amazon DocumentDB и Профилирование операций Amazon DocumentDB.

(строка)

Тип хранилища, который нужно связать с кластером БД.

Дополнительную информацию о типах хранилища для кластеров Amazon DocumentDB см. в руководстве по разработке Amazon DocumentDB в разделе Настройки хранилища кластера.

Допустимые значения для типа хранилища - standard | iopt1

Значение по умолчанию — standard

Идентификатор ключа KMS Amazon Web Services для шифрования секрета, который автоматически генерируется и управляется в Amazon Web Services Secrets Manager. Это значение действует только в том случае, если пароль пользователя-мастера управляется Amazon DocumentDB в Amazon Web Services Secrets Manager для кластера БД.

Идентификатор ключа KMS Amazon Web Services — это ARN ключа, ID ключа, ARN псевдонима или имя псевдонима ключа KMS. Чтобы использовать ключ KMS в другой учётной записи Amazon Web Services, укажите ARN ключа или ARN псевдонима.

Если вы не укажете MasterUserSecretKmsKeyId , то используется aws/secretsmanager ключ KMS для шифрования секрета. Если секрет находится в другой учётной записи Amazon Web Services, то вы не можете использовать aws/secretsmanager ключ KMS для шифрования секрета, и вам необходимо использовать управляемый клиентом ключ KMS.

У вашей учётной записи Amazon Web Services есть ключ KMS по умолчанию для каждой области Amazon Web Services.

Общие параметры

--debug (boolean)

Включить отладовую запись журнала.

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования для вывода команд.

• json
• text
• table
• yaml
• yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Показать версию этого инструмента.

--color (string)

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

• on
• off
• auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (string)

Файл сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. По умолчанию используется формат 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 (boolean)

Отключить вывод пагинатора CLI.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Для создания кластера Amazon DocumentDB

Следующий create-db-cluster пример создает кластер Amazon DocumentDB с именем sample-cluster с предпочтительным окном обслуживания по воскресеньям между 20:30 и 11:00.

aws docdb create-db-cluster \
    --db-cluster-identifier sample-cluster \
    --engine docdb \
    --master-username master-user \
    --master-user-password password \
    --preferred-maintenance-window Sun:20:30-Sun:21:00

Вывод:

{
    "DBCluster": {
        "DBClusterParameterGroup": "default.docdb3.6",
        "AssociatedRoles": [],
        "DBSubnetGroup": "default",
        "ClusterCreateTime": "2019-03-18T18:06:34.616Z",
        "Status": "creating",
        "Port": 27017,
        "PreferredMaintenanceWindow": "sun:20:30-sun:21:00",
        "HostedZoneId": "ZNKXH85TT8WVW",
        "DBClusterMembers": [],
        "Engine": "docdb",
        "DBClusterIdentifier": "sample-cluster",
        "PreferredBackupWindow": "10:12-10:42",
        "AvailabilityZones": [
            "us-west-2d",
            "us-west-2f",
            "us-west-2e"
        ],
        "MasterUsername": "master-user",
        "BackupRetentionPeriod": 1,
        "ReaderEndpoint": "sample-cluster.cluster-ro-corcjozrlsfc.us-west-2.docdb.amazonaws.com",
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-77186e0d",
                "Status": "active"
            }
        ],
        "StorageEncrypted": false,
        "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:sample-cluster",
        "DbClusterResourceId": "cluster-L3R4YRSBUYDP4GLMTJ2WF5GH5Q",
        "MultiAZ": false,
        "Endpoint": "sample-cluster.cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com",
        "EngineVersion": "3.6.0"
    }
}

Для получения дополнительной информации см. раздел Создание кластера Amazon DocumentDB в Руководстве разработчика Amazon DocumentDB.

Вывод

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