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/ Definição da política de leitura direta para objetos de Arquivo em um bucket
Atualizado em 2022-11-07 GMT+08:00

Definição da política de leitura direta para objetos de Arquivo em um bucket

Funções

A função de leitura direta de objetos Arquivo significa que um usuário pode executar operações diretamente nos objetos Arquivo sem restaurá-los.

Por padrão, a função de leitura direta é desativada em um bucket.

Essa API ativa ou desativa a função de leitura direta para objetos Arquivo de um bucket.

  • Quando a função está Enabled:
    • Você pode executar operações diretamente nos objetos Arquivo de um bucket, independentemente de terem sido restaurados.
    • Se os objetos Arquivo não forem restaurados, suas operações neles serão cobradas separadamente.
  • Quando a função estiver Disabled:
    • Você precisa restaurar os objetos Arquivo antes de executar qualquer operação neles.

Para executar essa operação, você deve ter a permissão PutDirectColdAccessConfiguration. Por padrão, somente o proprietário do bucket pode executar essa operação. O proprietário do bucket pode conceder a permissão a outros usuários configurando a política do bucket ou a política do usuário.

A função de leitura direta está disponível apenas nas seguintes regiões: CN Norte-Pequim1, CN Leste-Xangai2, CN Sul-Guangzhou.

Sintaxe da solicitação

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
PUT /?directcoldaccess HTTP/1.1 
Host: examplebucket.obs.region.myhuaweicloud.com
Date: date
Authorization: authorization
Content-SHA256: SHA256
Content-Length: length

<DirectColdAccessConfiguration>     
    <Status>status</Status> 
</DirectColdAccessConfiguration>

Parâmetros de solicitação

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

Cabeçalhos de solicitação

Tabela 1 lista o cabeçalho da solicitação.

Tabela 1 Cabeçalhos de solicitação

Cabeçalho

Descrição

Obrigatório

Content-SHA256

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

Tipo: string

Exemplo: ogX9qClMrVJUBiUSIKDFM0qO41jJM0I5SCN55/OtMyI=

Sim

Elementos de solicitação

Esta solicitação contém elementos para configurar o status de leitura direta de objetos Arquivo no formato XML. Tabela 2 lista os elementos da solicitação.

Tabela 2 Solicitar elementos necessários para configurar o status de leitura direta para objetos Arquivo

Elemento

Descrição

Obrigatório

DirectColdAccessConfiguration

Nó raiz para a configuração da função de leitura direta para objetos Arquivo

Antepassado: nenhum

Sim

Status

Indica o status de leitura direta de objetos Arquivo de um bucket.

Tipo: enumeração

Antepassado: DirectColdAccessConfiguration

Opções de valor: Enabled, Disabled

Sim

Sintaxe da resposta

1
2
3
4
HTTP/1.1 status_code
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.

Solicitação de exemplo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
PUT /?directcoldaccess HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Date: Fri, 26 Apr 2019 07:37:36 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:sc2PM13Wlfcoc/YZLK0MwsI2Zpo=
Content-SHA256: ogX9qClMrVJUBiUSIKDFM0qO41jJM0I5SCN55/OtMyI=
Content-Length: 92

<DirectColdAccessConfiguration>
    <Status>Enabled</Status>
</DirectColdAccessConfiguration>

Resposta de exemplo

1
2
3
4
5
6
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 0000016A58940244809DEF00122E6802
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCStOlo1yxthHHo2GlS3WGgt1ekAIh3Vy
Date: Fri, 26 Apr 2019 07:37:36 GMT
Content-Length: 0