batch-put-attributes

Описание

Операция BatchPutAttributes создаёт или заменяет атрибуты в одном или нескольких элементах. Используя эту операцию, клиент может выполнить несколько операций PutAttribute одним вызовом. Это помогает сэкономить время запросов и задержки, позволяя Amazon SimpleDB оптимизировать запросы и, в целом, повысить пропускную способность.

Клиент может указать имя элемента с помощью параметра Item.X.ItemName. Клиент может указать новые атрибуты, используя комбинацию параметров Item.X.Attribute.Y.Name и Item.X.Attribute.Y.Value. Клиент может указать первый атрибут для первого элемента, используя параметры Item.0.Attribute.0.Name и Item.0.Attribute.0.Value, и второй атрибут для первого элемента, используя параметры Item.0.Attribute.1.Name и Item.0.Attribute.1.Value, и так далее.

Атрибуты уникально идентифицируются в элементе по комбинации имя/значение. Например, один элемент может иметь атрибуты { "first_name", "first_value" } и { "first_name", "second_value" }. Однако он не может иметь две записи атрибутов, где Item.X.Attribute.Y.Name и Item.X.Attribute.Y.Value одинаковы.

По желанию, запрашивающий может предоставить параметр Replace для каждого отдельного значения. Установка этого значения в true заставит новые значения атрибутов заменить существующие значения атрибутов. Например, если элемент I имеет атрибуты { 'a', '1' }, { 'b', '2'} и { 'b', '3' }, а запрашивающий выполняет BatchPutAttributes для {'I', 'b', '4' } с параметром Replace установленным в true, то окончательными атрибутами элемента будут { 'a', '1' } и { 'b', '4' }, заменяющие предыдущие значения атрибута ‘b’ новым значением.

Вы можете выполнять несколько операций BatchPutAttributes и другие операции параллельно. Однако большое количество одновременных вызовов BatchPutAttributes может привести к ответам Service Unavailable (503).

Для этой операции применяются следующие ограничения:

• 256 пар имя-значение атрибутов на элемент
• Размер запроса 1 МБ
• 1 миллиард атрибутов на домен
• 10 ГБ общего хранилища данных пользователя на домен
• Предел в 25 элементов на операцию BatchPutAttributes

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

Синтаксис

  batch-put-attributes
--domain-name <value>
--items <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]

Параметры

--domain-name (строка) Имя домена, в котором хранятся атрибуты.

--items (список) Список элементов, для которых нужно выполнить операцию. (структура)

Упрощенный синтаксис:

Name=string,Attributes=[{Name=string,Value=string,Replace=boolean},{Name=string,Value=string,Replace=boolean}] ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Attributes": [
      {
        "Name": "string",
        "Value": "string",
        "Replace": true|false
      }
      ...
    ]
  }
  ...
]

--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 (булево)

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

--no-cli-auto-prompt (булево)

Отключить автоматический запрос параметров CLI.

Вывод

Нет