создать-группу-фрагментов-базы-данных

Описание

Создаёт новую группу фрагментов базы данных для Aurora Limitless Database. Для создания группы фрагментов базы данных необходимо включить Aurora Limitless Database.

Применимо к: только кластерам баз данных Aurora

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

Синтаксис

  create-db-shard-group
--db-shard-group-identifier <value>
--db-cluster-identifier <value>
[--compute-redundancy <value>]
--max-acu <value>
[--min-acu <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]

Параметры

--db-shard-group-identifier (строка)

Имя группы фрагментов базы данных.

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

Имя первичного кластера базы данных для группы фрагментов базы данных.

--compute-redundancy (целое число)

Указывает, необходимо ли создавать резервные группы фрагментов базы данных для группы фрагментов базы данных. Допустимые значения:

0 - Создаёт группу фрагментов базы данных без резервной группы фрагментов базы данных. Это значение по умолчанию.
1 - Создаёт группу фрагментов базы данных с резервной группой фрагментов базы данных в другой зоне доступности (AZ).
2 - Создаёт группу фрагментов базы данных с двумя резервными группами фрагментов базы данных в двух разных зонах доступности.

--max-acu (дробное число)

Максимальная ёмкость группы фрагментов базы данных в единицах ёмкости Aurora (ACU).

--min-acu (дробное число)

Минимальная ёмкость группы фрагментов базы данных в единицах ёмкости Aurora (ACU).

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

Указывает, доступна ли группа фрагментов базы данных публично.

Если группа фрагментов базы данных доступна публично, её DNS-адрес разрешается до частного IP-адреса внутри виртуальной частной сети (VPC) группы фрагментов базы данных. Он разрешается до публичного IP-адреса за пределами VPC группы фрагментов базы данных. Доступ к группе фрагментов базы данных в конечном счёте контролируется используемой группой безопасности. Такой публичный доступ не разрешён, если группа безопасности, назначенная группе фрагментов базы данных, его не разрешает.

Если группа фрагментов базы данных не доступна публично, это внутренняя группа фрагментов базы данных с DNS-именем, которое разрешается до частного IP-адреса.

Значение по умолчанию: поведение по умолчанию зависит от того, указан ли DBSubnetGroupName.

Если DBSubnetGroupName не указан и PubliclyAccessible не указан, действует следующее:

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

Если DBSubnetGroupName указан, а PubliclyAccessible не указан, действует следующее:

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

--tags (список)

Список тегов.

Дополнительную информацию см. в разделе Маркировка ресурсов Amazon RDS в руководстве пользователя Amazon RDS или Маркировка ресурсов Amazon Aurora и Amazon RDS в руководстве пользователя Amazon Aurora.

(структура)

Метаданные, назначенные ресурсу Amazon RDS, представляющие собой пару ключ-значение.

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

Ключ — это требуемое имя тега. Строковое значение может иметь длину от 1 до 128 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).

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

Значение — это необязательное значение тега. Строковое значение может иметь длину от 1 до 256 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).

Сокращённый синтаксис:

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
text
таблица
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-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

Отключение автоматического запроса параметров ввода командной строки.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве пользователя AWS CLI в разделе «Начало работы».

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

Пример 1: Создание первичного кластера базы данных Aurora PostgreSQL

Следующий create-db-cluster пример создаёт первичный кластер базы данных Aurora PostgreSQL SQL, совместимый с Aurora Serverless v2 и Aurora Limitless Database.

aws rds create-db-cluster \
    --db-cluster-identifier my-sv2-cluster \
    --engine aurora-postgresql \
    --engine-version 15.2-limitless \
    --storage-type aurora-iopt1 \
    --serverless-v2-scaling-configuration MinCapacity=2,MaxCapacity=16 \
    --enable-limitless-database \
    --master-username myuser \
    --master-user-password mypassword \
    --enable-cloudwatch-logs-exports postgresql

