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

Configure campos de log definidos pelo usuário em tempo real. Esse recurso permite adicionar cabeçalhos de solicitação ou parâmetros de consulta personalizados como campos de log para facilitar a análise posterior dos dados da solicitação.

Observações

Por padrão, uma conta Alibaba Cloud tem permissão para configurar campos de log personalizados. Para configurar esses campos como um usuário RAM ou com o Security Token Service (STS), é necessária a permissão oss:PutUserDefinedLogFieldsConfig. Para obter mais instruções, consulte conceder política personalizada ao usuário RAM.

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	Contêiner que armazena a configuração de log especificada.

Nota

O comando put-user-defined-log-fields-config corresponde à interface da API PutUserDefinedLogFieldsConfig. Para consultar os significados específicos dos parâmetros na API, veja 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 contiver o prefixo "file://", o sistema carregará as configurações 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 ver as opções globais de linha de comando compatíveis, consulte opções globais de linha de comando suportadas.

Exemplos

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

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

<?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 adicione o seguinte código a ele:

{
  "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

Defina os parâmetros diretamente no 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\"]}}"