Puede llamar a la operación AppendObject para anexar contenido a objetos anexables existentes.
Notas
En este tema se utiliza el endpoint público de la región China (Hangzhou). Si desea acceder a OSS desde otros servicios de Alibaba Cloud en la misma región que OSS, utilice un endpoint interno. Para obtener más información sobre las regiones y endpoints de OSS, consulte Regions and endpoints.
Este tema muestra cómo crear una instancia de OSSClient con un endpoint de OSS. Para configuraciones alternativas, como el uso de un dominio personalizado o la autenticación con credenciales de Security Token Service (STS), consulte Initialization.
Si el objeto al que desea anexar contenido no existe, la operación AppendObject crea un objeto anexable.
-
Si el objeto al que desea anexar contenido ya existe:
Si el objeto es anexable y la posición especificada donde inicia la operación de anexión coincide con el tamaño actual del objeto, los datos se anexan al final del mismo.
Si el objeto es anexable pero la posición especificada donde inicia la operación de anexión no coincide con el tamaño actual del objeto, se devuelve el error PositionNotEqualToLength.
Si el objeto no es de tipo anexable, se devuelve el error ObjectNotAppendable.
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 predeterminado. La cuenta de Alibaba Cloud o el administrador de la cuenta deben otorgar los permisos de operación mediante RAM policies o Bucket Policy.
|
API |
Action |
Descripción |
|
AppendObject |
|
Puede llamar a esta operación para cargar un objeto mediante su anexión a un objeto existente. |
|
|
Al cargar un objeto mediante su anexión a uno existente, este permiso es obligatorio si especifica etiquetas de objeto a través de x-oss-tagging. |
Ejemplos
A continuación se presenta un código de ejemplo que muestra cómo realizar una operación de carga por anexión:
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# Obtain access credentials from environment variables. Before you run the code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# Specify the ID of the region that maps to the endpoint. Example: cn-hangzhou. This parameter is required if you use the signature algorithm V4.
region = "cn-hangzhou"
# Specify the name of your bucket.
bucket = oss2.Bucket(auth, endpoint, "yourBucketName", region=region)
# The following code provides an example on how to specify headers for the append upload:
# headers = dict()
# Specify the caching behavior of the web page for the object.
# headers['Cache-Control'] = 'no-cache'
# Specify the name of the object when the object is downloaded.
# headers['Content-Disposition'] = 'oss_MultipartUpload.txt'
# Specify the request header that is used to check whether the content of the received message is the same as the content of the sent message.
# headers['Content-MD5'] = 'ohhnqLBJFiKkPSBO1eNaUA=='
# Specify the expiration time.
# headers['Expires'] = 'Wed, 08 Jul 2022 16:57:01 GMT'
# Specify the access control list (ACL) of the object. In this example, the ACL is set to OBJECT_ACL_PRIVATE.
# headers['x-oss-object-acl'] = oss2.OBJECT_ACL_PRIVATE
# Specify whether to overwrite the object with the same name in the append upload.
# headers['x-oss-forbid-overwrite'] = 'true'
# Specify the server-side encryption method. In this example, SSE-OSS is specified for server-side encryption.
# headers[OSS_SERVER_SIDE_ENCRYPTION] = SERVER_SIDE_ENCRYPTION_AES256
# Specify the storage class of the object.
# headers['x-oss-storage-class'] = oss2.BUCKET_STORAGE_CLASS_STANDARD
# You can add parameters whose names are prefixed with x-oss-meta- when you call the AppendObject operation to create an appendable object. These parameters cannot be included in the requests when you append content to an existing appendable object. Parameters whose names are prefixed with x-oss-meta- are considered the metadata of the object.
# headers['x-oss-meta-author'] = 'Alice'
# result = bucket.append_object(exampledir/exampleobject.txt, 0, 'content of first append', headers=headers)
# Set the position from which the first append operation starts to 0.
# Specify the full path of the object. Do not include the bucket name in the full path. Example: exampledir/exampleobject.txt.
result = bucket.append_object('exampledir/exampleobject.txt', 0, 'content of first append')
# If you have appended content to the object, you can obtain the position from which the current append operation starts from the next_position field in the response returned by the last operation or by using bucket.head_object.
bucket.append_object('<yourObjectName>', result.next_position, 'content of second append') Referencias
Para consultar el código de ejemplo completo sobre la carga por anexión, visite GitHub.
Para obtener más información sobre la operación de API que puede llamar para realizar una carga por anexión, consulte AppendObject.