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.

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.

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