Spec-Zone.ru › AWS CLI v2

[ aws . dynamodb ]

удалить-элемент

Описание

Удаляет один элемент в таблице по первичному ключу. Вы можете выполнить условное удаление, которое удаляет элемент, если он существует или имеет ожидаемое значение атрибута.

Помимо удаления элемента, вы также можете вернуть значения атрибутов элемента в той же операции, используя параметр ReturnValues.

Если вы не укажете условия, операция DeleteItem является идемпотентной; её многократное выполнение на одном и том же элементе или атрибуте не приводит к ошибке.

Условные удаления полезны для удаления элементов только при выполнении определенных условий. Если эти условия выполнены, DynamoDB выполняет удаление. В противном случае элемент не удаляется.

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

Синтаксис

  delete-item
--table-name <value>
--key <value>
[--expected <value>]
[--conditional-operator <value>]
[--return-values <value>]
[--return-consumed-capacity <value>]
[--return-item-collection-metrics <value>]
[--condition-expression <value>]
[--expression-attribute-names <value>]
[--expression-attribute-values <value>]
[--return-values-on-condition-check-failure <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]

Параметры

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

Имя таблицы, из которой необходимо удалить элемент. Вы также можете указать Amazon Resource Name (ARN) таблицы в этом параметре.

--key (массив)

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

Для первичного ключа вы должны предоставить все атрибуты ключа. Например, при простом первичном ключе вам нужно только предоставить значение для разделяющего ключа. При составном первичном ключе вы должны предоставить значения и для разделяющего, и для сортирующего ключа.

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

значение -> (структура)

Представляет данные атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это само значение.

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

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются в DynamoDB по сети как строки для максимальной совместимости с различными языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (байтовый массив)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются в DynamoDB по сети как строки для максимальной совместимости с различными языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(байтовый массив)

M -> (массив)

Атрибут типа Карта. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

значение -> (структура)

Представляет данные атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это само значение.

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

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются в DynamoDB по сети как строки для максимальной совместимости с различными языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (байтовый массив)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются в DynamoDB по сети как строки для максимальной совместимости с различными языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(байтовый массив)

M -> (массив)

Атрибут типа Карта. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

( … рекурсивно … )

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

( … рекурсивно … )

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Логическое значение. Например:

"BOOL": true

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(структура)

Представляет данные атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это само значение.

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

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются в DynamoDB по сети как строки для максимальной совместимости с различными языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (байтовый массив)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются в DynamoDB по сети как строки для максимальной совместимости с различными языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(байтовый массив)

M -> (массив)

Атрибут типа Карта. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

( … рекурсивно … )

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

( … рекурсивно … )

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Логическое значение. Например:

"BOOL": true

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Логическое значение. Например:

"BOOL": true

Синтаксис JSON:

{"string": {
      "S": "string",
      "N": "string",
      "B": blob,
      "SS": ["string", ...],
      "NS": ["string", ...],
      "BS": [blob, ...],
      "M": {"string": {
            "S": "string",
            "N": "string",
            "B": blob,
            "SS": ["string", ...],
            "NS": ["string", ...],
            "BS": [blob, ...],
            "M": {"string": { ... recursive ... }
              ...},
            "L": [
              { ... recursive ... }
              ...
            ],
            "NULL": true|false,
            "BOOL": true|false
          }
        ...},
      "L": [
        {
          "S": "string",
          "N": "string",
          "B": blob,
          "SS": ["string", ...],
          "NS": ["string", ...],
          "BS": [blob, ...],
          "M": {"string": { ... recursive ... }
            ...},
          "L": [
            { ... recursive ... }
            ...
          ],
          "NULL": true|false,
          "BOOL": true|false
        }
        ...
      ],
      "NULL": true|false,
      "BOOL": true|false
    }
  ...}

--expected (массив)

Это параметр устаревшего формата. Используйте ConditionExpression вместо него. Дополнительную информацию см. в руководстве Amazon DynamoDB Developer Guide.

key -> (строка)

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

