создать-базу-данных
Описание
Создает новую базу данных.
См. также: Документацию API AWS
Синтаксис
create-db-instance
[--db-name <value>]
--db-instance-identifier <value>
[--allocated-storage <value>]
--db-instance-class <value>
--engine <value>
[--master-username <value>]
[--master-user-password <value>]
[--db-security-groups <value>]
[--vpc-security-group-ids <value>]
[--availability-zone <value>]
[--db-subnet-group-name <value>]
[--preferred-maintenance-window <value>]
[--db-parameter-group-name <value>]
[--backup-retention-period <value>]
[--preferred-backup-window <value>]
[--port <value>]
[--multi-az | --no-multi-az]
[--engine-version <value>]
[--auto-minor-version-upgrade | --no-auto-minor-version-upgrade]
[--license-model <value>]
[--iops <value>]
[--option-group-name <value>]
[--character-set-name <value>]
[--publicly-accessible | --no-publicly-accessible]
[--tags <value>]
--db-cluster-identifier <value>
[--storage-type <value>]
[--tde-credential-arn <value>]
[--tde-credential-password <value>]
[--storage-encrypted | --no-storage-encrypted]
[--kms-key-id <value>]
[--domain <value>]
[--copy-tags-to-snapshot | --no-copy-tags-to-snapshot]
[--monitoring-interval <value>]
[--monitoring-role-arn <value>]
[--domain-iam-role-name <value>]
[--promotion-tier <value>]
[--timezone <value>]
[--enable-iam-database-authentication | --no-enable-iam-database-authentication]
[--enable-performance-insights | --no-enable-performance-insights]
[--performance-insights-kms-key-id <value>]
[--enable-cloudwatch-logs-exports <value>]
[--deletion-protection | --no-deletion-protection]
[--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]
Параметры
--db-name (строка)
--db-instance-identifier (строка)
Идентификатор экземпляра БД. Этот параметр хранится в виде строчной строки.
Ограничения:
- Должен содержать от 1 до 63 букв, цифр или дефисов.
- Первый символ должен быть буквой.
- Не должен заканчиваться дефисом и не должен содержать два дефиса подряд.
Пример: mydbinstance
--allocated-storage (целое число)
--db-instance-class (строка)
db.m4.large. Не все классы экземпляров БД доступны во всех регионах Amazon.--engine (строка)
Название используемого для этого экземпляра движка базы данных.
Допустимые значения: neptune
--master-username (строка)
--master-user-password (строка)
--db-security-groups (список)
Список групп безопасности БД, которые необходимо ассоциировать с этим экземпляром БД.
По умолчанию: группа безопасности БД по умолчанию для движка базы данных.
(строка)
Синтаксис:
"string" "string" ...
--vpc-security-group-ids (список)
Список групп безопасности VPC EC2, которые необходимо ассоциировать с этим экземпляром БД.
Не применимо. Ассоциированный список групп безопасности VPC EC2 управляется кластером БД. Дополнительную информацию см. в разделе CreateDBCluster .
По умолчанию: группа безопасности VPC EC2 по умолчанию для группы подсетей БД.
(строка)
Синтаксис:
"string" "string" ...
--availability-zone (строка)
Зона доступности EC2, в которой создается экземпляр БД
По умолчанию: случайная, выбранная системой зона доступности в регионе Amazon.
Пример: us-east-1d
Ограничение: параметр AvailabilityZone нельзя указать, если параметр MultiAZ имеет значение true. Указанная зона доступности должна находиться в том же регионе Amazon, что и текущая конечная точка.
--db-subnet-group-name (строка)
Группа подсетей БД, которая должна быть ассоциирована с этим экземпляром БД.
Если группа подсетей БД отсутствует, то это экземпляр БД без VPC.
--preferred-maintenance-window (строка)
Диапазон времени каждую неделю, в течение которого может происходить техническое обслуживание системы, в универсальном координированном времени (UTC).
Формат: ddd:hh24:mi-ddd:hh24:mi
По умолчанию — 30-минутный интервал, выбранный случайным образом из 8-часового временного блока для каждого региона Amazon, происходящий в случайный день недели.
Допустимые дни: Пн, Вт, Ср, Чт, Пт, Сб, Вс.
Ограничения: минимальный 30-минутный интервал.
--db-parameter-group-name (строка)
Имя группы параметров БД, которая должна быть ассоциирована с этим экземпляром БД. Если этот аргумент опущен, используется группа параметров БД по умолчанию для указанного движка.
Ограничения:
- Должен содержать от 1 до 255 букв, цифр или дефисов.
- Первый символ должен быть буквой.
- Не должен заканчиваться дефисом и не должен содержать два дефиса подряд.
--backup-retention-period (целое число)
Количество дней, в течение которых сохраняются автоматические резервные копии.
Не применимо. Срок хранения автоматических резервных копий управляется кластером БД. Дополнительную информацию см. в разделе CreateDBCluster .
По умолчанию: 1
Ограничения:
- Должно быть значение от 0 до 35
- Не может быть установлено в 0, если экземпляр БД является источником реплик чтения
--preferred-backup-window (строка)
Ежедневный интервал времени, в течение которого создаются автоматические резервные копии.
Не применимо. Ежедневный интервал времени для создания автоматических резервных копий управляется кластером БД. Дополнительную информацию см. в разделе CreateDBCluster .
--port (целое число)
Номер порта, на котором база данных принимает соединения.
Не применимо. Порт управляется кластером БД. Дополнительную информацию см. в разделе CreateDBCluster .
По умолчанию: 8182
Тип: целое число
--multi-az | --no-multi-az (логическое значение)
--engine-version (строка)
--auto-minor-version-upgrade | --no-auto-minor-version-upgrade (логическое значение)
Указывает, что незначительные обновления движка применяются автоматически к экземпляру БД в течение окна обслуживания.
По умолчанию: true
--license-model (строка)
Информация о лицензионной модели для этого экземпляра БД.
Допустимые значения: license-included | bring-your-own-license | general-public-license
--iops (целое число)
--option-group-name (строка)
--character-set-name (строка)
--publicly-accessible | --no-publicly-accessible (логическое значение)
--tags (список)
Теги, которые необходимо назначить новому экземпляру.
(структура)
Метаданные, назначенные ресурсу Amazon Neptune, состоящие из пары «ключ-значение».
Ключ -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «/», «=», «+», «-» (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$”).Значение -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «/», «=», «+», «-» (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$”).Сокращенный синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--db-cluster-identifier (строка)
Идентификатор кластера БД, к которому будет принадлежать экземпляр.
Дополнительную информацию о создании кластера БД см. в CreateDBCluster .
Тип: строка
--storage-type (строка)
--tde-credential-arn (строка)
--tde-credential-password (строка)
--storage-encrypted | --no-storage-encrypted (логическое значение)
Указывает, зашифрован ли экземпляр БД.
Не применимо. Шифрование экземпляров БД управляется кластером БД. Дополнительную информацию см. в CreateDBCluster .
По умолчанию: false
--kms-key-id (строка)
Идентификатор ключа Amazon KMS для зашифрованного экземпляра БД.
Идентификатор ключа KMS — это Amazon Resource Name (ARN) для ключа шифрования KMS. Если вы создаёте экземпляр БД с той же учётной записью Amazon, что и владелец ключа шифрования KMS, используемого для шифрования нового экземпляра БД, то вместо ARN для ключа шифрования KMS можно использовать псевдоним ключа KMS.
Не применимо. Идентификатор ключа KMS управляется кластером БД. Дополнительную информацию см. в CreateDBCluster .
Если параметр StorageEncrypted имеет значение true, а вы не указываете значение для параметра KmsKeyId, то Amazon Neptune будет использовать ваш ключ шифрования по умолчанию. Amazon KMS создаёт ключ шифрования по умолчанию для вашей учётной записи Amazon. У вашей учётной записи Amazon есть другой ключ шифрования по умолчанию для каждого региона Amazon.
--domain (строка)
--copy-tags-to-snapshot | --no-copy-tags-to-snapshot (логическое значение)
--monitoring-interval (целое число)
Интервал в секундах между точками, когда для экземпляра БД собираются метрики расширенного мониторинга. Чтобы отключить сбор метрик расширенного мониторинга, укажите 0. По умолчанию 0.
Если MonitoringRoleArn указан, то вы также должны установить MonitoringInterval на значение, отличное от 0.
Допустимые значения: 0, 1, 5, 10, 15, 30, 60
--monitoring-role-arn (строка)
ARN для роли IAM, которая разрешает Neptune отправлять метрики расширенного мониторинга в Amazon CloudWatch Logs. Например, arn:aws:iam:123456789012:role/emaccess.
Если MonitoringInterval имеет значение, отличное от 0, то вам необходимо указать значение MonitoringRoleArn.
--domain-iam-role-name (строка)
--promotion-tier (целое число)
Значение, которое определяет порядок повышения реплики чтения до основного экземпляра после сбоя существующего основного экземпляра.
По умолчанию: 1
Допустимые значения: 0 - 15
--timezone (строка)
--enable-iam-database-authentication | --no-enable-iam-database-authentication (логическое значение)
--enable-performance-insights | --no-enable-performance-insights (логическое значение)
--performance-insights-kms-key-id (строка)
--enable-cloudwatch-logs-exports (список)
Список типов журналов, которые необходимо включить для экспорта в CloudWatch Logs.
(строка)
Синтаксис:
"string" "string" ...
--deletion-protection | --no-deletion-protection (логическое значение)
Значение, указывающее, включена ли защита от удаления для экземпляра БД. База данных не может быть удалена при включенной защите от удаления. По умолчанию защита от удаления отключена. См. Удаление экземпляра БД .
Экземпляры БД в кластере БД могут быть удалены даже при включенной защите от удаления в родительском кластере БД.
--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
- 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 для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматический запрос параметров ввода CLI.
Вывод
DBInstance -> (структура)
Содержит данные об экземпляре базы данных Amazon Neptune.
Этот тип данных используется в качестве элемента ответа в действии DescribeDBInstances.
DBInstanceIdentifier -> (строка)
DBInstanceClass -> (строка)
Engine -> (строка)
DBInstanceStatus -> (строка)
MasterUsername -> (строка)
DBName -> (строка)
Endpoint -> (структура)
Указывает конечную точку подключения.
Address -> (строка)
Port -> (целое число)
HostedZoneId -> (строка)
AllocatedStorage -> (целое число)
InstanceCreateTime -> (метка времени)
PreferredBackupWindow -> (строка)
BackupRetentionPeriod.BackupRetentionPeriod -> (целое число)
DBSecurityGroups -> (список)
Предоставляет список элементов группы безопасности базы данных, содержащих только DBSecurityGroup.Name и DBSecurityGroup.Status подэлементы.
(структура)
Указывает членство в выделенной группе безопасности базы данных.
DBSecurityGroupName -> (строка)
Status -> (строка)
VpcSecurityGroups -> (список)
Предоставляет список элементов групп безопасности VPC, к которым принадлежит экземпляр базы данных.
(структура)
Этот тип данных используется в качестве элемента ответа для запросов о членстве в группе безопасности VPC.
VpcSecurityGroupId -> (строка)
Status -> (строка)
DBParameterGroups -> (список)
Предоставляет список групп параметров базы данных, примененных к этому экземпляру базы данных.
(структура)
Статус группы параметров базы данных.
Этот тип данных используется в качестве элемента ответа в следующих действиях:
- CreateDBInstance
- DeleteDBInstance
- ModifyDBInstance
- RebootDBInstance
DBParameterGroupName -> (строка)
ParameterApplyStatus -> (строка)
AvailabilityZone -> (строка)
DBSubnetGroup -> (структура)
Указывает информацию о группе подсетей, связанной с экземпляром базы данных, включая имя, описание и подсети в группе подсетей.
DBSubnetGroupName -> (строка)
DBSubnetGroupDescription -> (строка)
VpcId -> (строка)
SubnetGroupStatus -> (строка)
Subnets -> (список)
Содержит список элементов Subnet.
(структура)
Указывает подсеть.
Этот тип данных используется в качестве элемента ответа в действии DescribeDBSubnetGroups.
SubnetIdentifier -> (строка)
SubnetAvailabilityZone -> (структура)
Указывает зону доступности EC2, в которой находится подсеть.
Name -> (строка)
SubnetStatus -> (строка)
DBSubnetGroupArn -> (строка)
PreferredMaintenanceWindow -> (строка)
PendingModifiedValues -> (структура)
Указывает, что изменения в экземпляре базы данных находятся в ожидании. Этот элемент включается только при ожидании изменений. Конкретные изменения определяются подэлементами.
DBInstanceClass -> (строка)
DBInstanceClass для экземпляра базы данных, которое будет применено или в настоящее время применяется.AllocatedStorage -> (целое число)
AllocatedStorage для экземпляра базы данных, который будет применён или в настоящее время применяется.MasterUserPassword -> (строка)
Port -> (целое число)
BackupRetentionPeriod -> (целое число)
MultiAZ -> (булево)
EngineVersion -> (строка)
LicenseModel -> (строка)
Iops -> (целое число)
DBInstanceIdentifier -> (строка)
DBInstanceIdentifier для экземпляра базы данных, которое будет применено или в настоящее время применяется.StorageType -> (строка)
CACertificateIdentifier -> (строка)
DBSubnetGroupName -> (строка)
PendingCloudwatchLogsExports -> (структура)
Эта структура PendingCloudwatchLogsExports указывает ожидаемые изменения, для которых включены и отключены журналы CloudWatch.
LogTypesToEnable -> (список)
Типы журналов, которые находятся в процессе отключения. После отключения эти типы журналов не экспортируются в CloudWatch Logs.
(строка)
LogTypesToDisable -> (список)
Типы журналов, которые находятся в процессе включения. После включения эти типы журналов экспортируются в CloudWatch Logs.
(строка)
LatestRestorableTime -> (метка времени)
MultiAZ -> (булево)
EngineVersion -> (строка)
AutoMinorVersionUpgrade -> (булево)
ReadReplicaSourceDBInstanceIdentifier -> (строка)
ReadReplicaDBInstanceIdentifiers -> (список)
Содержит один или несколько идентификаторов Read Replica, связанных с этим экземпляром базы данных.
(строка)
ReadReplicaDBClusterIdentifiers -> (список)
Содержит один или несколько идентификаторов кластеров базы данных, являющихся Read Replica этого экземпляра базы данных.
(строка)
LicenseModel -> (строка)
Iops -> (целое число)
OptionGroupMemberships -> (список)
(структура)
Не поддерживается Neptune.
OptionGroupName -> (строка)
Status -> (строка)
CharacterSetName -> (строка)
SecondaryAvailabilityZone -> (строка)
PubliclyAccessible -> (булево)
StatusInfos -> (список)
Статус Read Replica. Если экземпляр не является Read Replica, это пусто.
(структура)
Предоставляет список информации о статусе экземпляра базы данных.
StatusType -> (строка)
Normal -> (булево)
Status -> (строка)
Message -> (строка)
StorageType -> (строка)
TdeCredentialArn -> (строка)
DbInstancePort -> (целое число)
DBClusterIdentifier -> (строка)
StorageEncrypted -> (булево)
KmsKeyId -> (строка)
DbiResourceId -> (строка)
CACertificateIdentifier -> (строка)
DomainMemberships -> (список)
Не поддерживается
(структура)
Запись о членстве в домене Active Directory, связанная с экземпляром базы данных.
Domain -> (строка)
Status -> (строка)
FQDN -> (строка)
IAMRoleName -> (строка)
CopyTagsToSnapshot -> (булево)
MonitoringInterval -> (целое число)
EnhancedMonitoringResourceArn -> (string)
MonitoringRoleArn -> (string)
PromotionTier -> (integer)
DBInstanceArn -> (string)
Timezone -> (string)
IAMDatabaseAuthenticationEnabled -> (boolean)
PerformanceInsightsEnabled -> (boolean)
PerformanceInsightsKMSKeyId -> (string)
EnabledCloudwatchLogsExports -> (list)
Список типов журналов, которые настроен этот экземпляр базы данных для экспорта в CloudWatch Logs.
(string)
DeletionProtection -> (boolean)
© Copyright 2025, Amazon Web Services. Created using Sphinx.