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 de regras de volta à fonte do espelhamento

Atualizado em 2022-11-18 GMT+08:00

Ver PDF

Configuração de regras de volta à fonte do espelhamento

Funções

Essa operação configura as regras de volta à fonte do espelhamento para um bucket especificado. Esta API é idempotente. Se a mesma regra já existir no bucket, uma mensagem de sucesso será retornada com o código de status 200. Caso contrário, o código de status 201 é retornado.

Sintaxe de solicitação

PUT /?mirrorBackToSource HTTP/1.1
Host: bucketname.obs.region.myhuaweicloud.com 
Authorization: authorization
Content-Type: application/json
Content-Length: length
Date: date

policy json body

Parâmetros de solicitação

Esta solicitação não contém parâmetros de mensagem.

Cabeçalhos de solicitação

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

Elementos de solicitação

**Tabela 1** Elementos de solicitação
Elemento	Descrição	Obrigatório
rules	Número de regras. Tipo: container Intervalo de valor: tamanho da matriz que varia de 1 a 10 NOTA: Para o mesmo bucket, os prefixos de regras diferentes não podem conter uns aos outros ou ter caracteres iniciais duplicados. Recomenda-se a mesma agência.	Sim

**Tabela 2** Parâmetros de regra
Parâmetro	Descrição	Obrigatório
id	ID da regra. ID exclusivo de uma regra de retorno à origem configurada para o bucket atual. Tipo: string Intervalo de valor: 1 ao 256. O valor deve estar dentro do intervalo de ^[a-zA-Z0-9_-]{1, 256}$.	Sim
condition	Condição para disparar volta à fonte. Tipo: container	Sim
httpErrorCodeReturnedEquals	Código de erro que dispara a função volta à fonte. Quando esse erro é retornado para uma solicitação de download, a função volta à fonte é acionada. Tipo: positive integer Intervalo de valor: 404	Sim
objectKeyPrefixEquals	Prefixo do nome do objeto que aciona a função volta à fonte. Volta à fonte é realizado somente quando o prefixo de nome de objeto especificado está contido na solicitação. Se este parâmetro for deixado em branco, todos os objetos são correspondidos por padrão. Para o mesmo bucket, os prefixos de regras diferentes não podem conter uns aos outros ou ter caracteres iniciais duplicados. Tipo: string Valor válido: uma cadeia de 0 a 1023 caracteres	Não
redirect	Principais parâmetros de volta à fonte. Tipo: container	Sim
agency	Nome da agência com uma agência, o cliente pode conceder ao OBS as permissões para consultar se um objeto especificado existe no bucket e carregar objetos para o bucket. Tipo: string	Sim
publicSource	Configuração do site de origem que pode ser acessado publicamente. Este parâmetro é obrigatório quando o site de origem é um recurso acessível ao público. Tipo: container	Não
sourceEndpoint	Endereço do site de origem que pode ser acessado publicamente. Tipo: container	Não
master	Endereço de origem primária. Se a origem for um bucket que pode ser acessado pela rede de HTTP, o endereço será o nome de domínio do bucket. Se a origem for um bucket privado fornecido por outros fornecedores de nuvem, o endereço é um endereço de nome de domínio de região. Tipo: array Valor válido: Um único endereço de site de origem está no formato de https\|http://xxx.yyy.zzz, contendo de 10 a 255 caracteres. NOTA: A fonte primária site endereço é preferencialmente utilizado durante o volta à fonte processo. Se vários endereços primários estiverem configurados, todos os endereços primários serão acessados no modo de polling. Se dois ou mais endereços primários estiverem configurados, quando a primeira solicitação para o endereço primário falhar e as condições de repetição forem atendidas, a solicitação tentará novamente outro endereço primário. Pelo menos um endereço principal deve ser configurado. Um máximo de cinco endereços primários podem ser configurados.	Não
slave	Endereço do site de origem secundária. Se a origem for um bucket que pode ser acessado pela rede de HTTP, o endereço será o nome de domínio do bucket. Se a origem for um bucket privado fornecido por outros fornecedores de nuvem, o endereço é um endereço de nome de domínio de região. Tipo: array Valor válido: Um único endereço de site de origem está no formato de https\|http://xxx.yyy.zzz, contendo de 10 a 255 caracteres. NOTA: Uma solicitação de retorno à origem repetirá o endereço do site de origem secundária quando o endereço do site de origem primária não estiver disponível. Um máximo de cinco endereços secundários podem ser configurados.	Não
retryConditions	Condição para mudar o endereço do site de origem. Tipo: array Intervalo de valor: Códigos de erro 4XX, 5XX, 400-499 e 500-599 NOTA: Os códigos de erro que começam com 4XX e 4 não podem ser configurados juntos. Os códigos de erro que começam com 5XX e 5 não podem ser configurados juntos. Um máximo de 20 códigos de erro podem ser configurados.	Não
passQueryString	Indica se deve transportar a seqüência de caracteres de solicitação. Se o valor for true, o valor queryString na solicitação OBS é passado para o site de origem. Caso contrário, o valor de queryString não será passado para o site de origem. O valor padrão é false. O valor false indica que o parâmetro é ignorado. Tipo: BOOL Intervalo de valor: false or true NOTA: Se o valor for true, mas a consulta contiver informações de assinatura, exclua as informações de assinatura e passe os parâmetros restantes.	Sim
mirrorFollowRedirect	Indica se deseja obter recursos após a solicitação de redirecionamento 3xx do site de origem redirecionado. Se o valor for true, obtenha recursos seguindo a solicitação de redirecionamento 3xx do site de origem redirecionado. Caso contrário, OBS passa pela resposta 3XX e não obtém recursos. O valor padrão é false. O valor false indica que o parâmetro é ignorado. Tipo: BOOL Intervalo de valor: false ou true	Sim
mirrorHttpHeader	Regra de encaminhamento do cabeçalho de HTTP Tipo: container	Não
passAll	Indica se deve passar todos os cabeçalhos HTTP através do site de origem. Os seguintes tipos de cabeçalho de HTTP não suportam passthrough: 1. Cabeçalhos que começam com os seguintes prefixos: x-obs- x-amz- 2. Todos os cabeçalhos de HTTP padrão, por exemplo: Conteúdo-Comprimento Autorização Data passAll e pass são mutuamente exclusivos. Tipo do valor: BOOL Intervalo de valor: false ou true	Não
pass	Especifica a lista de cabeçalhos de HTTP a serem passados. Tipo: list Intervalo de valor: um máximo de 10 listas. O comprimento de cada lista varia de 1 a 63 caracteres. A tecla pode conter apenas letras (maiúsculas e minúsculas), dígitos, hífens (-) e sublinhados (_).	Não
remove	Lista de cabeçalhos de HTTP que não podem ser passados. A operação remove tem precedência sobre as operações pass e passAll. Tipo: list Intervalo de valor: um máximo de 10 listas. O comprimento de cada lista varia de 1 a 63 caracteres. A tecla pode conter apenas letras (maiúsculas e minúsculas), dígitos, hífens (-) e sublinhados (_).	Não
set	Configuração da lista de cabeçalhos HTTP a serem passados. A operação set tem uma prioridade mais alta do que as operações remove, pass, e passAll. Se o cabeçalho definido pelo usuário contém Referer, redirectWithoutReferer deve ser definido como true. Caso contrário, Referer será sobrescrito. Tipo: container list Intervalo de valor: um máximo de 10 listas	Não
key	Palavra-chave do cabeçalho de HTTP que precisa ser passado. Cada chave é única. Tipo: string Intervalo de valor: uma string de 1 a 63 caracteres. Somente letras (maiúsculas e minúsculas), dígitos, hífens (-) e sublinhados (_) são permitidos.	Não
value	Valor do cabeçalho de HTTP que precisa ser passado. Tipo: string Intervalo de valor: uma string de 0 a 2048 caracteres	Não
replaceKeyWith	Adicionar prefixo ou sufixo. Se você precisar adicionar um prefixo ou sufixo ao baixar objetos do site de origem, defina esse parâmetro como prefix${key}suffix. Se nenhum prefixo ou sufixo precisar ser adicionado, defina este parâmetro como ${key}. Tipo: string Intervalo de valor: prefix${key}suffix ${key} é a palavra-chave, prefixo e sufixo são os que devem ser adicionados. Comprimento total do prefixo e sufixo. O valor varia de 0 a 1023 caracteres.	Não
replaceKeyPrefixWith	Cadeia de caracteres usada para substituir o prefixo objectKeyPrefixEquals. Se você precisar substituir o prefixo do nome do objeto atual ao fazer o download de objetos do site de origem, modifique esse item de configuração. Se ambos replaceKeyWith e ReplaceKeyPrefixWith estiverem vazios, ReplaceKeyPrefixWith entrará em vigor. A solicitação é inválida se ambos os parâmetros forem especificados. Tipo: string Intervalo de valor: uma string de 0 a 1023 caracteres	Não
vpcEndpointURN	URN do serviço VPC Endpoint. Tipo: string Intervalo de valor: uma string de 0 a 127 caracteres	Não
redirectWithoutReferer	Indica se a transportar o host original como o cabeçalho de referência para o endereço de destino para redirecionamento. O valor false indica que o host original será transportado, e true indica que o host original não será transportado. Tipo: BOOL Valor padrão: false	Não
mirrorAllowHttpMethod	Tipo da solicitação de HTTP que você deseja passar, por exemplo, HEAD. Atualmente, apenas HEAD é suportado. Tipo: list	Não