Представляет условие, которое нужно сравнить со значением атрибута. Это условие может быть использовано с операциями DeleteItem, PutItem или UpdateItem; если сравнение возвращает true, операция выполняется успешно; в противном случае операция завершается ошибкой. Вы можете использовать ExpectedAttributeValue двумя способами:

  • Используйте AttributeValueList, чтобы указать одно или несколько значений для сравнения с атрибутом. Используйте ComparisonOperator, чтобы указать, как выполнить сравнение. Если сравнение возвращает true, условная операция выполняется успешно.
  • Используйте Value, чтобы указать значение, с которым DynamoDB сравнит атрибут. Если значения совпадают, тогда ExpectedAttributeValue возвращает true, и условная операция выполняется успешно. Дополнительно вы можете установить Exists в значение false, указав, что вы не ожидаете найти значение атрибута в таблице. В этом случае условная операция выполняется успешно только если сравнение возвращает false.
Value и Exists несовместимы с AttributeValueList и ComparisonOperator. Обратите внимание, что если вы используете оба набора параметров одновременно, DynamoDB вернёт исключение ValidationException.

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

Представляет данные для ожидаемого атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Дополнительную информацию см. в разделе Типы данных в руководстве Amazon DynamoDB Developer Guide.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа отправляются в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (бинарный массив)

Атрибут типа Бинарный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Множество строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Множество чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа отправляются в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Множество бинарных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(бинарный массив)

M -> (словарь)

Атрибут типа Словарь. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

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

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Дополнительную информацию см. в разделе Типы данных в руководстве Amazon DynamoDB Developer Guide.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа отправляются в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (бинарный массив)

Атрибут типа Бинарный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Множество строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Множество чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа отправляются в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Множество бинарных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(бинарный массив)

M -> (словарь)

Атрибут типа Словарь. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

(… рекурсивно…)

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(… рекурсивно…)

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(структура)

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Дополнительную информацию см. в разделе Типы данных в руководстве Amazon DynamoDB Developer Guide.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа отправляются в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (бинарный массив)

Атрибут типа Бинарный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Множество строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Множество чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа отправляются в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Множество бинарных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(бинарный массив)

M -> (словарь)

Атрибут типа Словарь. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

(… рекурсивно…)

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(… рекурсивно…)

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

Exists -> (булево)

Принуждает DynamoDB оценить значение перед выполнением условной операции:

  • Если Exists имеет значение true, DynamoDB проверит, существует ли это значение атрибута в таблице. Если значение найдено, операция выполняется успешно. Если значение не найдено, операция завершается ошибкой с исключением ConditionCheckFailedException.
  • Если Exists имеет значение false, DynamoDB предполагает, что значение атрибута не существует в таблице. Если значение фактически не существует, предположение верно, и операция выполняется успешно. Если значение найдено, несмотря на предположение, что оно не существует, операция завершается ошибкой с исключением ConditionCheckFailedException.

Значение по умолчанию для Exists — это true. Если вы передаете значение Value, DynamoDB предполагает, что атрибут существует: вам не нужно устанавливать Exists в true, так как это подразумевается.

DynamoDB возвращает исключение ValidationException, если:

  • Exists имеет значение true, но нет Value для проверки. (Вы ожидаете, что значение существует, но не указываете, какое именно.)
  • Exists имеет значение false, но вы также указали Value. (Вы не можете ожидать, что атрибут имеет значение, и в то же время ожидать, что его не существует.)

ComparisonOperator -> (строка)

Компаратор для оценки атрибутов в AttributeValueList. Например, равно, больше, меньше и т. д.

Доступны следующие операторы сравнения:

EQ | NE | LE | LT | GE | GT | NOT_NULL | NULL | CONTAINS | NOT_CONTAINS | BEGINS_WITH | IN | BETWEEN

