PutRecord

Статья создана

Обновлена 24 августа 2021 г.

В запросе указывается имя потока, ключ сегмента и объект, содержащий данные пользователя в кодировке Base64.

Возвращает идентификатор сегмента, в который было помещено сообщение, и порядковый номер сообщения.

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

Запрос

Запрос содержит данные в формате JSON.

{
  "Data": blob,
  "ExplicitHashKey": "string",
  "PartitionKey": "string",
  "SequenceNumberForOrdering": "string",
  "StreamName": "string"
}

Параметр	Описание
`Data`	Данные пользователя. Тип: Бинарный, кодировка Base64 Размер: `0`-`1048576` байт данных в кодировке Base64 Обязательный: Да
`ExplicitHashKey`	Хеш ключа сегмента. При определении сегмента для записи сообщения с помощью хеша `PartitionKey` возможно неоптимальное распределение сообщений по сегментам. Используйте этот параметр для явного определения сегмента, в который будет записано сообщение. Тип: Строка Возможные значения: `0\|([1-9]\d{0,38})` Обязательный: Нет
`PartitionKey`	Ключ сегмента. Определяет, в какой сегмент потока будет записано сообщение. Тип: Строка Размер: `1`-`256` символов. Обязательный: Да
`StreamName`	Имя потока данных. Тип: Строка Размер: `1`-`128` символов. Возможные значения: `[a-zA-Z][a-zA-Z0-9-]+(?<!-)$` Обязательный*: Да

В случае успеха возвращаются HTTP-ответ с кодом 200 и данные в формате JSON.

{
  "EncryptionType": "string",
  "SequenceNumber": "string",
  "ShardId": "string"
}

Параметр	Описание
`EncryptionType`	Тип шифрования. Тип: Строка Возможные значения: `NONE` Обязательный: Да
`SequenceNumber`	Порядковый номер сообщения. Тип: Строка Возможные значения: `0\|([1-9]\d{0,128})` Обязательный: Да
`ShardId`	Идентификатор сегмента, в который было записано сообщение. Тип: Строка Размер: `1`-`128` символов. Возможные значения: `[a-zA-Z0-9_.-]+` Обязательный: Да

Параметр	Описание	Код HTTP
`InvalidArgumentException`	Недопустимый аргумент. Дополнительные сведения смотрите в сообщении об ошибке.	400
`ProvisionedThroughputExceededException`	Недостаточно пропускной способности для выполнения запроса.	400
`ResourceNotFoundException`	Запрошенный ресурс не найден.	400

Могут возникать ошибки, общие для всех методов.