Todos os produtos
Search
Central de documentação

Object Storage Service:PutBucketArchiveDirectRead

Última atualização: Jul 03, 2026

Ative ou desativa a leitura direta de Archive para um bucket.

Observações de uso

  • Requer a permissão oss:PutBucketArchiveDirectRead. Para mais informações, consulte Conceder uma política personalizada.

  • Cada região tem seu próprio endpoint do OSS. Para obter detalhes sobre regiões e endpoints, consulte Regiões e endpoints.

  • Com a leitura direta de Archive ativada, o acesso a objetos Archive não restaurados gera taxas de recuperação de dados (RetrievalDataArchiveDirect) proporcionais ao volume acessado. Objetos Archive já restaurados não incorrem em custos de recuperação. Para mais detalhes, consulte Taxas de processamento de dados.

Sintaxe da solicitação

PUT /?bucketArchiveDirectRead HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com

<?xml version="1.0" encoding="UTF-8"?>
<ArchiveDirectReadConfiguration>
    <Enabled>true</Enabled>
</ArchiveDirectReadConfiguration>

Cabeçalhos da solicitação

Esta operação usa apenas os Cabeçalhos HTTP comuns.

Elementos da solicitação

Elemento

Tipo

Obrigatório

Exemplo

Descrição

ArchiveDirectReadConfiguration

Contêiner

Sim

N/A

Contêiner da configuração de leitura direta de Archive.

Enabled

Booleano

Sim

true

Define se a leitura direta de Archive deve ser ativada para o bucket. Valores válidos:

  • true

  • false

Cabeçalhos da resposta

Esta operação retorna apenas os Cabeçalhos HTTP comuns.

Exemplos

  • Exemplo de solicitação

    PUT /?bucketArchiveDirectRead HTTP/1.1
    Date: Mon, 24 Apr 2023 15:56:37 GMT
    Content-Length: 60
    Content-Type: application/xml
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    
    <?xml version="1.0" encoding="UTF-8"?>
    <ArchiveDirectReadConfiguration>
        <Enabled>true</Enabled>
    </ArchiveDirectReadConfiguration>
  • Exemplo de resposta

    HTTP/1.1 200 OK
    x-oss-request-id: 534B371674E88A4D8906****
    Date: Mon, 24 Apr 2023 15:56:37 GMT
    Content-Length: 60
    Connection: keep-alive
    Server: AliyunOSS

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação PutBucketArchiveDirectRead, consulte put-bucket-archive-direct-read.