Spec-Zone.ru › AWS CLI v2

[ aws . rds ]

modify-custom-db-engine-version

Описание

Изменяет статус версии пользовательского движка (CEV). Вы можете найти CEV для изменения, вызвав DescribeDBEngineVersions .

Примечание

Служба MediaImport, которая импортирует файлы из Amazon S3 для создания CEV, не интегрирована с Amazon Web Services CloudTrail. Если вы включите ведение журнала данных для Amazon RDS в CloudTrail, вызовы события ModifyCustomDbEngineVersion не будут регистрироваться. Однако вы можете увидеть вызовы из шлюза API, который получает доступ к вашему ведру Amazon S3. Эти вызовы исходят от службы MediaImport для события ModifyCustomDbEngineVersion.

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

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

Синтаксис

  modify-custom-db-engine-version
--engine <value>
--engine-version <value>
[--description <value>]
[--status <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]

Параметры

--engine (строка)

Движок базы данных. RDS Custom для Oracle поддерживает следующие значения:

  • custom-oracle-ee
  • custom-oracle-ee-cdb
  • custom-oracle-se2
  • custom-oracle-se2-cdb

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

Версия пользовательского движка (CEV), которую вы хотите изменить. Этот параметр является обязательным для RDS Custom для Oracle, но необязательным для Amazon RDS. Сочетание Engine и EngineVersion уникально для каждого клиента в каждом регионе Amazon Web Services.

--description (строка)

Необязательное описание вашего CEV.

--status (строка)

Статус доступности, который нужно назначить CEV. Допустимые значения:

available

Вы можете использовать этот CEV для создания нового экземпляра базы данных RDS Custom.

inactive

Вы можете создать новый экземпляр RDS Custom, восстановив снимок базы данных с этой версией CEV. Вы не можете применять исправления или создавать новые экземпляры с этой версией CEV.

Вы можете изменить любой статус на любой другой. Типичная причина изменения статуса — предотвращение случайного использования CEV или придание устаревшему CEV возможности повторного использования. Например, вы можете изменить статус вашего CEV с available на inactive , и с inactive обратно на available . Для изменения статуса доступности CEV, он не должен в настоящее время использоваться экземпляром RDS Custom, снимком или автоматическим резервным копированием.

Возможные значения:

  • available
  • inactive
  • inactive-except-restore

--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.

Вывод

Engine -> (строка)

Название базы данных.

EngineVersion -> (строка)

Номер версии базы данных.

DBParameterGroupFamily -> (строка)

Название семейства параметров группы БД для базы данных.

DBEngineDescription -> (строка)

Описание базы данных.

DBEngineVersionDescription -> (строка)

Описание версии базы данных.

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

Набор символов по умолчанию для новых экземпляров этой версии движка, если параметр CharacterSetName API CreateDBInstance не указан.

CharacterSetName -> (строка)

Название набора символов.

CharacterSetDescription -> (строка)

Описание набора символов.

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

Изображение EC2

ImageId -> (строка)

Значение, указывающее идентификатор AMI.

Status -> (строка)

Значение, указывающее состояние пользовательской версии движка (CEV).

DBEngineMediaType -> (строка)

Значение, указывающее поставщика исходных носителей AMI на основе операции использования. Применимо для RDS Custom для SQL Server.

SupportedCharacterSets -> (список)

Список наборов символов, поддерживаемых этим движком для параметра CharacterSetName операции CreateDBInstance.

(структура)

Этот тип данных используется как элемент ответа в действии DescribeDBEngineVersions.

CharacterSetName -> (строка)

Название набора символов.

CharacterSetDescription -> (строка)

Описание набора символов.

SupportedNcharCharacterSets -> (список)

Список наборов символов, поддерживаемых движком Oracle DB для параметра NcharCharacterSetName операции CreateDBInstance.

(структура)

Этот тип данных используется как элемент ответа в действии DescribeDBEngineVersions.

CharacterSetName -> (строка)

Название набора символов.

CharacterSetDescription -> (строка)

Описание набора символов.

ValidUpgradeTarget -> (список)

Список версий движка, до которых можно обновить эту версию движка базы данных.

(структура)

Версия базы данных, до которой можно обновить экземпляр БД.

Engine -> (строка)

Название целевого движка базы данных.

EngineVersion -> (строка)

Номер версии целевого движка базы данных.

Description -> (строка)

Версия базы данных, до которой можно обновить экземпляр БД.

AutoUpgrade -> (булево)

Указывает, применяется ли целевая версия к любым исходным экземплярам БД, у которых AutoMinorVersionUpgrade установлено в значение true.

Этот параметр динамический и устанавливается RDS.

IsMajorVersionUpgrade -> (булево)

Указывает, требуется ли обновление до целевой версии для обновления основной версии базы данных.

SupportedEngineModes -> (список)

Список поддерживаемых режимов работы движка БД для целевой версии движка.

(строка)

SupportsParallelQuery -> (булево)

Указывает, можно ли использовать параллельные запросы Aurora с целевой версией движка.

SupportsGlobalDatabases -> (булево)

Указывает, можно ли использовать глобальные базы данных Aurora с целевой версией движка.

SupportsBabelfish -> (булево)

Указывает, можно ли использовать Babelfish для Aurora PostgreSQL с целевой версией движка.

SupportsLimitlessDatabase -> (булево)

Указывает, поддерживает ли версия движка баз данных Aurora Limitless Database.

SupportsLocalWriteForwarding -> (булево)