Ниже приведены описания каждого оператора сравнения.

  • EQ : Равно. EQ поддерживается для всех типов данных, включая списки и карты. AttributeValueList может содержать только один AttributeValue элемент типа String, Number, Binary, String Set, Number Set или Binary Set. Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также {"N":"6"} не равно {"NS":["6", "2", "1"]}.
  • NE : Не равно. NE поддерживается для всех типов данных, включая списки и карты. AttributeValueList может содержать только один AttributeValue элемент типа String, Number, Binary, String Set, Number Set или Binary Set. Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также {"N":"6"} не равно {"NS":["6", "2", "1"]}.
  • LE : Меньше или равно. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не тип множества). Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}.
  • LT : Меньше. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не тип множества). Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}.
  • GE : Больше или равно. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не тип множества). Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}.
  • GT : Больше. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не тип множества). Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не равно {"N":"6"}. Также {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}.
  • NOT_NULL : Атрибут существует. NOT_NULL поддерживается для всех типов данных, включая списки и карты.

Примечание

Этот оператор проверяет наличие атрибута, а не его тип данных. Если тип данных атрибута “a” равен null, и вы оцениваете его с помощью NOT_NULL, результат — булево true. Это результат того, что атрибут “a” существует; его тип данных не относится к оператору сравнения NOT_NULL.
  • NULL : Атрибут не существует. NULL поддерживается для всех типов данных, включая списки и карты.

Примечание

Этот оператор проверяет отсутствие атрибута, а не его тип данных. Если тип данных атрибута “a” равен null, и вы оцениваете его с помощью NULL, результат — булево false. Это потому, что атрибут “a” существует; его тип данных не относится к оператору сравнения NULL.
  • CONTAINS : Проверка подпоследовательности или значения в наборе. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не тип множества). Если целевой атрибут сравнения имеет тип String, оператор проверяет соответствие подстроки. Если целевой атрибут сравнения имеет тип Binary, оператор ищет подпоследовательность целевого значения, соответствующую вводу. Если целевой атрибут сравнения является множеством (”SS”, “NS” или “BS”), оператор оценивается как истинный, если находит точное совпадение с любым членом множества. CONTAINS поддерживается для списков: при оценке “a CONTAINS b”, “a” может быть списком; однако “b” не может быть множеством, картой или списком.
  • NOT_CONTAINS : Проверка отсутствия подпоследовательности или отсутствия значения в множестве. AttributeValueList может содержать только один AttributeValue элемент типа String, Number или Binary (не тип множества). Если целевой атрибут сравнения является строкой, оператор проверяет отсутствие соответствия подстроки. Если целевой атрибут сравнения имеет тип Binary, оператор проверяет отсутствие подпоследовательности целевого значения, соответствующей вводу. Если целевой атрибут сравнения является множеством (”SS”, “NS” или “BS”), оператор оценивается как истинный, если не находит точного совпадения с любым членом множества. NOT_CONTAINS поддерживается для списков: при оценке “a NOT CONTAINS b”, “a” может быть списком; однако “b” не может быть множеством, картой или списком.
  • BEGINS_WITH : Проверка префикса. AttributeValueList может содержать только один AttributeValue элемент типа String или Binary (не Number или тип множества). Целевой атрибут сравнения должен иметь тип String или Binary (не Number или тип множества).
  • IN : Проверка соответствия элементов в списке. AttributeValueList может содержать один или несколько AttributeValue элементов типа String, Number или Binary. Эти атрибуты сравниваются с существующим атрибутом элемента. Если какие-либо элементы входных данных равны атрибуту элемента, выражение оценивается как истинное.
  • BETWEEN : Больше или равно первому значению и меньше или равно второму значению. AttributeValueList должен содержать два AttributeValue элемента одного типа: String, Number или Binary (не тип множества). Целевой атрибут соответствует, если целевое значение больше или равно первому элементу и меньше или равно второму элементу. Если элемент содержит AttributeValue элемент другого типа, чем указанный в запросе, значение не совпадает. Например, {"S":"6"} не сравнивается с {"N":"6"}. Также {"N":"6"} не сравнивается с {"NS":["6", "2", "1"]}.

AttributeValueList -> (список)

Одно или несколько значений для сравнения с предоставленным атрибутом. Количество значений в списке зависит от используемого ComparisonOperator.

Для типа Число сравнение значений выполняется по числовому типу.

Сравнение строковых значений на больше, равно или меньше основано на значениях кодов ASCII. Например, a больше, чем A, и a больше, чем B. Список значений кодов см. на http://en.wikipedia.org/wiki/ASCII#ASCII_printable_characters.

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