Sintaxe de resposta

HTTP/1.1 status
Server: OBS
Date: date
Content-Length: length

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 obter detalhes sobre respostas de erro, consulte Tabela 2 e Tabela 3.

Solicitação de exemplo

PUT /?mirrorBackToSource HTTP/1.1
Host: bucketname.obs.region.myhuaweicloud.com 
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:sc2PM13Wlfcoc/YZLK0MwsI2Zpo=
Content-Type: application/json
Content-Length: 1049
Date: Tue, 21 Jul 2020 15:38:30 GMT

{
    "rules": [{
        "id": "abc123",
        "condition": {
            "httpErrorCodeReturnedEquals": "404",
            "objectKeyPrefixEquals": "video/"
        },
        "redirect": {
            "agency": "agency",
            "publicSource": {
                "sourceEndpoint": {
                    "master":["http://bucket1.xxx.yyy.com", "https://bucket2.xxx.yyy.com"],
                    "slave": ["http://bucket3.xxx.yyy.com", "https://bucket4.xxx.yyy.com"]
                }
            },
            "retryConditions": ["4XX", "5XX"],
            "passQueryString": true,
            "mirrorFollowRedirect": true,
            "redirectWithoutReferer": true,
            "mirrorAllowHttpMethod":["HEAD"],
            "mirrorHttpHeader": {
                "passAll": false,
                "pass": ["content-encoding"],
                "remove": ["content-type"],
                "set": [{
                    "key": "helloworld",
                    "value": "2222"
                }]
            },
            "replaceKeyWith": "prefix${key}suffix",
            "replaceKeyPrefixWith": "picture/",
            "vpcEndpointURN": "001"
        }
    }]
}

Resposta de exemplo

HTTP/1.1 201 Created
Server: OBS
Date: Tue, 07 Jul 2020 07:29:13 GMT
Content-Length: 0

Tópico principal: Configurações avançadas de bucket

Tópico anterior: Exclusão da política de leitura direta para objetos de Arquivo em um bucket

Próximo tópico: Obtenção de regras de volta à fonte do espelhamento

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar