appendfromfile - Object Storage Service - Centro de documentación de Alibaba Cloud

Este tema describe cómo ejecutar el comando appendfromfile para agregar contenido a un objeto anexable en Object Storage Service (OSS).

Notas de uso

Para realizar una carga por anexado, debe contar con los permisos oss:GetObject y oss:PutObject. Para obtener más información, consulte Grant a custom policy.
En ossutil 1.6.16 y versiones posteriores, puede usar directamente ossutil como nombre del binario en la línea de comandos; no es necesario actualizarlo según el sistema operativo. En versiones anteriores a la 1.6.16, sí debe actualizar el nombre del binario según el sistema operativo. Para obtener más información, consulte ossutil command reference.

Para obtener más información sobre las cargas por anexado, consulte Append upload.

Sintaxis del comando

ossutil appendfromfile localfilename oss://bucketname/objectname
[--meta <value>]

La siguiente tabla describe los parámetros y opciones anteriores.

Parámetro/Opción	Descripción
localfilename	La ruta completa del archivo local que desea cargar.
bucketname	El nombre del bucket que almacena el objeto al que desea agregar contenido.
objectname	El nombre del objeto al que desea agregar contenido. Al ejecutar el comando appendfromfile para realizar una carga por anexado, puede conservar el nombre original del archivo local para el objeto o especificar otro nombre.
--meta	Los metadatos del objeto. Solo puede configurar este parámetro la primera vez que ejecuta el comando appendfromfile para cargar un objeto. Ejemplo: `--meta "x-oss-object-acl:private"`. Después de configurar los metadatos del objeto, puede ejecutar el comando set-meta (Manage object metadata) para modificarlos.

Ejemplos

En los siguientes ejemplos, primero se usa el comando appendfromfile para cargar un archivo local llamado exampleobject.txt desde el directorio raíz hacia el bucket examplebucket y almacenarlo como el objeto exampleobject.txt dentro del bucket. Después, se usa el mismo comando para agregar contenido al objeto exampleobject.txt.

Ejecute el siguiente comando para cargar exampleobject.txt y establecer la lista de control de acceso (ACL) del objeto cargado como privada:
```
ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt --meta "x-oss-object-acl:private"
```
El siguiente resultado de ejemplo indica que el archivo local se cargó en el bucket y se almacenó como el objeto exampleobject.txt. El tamaño del objeto exampleobject.txt es de 5 bytes.
```
total append 5(100.00%) byte,speed is 0.00(KB/s)
local file size is 5,the object new size is 5,average speed is 0.04(KB/s)
```
Ejecute el siguiente comando para agregar el contenido de un archivo llamado dest.txt a exampleobject.txt.

Si desea agregar más contenido a exampleobject.txt, reemplace dest.txt por el nombre del archivo cuyo contenido desea anexar a exampleobject.txt:
```
ossutil appendfromfile dest.txt oss://examplebucket/exampleobject.txt
```
El siguiente resultado de ejemplo indica que se agregó contenido a exampleobject.txt y que el tamaño del objeto después de la operación de carga por anexado es de 150 bytes.
```
total append 150(100.00%) byte,speed is 0.00(KB/s)
local file size is 150,the object new size is 150,average speed is 1.19(KB/s)
```

Opciones comunes

Para acceder a un bucket en una región diferente, use -e para especificar el endpoint. Para acceder a un bucket propiedad de otra cuenta de Alibaba Cloud, use -i para el AccessKey ID y -k para el AccessKey secret.

Por ejemplo, ejecute el siguiente comando para cargar el archivo exampleobject.txt mediante una carga por anexado al bucket examplebucket, ubicado en la región China (Shanghai) y propiedad de otra cuenta de Alibaba Cloud:

ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt -e shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Common options.