Дополнительную информацию о задании типов данных в JSON см. в разделе Формат данных JSON в Руководстве разработчика Amazon DynamoDB.

(структура)

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Дополнительную информацию см. в разделе Типы данных в Руководстве разработчика Amazon DynamoDB.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (двоичные данные)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(двоичные данные)

M -> (словарь)

Атрибут типа Словарь. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

значение -> (структура)

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Дополнительную информацию см. в разделе Типы данных в Руководстве разработчика Amazon DynamoDB.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (двоичные данные)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(двоичные данные)

M -> (словарь)

Атрибут типа Словарь. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

(… рекурсивно …)

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(… рекурсивно …)

NULL -> (логическое значение)

Атрибут типа NULL. Например:

"NULL": true

BOOL -> (логическое значение)

Атрибут типа Логическое значение. Например:

"BOOL": true

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(структура)

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Дополнительную информацию см. в разделе Типы данных в Руководстве разработчика Amazon DynamoDB.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (двоичные данные)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(двоичные данные)

M -> (словарь)

Атрибут типа Словарь. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

(… рекурсивно …)

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(… рекурсивно …)

NULL -> (логическое значение)

Атрибут типа NULL. Например:

"NULL": true

BOOL -> (логическое значение)

Атрибут типа Логическое значение. Например:

"BOOL": true

NULL -> (логическое значение)

Атрибут типа NULL. Например:

"NULL": true

BOOL -> (логическое значение)

Атрибут типа Логическое значение. Например:

"BOOL": true

Синтаксис JSON:

{"string": {
      "Value": {
        "S": "string",
        "N": "string",
        "B": blob,
        "SS": ["string", ...],
        "NS": ["string", ...],
        "BS": [blob, ...],
        "M": {"string": {
              "S": "string",
              "N": "string",
              "B": blob,
              "SS": ["string", ...],
              "NS": ["string", ...],
              "BS": [blob, ...],
              "M": {"string": { ... recursive ... }
                ...},
              "L": [
                { ... recursive ... }
                ...
              ],
              "NULL": true|false,
              "BOOL": true|false
            }
          ...},
        "L": [
          {
            "S": "string",
            "N": "string",
            "B": blob,
            "SS": ["string", ...],
            "NS": ["string", ...],
            "BS": [blob, ...],
            "M": {"string": { ... recursive ... }
              ...},
            "L": [
              { ... recursive ... }
              ...
            ],
            "NULL": true|false,
            "BOOL": true|false
          }
          ...
        ],
        "NULL": true|false,
        "BOOL": true|false
      },
      "Exists": true|false,
      "ComparisonOperator": "EQ"|"NE"|"IN"|"LE"|"LT"|"GE"|"GT"|"BETWEEN"|"NOT_NULL"|"NULL"|"CONTAINS"|"NOT_CONTAINS"|"BEGINS_WITH",
      "AttributeValueList": [
        {
          "S": "string",
          "N": "string",
          "B": blob,
          "SS": ["string", ...],
          "NS": ["string", ...],
          "BS": [blob, ...],
          "M": {"string": {
                "S": "string",
                "N": "string",
                "B": blob,
                "SS": ["string", ...],
                "NS": ["string", ...],
                "BS": [blob, ...],
                "M": {"string": { ... recursive ... }
                  ...},
                "L": [
                  { ... recursive ... }
                  ...
                ],
                "NULL": true|false,
                "BOOL": true|false
              }
            ...},
          "L": [
            {
              "S": "string",
              "N": "string",
              "B": blob,
              "SS": ["string", ...],
              "NS": ["string", ...],
              "BS": [blob, ...],
              "M": {"string": { ... recursive ... }
                ...},
              "L": [
                { ... recursive ... }
                ...
              ],
              "NULL": true|false,
              "BOOL": true|false
            }
            ...
          ],
          "NULL": true|false,
          "BOOL": true|false
        }
        ...
      ]
    }
  ...}

--conditional-operator (строка)

Это устаревший параметр. Используйте ConditionExpression вместо него. Дополнительную информацию см. в разделе ConditionalOperator в Руководстве разработчика Amazon DynamoDB.

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

  • AND
  • OR

--return-values (строка)

Используйте ReturnValues, если вы хотите получить атрибуты элемента в том виде, в котором они были до удаления. Для DeleteItem допустимые значения:

  • NONE — Если ReturnValues не указан или его значение равно NONE, ничего не возвращается. (Это значение по умолчанию для ReturnValues).
  • ALL_OLD — Возвращается содержимое старого элемента.

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

Примечание

Параметр ReturnValues используется несколькими операциями DynamoDB; однако DeleteItem не распознает значений, кроме NONE или ALL_OLD.

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

  • NONE
  • ALL_OLD
  • UPDATED_OLD
  • ALL_NEW
  • UPDATED_NEW

--return-consumed-capacity (строка)

Определяет уровень детализации расхода пропускной способности (зарезервированной или по требованию), возвращаемой в ответе:

  • INDEXES — Ответ включает агрегированный ConsumedCapacity для операции, а также ConsumedCapacity для каждой таблицы и вторичного индекса, к которым был произведён доступ. Обратите внимание, что некоторые операции, такие как GetItem и BatchGetItem, вообще не обращаются к индексам. В этих случаях указание INDEXES вернёт только информацию о таблице(ах) ConsumedCapacity.
  • TOTAL — Ответ включает только агрегированный ConsumedCapacity для операции.
  • NONE — Подробности по расходу ConsumedCapacity не включаются в ответ.

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

  • INDEXES
  • TOTAL
  • NONE

--return-item-collection-metrics (строка)

Определяет, возвращаются ли метрики коллекции элементов. Если установлено значение SIZE, ответ включает статистику о коллекциях элементов, если таковые были изменены в ходе операции, возвращаются в ответе. Если установлено значение NONE (по умолчанию), статистика не возвращается.

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

  • SIZE
  • NONE

--condition-expression (строка)

Условие, которое должно быть выполнено для успешного выполнения условного DeleteItem.

Выражение может содержать следующие элементы:

  • Функции: attribute_exists | attribute_not_exists | attribute_type | contains | begins_with | size Эти имена функций чувствительны к регистру.
  • Операторы сравнения: = | <> | < | > | <= | >= | BETWEEN | IN
  • Логические операторы: AND | OR | NOT

Дополнительную информацию об условных выражениях см. в разделе Условные выражения в Руководстве разработчика Amazon DynamoDB.

--expression-attribute-names (словарь)

Один или несколько маркеров подстановки для имен атрибутов в выражении. Ниже приведены некоторые примеры использования ExpressionAttributeNames:

  • Для доступа к атрибуту, имя которого конфликтует с зарезервированным словом DynamoDB.
  • Для создания маркера для повторяющихся вхождений имени атрибута в выражении.
  • Для предотвращения того, чтобы специальные символы в имени атрибута были неправильно интерпретированы в выражении.

Используйте символ # в выражении для обращения к имени атрибута. Например, рассмотрим следующее имя атрибута:

  • Percentile

Имя этого атрибута конфликтует с зарезервированным словом, поэтому его нельзя использовать непосредственно в выражении. (Полный список зарезервированных слов см. в разделе «Зарезервированные слова» в руководстве разработчика Amazon DynamoDB). Чтобы обойти это, можно указать следующее для ExpressionAttributeNames:

  • {"#P":"Percentile"}

Затем можно использовать эту подстановку в выражении, как в этом примере:

  • #P = :val

Примечание

Маркеры, начинающиеся с символа :, являются значениями атрибутов выражения, которые являются маркерами для фактического значения во время выполнения.

Дополнительную информацию об именах атрибутов выражения см. в разделе «Указание атрибутов элементов» в руководстве разработчика Amazon DynamoDB.

key -> (строка)

value -> (строка)

Сокращенная синтаксическая запись:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--expression-attribute-values (словарь)

Один или несколько значений, которые могут быть заменены в выражении.

Используйте символ : (двоеточие) в выражении для обращения к значению атрибута. Например, предположим, что вы хотите проверить, является ли значение атрибута ProductStatus одним из следующих:

Available | Backordered | Discontinued

