disassociate-resource-share
Описание
Удаляет указанных принципов или ресурсы из участия в указанном общем ресурсе.
См. также: Документация API AWS
Синтаксис
disassociate-resource-share
--resource-share-arn <value>
[--resource-arns <value>]
[--principals <value>]
[--client-token <value>]
[--sources <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]
Параметры
--resource-share-arn (строка)
--resource-arns (список)
Указывает список Amazon Resource Names (ARN) для одного или нескольких ресурсов, которые вы хотите удалить из общего ресурса. После выполнения операции эти ресурсы больше не будут совместно использоваться с принципами, связанными с общим ресурсом.
(строка)
Синтаксис:
"string" "string" ...
--principals (список)
Указывает список одного или нескольких принципов, которым больше не должен быть доступ к ресурсам в этом общем ресурсе.
Вы можете включить следующие значения:
- Идентификатор учетной записи Amazon Web Services, например:
123456789012 - Amazon Resource Name (ARN) организации в Organizations, например:
organizations::123456789012:organization/o-exampleorgid - ARN организационной единицы (OU) в Organizations, например:
organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid123 - ARN роли IAM, например:
iam::123456789012:role/rolename - ARN пользователя IAM, например:
iam::123456789012user/username
Примечание
Не все типы ресурсов могут быть совместно использованы с ролями и пользователями IAM. Для получения дополнительной информации см. Совместное использование с ролями и пользователями IAM в руководстве пользователя Resource Access Manager.(строка)
Синтаксис:
"string" "string" ...
--client-token (строка)
Указывает уникальный, чувствительный к регистру идентификатор, который вы предоставляете для обеспечения идемпотентности запроса. Это позволяет безопасно повторно выполнить запрос без случайного выполнения той же операции повторно. Передача того же значения в последующий вызов операции требует, чтобы вы также передавали то же значение для всех других параметров. Рекомендуется использовать значение типа UUID. .
Если вы не предоставите это значение, Amazon Web Services сгенерирует случайное для вас.
Если вы повторно выполняете операцию с тем же ClientToken, но с разными параметрами, повторное выполнение завершается с ошибкой IdempotentParameterMismatch.
--sources (список)
Указывает, из каких исходных учетных записей служба-принципал больше не имеет доступа к ресурсам в этом общем ресурсе.
(строка)
Синтаксис:
"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
- текст
- таблица
- 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 для вывода.
--cli-auto-prompt (булево)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (булево)
Отключить автоматический запрос параметров ввода CLI.
Примеры
Примечание
Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила кавычек unix-подобных. Эти примеры необходимо адаптировать к правилам кавычек вашего терминала. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Чтобы удалить ресурс из общего ресурса
Следующий disassociate-resource-share пример удаляет указанный ресурс, в данном случае VPC-подсеть, из указанного общего ресурса. Любые принципы с доступом к общему ресурсу больше не могут выполнять операции с этим ресурсом.
aws ram disassociate-resource-share \
--resource-arns arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE \
--resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
Вывод:
{
"resourceShareAssociations": [
"resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
"associatedEntity": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE",
"associationType": "RESOURCE",
"status": "DISASSOCIATING",
"external": false
]
}
Вывод
resourceShareAssociations -> (список)
Массив объектов с информацией об обновленных ассоциациях для этого общего ресурса.
(структура)
Описание ассоциации между общим ресурсом и либо принципом, либо ресурсом.
resourceShareArn -> (строка)
resourceShareName -> (строка)
associatedEntity -> (строка)
Ассоциированный элемент. Это может быть следующее:
- Для ассоциации ресурсов это Amazon Resource Name (ARN) ресурса.
- Для ассоциаций принципов это одно из следующего:
- Идентификатор учетной записи Amazon Web Services
- Amazon Resource Name (ARN) организации в Organizations
- ARN организационной единицы (OU) в Organizations
- ARN роли IAM
- ARN пользователя IAM
associationType -> (строка)
status -> (строка)
statusMessage -> (строка)
creationTime -> (временная метка)
lastUpdatedTime -> (временная метка)
external -> (булево)
clientToken -> (строка)
clientToken в последующем вызове. Все другие параметры также должны иметь те же значения, что и в первом вызове.
© Copyright 2025, Amazon Web Services. Created using Sphinx.