# mon-put-data
<a name="cli-mon-put-data"></a>

## Descrição
<a name="w2aab9c47b3"></a>

Adicione pontos de dados de métrica à métrica especificada. Essa chamada colocará dados de série temporal para o valor bruto ou valores estatísticos válidos de um determinado nome da métrica. Ele oferece suporte à entrada de um único ponto de dados por vez.

**nota**  
Quando você cria uma nova métrica usando o comando `mon-put-data`, pode levar até dois minutos para recuperar estatísticas na nova métrica usando o comando `mon-get-stats`. No entanto, pode levar até 15 minutos para que a nova métrica seja exibida na lista de métricas recuperadas com o comando `mon-list-metrics`.

## Sintaxe
<a name="w2aab9c47b5"></a>

 ****mon-put-data** --metric-name {{value}}[--namespace {{value}} [--dimensions "key1={{value1}},key2={{value2}}..."] [--statisticValues "key1={{value1}},key2={{value2}}..."] [--timestamp {{value}}] [--unit {{value}}] [--value {{value}}] [Common Options] ** 

## Opções
<a name="w2aab9c47b7"></a>


| Name (Nome) | Descrição | 
| --- | --- | 
| -d, --dimensions "key1=value1,key2=value2..." ``  | As dimensões que identificam com exclusividade os dados da métrica. Especifique dimensões de duas maneiras, e os formatos podem ser combinados ou usados de maneira intercambiável:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/cli/cli-mon-put-data.html)<br />Tipo: mapa<br />Valores válidos: uma string do formato nome = valor, em que a chave é o nome da dimensão e o valor é o valor da dimensão. Os nomes de dimensão e os valores devem ser uma string ANSI entre 1 e 250 caracteres. Um máximo de 10 dimensões é permitido.<br />Padrão: n/d<br />Obrigatório: não | 
| `-m, --metric-name` `VALUE1,VALUE2,VALUE3...`  | O nome da métrica.<br />Tipo: string<br />Valores válidos: qualquer nome da métrica válido entre 1 e 250 caracteres.<br />Padrão: n/d<br />Obrigatório: sim | 
| `n, --namespace` `VALUE`  | O namespace da métrica. Para obter mais informações sobre namespaces, consulte [Namespaces do AWS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html).<br />Tipo: string<br />Valores válidos: uma string ANSI entre 1 e 250 caracteres de comprimento.<br />Padrão: n/d<br />Obrigatório: sim | 
| `-s, --statistic` `Values "key1=value1,key2=value2..."`  | As estatísticas a serem armazenadas para o time stamp e a métrica especificados. Essa opção é exclusiva com `--value`. Pelo menos um `--statisticValue` ou `--value` deve ser especificado.<br />Tipo: mapa<br />Valores válidos: uma string contendo todos os valores duplos para todos os nomes de estatísticas: SampleCount, Sum, Maximum e Minimum. Todos esses valores devem ser um valor entre 1E-130 e 1E130.<br />Padrão: n/d<br />Obrigatório: sim | 
| `-t, --timestamp` `VALUE`  | O time stamp do ponto de dados ou a observação da métrica a ser registrado. Os time stamps são especificados usando-se o formato combinado ISO8601. Por exemplo, a data e a hora em 30 de julho de 2013, 12:30:00 PST, seriam representadas como 2013-07-30T12:30:00-07:00 ou em UTC: 2013-07-30T19:30:00Z.<br />Tipo: simples<br />Valores válidos: um time stamp válido representado no formato ISO8601 com diferença de fuso horário ou indicador UTC.<br />Padrão: a hora UTC atual.<br />Obrigatório: não | 
| `-u, --unit` `VALUE`  | A unidade da métrica.<br />Tipo: enumeração<br />Valores válidos: um dos seguintes:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/cli/cli-mon-put-data.html)<br />Padrão: n/d<br />Obrigatório: não | 
| `-v, --value` `VALUE`  | Um único valor a ser registrado. O valor é convertido em um conjunto de estatísticas do formulário: SampleCount=1, Sum=VALUE, Minimum=VALUE, Maximum=VALUE. Essa opção é exclusiva de `--statisticValues`.<br />Tipo: simples<br />Valores válidos: todos os valores devem ser um número entre 1E-130 e 1E130.<br />Padrão: n/d<br />Obrigatório: sim | 

