Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Object Storage Service/ Referência de API/ As API/ Configurações avançadas de bucket/ Configuração da replicação entre regiões para um bucket
Atualizado em 2022-11-07 GMT+08:00

Configuração da replicação entre regiões para um bucket

Funções

A replicação entre regiões refere-se à replicação automática e assíncrona de objetos em buckets em diferentes regiões. Ao ativar a função de replicação entre regiões, o OBS pode copiar novos objetos e objetos modificados de um bucket de origem para buckets de destino em diferentes regiões.

Os dois requisitos a seguir devem ser atendidos ao configurar a replicação entre regiões para um bucket:

  1. A replicação entre regiões só pode ser configurada quando os status de versionamento dos buckets de origem e de destino forem os mesmos. Para obter detalhes sobre como configurar o versionamento do bucket, consulte Configuração do versionamento para um bucket.
  2. O proprietário e a agência (OBS) do bucket de origem devem ter permissão para gravar o bucket de destino (configurado com BucketPolicy) e a agência (OBS) deve ter permissão de leitura para o bucket de origem. Essa delegação de permissão precisa ser implementada chamando a API BucketPolicy.

Para obter detalhes sobre como configurar a política de bucket, consulte Configuração de uma política de bucket. Depois que a política do bucket é definida, a agência (OBS) pode ler objetos do bucket de origem e copiar objetos para o bucket de destino.

Sintaxe da solicitação

 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> 
        </Destination> 
     </Rule> 
</ReplicationConfiguration>

Parâmetros de solicitação

Esta solicitação não contém nenhum parâmetro.

Cabeçalhos de solicitação

A solicitação usa um cabeçalho, conforme descrito na tabela a seguir.

Tabela 1 Cabeçalho de solicitação para replicação entre regiões

Elemento

Descrição

Obrigatório

Content-SHA256

Base64-encoded 256-bit SHA256 resumo da mensagem de acordo com SHA.

Sim

Elementos de solicitação

Essa solicitação contém elementos para especificar a configuração de replicação para o bucket no formato XML. A tabela a seguir lista os elementos de solicitação:

Tabela 2 Elementos de configuração de replicação do bucket

Elemento

Descrição

Obrigatório

ReplicationConfiguration

Contêiner para as regras de replicação. Um máximo de 100 regras podem ser configuradas. O tamanho do arquivo XML pode chegar a 50 KB.

Tipo: recipiente

Crianças: Regra

Antepassado: nenhum

Sim

Agency

Nome da Agência com um comprimento máximo de 64 caracteres.

Tipo: string

Antepassado: ReplicationConfiguration

Sim

Rule

Recipiente de uma regra de replicação especificada.

A configuração de replicação deve conter pelo menos uma regra. O número máximo de regras é 100.

Tipo: recipiente

Antepassado:

ReplicationConfiguration

Sim

ID

Identificador único de uma regra, com um comprimento máximo de 255 caracteres.

Tipo: string

Antepassado: Regra

Não

Status

Se o valor deste elemento for Disabled, esta regra será ignorada.

Tipo: string

Antepassado: Regra

Opções de valor: Enabled, Disabled

Sim

Prefix

Prefixo de um nome de chave de objeto, aplicável a um ou mais objetos.

O comprimento máximo de um prefixo é de 1024 caracteres. Prefixos duplicados não são suportados.

Tipo: string

Antepassado: Regra

Sim

Destination

Contêiner para as informações do bucket de destino.

Tipo: recipiente

Antepassado: Regra

Sim

Bucket

Bucket usado para armazenar cópias de objetos que são marcadas por regras.

Se a configuração de replicação contiver várias regras, as regras deverão especificar o mesmo bucket que o bucket de destino.

Tipo: string

Antepassado: Destino

Sim

StorageClass

Classe de armazenamento de um objeto

Tipo: enumeração

Antepassado: Destino

Opções de valor: STANDARD | WARM | COLD

Não

HistoricalObjectReplication

Palavra-chave para copiar um objeto histórico. Se o valor for Enabled, os objetos históricos que atendem a essa regra serão copiados.

Tipo: string

Antepassado: Regra

Opções de valor: Enabled, Disabled

Não

Sintaxe da resposta

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

Cabeçalhos de resposta

A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.

Elementos de resposta

Esta resposta não envolve elementos.

Respostas de erro

Nenhuma resposta de erro especial é retornada para essa solicitação.

Solicitação de exemplo

 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>

Resposta de exemplo

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