Указывает, поддерживает ли целевая версия движка перенаправление операций записи от экземпляров БД чтения к экземпляру БД записи в кластере БД. По умолчанию операции записи не разрешены на экземплярах БД чтения.

Применимо для: только кластеров БД Aurora

SupportsIntegrations -> (булево)

Указывает, поддерживает ли версия движка БД интеграции zero-ETL с Amazon Redshift.

SupportedTimezones -> (список)

Список часовых поясов, поддерживаемых этим движком для параметра Timezone действия CreateDBInstance.

(структура)

Часовой пояс, связанный с DBInstance или DBSnapshot. Этот тип данных является элементом ответа действий DescribeDBInstances, DescribeDBSnapshots и DescribeDBEngineVersions.

TimezoneName -> (строка)

Название часового пояса.

ExportableLogTypes -> (список)

Типы журналов, доступные для экспорта в CloudWatch Logs.

(строка)

SupportsLogExportsToCloudwatchLogs -> (булево)

Указывает, поддерживает ли версия движка экспорт типов журналов, указанных в ExportableLogTypes, в CloudWatch Logs.

SupportsReadReplica -> (булево)

Указывает, поддерживает ли версия движка баз данных реплики чтения.

SupportedEngineModes -> (список)

Список поддерживаемых режимов работы движка БД.

(строка)

SupportedFeatureNames -> (список)

Список функций, поддерживаемых движком БД.

Поддерживаемые функции зависят от движка БД и версии движка БД.

Чтобы определить поддерживаемые функции для определенного движка БД и версии движка БД с помощью CLI, используйте следующую команду:

aws rds describe-db-engine-versions --engine <engine_name> --engine-version <engine_version>

Например, чтобы определить поддерживаемые функции для RDS для PostgreSQL версии 13.3 с помощью CLI, используйте следующую команду:

aws rds describe-db-engine-versions --engine postgres --engine-version 13.3

Поддерживаемые функции перечислены в SupportedFeatureNames в выводе.

(строка)

Status -> (строка)

Состояние версии движка БД, либо available, либо deprecated.

SupportsParallelQuery -> (булево)

Указывает, можно ли использовать параллельные запросы Aurora с конкретной версией движка БД.

SupportsGlobalDatabases -> (булево)

Указывает, можно ли использовать глобальные базы данных Aurora с конкретной версией движка БД.

MajorEngineVersion -> (строка)

Основная версия движка CEV.

DatabaseInstallationFilesS3BucketName -> (строка)

Название ведра Amazon S3, содержащего файлы установки базы данных.

DatabaseInstallationFilesS3Prefix -> (строка)

Директория Amazon S3, содержащая файлы установки базы данных. Если не указано, то не предполагается наличие префикса.

DBEngineVersionArn -> (строка)

ARN пользовательской версии движка.

KMSKeyId -> (строка)

Идентификатор ключа Amazon Web Services KMS для зашифрованного CEV. Этот параметр необходим для RDS Custom, но необязателен для Amazon RDS.

CreateTime -> (метка времени)

Время создания версии движка БД.

TagList -> (список)

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

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

(структура)

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

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

Key -> (строка)

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

Value -> (строка)

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

SupportsBabelfish -> (булево)

Указывает, поддерживает ли версия движка Babelfish для Aurora PostgreSQL.

CustomDBEngineVersionManifest -> (строка)

Строка JSON, в которой перечислены файлы установки и параметры, используемые RDS Custom для создания пользовательской версии движка (CEV). RDS Custom применяет исправления в том порядке, в котором они перечислены в манифесте. Вы можете установить домашнюю директорию Oracle, базу данных Oracle и пользователя/группу UNIX/Linux с помощью параметров установки. Дополнительную информацию см. в разделе JSON-поля в манифесте CEV в Руководстве пользователя Amazon RDS.

SupportsLimitlessDatabase -> (булево)

Указывает, поддерживает ли версия движка баз данных Aurora Limitless Database.

SupportsCertificateRotationWithoutRestart -> (булево)

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

SupportedCACertificateIdentifiers -> (список)

Список поддерживаемых идентификаторов сертификатов CA.

Дополнительную информацию см. в разделе Использование SSL/TLS для шифрования подключения к экземпляру БД в Руководстве пользователя Amazon RDS и Использование SSL/TLS для шифрования подключения к кластеру БД в Руководстве пользователя Amazon Aurora.

(строка)

SupportsLocalWriteForwarding -> (булево)

Указывает, поддерживает ли версия движка перенаправление операций записи от экземпляров БД чтения к экземпляру БД записи в кластере БД. По умолчанию операции записи не разрешены на экземплярах БД чтения.

Применимо для: только кластеров БД Aurora

SupportsIntegrations -> (булево)

Указывает, поддерживает ли версия движка БД интеграции zero-ETL с Amazon Redshift.

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

Указывает любые свойства или ограничения Aurora Serverless v2, которые отличаются между версиями движка Aurora. Вы можете проверить значения этого атрибута, чтобы выбрать нужную версию Aurora для нового или обновляемого кластера БД. Вы также можете получить версию существующего кластера БД и проверить, поддерживает ли эта версия определенные функции Aurora Serverless v2, прежде чем пытаться использовать эти функции.

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

Если минимальная емкость равна 0 ACU, версия движка поддерживает функцию автоматической паузы/возобновления Aurora Serverless v2.

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

Указывает верхний предел емкости Aurora Serverless v2 для конкретной версии движка. В зависимости от версии движка максимальная емкость кластера Aurora Serverless v2 может быть 256 или 128.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

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