Сначала вам нужно указать ExpressionAttributeValues следующим образом:

{ ":avail":{"S":"Available"}, ":back":{"S":"Backordered"}, ":disc":{"S":"Discontinued"} }

Затем вы можете использовать эти значения в выражении, например, так:

ProductStatus IN (:avail, :back, :disc)

Дополнительную информацию об атрибутах выражения см. в разделе «Условные выражения» в руководстве разработчика Amazon DynamoDB.

key -> (строка)

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

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon DynamoDB.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

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

B -> (бинарный блок)

Атрибут типа Бинарный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

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

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(бинарный блок)

M -> (словарь)

Атрибут типа Словарь. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

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

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon DynamoDB.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

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

B -> (бинарный блок)

Атрибут типа Бинарный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

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

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(бинарный блок)

M -> (словарь)

Атрибут типа Словарь. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

(… рекурсивно …)

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(… рекурсивно …)

NULL -> (логическое значение)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (логическое значение)

Атрибут типа Булево. Например:

"BOOL": true

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(структура)

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon DynamoDB.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

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

B -> (бинарный блок)

Атрибут типа Бинарный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

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

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(бинарный блок)

M -> (словарь)

Атрибут типа Словарь. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

(… рекурсивно …)

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(… рекурсивно …)

NULL -> (логическое значение)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (логическое значение)

Атрибут типа Булево. Например:

"BOOL": true

NULL -> (логическое значение)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (логическое значение)

Атрибут типа Булево. Например:

"BOOL": true

Синтаксис JSON:

{"string": {
      "S": "string",
      "N": "string",
      "B": blob,
      "SS": ["string", ...],
      "NS": ["string", ...],
      "BS": [blob, ...],
      "M": {"string": {
            "S": "string",
            "N": "string",
            "B": blob,
            "SS": ["string", ...],
            "NS": ["string", ...],
            "BS": [blob, ...],
            "M": {"string": { ... recursive ... }
              ...},
            "L": [
              { ... recursive ... }
              ...
            ],
            "NULL": true|false,
            "BOOL": true|false
          }
        ...},
      "L": [
        {
          "S": "string",
          "N": "string",
          "B": blob,
          "SS": ["string", ...],
          "NS": ["string", ...],
          "BS": [blob, ...],
          "M": {"string": { ... recursive ... }
            ...},
          "L": [
            { ... recursive ... }
            ...
          ],
          "NULL": true|false,
          "BOOL": true|false
        }
        ...
      ],
      "NULL": true|false,
      "BOOL": true|false
    }
  ...}

--return-values-on-condition-check-failure (строка)

Необязательный параметр, возвращающий атрибуты элемента для операции DeleteItem, которая не выполнила проверку условия.

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

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

  • ALL_OLD
  • NONE

--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 (boolean)

Включить отладочную регистрацию.

--endpoint-url (string)

Переопределить URL команды по умолчанию заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки из конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/отключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (string)

