Todos os produtos
Search
Central de documentação

Object Storage Service:put-bucket-access-monitor

Última atualização: Sep 22, 2026

ative ou desative o rastreamento de acesso de um bucket.

Notas de uso

Por padrão, uma conta Alibaba Cloud tem as permissões para ativar ou desativar o rastreamento de acesso de um bucket. Para ativar ou desativar o rastreamento de acesso de um bucket usando um usuário RAM ou o Security Token Service (STS), você precisa ter a permissão oss:PutBucketAccessMonitor. Para mais informações, consulte Conceder uma política personalizada.

Sintaxe do comando

ossutil api put-bucket-access-monitor --bucket value --access-monitor-configuration value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket.

--access-monitor-configuration

string

As configurações de rastreamento de acesso do bucket.

Nota

O comando put-bucket-access-monitor corresponde à operação PutBucketAccessMonitor. Para mais informações sobre os parâmetros da operação PutBucketAccessMonitor, consulte PutBucketAccessMonitor.

--access-monitor-configuration

A opção --access-monitor-configuration aceita os formatos XML e JSON. Se o valor da opção contiver o prefixo file://, o ossutil lê as configurações a partir de um arquivo de configuração.

  • Formato XML:

    <AccessMonitorConfiguration>
      <Status>string</Status>
    </AccessMonitorConfiguration>
  • Formato JSON:

    {
      "Status": "string"
    }
Nota

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

Exemplos

Nos exemplos a seguir, ative o rastreamento de acesso para um bucket chamado examplebucket.

  • Crie um arquivo de configuração access-monitor-configuration.xml e adicione o seguinte código a ele:

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

Comando de exemplo:

ossutil api put-bucket-access-monitor --bucket examplebucket --access-monitor-configuration file://access-monitor-configuration.xml
  • Crie um arquivo de configuração access-monitor-configuration.json e adicione o seguinte código a ele:

    {
      "Status": "Enabled"
    }

    Comando de exemplo:

    ossutil api put-bucket-access-monitor --bucket examplebucket --access-monitor-configuration file://access-monitor-configuration.json
  • Configure os parâmetros no seguinte comando usando o formato JSON:

    ossutil api put-bucket-access-monitor --bucket examplebucket --access-monitor-configuration "{\"Status\":\"Enabled\"}"