put-user-defined-log-fields-config - Object Storage Service: Central de Documentação do Alibaba Cloud

Configure campos de log personalizados em tempo real e permite adicionar cabeçalhos de requisição ou parâmetros de consulta personalizados como campos de log, o que facilita a análise posterior dos dados de requisição.

Notas

Por padrão, uma conta Alibaba Cloud tem as permissões para configurar campos de log personalizados. Configurar como usuário RAM ou ao usar o Security Token Service (STS) requer a permissão oss:PutUserDefinedLogFieldsConfig. Para obter mais instruções, consulte grant custom policy to RAM user.

Sintaxe

ossutil api put-user-defined-log-fields-config --bucket value --user-defined-log-fields-configuration value [flags]

Parâmetro	Tipo	Descrição
--bucket	string	Nome do bucket.
--user-defined-log-fields-configuration	string	O contêiner que armazena a configuração de log especificada.

Nota

O comando put-user-defined-log-fields-config corresponde à API PutUserDefinedLogFieldsConfig. Para consultar os significados específicos dos parâmetros da API, consulte PutUserDefinedLogFieldsConfig.

--user-defined-log-fields-configuration

A opção --user-defined-log-fields-configuration aceita as sintaxes XML e JSON. Se o valor da opção incluir o prefixo "file://", o sistema carrega as configurações a partir de um arquivo específico.

Sintaxe XML:

<HeaderSet>
  <header>string</header>
  ...
</HeaderSet>
<ParamSet>
  <parameter>string</parameter>
  ...
</ParamSet>

Sintaxe JSON:

{
  "HeaderSet": {
    "header": ["string", ...]
  },
  "ParamSet": {
    "parameter": ["string", ...]
  }
}

Nota

Para consultar as opções globais de linha de comando compatíveis, consulte supported global command line options.

Exemplos

Personalize o campo user_defined_log_fields em tempo real. Para isso, adicione cabeçalhos de requisição ou parâmetros de consulta personalizados para analisar posteriormente as requisições enviadas ao examplebucket.

Crie um arquivo de configuração chamado user-defined-log-fields-configuration.xml e adicione o seguinte código:

<?xml version="1.0" encoding="UTF-8"?>
<UserDefinedLogFieldsConfiguration>
  <HeaderSet>
     <header>header1</header>
     <header>header2</header>
     <header>header3</header>
  </HeaderSet>
  <ParamSet>
     <parameter>param1</parameter>
     <parameter>param2</parameter>
  </ParamSet>
</UserDefinedLogFieldsConfiguration>

Exemplo:

ossutil api put-user-defined-log-fields-config --bucket examplebucket --user-defined-log-fields-configuration file://user-defined-log-fields-configuration.xml

Crie um arquivo de configuração chamado user-defined-log-fields-configuration.json e insira o código abaixo:

{
  "HeaderSet": {
    "header": [
      "header1",
      "header2",
      "header3"
    ]
  },
  "ParamSet": {
    "parameter": [
      "param1",
      "param2"
    ]
  }
}

Exemplo:

ossutil api put-user-defined-log-fields-config --bucket examplebucket --user-defined-log-fields-configuration file://user-defined-log-fields-configuration.json

Configure os parâmetros no seguinte comando usando o formato JSON:

ossutil api put-user-defined-log-fields-config --bucket examplebucket --user-defined-log-fields-configuration "{\"HeaderSet\":{\"header\":[\"header1\",\"header2\",\"header3\"]},\"ParamSet\":{\"parameter\":[\"param1\",\"param2\"]}}"