## Opções comuns
<a name="w2aab9c47b9"></a>


| Nome | Descrição | 
| --- | --- | 
| `--aws-credential-file` `VALUE`  | O local do arquivo com suas credenciais da AWS. É possível definir esse valor usando a variável de ambiente `AWS_CREDENTIAL_FILE`. Se você definir a variável de ambiente ou fornecer o caminho para o arquivo de credenciais, a solicitação falhará caso o arquivo não exista. Todas as solicitações do CloudWatch deverão ser assinadas usando seu ID da chave de acesso e sua chave de acesso secreta.<br />Tipo: string<br />Valores válidos: um caminho válido para um arquivo contendo seu ID da chave de acesso e sua chave de acesso secreta.<br />Padrão: usa a variável de ambiente `AWS_CREDENTIAL_FILE`, se estiver definida. | 
| `-C, --ec2-cert-file-path` `VALUE`  | O local do arquivo de certificado do EC2 para solicitações de assinatura. É possível usar a variável de ambiente `EC2_CERT` para especificar esse valor.<br />Tipo: string<br />Valores válidos: um caminho de arquivo válido para o arquivo PEM fornecido pelo Amazon EC2 ou pelo AWS Identity and Access Management.<br />Padrão: usa a variável de ambiente `EC2_CERT`, se estiver definida. | 
|  `--connection-timeout` `VALUE`  | O valor de tempo limite de conexão, em segundos.<br />Tipo: inteiro<br />Valores válidos: qualquer número positivo.<br />Padrão: 30 | 
|  `--delimiter` `VALUE`  | O delimitador a ser usado quando são exibidos resultados delimitados (longos).<br />Tipo: string<br />Valores válidos: qualquer string.<br />Padrão: vírgula (,) | 
|  `--headers` ``  | Se estiver exibindo resultados tabulares ou delimitados, inclua os cabeçalhos de coluna. Se estiver exibindo resultados em XML, retorne os cabeçalhos HTTP da solicitação de serviço, quando aplicável.<br />Tipo: sinalizador<br />Valores válidos: quando presente, exibe cabeçalhos.<br />Padrão: a opção `--headers` fica desativada por padrão. | 
|  `-I, --access-key-id` `VALUE`  | O ID da chave de acesso que será usada, em conjunto com a chave secreta, para assinar a solicitação. Esse parâmetro deverá ser usado em conjunto com --secret-key, ou a opção será ignorada. Todas as solicitações para o CloudWatch deverão ser assinadas, ou a solicitação será rejeitada.<br />Tipo: string<br />Valores válidos: um ID da chave de acesso válido.<br />Padrão: nenhum | 
|  `-K, --ec2-private-key-file-path` `VALUE`  | A chave privada que será usada para assinar a solicitação. Utilizar chaves públicas/privadas faz com que a CLI use SOAP. A solicitação é assinada com um certificado público e uma chave privada. Esse parâmetro deverá ser usado em conjunto com `EC2_CERT`, ou o valor será ignorado. O valor da variável de ambiente `EC2_PRIVATE_KEY` será usado se estiver definido e se essa opção não estiver especificada. Essa opção será ignorada se a variável de ambiente `AWS_CREDENTIAL_FILE` estiver definida ou quando se utilizar `--aws-credentials-file`. Todas as solicitações para o CloudWatch deverão ser assinadas, ou a solicitação será rejeitada.<br />Tipo: string<br />Valores válidos: o caminho para uma chave privada ASN.1 válida.<br />Padrão: nenhum | 
|  `--region` `VALUE`  | A região para onde as solicitações são direcionadas. É possível usar a variável de ambiente `EC2_REGION` para especificar o valor. Utiliza-se a região para criar a URL usada para chamar o CloudWatch e deve ser uma região da Amazon Web Services válida (AWS).<br />Tipo: string<br />Valores válidos: qualquer região da AWS, por exemplo, us-east-1.<br />Padrão: us-east-1, a menos que a variável de ambiente `EC2_REGION` esteja definida. | 
|  `S, --secret-key` `VALUE`  | A chave de acesso secreta que será usada para assinar a solicitação, em conjunto com a ID da chave de acesso. Esse parâmetro deverá ser usado em conjunto com `--access-key-id`, ou essa opção será ignorada.<br />Tipo: string<br />Valores válidos: seu ID da chave de acesso.<br />Padrão: nenhum | 
|  `--show-empty-fields` ``  | Exibe campos vazios usando (nil) como espaço reservado para indicar que esses dados não foram solicitados.<br />Tipo: sinalizador<br />Valores válidos: nenhum<br />Padrão: campos vazios não são exibidos por padrão. | 
|  `--show-request` ``  | Exibe a URL que a CLI usa para chamar a AWS.<br />Tipo: sinalizador<br />Valores válidos: nenhum<br />Padrão: Falso | 
|  `--show-table, --show-long, --show-xml, --quiet` ``  | Especifica como os resultados são exibidos: em uma tabela, delimitados (longos), XML ou nenhuma saída (silenciosos). A exibição `--show-table` mostra um subconjunto dos dados em forma fixa de largura de coluna; `--show-long` exibe todos os valores retornados delimitados por um caractere; `--show-xml` é o retorno bruto do serviço; e `--quiet` suprime todas as saídas padrão. Todas as opções são mutuamente exclusivas, tendo prioridade `--show-table`, `--show-long`, `--show-xml` e `--quiet`.<br />Tipo: sinalizador<br />Valores válidos: nenhum<br />Padrão: `--show-table` | 
|  `-U, --url` `VALUE`  | A URL usada para entrar em contato com o CloudWatch. É possível definir esse valor usando a variável de ambiente `AWS_CLOUDWATCH_URL`. Esse valor é usado em conjunto com `--region` para criar a URL esperada. Essa opção substitui a URL da chamada de serviço.<br />Tipo: string<br />Valores válidos: uma URL HTTP ou HTTPS válida.<br />Padrão: usa o valor especificado em `AWS_CLOUDWATCH_URL`, se estiver definido. | 