Файл с сертификатами CA для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. По умолчанию используется формат 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 (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

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

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

Пример 1: Удаление элемента

Следующий пример удаляет элемент из таблицы MusicCollection и запрашивает подробности об удалённом элементе и используемые запросом ресурсы.

aws dynamodb delete-item \
    --table-name MusicCollection \
    --key file://key.json \
    --return-values ALL_OLD \
    --return-consumed-capacity TOTAL \
    --return-item-collection-metrics SIZE

Содержимое key.json:

{
    "Artist": {"S": "No One You Know"},
    "SongTitle": {"S": "Scared of My Shadow"}
}

Вывод:

{
    "Attributes": {
        "AlbumTitle": {
            "S": "Blue Sky Blues"
        },
        "Artist": {
            "S": "No One You Know"
        },
        "SongTitle": {
            "S": "Scared of My Shadow"
        }
    },
    "ConsumedCapacity": {
        "TableName": "MusicCollection",
        "CapacityUnits": 2.0
    },
    "ItemCollectionMetrics": {
        "ItemCollectionKey": {
            "Artist": {
                "S": "No One You Know"
            }
        },
        "SizeEstimateRangeGB": [
            0.0,
            1.0
        ]
    }
}

Для получения дополнительной информации см. Запись элемента в Руководстве разработчика Amazon DynamoDB.

Пример 2: Удаление элемента с условием

Следующий пример удаляет элемент из таблицы ProductCatalog только в том случае, если его ProductCategory равен либо Sporting Goods, либо Gardening Supplies, а его цена находится в диапазоне от 500 до 600. Возвращает информацию об удаленном элементе.

aws dynamodb delete-item \
    --table-name ProductCatalog \
    --key '{"Id":{"N":"456"}}' \
    --condition-expression "(ProductCategory IN (:cat1, :cat2)) and (#P between :lo and :hi)" \
    --expression-attribute-names file://names.json \
    --expression-attribute-values file://values.json \
    --return-values ALL_OLD

Содержимое names.json:

{
    "#P": "Price"
}

Содержимое values.json:

{
    ":cat1": {"S": "Sporting Goods"},
    ":cat2": {"S": "Gardening Supplies"},
    ":lo": {"N": "500"},
    ":hi": {"N": "600"}
}

Вывод:

{
    "Attributes": {
        "Id": {
            "N": "456"
        },
        "Price": {
            "N": "550"
        },
        "ProductCategory": {
            "S": "Sporting Goods"
        }
    }
}

Для получения дополнительной информации см. Запись элемента в Руководстве разработчика Amazon DynamoDB.

Вывод

Атрибуты -> (карта)

Карта имен атрибутов к AttributeValue объектам, представляющим элемент в виде, как он выглядел до операции DeleteItem. Эта карта появляется в ответе только в том случае, если ReturnValues было указано как ALL_OLD в запросе.

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

значение -> (структура)

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Для получения дополнительной информации см. Типы данных в Руководстве разработчика Amazon DynamoDB .

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (байтовый массив)

Атрибут типа Двоичный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(байтовый массив)

M -> (карта)

Атрибут типа Карта. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

значение -> (структура)

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Для получения дополнительной информации см. Типы данных в Руководстве разработчика Amazon DynamoDB .

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (байтовый массив)

Атрибут типа Двоичный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(байтовый массив)

M -> (карта)

Атрибут типа Карта. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

(… рекурсивно …)

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(… рекурсивно …)

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(структура)

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара имя-значение. Имя — это тип данных, а значение — это данные сами по себе.

Для получения дополнительной информации см. Типы данных в Руководстве разработчика Amazon DynamoDB .

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

B -> (байтовый массив)

Атрибут типа Двоичный. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются по сети в DynamoDB в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты числового типа для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(байтовый массив)

M -> (карта)

Атрибут типа Карта. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

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

(… рекурсивно …)

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(… рекурсивно …)

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

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

Единицы емкости, потребленные операцией DeleteItem. Возвращаемые данные включают общую потребленную пропускную способность, а также статистику для таблицы и любых индексов, участвующих в операции. ConsumedCapacity возвращается только в том случае, если параметр ReturnConsumedCapacity был указан. Для получения дополнительной информации см. Режим выделенной пропускной способности в Руководстве разработчика Amazon DynamoDB .

TableName -> (строка)

Имя таблицы, затронутой операцией. Если в вводе был указан Amazon Resource Name (ARN) таблицы, в ответе будет указан ARN таблицы.

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

Общее количество единиц емкости, потребленных операцией.

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

Общее количество единиц емкости чтения, потребленных операцией.

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

Общее количество единиц емкости записи, потребленных операцией.

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

Объем пропускной способности, потребленный таблицей, затронутой операцией.

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

Общее количество единиц емкости чтения, потребленных таблицей или индексом.

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

Общее количество единиц емкости записи, потребленных таблицей или индексом.

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

Общее количество единиц емкости, потребленных таблицей или индексом.

LocalSecondaryIndexes -> (карта)

Объем пропускной способности, потребленный каждым локальным индексом, затронутым операцией.

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

значение -> (структура)

Представляет объем потребленной емкости выделенной пропускной способности таблицы или индекса.

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

Общее количество единиц емкости чтения, потребленных таблицей или индексом.

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

Общее количество единиц емкости записи, потребленных таблицей или индексом.

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

Общее количество единиц емкости, потребленных таблицей или индексом.

GlobalSecondaryIndexes -> (карта)

Объем пропускной способности, потребленный каждым глобальным индексом, затронутым операцией.

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

значение -> (структура)

Представляет объем потребленной емкости выделенной пропускной способности таблицы или индекса.

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

Общее количество единиц емкости чтения, потребленных таблицей или индексом.

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

Общее количество единиц емкости записи, потребленных таблицей или индексом.

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

Общее количество единиц емкости, потребленных таблицей или индексом.

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

Информация об элементах коллекций, если таковые были затронуты операцией DeleteItem. ItemCollectionMetrics возвращается только в том случае, если был указан параметр ReturnItemCollectionMetrics. Если таблица не имеет локальных вторичных индексов, эта информация не возвращается в ответе.

Каждый элемент ItemCollectionMetrics состоит из:

  • ItemCollectionKey - Значение ключа раздела для коллекции элементов. Это то же самое, что и значение ключа раздела для самого элемента.
  • SizeEstimateRangeGB - Оценка размера коллекции элементов в гигабайтах. Это значение представляет собой массив из двух элементов, содержащий нижнюю и верхнюю границы оценки. Оценка включает размер всех элементов в таблице плюс размер всех атрибутов, спроецированных во все локальные вторичные индексы в этой таблице. Используйте эту оценку для измерения того, приближается ли локальный вторичный индекс к пределу размера. Оценка может меняться со временем, поэтому не полагайтесь на точность или достоверность оценки.

ItemCollectionKey -> (map)

Значение ключа раздела для коллекции элементов. Это значение совпадает со значением ключа раздела для элемента.

key -> (строка)

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

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара «имя-значение». Имя — это тип данных, а значение — это сами данные.

Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon DynamoDB.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты типа число для математических операций.

B -> (двоичные данные)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты типа число для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(двоичные данные)

M -> (map)

Атрибут типа Массив. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

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

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара «имя-значение». Имя — это тип данных, а значение — это сами данные.

Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon DynamoDB.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты типа число для математических операций.

B -> (двоичные данные)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты типа число для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(двоичные данные)

M -> (map)

Атрибут типа Массив. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

(… рекурсивно …)

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(… рекурсивно …)

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(структура)

Представляет данные для атрибута.

Каждое значение атрибута описывается как пара «имя-значение». Имя — это тип данных, а значение — это сами данные.

Дополнительную информацию см. в разделе «Типы данных» в руководстве разработчика Amazon DynamoDB.

S -> (строка)

Атрибут типа Строка. Например:

"S": "Hello"

N -> (строка)

Атрибут типа Число. Например:

"N": "123.45"

Числа передаются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты типа число для математических операций.

B -> (двоичные данные)

Атрибут типа Двоичные данные. Например:

"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"

SS -> (список)

Атрибут типа Набор строк. Например:

"SS": ["Giraffe", "Hippo" ,"Zebra"]

(строка)

NS -> (список)

Атрибут типа Набор чисел. Например:

"NS": ["42.2", "-19", "7.5", "3.14"]

Числа передаются в DynamoDB по сети в виде строк для максимальной совместимости между языками и библиотеками. Однако DynamoDB обрабатывает их как атрибуты типа число для математических операций.

(строка)

BS -> (список)

Атрибут типа Набор двоичных данных. Например:

"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]

(двоичные данные)

M -> (map)

Атрибут типа Массив. Например:

"M": {"Name": {"S": "Joe"}, "Age": {"N": "35"}}

key -> (строка)

(… рекурсивно …)

L -> (список)

Атрибут типа Список. Например:

"L": [ {"S": "Cookies"} , {"S": "Coffee"}, {"N": "3.14159"}]

(… рекурсивно …)

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

NULL -> (булево)

Атрибут типа Null. Например:

"NULL": true

BOOL -> (булево)

Атрибут типа Булево. Например:

"BOOL": true

SizeEstimateRangeGB -> (список)

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

Оценка может меняться со временем, поэтому не полагайтесь на точность или достоверность оценки.

(двойное значение)

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

Spec-Zone.ru

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