Вывод:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "us-east-2b",
            "us-east-2c",
            "us-east-2a"
        ],
        "BackupRetentionPeriod": 1,
        "DBClusterIdentifier": "my-sv2-cluster",
        "DBClusterParameterGroup": "default.aurora-postgresql15",
        "DBSubnetGroup": "default",
        "Status": "creating",
        "Endpoint": "my-sv2-cluster.cluster-cekycexample.us-east-2.rds.amazonaws.com",
        "ReaderEndpoint": "my-sv2-cluster.cluster-ro-cekycexample.us-east-2.rds.amazonaws.com",
        "MultiAZ": false,
        "Engine": "aurora-postgresql",
        "EngineVersion": "15.2-limitless",
        "Port": 5432,
        "MasterUsername": "myuser",
        "PreferredBackupWindow": "06:05-06:35",
        "PreferredMaintenanceWindow": "mon:08:25-mon:08:55",
        "ReadReplicaIdentifiers": [],
        "DBClusterMembers": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-########",
                "Status": "active"
            }
        ],
        "HostedZoneId": "Z2XHWR1EXAMPLE",
        "StorageEncrypted": false,
        "DbClusterResourceId": "cluster-XYEDT6ML6FHIXH4Q2J1EXAMPLE",
        "DBClusterArn": "arn:aws:rds:us-east-2:123456789012:cluster:my-sv2-cluster",
        "AssociatedRoles": [],
        "IAMDatabaseAuthenticationEnabled": false,
        "ClusterCreateTime": "2024-02-19T16:24:07.771000+00:00",
        "EnabledCloudwatchLogsExports": [
            "postgresql"
        ],
        "EngineMode": "provisioned",
        "DeletionProtection": false,
        "HttpEndpointEnabled": false,
        "CopyTagsToSnapshot": false,
        "CrossAccountClone": false,
        "DomainMemberships": [],
        "TagList": [],
        "StorageType": "aurora-iopt1",
        "AutoMinorVersionUpgrade": true,
        "ServerlessV2ScalingConfiguration": {
            "MinCapacity": 2.0,
            "MaxCapacity": 16.0
        },
        "NetworkType": "IPV4",
        "IOOptimizedNextAllowedModificationTime": "2024-03-21T16:24:07.781000+00:00",
        "LimitlessDatabase": {
            "Status": "not-in-use",
            "MinRequiredACU": 96.0
        }
    }
}

Пример 2: Создание первичного (записывающего) экземпляра базы данных

Следующий create-db-instance пример создаёт первичный (записывающий) экземпляр базы данных Aurora Serverless v2. При использовании консоли для создания кластера базы данных Amazon RDS автоматически создаёт экземпляр записывающей базы данных для вашего кластера базы данных. Однако при использовании AWS CLI для создания кластера базы данных необходимо явно создать экземпляр записывающей базы данных для вашего кластера базы данных с помощью команды AWS CLI create-db-instance.

aws rds create-db-instance \
    --db-instance-identifier my-sv2-instance \
    --db-cluster-identifier my-sv2-cluster \
    --engine aurora-postgresql \
    --db-instance-classdb.serverless

Вывод:

{
    "DBInstance": {
        "DBInstanceIdentifier": "my-sv2-instance",
        "DBInstanceClass": "db.serverless",
        "Engine": "aurora-postgresql",
        "DBInstanceStatus": "creating",
        "MasterUsername": "myuser",
        "AllocatedStorage": 1,
        "PreferredBackupWindow": "06:05-06:35",
        "BackupRetentionPeriod": 1,
        "DBSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-########",
                "Status": "active"
            }
        ],
        "DBParameterGroups": [
            {
                "DBParameterGroupName": "default.aurora-postgresql15",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "DBSubnetGroup": {
            "DBSubnetGroupName": "default",
            "DBSubnetGroupDescription": "default",
            "VpcId": "vpc-########",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-2c"
                    },
                    "SubnetOutpost": {},
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-2a"
                    },
                    "SubnetOutpost": {},
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-2b"
                    },
                    "SubnetOutpost": {},
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "fri:09:01-fri:09:31",
        "PendingModifiedValues": {
            "PendingCloudwatchLogsExports": {
                "LogTypesToEnable": [
                    "postgresql"
                ]
            }
        },
        "MultiAZ": false,
        "EngineVersion": "15.2-limitless",
        "AutoMinorVersionUpgrade": true,
        "ReadReplicaDBInstanceIdentifiers": [],
        "LicenseModel": "postgresql-license",
        "OptionGroupMemberships": [
            {
                "OptionGroupName": "default:aurora-postgresql-15",
                "Status": "in-sync"
            }
        ],
        "PubliclyAccessible": false,
        "StorageType": "aurora-iopt1",
        "DbInstancePort": 0,
        "DBClusterIdentifier": "my-sv2-cluster",
        "StorageEncrypted": false,
        "DbiResourceId": "db-BIQTE3B3K3RM7M74SK5EXAMPLE",
        "CACertificateIdentifier": "rds-ca-rsa2048-g1",
        "DomainMemberships": [],
        "CopyTagsToSnapshot": false,
        "MonitoringInterval": 0,
        "PromotionTier": 1,
        "DBInstanceArn": "arn:aws:rds:us-east-2:123456789012:db:my-sv2-instance",
        "IAMDatabaseAuthenticationEnabled": false,
        "PerformanceInsightsEnabled": false,
        "DeletionProtection": false,
        "AssociatedRoles": [],
        "TagList": [],
        "CustomerOwnedIpEnabled": false,
        "BackupTarget": "region",
        "NetworkType": "IPV4",
        "StorageThroughput": 0,
        "CertificateDetails": {
            "CAIdentifier": "rds-ca-rsa2048-g1"
        },
        "DedicatedLogVolume": false
    }
}