## Output
<a name="w2aab9c47c11"></a>

Esse comando adiciona pontos de dados de métrica a uma métrica.

A CLI do Amazon CloudWatch exibe erros em stderr.

## Exemplos
<a name="w2aab9c47c13"></a>

### Exemplo de solicitação
<a name="w2aab9c47c13b2"></a>

Esse exemplo coloca dados estatísticos de `RequestCount` no namespace `MyService`. A métrica não contém dimensões e, assim, representa o RequestCount geral em todo o serviço. A medição é um statisticValue pré-agregado representando cinco medições anteriores cujo máximo era 70, cujo mínimo era 30 e cuja soma era 250.

```
mon-put-data --metric-name RequestCount --namespace "MyService" --timestamp 2013-11-25T00:00:00.000Z --statisticValues "Sum=250,Minimum=30,Maximum=70,SampleCount=5"
```

### Exemplo de solicitação
<a name="w2aab9c47c13b4"></a>

Esse exemplo coloca dados de teste `RequestCount` específicos do usuário no namespace `MyService`. O usuário e o nome da pilha são armazenados como dimensões para diferenciar essa métrica da métrica em todo o serviço no exemplo acima.

```
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50
```

## Tópicos relacionados
<a name="w2aab9c47c15"></a>

### Baixar
<a name="w2aab9c47c15b2"></a>
+ [Configurar a interface de linha de comando](SetupCLI.md)

### Ação relacionada
<a name="w2aab9c47c15b4"></a>
+ [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)

### Comando relacionado
<a name="w2aab9c47c15b6"></a>
+  [mon-put-metric-alarm](cli-mon-put-metric-alarm.md)