Todos os produtos
Search
Central de documentação

Object Storage Service:put-bucket-archive-direct-read

Última atualização: Sep 22, 2026

O comando put-bucket-archive-direct-read permite ativar ou desativar o acesso em tempo real a objetos do tipo Archive em buckets do OSS.

Notas de uso

Por padrão, uma conta do Alibaba Cloud tem permissões para ativar ou desativar o acesso em tempo real a objetos do tipo Archive em buckets do OSS. Executar essas operações como um usuário da RAM ou por meio do Security Token Service (STS) requer a permissão oss:PutBucketArchiveDirectRead. Para mais informações, consulte Conceder uma política personalizada.

Sintaxe do comando

ossutil api put-bucket-archive-direct-read --bucket value --archive-direct-read-configuration value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--archive-direct-read-configuration

string

Configuração para acesso em tempo real a objetos do tipo Archive.

Nota

O comando put-bucket-archive-direct-read corresponde à operação PutBucketArchiveDirectRead. Para mais informações sobre os parâmetros dessa operação, consulte PutBucketArchiveDirectRead.

--archive-direct-read-configuration

A opção --archive-direct-read-configuration aceita os formatos XML e JSON. Caso o valor informado inclua o prefixo file://, a ferramenta lê os parâmetros de configuração diretamente do arquivo especificado.

  • Formato XML:

    <ArchiveDirectReadConfiguration>
        <Enabled>string</Enabled>
    </ArchiveDirectReadConfiguration>
  • Formato JSON:

    {
      "Enabled": "string"
    }
Nota

Para mais informações sobre as opções de linha de comando globais compatíveis, consulte Opções de linha de comando.

Exemplos

Ative o acesso em tempo real a objetos do tipo Archive no examplebucket.

  • Crie um arquivo de configuração chamado archive-direct-read-configuration.xml e adicione o código a seguir:

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

    Comando de exemplo:

    ossutil api put-bucket-archive-direct-read --bucket examplebucket --archive-direct-read-configuration file://archive-direct-read-configuration.xml
  • Crie um arquivo de configuração chamado archive-direct-read-configuration.json e adicione o código a seguir:

    {
      "Enabled": "true"
    }

    Comando de exemplo:

    ossutil api put-bucket-archive-direct-read --bucket examplebucket --archive-direct-read-configuration file://archive-direct-read-configuration.json
  • Configure os parâmetros do comando a seguir no formato JSON:

    ossutil api put-bucket-archive-direct-read --bucket examplebucket --archive-direct-read-configuration "{\"Enabled\":\"true\"}"