Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Configuración avanzada del bucket/ Configuración de la replicación entre regiones para un bucket
Actualización más reciente 2024-09-18 GMT+08:00

Configuración de la replicación entre regiones para un bucket

Funciones

La replicación entre regiones se refiere a la replicación automática y asincrónica de objetos en los bucket en diferentes regiones. Al activar la replicación entre regiones, OBS puede copiar nuevos objetos y objetos modificados desde un bucket de origen en una región a un bucket de destino en una región diferente.

Se deben cumplir los dos requisitos siguientes al configurar la replicación entre regiones para un bucket:

  1. La replicación entre regiones solo se puede configurar cuando los estados de control de versiones de los bucket de origen y de destino son los mismos. Para obtener más información acerca de cómo configurar el control de versiones del bucket, consulte Configuración del control de versiones para un bucket.
  2. El propietario y la delegación (OBS) del bucket de origen deben tener el permiso para escribir el bucket de destino (configurado con BucketPolicy) y la delegación (OBS) debe tener el permiso de lectura para el bucket de origen. Esta delegación de permisos debe implementarse llamando a la API BucketPolicy.

Para obtener más información acerca de cómo configurar la política de bucket, consulte Configuración de la política de bucket. Una vez establecida la política de bucket, la delegación (OBS) puede leer objetos del bucket de origen y copiar objetos en el bucket de destino.

Sintaxis de solicitud

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
PUT /?replication HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com x-obs-date: date 
Content-SHA256: SHA256
Authorization: authorization string 
Content-Length: contentlength 

<ReplicationConfiguration> 
    <Agency>testAcy</Agency>
    <Rule> 
        <ID>rule1</ID> 
        <Prefix>key-prefix</Prefix> 
        <Status>rule-status</Status> 
        <Destination> 
            <Bucket>targetbucketname</Bucket> 
            <StorageClass>STANDARD</StorageClass>
        </Destination> 
    </Rule> 
</ReplicationConfiguration>

Parámetros de solicitud

Esta solicitud no contiene parámetros de mensaje.

Encabezados de solicitud

La solicitud utiliza un encabezado, como se describe en la tabla siguiente.

Tabla 1 Encabezado de solicitud para replicación entre regiones

Elemento

Descripción

Obligatorio

Content-SHA256

Resumen de 256 bits SHA256 codificado en base64 del mensaje según SHA.

Elementos de solicitud

Esta solicitud contiene elementos para especificar la configuración de replicación para el bucket en formato XML. En la siguiente tabla se enumeran los elementos de solicitud:

Tabla 2 Elementos de configuración de replicación de bucket

Elemento

Descripción

Obligatorio

ReplicationConfiguration

Contenedor para las reglas de replicación. Se puede configurar un máximo de 100 reglas. El tamaño del archivo XML puede alcanzar los 50 KB.

Tipo: container

Hijos: Rule

Antepasado: ninguno

Agency

Nombre de la delegación, que puede tener un máximo de 64 caracteres.

Tipo: string

Antepasado: ReplicationConfiguration

Rule

Contenedor de una regla de replicación especificada.

La configuración de replicación debe contener al menos una regla. El número máximo de reglas es 100.

Tipo: container

Antepasado:

ReplicationConfiguration

ID

Identificador único de una regla, con una longitud máxima de 255 caracteres.

Tipo: string

Antepasado: Rule

No

Status

Si el valor de este elemento es Disabled, esta regla se omitirá.

Tipo: string

Antepasado: Rule

Opciones de valor: Enabled, Disabled

Prefix

Prefijo de un nombre de clave de objeto, aplicable a uno o más objetos. Si el Prefix se deja en blanco, la regla de replicación entre regiones se aplica a todo el bucket.

La longitud máxima de un prefijo es de 1024 caracteres. No se admiten prefijos duplicados.

Tipo: string

Antepasado: Rule

Destination

Contenedor para la información del bucket de destino.

Tipo: container

Antepasado: Rule

Bucket

El bucket utilizado para almacenar copias de objetos marcadas por reglas.

Si la configuración de replicación contiene varias reglas, las reglas deben especificar el mismo bucket que el bucket de destino.

Tipo: string

Antepasado: Destination

StorageClass

Clase de almacenamiento de un objeto

Tipo: string

Antepasado: Destination

Opciones de valor: STANDARD, WARM, COLD

No

HistoricalObjectReplication

Palabra clave para copiar un objeto histórico. Si el valor es Enabled, se copian los objetos históricos que cumplen con esta regla.

Tipo: string

Antepasado: Rule

Opciones de valor: Enabled y Disabled (Si este elemento está ausente de la solicitud, se aplica Disabled de forma predeterminada.)

No

Sintaxis de respuesta

1
2
3
4
HTTP/1.1 status_code 
Server: OBS 
Date:date 
Content-Length: contentlength

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Elementos de respuesta

Esta respuesta no contiene elementos.

Respuestas de error

No se devuelven respuestas de error especiales para esta solicitud.

Modelo de solicitud

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
PUT /?replication HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: Wed, 27 Jun 2018 13:39:15 +0000
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:CdeqU0Vg9xNdJMZ0PGPgh5EnkO0=
Content-SHA256: ogX9qClMrVJUBiUSIKDFM0qO41jJM0I5SCN55/OtMyI=
Content-Length: 330

<ReplicationConfiguration>
   <Agency>testAcy</Agency>
   <Rule>
       <ID>Rule-1</ID>
       <Status>Enabled</Status>
       <Prefix></Prefix>
       <Destination>
          <Bucket>dstbucket</Bucket>
          <StorageClass>STANDARD</StorageClass>
       </Destination>      
       <HistoricalObjectReplication>Enabled</HistoricalObjectReplication>
     </Rule>
</ReplicationConfiguration>

Modelo de respuesta

1
2
3
4
5
6
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: B59500000164417839932E5A2295674C
x-obs-id-2: 32AAAQAAEAABKAAQAAEAABAAAQAAEAABCStv51t2NMMx+Ou+ow7IWV4Sxo231fKe
Date: Wed, 27 Jun 2018 13:39:15 GMT
Content-Length: 0