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:
- 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.
- 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.
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:
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 |