Пример 3: Создание группы фрагментов базы данных

Следующий create-db-shard-group пример создаёт группу фрагментов базы данных в вашем первичном кластере базы данных Aurora PostgreSQL.

aws rds create-db-shard-group \
    --db-shard-group-identifier my-db-shard-group \
    --db-cluster-identifier my-sv2-cluster \
    --max-acu 768

Вывод:

{
    "DBShardGroupResourceId": "shardgroup-a6e3a0226aa243e2ac6c7a1234567890",
    "DBShardGroupIdentifier": "my-db-shard-group",
    "DBClusterIdentifier": "my-sv2-cluster",
    "MaxACU": 768.0,
    "ComputeRedundancy": 0,
    "Status": "creating",
    "PubliclyAccessible": false,
    "Endpoint": "my-sv2-cluster.limitless-cekycexample.us-east-2.rds.amazonaws.com"
}

Дополнительную информацию см. в разделе Использование Aurora Serverless v2 в руководстве пользователя Amazon Aurora.

Вывод

DBShardGroupResourceId -> (строка)

Уникальный, неизменяемый идентификатор группы фрагментов БД, специфичный для региона Amazon Web Services.

DBShardGroupIdentifier -> (строка)

Имя группы фрагментов БД.

DBClusterIdentifier -> (строка)

Имя первичного кластера БД для группы фрагментов БД.

MaxACU -> (двойное)

Максимальная емкость группы фрагментов БД в единицах мощности Aurora (ACU).

MinACU -> (двойное)

Минимальная емкость группы фрагментов БД в единицах мощности Aurora (ACU).

ComputeRedundancy -> (целое число)

Указывает, нужно ли создавать резервные группы фрагментов БД для группы фрагментов БД. Допустимые значения:

0 - Создает группу фрагментов БД без резервной группы фрагментов БД. Это значение по умолчанию.
1 - Создает группу фрагментов БД с резервной группой фрагментов БД в другой доступной зоне (AZ).
2 - Создает группу фрагментов БД с двумя резервными группами фрагментов БД в двух разных AZ.

Status -> (строка)

Статус группы фрагментов БД.

PubliclyAccessible -> (булево)

Указывает, доступна ли группа фрагментов БД для публичного доступа.

Если группа фрагментов БД доступна для публичного доступа, её DNS-адрес разрешается на частный IP-адрес изнутри виртуальной частной сети (VPC) группы фрагментов БД. Он разрешается на публичный IP-адрес извне VPC группы фрагментов БД. Доступ к группе фрагментов БД в конечном итоге контролируется используемой группой безопасности. Такой публичный доступ не разрешён, если группа безопасности, назначенная группе фрагментов БД, его не разрешает.

Если группа фрагментов БД недоступна для публичного доступа, это внутренняя группа фрагментов БД с именем DNS, которое разрешается на частный IP-адрес.

Для получения дополнительной информации см. CreateDBShardGroup.

Это свойство применяется только для базы данных Aurora Limitless.

Endpoint -> (строка)

Точка подключения для группы фрагментов БД.

DBShardGroupArn -> (строка)

Amazon Resource Name (ARN) для группы фрагментов БД.

TagList -> (список)

Список тегов.

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

(структура)

Метаданные, назначенные ресурсу Amazon RDS, представленные в виде пары «ключ-значение».

Key -> (строка)

Ключ — это обязательное имя тега. Строковое значение может иметь длину от 1 до 128 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).

Value -> (строка)

Значение — это необязательное значение тега. Строковое значение может иметь длину от 1 до 256 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).