Todos os produtos
Search
Central de documentação

Object Storage Service:access-monitor

Última atualização: Sep 22, 2026

Você pode configurar regras de ciclo de vida com base no último horário de acesso dos objetos para monitorar automaticamente o padrão de acesso dos objetos em um bucket, identificar dados frios e converter a classe de armazenamento desses dados. Isso ajuda a reduzir custos de armazenamento. Antes de configurar uma regra de ciclo de vida baseada no último horário de acesso dos objetos em um bucket, execute o comando access-monitor para ativar o rastreamento de acesso no bucket.

Observações de uso

  • Para ativar o rastreamento de acesso, você precisa da permissão oss:PutBucketAccessMonitor. Para consultar as configurações de rastreamento de acesso de um bucket, você precisa da permissão oss:GetBucketAccessMonitor. Para obter mais informações, consulte Grant a custom policy.

  • A partir do ossutil 1.6.16, é possível usar diretamente ossutil como nome do binário na linha de comando, sem necessidade de atualizar o nome do binário conforme o sistema operacional. Para versões anteriores ao ossutil 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para obter mais informações, consulte ossutil command reference.

  • Apenas o ossutil 1.7.15 e versões posteriores oferecem suporte ao comando access-monitor.

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 mencionados.

    Parâmetro

    Descrição

    bucketname

    Nome do bucket para o qual você deseja configurar o rastreamento de acesso.

    local_xml_file

    Nome do arquivo local usado para configurar o rastreamento de acesso. Exemplo: config.xml.

  • Exemplos

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

      • Ativar 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

      A seguinte 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 mencionados.

    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 usado para armazenar as configurações de rastreamento de acesso. Exemplo: local.xml. Caso esse parâmetro não seja especificado, as configurações de rastreamento de acesso serão exibidas diretamente.

  • Exemplos

    • O exemplo a seguir mostra como consultar e exibir as configurações de rastreamento de acesso de um bucket chamado examplebucket:

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

      A seguinte saída é retornada:

      <?xml version="1.0" encoding="UTF-8"?>
      <AccessMonitorConfiguration>
        <Status>Enabled</Status>
      </AccessMonitorConfiguration>
      
      0.154689(s) elapsed
    • O exemplo a seguir demonstra como consultar as configurações de rastreamento de acesso de um bucket chamado examplebucket e armazená-las no arquivo local.xml:

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

      A seguinte saída é retornada:

      • O resultado exibido é:

        0.214483(s) elapsed
      • O arquivo local.xml contém o seguinte conteúdo:

        <?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 com base no último horário de acesso dos objetos para converter a classe de armazenamento dos dados frios. Isso reduz custos de armazenamento. Para obter mais informações, consulte lifecycle.