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> Obtenção da configuração de replicação entre regiões de um bucket
Atualizado em 2022-11-07 GMT+08:00

Obtenção da configuração de replicação entre regiões de um bucket

Funções

Esta operação obtém as informações de configuração de replicação de um bucket especificado. Para executar essa operação, você deve ter a permissão GetReplicationConfiguration.

Sintaxe da solicitação

1
2
3
4
GET /?replication HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date 
Authorization:authorization string

Parâmetros de solicitação

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

Cabeçalhos de solicitação

Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.

Elementos de solicitação

Este pedido não envolve elementos.

Sintaxe da resposta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
HTTP/1.1 status_code 
Date: date 
Server:OBS 
Content-Length: contentlength 
<?xml version="1.0" encoding="UTF-8"?> 
<ReplicationConfiguration xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2006-03-01/">
 
  <Agency>testAcy</Agency>
  <Rule> 
      <ID>rule1</ID> 
      <Status>Enabled</Status> 
      <Prefix></Prefix> 
      <Destination> 
         <Bucket>exampletargetbucket</Bucket> 
         <StorageClass>WARM</StorageClass> 
      </Destination> 
      <HistoricalObjectReplication>Enabled</HistoricalObjectReplication>
  </Rule> 
</ReplicationConfiguration>

Cabeçalhos de resposta

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

Elementos de resposta

Essa resposta contém elementos para detalhar a configuração. A tabela a seguir descreve os elementos.

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

Elemento

Descrição

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

Crianças: Regra

Antepassado: nenhum

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

Antepassado: ReplicationConfiguration

ID

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

Tipo: string

Antepassado: Regra

Status

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

Tipo: string

Antepassado: Rule

Opções de valor: Enabled, Disabled

Prefix

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

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

Tipo: string

Antepassado: Regra

Destination

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

Tipo: container

Antepassado: Rule

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

StorageClass

Classe de armazenamento de um objeto.

Tipo: enumeração

Antepassado: Destination

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

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

Respostas de erro

A tabela a seguir descreve a resposta de erro para essa solicitação.

Tabela 2 Elementos de resposta a erros

Código de erro

Descrição

Código de resposta HTTP

Prefixo do código de erro SOAP

NoSuchReplicationConfiguration

A configuração de replicação entre regiões não existe.

404 not found

Cliente

Solicitação de exemplo

1
2
3
4
5
6
GET /?replication HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: Wed, 27 Jun 2018 13:42:40 +0000
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:jGHviInfRyOkT/EpySpua1hlBuY=

Resposta de exemplo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: B59500000164417B57D02F7EF8823152
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSHu6lz4vgk5G3E32OFcIPEZZgdOEYE/
Content-Type: application/xml
Date: Wed, 27 Jun 2018 13:42:39 GMT
Content-Length: 337

<?xml version="1.0" encoding="utf-8"?>
<ReplicationConfiguration xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2006-03-01/">
 
  <Rule> 
    <ID>Rule-1</ID>  
    <Status>Enabled</Status>  
    <Prefix></Prefix>  
    <Destination> 
      <Bucket>dstbucket</Bucket>  
      <StorageClass>STANDARD</StorageClass> 
    </Destination>
    <HistoricalObjectReplication>Enabled</HistoricalObjectReplication> 
  </Rule>  
  <Agency>testAcy</Agency> 
</ReplicationConfiguration>