Todos los productos
Search

Este producto

    Object Storage Service:append-object

    Centro de documentos

    Object Storage Service:append-object

    Última actualización: Sep 03, 2026

    Carga un objeto mediante la anexión incremental de datos.

    Notas de uso

    • El objeto final creado con append-object no puede superar los 5 GB.

    • append-object no admite el cifrado del lado del servidor con Key Management Service (KMS) mediante un ID de clave maestra del cliente (CMK) específico.

    Permisos

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

    API

    Action

    Descripción

    AppendObject

    oss:PutObject

    Esta operación permite cargar un objeto anexándolo a uno existente.

    oss:PutObjectTagging

    Este permiso es obligatorio si se especifican etiquetas de objeto mediante x-oss-tagging al cargar un objeto por anexión a uno existente.

    Sintaxis del comando

    ossutil api append-object --bucket value --key value --position value [flags]

    Parámetro

    Tipo

    Descripción

    --body

    string

    Cuerpo de la solicitud.

    --bucket

    string

    Nombre del bucket.

    --cache-control

    string

    Comportamiento de caché del objeto.

    --content-disposition

    string

    Nombre que se muestra para el objeto al descargarlo.

    --content-encoding

    string

    Formato de codificación del objeto.

    --content-md5

    string

    Hash MD5 del contenido del objeto; se utiliza para verificar la integridad de los datos.

    --expires

    string

    Tiempo de expiración.

    --key

    string

    Ruta completa del objeto.

    --metadata

    stringArray

    Metadatos del objeto. Especifique metadatos personalizados con parámetros que tengan el prefijo x-oss-meta-*.

    --object-acl

    string

    Lista de control de acceso (ACL) del objeto.

    --position

    string

    Posición en bytes desde la cual comenzar a anexar datos.

    --server-side-encryption

    string

    Método de cifrado del lado del servidor.

    --storage-class

    string

    Clase de almacenamiento del objeto.

    --tagging

    string

    Etiquetas del objeto. Se pueden especificar varias etiquetas. Ejemplo: TagA=A&TagB=B.
    Nota

    • El comando append-object corresponde a la operación de API AppendObject. Para obtener más información sobre los parámetros de esta operación de API, consulte AppendObject.

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

    Ejemplos

    • Anexar una cadena al objeto exampleobject.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss"

    • Anexar datos de un archivo al objeto exampleobject.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body file://appendFile

    • Anexar una cadena al objeto exampleobject con metadatos personalizados.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --metadata user=aliyun --metadata email=ali***@aliyuncs.com

    • Anexar una cadena al objeto exampleobject con etiquetas de objeto.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --tagging "TagA=A&TagB=B"

    • Anexar una cadena al objeto exampleobject y establecer la ACL y la clase de almacenamiento.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --object-acl private --storage-class IA

    • Anexar una cadena al objeto exampleobject con cifrado del lado del servidor.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --body "hi oss" --server-side-encryption AES256

    • Anexar una cadena y configurar el comportamiento de cache-control para el objeto.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --cache-control no-cache

    • Anexar una cadena y establecer el nombre de descarga del objeto.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"

    • Anexar una cadena al objeto exampleobject con una verificación de integridad Content-MD5.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-md5 ohhnqLBJFiKkPSBO1eNaUA==