Todos os produtos
Search
Central de documentação

Object Storage Service:put-bucket-access-monitor

Última atualização: Jul 03, 2026

Ative ou desative o rastreamento de acesso a um bucket.

Observações de uso

Por padrão, uma conta Alibaba Cloud tem permissão para ativar ou desativar o rastreamento de acesso a um bucket. Para executar essa operação com um usuário RAM ou o Security Token Service (STS), é necessária 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

Nome do bucket.

--access-monitor-configuration

string

Configurações de rastreamento de acesso do bucket.

Nota

O comando put-bucket-access-monitor corresponde à operação PutBucketAccessMonitor. Para obter detalhes sobre os parâmetros dessa operação, consulte PutBucketAccessMonitor.

--access-monitor-configuration

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

  • Formato XML:

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

    {
      "Status": "string"
    }
Nota

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

Exemplos

Os exemplos a seguir mostram como ativar o rastreamento de acesso para um bucket chamado examplebucket.

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

    <?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 chamado access-monitor-configuration.json e adicione o seguinte código:

    {
      "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 diretamente no comando usando o formato JSON:

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