Spec-Zone.ru › AWS CLI v2

[ aws . rds ]

modify-db-cluster-snapshot-attribute

Описание

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

Чтобы поделиться снимком кластера баз данных вручную с другими учетными записями Amazon Web Services, укажите restore в качестве AttributeName и используйте параметр ValuesToAdd для добавления списка идентификаторов учетных записей Amazon Web Services, которым разрешено восстановить снимок кластера баз данных вручную. Используйте значение all, чтобы сделать снимок кластера баз данных вручную общедоступным, что означает, что его можно копировать или восстанавливать все учетные записи Amazon Web Services.

Примечание

Не добавляйте значение all для снимков кластеров баз данных вручную, содержащих конфиденциальную информацию, которую вы не хотите предоставлять всем учетным записям Amazon Web Services.

Если снимок кластера баз данных вручную зашифрован, его можно поделиться, но только указав список идентификаторов учетных записей авторизованных учетных записей Amazon Web Services для параметра ValuesToAdd. В этом случае нельзя использовать all в качестве значения для этого параметра.

Чтобы просмотреть, какие учетные записи Amazon Web Services имеют доступ к копированию или восстановлению снимка кластера баз данных вручную, или является ли снимок кластера баз данных вручную общедоступным или частным, используйте операцию API DescribeDBClusterSnapshotAttributes. Учетные записи возвращаются в качестве значений для атрибута restore.

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

Синтаксис

  modify-db-cluster-snapshot-attribute
--db-cluster-snapshot-identifier <value>
--attribute-name <value>
[--values-to-add <value>]
[--values-to-remove <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-cluster-snapshot-identifier (строка)

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

--attribute-name (строка)

Имя атрибута снимка кластера баз данных, который необходимо изменить.

Чтобы управлять авторизацией других учетных записей Amazon Web Services для копирования или восстановления снимка кластера баз данных вручную, установите это значение в restore.

Примечание

Чтобы просмотреть список доступных для изменения атрибутов, используйте операцию API DescribeDBClusterSnapshotAttributes.

--values-to-add (список)

Список атрибутов снимка кластера баз данных для добавления к атрибуту, указанному в AttributeName.

Чтобы предоставить авторизацию другим учетным записям Amazon Web Services для копирования или восстановления снимка кластера баз данных вручную, установите этот список, включив один или несколько идентификаторов учетных записей Amazon Web Services, или all, чтобы сделать снимок кластера баз данных вручную доступным для восстановления любой учетной записью Amazon Web Services. Не добавляйте значение all для снимков кластеров баз данных вручную, которые содержат конфиденциальную информацию, которую вы не хотите предоставлять всем учетным записям Amazon Web Services.

(строка)

Синтаксис:

"string" "string" ...

--values-to-remove (список)

Список атрибутов снимка кластера баз данных для удаления из атрибута, указанного в AttributeName.

Чтобы удалить авторизацию для других учетных записей Amazon Web Services для копирования или восстановления снимка кластера баз данных вручную, установите этот список, включив один или несколько идентификаторов учетных записей Amazon Web Services, или all, чтобы отозвать авторизацию для любой учетной записи Amazon Web Services для копирования или восстановления снимка кластера баз данных. Если вы укажете all, учетная запись Amazon Web Services, идентификатор которой явно добавлен в атрибут restore, по-прежнему может копировать или восстанавливать снимок кластера баз данных вручную.

(строка)

Синтаксис:

"string" "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
  • 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.

Примеры

Примечание

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

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

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

В следующем modify-db-cluster-snapshot-attribute примере производятся изменения в указанном атрибуте снимка кластера баз данных.

aws rds modify-db-cluster-snapshot-attribute \
    --db-cluster-snapshot-identifier myclustersnapshot \
    --attribute-name restore \
    --values-to-add 123456789012

Вывод:

{
    "DBClusterSnapshotAttributesResult": {
        "DBClusterSnapshotIdentifier": "myclustersnapshot",
        "DBClusterSnapshotAttributes": [
            {
                "AttributeName": "restore",
                "AttributeValues": [
                    "123456789012"
                ]
            }
        ]
    }
}

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

Вывод

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

Содержит результаты успешного вызова действия API DescribeDBClusterSnapshotAttributes.

Атрибуты снимков кластеров баз данных вручную используются для предоставления авторизации другим учетным записям Amazon Web Services для копирования или восстановления снимка кластера баз данных вручную. Дополнительную информацию см. в действии API ModifyDBClusterSnapshotAttribute.

DBClusterSnapshotIdentifier -> (строка)

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

DBClusterSnapshotAttributes -> (список)

Список атрибутов и значений для снимка кластера баз данных вручную.

(структура)

Содержит имя и значения атрибута снимка кластера баз данных вручную.

Атрибуты снимков кластеров баз данных вручную используются для предоставления авторизации другим учетным записям Amazon Web Services для восстановления снимка кластера баз данных вручную. Дополнительную информацию см. в действии API ModifyDBClusterSnapshotAttribute.

AttributeName -> (строка)

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

Атрибут с именем restore относится к списку учетных записей Amazon Web Services, имеющих разрешение на копирование или восстановление снимка кластера баз данных вручную. Дополнительную информацию см. в действии API ModifyDBClusterSnapshotAttribute.

AttributeValues -> (список)

Значение(я) для атрибута снимка кластера баз данных вручную.

Если поле AttributeName установлено в значение restore, этот элемент возвращает список идентификаторов учетных записей Amazon Web Services, которым разрешено копировать или восстанавливать снимок кластера баз данных вручную. Если значение all находится в списке, то снимок кластера баз данных вручную является общедоступным и доступным для копирования или восстановления любой учетной записью Amazon Web Services.

(строка)

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

Spec-Zone.ru

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