Загрузить фрагмент файла

Загружает данные файла в созданную сессию.

Используйте Content-Type: application/octet-stream и передавайте данные в теле запроса.
При загрузке в S3 передавайте части с параметром part_number, начиная с 1. Части можно
загружать параллельно и повторно при ошибке. Размер части ограничен настройками сервиса.
При загрузке через сервис загрузки файлов передайте файл целиком одним запросом: его размер
должен совпадать с размером, указанным при создании сессии.

Общие заголовки и способы аутентификации описаны в разделе Доступ к API. Примеры сценариев приведены в разделе Примеры использования API.

Request

PUT

https://api.wiki.yandex.net/v1/upload_sessions/{session_id}/upload_part

Path parameters

Name

Description

session_id

Type: string<uuid4>

Идентификатор сессии загрузки в формате UUID. Передайте значение поля session_id из ответа метода POST /v1/upload_sessions.

Example: ``

Query parameters

Name

Description

part_number

Type: integer

Номер загружаемой части файла от 1 до 10000. При отправке файла целиком укажите 1; при загрузке по частям нумеруйте их последовательно, начиная с 1.

Min value: 1

Max value: 10000

Responses

200 OK

Body

application/json

{
  "session_id": "example",
  "file_name": "example",
  "file_size": 0,
  "status": "not_started",
  "user": {
    "id": 0,
    "identity": {
      "uid": "example",
      "cloud_uid": "example"
    },
    "username": "example",
    "display_name": "example",
    "is_dismissed": true,
    "affiliation": "example"
  },
  "created_at": "2025-01-01T00:00:00Z",
  "finished_at": "2025-01-01T00:00:00Z",
  "storage_type": "mds"
}

Name	Description
created_at	Type: string<date-time> Дата и время создания сессии загрузки. Example: `2025-01-01T00:00:00Z`
file_name	Type: string Имя загружаемого файла. Example: `example`
file_size	Type: integer Заявленный при создании сессии размер файла в байтах.
session_id	Type: string<uuid4> Идентификатор сессии загрузки файла в формате UUID. Используйте это значение как `session_id` в методах загрузки, завершения и отмены сессии. Example: `example`
status	All of 1 type UploadSessionStatusType Type: UploadSessionStatusType An enumeration. Enum: `not_started`, `in_progress`, `finished`, `aborted`, `used`, `cleanup` Состояние сессии загрузки. Example: `not_started`
user	All of 1 type UserSchema Type: UserSchema Информация о пользователе Example `{ "id": 0, "identity": { "uid": "example", "cloud_uid": "example" }, "username": "example", "display_name": "example", "is_dismissed": true, "affiliation": "example" }` Пользователь, создавший сессию загрузки. Example `{ "id": 0, "identity": { "uid": "example", "cloud_uid": "example" }, "username": "example", "display_name": "example", "is_dismissed": true, "affiliation": "example" }`
finished_at	Type: string<date-time> Дата и время завершения загрузки; null, если загрузка еще не завершена. Example: `2025-01-01T00:00:00Z`
storage_type	All of 1 type StorageType Type: StorageType An enumeration. Enum: `mds`, `s3`, `custom_s3` Тип хранилища файла. Example: `mds`

UploadSessionStatusType

An enumeration.

Type: string

Enum: not_started, in_progress, finished, aborted, used, cleanup

UserIdentity

Идентификатор пользователя

Name

Description

cloud_uid

Type: string

Идентификатор пользователя в облаке

Example: example

uid

Type: string

Идентификатор пользователя в Яндексе

Example: example

Example

{
  "uid": "example",
  "cloud_uid": "example"
}

UserSchema

Информация о пользователе

Name	Description
affiliation	Type: string Принадлежность пользователя Example: `example`
display_name	Type: string Отображаемое имя пользователя Example: `example`
id	Type: integer Внутренний идентификатор пользователя
is_dismissed	Type: boolean Пользователь уволен
username	Type: string Логин пользователя Example: `example`
identity	All of 1 type UserIdentity Type: UserIdentity Идентификатор пользователя Example `{ "uid": "example", "cloud_uid": "example" }` Идентификатор пользователя в системе Example `{ "uid": "example", "cloud_uid": "example" }`

Example

{
  "id": 0,
  "identity": {
    "uid": "example",
    "cloud_uid": "example"
  },
  "username": "example",
  "display_name": "example",
  "is_dismissed": true,
  "affiliation": "example"
}

StorageType

An enumeration.

Type: string

Enum: mds, s3, custom_s3

Была ли статья полезна?

Получить сессию загрузки файла

Завершить сессию загрузки