Todos os produtos
Search
Central de documentação

Object Storage Service:access-monitor

Última atualização: Jul 03, 2026

Configure regras de ciclo de vida com base no último acesso aos objetos para monitorar automaticamente os padrões de acesso em um bucket, identificar dados frios e converter a classe de armazenamento desses dados. Essa prática ajuda a reduzir custos de armazenamento. Antes de configurar uma regra de ciclo de vida baseada no último acesso dos objetos em um bucket, execute o comando access-monitor para ativar o rastreamento de acesso do bucket.

Observações de uso

  • Para ativar o rastreamento de acesso, é necessária a permissão oss:PutBucketAccessMonitor. Para consultar as configurações de rastreamento de acesso de um bucket, é necessária a permissão oss:GetBucketAccessMonitor. Para mais informações, consulte Conceder uma política personalizada.

  • No ossutil 1.6.16 e versões posteriores, use diretamente ossutil como nome do binário na linha de comando, sem necessidade de alterá-lo conforme o sistema operacional. Em versões anteriores à 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para mais informações, consulte Guia de início rápido da ferramenta de linha de comando ossutil.

  • O comando access-monitor está disponível apenas no ossutil 1.7.15 ou superior.

Configure o rastreamento de acesso

  • Sintaxe do comando

    ossutil access-monitor --method put oss://bucketname/ local_xml_file

    A tabela a seguir descreve os parâmetros anteriores.

    Parâmetro

    Descrição

    bucketname

    Nome do bucket no qual você deseja configure o rastreamento de acesso.

    local_xml_file

    Nome do arquivo local usado para definir as configurações de rastreamento de acesso. Exemplo: config.xml.

  • Exemplos

    1. Ative ou desative o rastreamento de acesso usando um arquivo XML local.

      • Ative o rastreamento de acesso

        <?xml version="1.0" encoding="UTF-8"?>
        <AccessMonitorConfiguration>
            <Status>Enabled</Status>
        </AccessMonitorConfiguration>
      • Desativar o rastreamento de acesso

        <?xml version="1.0" encoding="UTF-8"?>
        <AccessMonitorConfiguration>
            <Status>Disabled</Status>
        </AccessMonitorConfiguration>
    2. Configure o rastreamento de acesso para um bucket chamado examplebucket.

      ossutil access-monitor --method put oss://examplebucket/ config.xml

      Saída retornada:

      0.299514(s) elapsed

Consultar configurações de rastreamento de acesso

  • Sintaxe do comando

    ossutil access-monitor --method get oss://bucketname [local_xml_file]

    A tabela a seguir descreve os parâmetros anteriores.

    Parâmetro

    Descrição

    bucketname

    Nome do bucket cujas configurações de rastreamento de acesso você deseja consultar.

    local_xml_file

    Nome do arquivo local destinado a armazenar as configurações de rastreamento de acesso. Exemplo: local.xml. Se este parâmetro não for especificado, as configurações serão exibidas diretamente.

  • Exemplos

    • Consulte e exiba as configurações de rastreamento de acesso de um bucket chamado examplebucket:

      ossutil access-monitor --method get oss://examplebucket

      Saída retornada:

      <?xml version="1.0" encoding="UTF-8"?>
      <AccessMonitorConfiguration>
        <Status>Enabled</Status>
      </AccessMonitorConfiguration>
      
      0.154689(s) elapsed
    • Consulte as configurações de rastreamento de acesso do bucket examplebucket e salve-as no arquivo local.xml:

      ossutil access-monitor --method get oss://examplebucket/ local.xml

      Saída retornada:

      • Resultado exibido no console:

        0.214483(s) elapsed
      • Conteúdo gravado no arquivo local.xml:

        <?xml version="1.0" encoding="UTF-8"?>
        <AccessMonitorConfiguration>
          <Status>Enabled</Status>
        </AccessMonitorConfiguration>

Próximas etapas

Após ativar o rastreamento de acesso, configure regras de ciclo de vida baseadas no último acesso aos objetos para converter a classe de armazenamento dos dados frios e reduzir custos. Para mais informações, consulte Ciclo de vida.