Todos los productos
Search
Centro de documentos

Object Storage Service:Carga de archivos (SDK de Python V2)

Última actualización: Sep 24, 2026

El OSS SDK for Python V2 ofrece diversas operaciones para cargar archivos. Seleccione la que mejor se adapte a su escenario.

Tipo

Nombre de la operación

Descripción

Simple upload (Python SDK V2)

client.put_object

  • Ejecuta una carga simple. El tamaño máximo del objeto que se puede cargar es de 5 GiB.

  • Es compatible con la validación de datos mediante suma de verificación cíclica de 64 bits (CRC-64). Esta función está habilitada de forma predeterminada.

  • Admite barras de progreso.

  • El cuerpo de la solicitud es de tipo io.Reader. Si el tipo io.Seeker es compatible, los datos se retransmiten cuando falla la carga.

client.put_object_from_file

  • Ofrece las mismas funciones que la operación client.put_object.

  • Los datos del cuerpo de la solicitud se obtienen de la ruta de un archivo.

Append upload (Python SDK V2)

client.append_object

  • Ejecuta una carga por anexión. El tamaño máximo del objeto final es de 5 GiB.

  • Es compatible con la validación de datos CRC-64. Esta función está habilitada de forma predeterminada.

  • Admite barras de progreso.

  • El cuerpo de la solicitud es de tipo BodyType. Los datos se retransmiten si la carga falla. Esta operación no es idempotente, por lo que la retransmisión podría fallar.

Operación AppendOnlyFile

AppendOnlyFile.write

AppendOnlyFile.write_from

  • Ofrece las mismas funciones que la operación client.append_object.

  • Optimiza la tolerancia a fallos durante las retransmisiones.

Multipart upload (Python SDK V2)

Operaciones de carga por partes

client.initiate_multipart_upload

client.upload_part

client.complete_multipart_upload

  • Ejecuta una carga por partes. El tamaño máximo de cada parte es de 5 GiB y el del objeto completo es de 48.8 TiB.

  • La operación upload_part es compatible con la validación CRC-64. Esta función está habilitada de forma predeterminada.

  • La operación upload_part admite barras de progreso.

  • El cuerpo de la solicitud de la operación upload_part es de tipo BodyType. También son compatibles los tipos str, bytes, Iterable[bytes], IO[str] e IO[bytes].

Form upload (Python SDK V2)

/

  • Genera información como una firma Post y una política Post. Luego, llama al método HTTP POST para cargar un archivo en OSS.

Upload using a signed URL (Python SDK V2)

client.presign

  • Genera una URL firmada para el método PUT con tiempo de expiración. Esto permite que otros usuarios carguen archivos de manera temporal.

File upload manager (Python SDK V2)

Uploader.upload_from

  • Encapsula las operaciones de carga simple y de carga por partes. El tamaño máximo del objeto que se puede cargar es de 48.8 TiB.

  • Es compatible con la validación de datos CRC-64. Esta función está habilitada de forma predeterminada.

  • Admite barras de progreso.

  • El parámetro del cuerpo de la solicitud es de tipo IO[bytes].

Uploader.upload_file

  • Ofrece las mismas funciones que la operación Uploader.upload_from.

  • Los datos del cuerpo de la solicitud se obtienen de la ruta de un archivo.

  • Es compatible con la carga reanudable.