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