Todos los productos
Search

Este producto

    Object Storage Service:upload-part-copy

    Centro de documentos

    Object Storage Service:upload-part-copy

    Última actualización: Sep 03, 2026

    Esta operación carga una parte al copiar datos de un objeto existente.

    Notas de uso

    • Para copiar un objeto mayor a 1 GB, use el comando upload-part-copy. Para copiar un objeto menor a 1 GB en una sola operación, consulte copy-object.

    • El bucket de origen y el bucket de destino deben estar en la misma región.

    • Antes de cargar una parte con esta operación, ejecute el comando initiate-multipart-upload para obtener un ID de carga.

    Permisos

    De forma predeterminada, una cuenta de Alibaba Cloud tiene todos los permisos. Los usuarios RAM o roles RAM bajo una cuenta de Alibaba Cloud no tienen ningún permiso. La cuenta de Alibaba Cloud o el administrador de la cuenta debe otorgar los permisos de operación mediante RAM policies o Bucket Policy.

    API

    Action

    Descripción

    UploadPartCopy

    oss:GetObject

    Lee datos del objeto de origen cuando se carga una parte al copiar datos de un objeto existente.

    oss:PutObject

    Escribe datos en el objeto de destino cuando se carga una parte al copiar datos de un objeto existente.

    oss:GetObjectVersion

    Si especifica la versión del objeto mediante versionId al cargar una parte por copia, este permiso es obligatorio para leer dicha versión del objeto de origen.

    Sintaxis

    ossutil api upload-part-copy --bucket value --key value --copy-source value --part-number value --upload-id value [flags]

    Parámetro

    Tipo

    Descripción

    --bucket

    string

    Nombre del bucket de destino.

    --key

    string

    Ruta completa del objeto de destino.

    --copy-source

    string

    Dirección de origen para la operación de copia (requiere permiso de lectura sobre el origen). Sigue el formato bucket/UrIEncode(key), donde el nombre del objeto de origen debe estar codificado como URL.

    --copy-source-if-match

    string

    Copia la parte solo si el ETag del objeto de origen coincide con el ETag especificado. De lo contrario, devuelve un error 412 Precondition Failed.

    --copy-source-if-modified-since

    string

    Copia la parte solo si el objeto de origen se modificó después de la hora especificada. De lo contrario, devuelve un error 304 Not Modified.

    --copy-source-if-none-match

    string

    Copia la parte solo si el ETag del objeto de origen no coincide con el ETag especificado. De lo contrario, devuelve un error 304 Not Modified.

    --copy-source-if-unmodified-since

    string

    Copia la parte solo si el objeto de origen no se ha modificado desde la hora especificada. De lo contrario, devuelve un error 412 Precondition Failed.

    --copy-source-range

    string

    Rango de bytes del objeto de origen que se copiará.

    --part-number

    string

    Número de parte, que debe ser único para cada parte en la carga multiparte.

    --upload-id

    string

    ID de la carga multiparte.
    Nota

    • El comando upload-part-copy encapsula la operación de API UploadPartCopy. Para más detalles sobre los parámetros de la API, consulte la documentación de UploadPartCopy.

    • Para más información sobre las opciones globales de línea de comandos compatibles, consulte Global command-line options.

    Ejemplos

    • Cargue una parte al copiar datos de la versión actual de srcobject en el bucket srcbucket.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1

    • Cargue una parte al copiar datos y formatee la salida como JSON.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --output-format json

    • Cargue una parte al copiar datos y formatee la salida como YAML.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --output-format yaml

    • Cargue una parte al copiar un rango específico de bytes (0 a 9) del objeto de origen.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --copy-source-range bytes=0-9

    • Cargue una parte al copiar datos solo si el ETag del objeto de origen srcobject coincide con 123.

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --copy-source-if-match 123

    • Cargue una parte al copiar datos solo si el objeto de origen srcobject no se ha modificado desde "Mon, 11 May 2020 08:16:23 GMT".

      ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --copy-source-if-unmodified-since "Mon, 11 May 2020 08:16:23 GMT"