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:
- 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.
- 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.
Elemento |
Descripción |
Obligatorio |
---|---|---|
Content-SHA256 |
Resumen de 256 bits SHA256 codificado en base64 del mensaje según SHA. |
Sí |
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:
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 |
Sí |
Agency |
Nombre de la delegación, que puede tener un máximo de 64 caracteres. Tipo: string Antepasado: ReplicationConfiguration |
Sí |
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 |
Sí |
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 |
Sí |
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 |
Sí |
Destination |
Contenedor para la información del bucket de destino. Tipo: container Antepasado: Rule |
Sí |
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 |
Sí |
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 |