Ative ou desative a leitura direta do Archive para um bucket.
Notas de uso
Requer a permissão
oss:PutBucketArchiveDirectRead. Para mais informações, consulte Grant a custom policy.Cada região tem seu próprio endpoint do OSS. Para obter mais informações sobre regiões e endpoints, consulte Regions and endpoints.
Com a leitura direta do Archive ativada, o acesso a objetos Archive não restaurados incorre em taxas de recuperação de dados (RetrievalDataArchiveDirect) com base no tamanho dos dados. Não há cobrança de taxas de recuperação para objetos Archive restaurados. Para mais detalhes, consulte Data processing fees.
Sintaxe da requisiçã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 requisição
Esta operação usa apenas Common HTTP headers.
Elementos da requisição
|
Elemento |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
ArchiveDirectReadConfiguration |
Contêiner |
Sim |
N/A |
Contêiner para a configuração de leitura direta do Archive. |
|
Enabled |
Booleano |
Sim |
true |
Define se a leitura direta do Archive está ativada para o bucket. Valores válidos:
|
Cabeçalhos da resposta
Esta operação retorna apenas Common HTTP headers.
Exemplos
-
Exemplo de requisiçã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.