Carga una parte a un objeto específico mediante el ID de carga que devuelve InitiateMultipartUpload.
Notas de uso
Antes de llamar a UploadPart, debe llamar a InitiateMultipartUpload para obtener un ID de carga de OSS.
Si carga una nueva parte con el mismo partNumber, se sobrescribe la parte existente.
OSS incluye el hash MD5 de cada parte recibida en el encabezado ETag de la respuesta.
Si especifica el encabezado x-oss-server-side-encryption en InitiateMultipartUpload, se cifra cada parte cargada. La respuesta incluye el encabezado x-oss-server-side-encryption que indica el algoritmo de cifrado. Para obtener más información, consulte InitiateMultipartUpload.
Permisos
De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos. Los usuarios de RAM o los roles de RAM bajo una cuenta de Alibaba Cloud no tienen ningún permiso de forma predeterminada. La cuenta de Alibaba Cloud o el administrador de la cuenta deben otorgar permisos de operación mediante RAM policies o Bucket Policy.
|
API |
Acción |
Descripción |
|
UploadPart |
|
Carga partes. |
Sintaxis de la solicitud
PUT /ObjectName?partNumber=PartNumber&uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Length: Size
Authorization: SignatureValueEncabezados de la solicitud
Todos los encabezados en una solicitud UploadPart son encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.
Elementos de la solicitud
|
Elemento |
Tipo |
Obligatorio |
Ejemplo |
Descripción |
|
partNumber |
Entero positivo |
Sí |
1 |
El número de parte. Valores válidos: de 1 a 10000. El tamaño de una parte varía de 100 KB a 5 GB. Nota
Cada parte, excepto la última, debe tener como mínimo 100 KB. Los tamaños de las partes no se verifican durante UploadPart porque OSS no puede determinar cuál es la última parte. La verificación del tamaño ocurre cuando llama a CompleteMultipartUpload. |
|
uploadId |
Cadena |
Sí |
0004B9895DBBB6EC9**** |
El ID que identifica el objeto al que pertenecen las partes por cargar. |
Encabezados de la respuesta
|
Encabezado |
Tipo |
Ejemplo |
Descripción |
|
Content-MD5 |
Cadena |
1B2M2Y8AsgTpgAmY7PhC**** |
El hash MD5 de la parte. Importante
El hash MD5 de la parte se obtiene después de que el cliente carga el objeto. No es el hash MD5 del cuerpo de la respuesta. |
|
x-oss-hash-crc64ecma |
Cadena |
316181249502703**** |
El valor CRC-64 de la parte. |
La respuesta también incluye encabezados comunes como Date y x-oss-request-id. Common HTTP headers.
Ejemplos
Solicitud de ejemplo
PUT /multipart.data?partNumber=1&uploadId=0004B9895DBBB6EC9**** HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Length: 6291456
Date: Wed, 22 Feb 2012 08:32:21 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
[6291456 bytes data]Respuesta de ejemplo
HTTP/1.1 200 OK
Server: AliyunOSS
Content-length: 0
Connection: keep-alive
ETag: "7265F4D211B56873A381D321F586****"
x-oss-request-id: 3e6aba62-1eae-d246-6118-8ff42cd0****
Date: Wed, 22 Feb 2012 08:32:21 GMT
Content-MD5: 1B2M2Y8AsgTpgAmY7Ph****
x-oss-hash-crc64ecma: 316181249502703****
x-oss-server-time: 77SDK de OSS
SDK de OSS compatibles con UploadPart:
ossutil
Para obtener información sobre el comando de ossutil correspondiente a la operación UploadPart, consulte upload-part.
Códigos de error
|
Código de error |
Código de estado HTTP |
Descripción |
|
NoSuchUpload |
404 |
El ID de carga multiparte especificado no existe. |
|
InvalidArgument |
400 |
El número de parte no está dentro del rango de 1 a 10000. |
|
InvalidDigest |
400 |
El valor Content-MD5 en la solicitud no coincide con el hash MD5 calculado por OSS. Para evitar errores de transmisión, incluya Content-MD5 en la solicitud. OSS calcula el hash MD5 de los datos cargados y lo compara con el valor Content-MD5. Una discrepancia indica un error en la transmisión de datos. |