# mon-describe-alarms-for-metric ## Descrição Obtém informações sobre os alarmes associados com a métrica especificada. ## Sintaxe ****mon-describe-alarms-for-metric** --metric-name {{value}} --namespace {{value}} [--dimensions "key1={{value1}},key2={{value2}}..."] [--period {{value}}] [--statistic {{value}}] [--extendedstatistic {{value}}] [--unit {{value}}] [Common Options] ** ## Opções | Name (Nome) | Descrição | | --- | --- | | `--dimensions` `- "key1=value1,key2=value2...` | As dimensões associadas à 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-describe-alarms-for-metric.html)
Tipo: mapa
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.
Padrão: n/d
Obrigatório: não | | `--metric-name` `VALUE` | O nome da métrica cujos alarmes associados você deseja procurar.
Tipo: argumento
Valores válidos: um nome da métrica válido entre 1 e 255 caracteres de comprimento.
Padrão: n/d
Obrigatório: sim | | `--namespace` `VALUE` | O namespace da métrica associada ao alarme. Para obter mais informações sobre namespaces, consulte [Namespaces do AWS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html).
Tipo: string
Valores válidos: um namespace válido entre 1 e 250 caracteres de comprimento.
Padrão: n/d
Obrigatório: sim | | `--period` `VALUE` | O período para filtrar alarmes. Somente alarmes que avaliam métricas nesse período serão incluídos nos resultados. Se isso não for especificado, os alarmes em qualquer período serão incluídos.
Tipo: argumento
Valores válidos: um número, em segundos, que seja um múltiplo de 60 segundos.
Padrão: n/d
Obrigatório: não | | `--statistic` `VALUE` | A estatística para filtrar alarmes. Somente alarmes da estatística especificada serão incluídos. Se esse parâmetro não for especificado, serão incluídos os alarmes de qualquer estatística.
Tipo: enumeração
Valores válidos: SampleCount, Average, Sum, Minimum ou Maximum
Padrão: n/d
Obrigatório: não | | `--extendedstatistic` `VALUE` | A estatística de percentil para filtrar alarmes. Somente alarmes da estatística especificada serão incluídos. Se esse parâmetro não for especificado, serão incluídos os alarmes de qualquer estatística.
Tipo: string
Valores válidos: qualquer percentil, com até duas casas decimais (por exemplo, p95.45).
Padrão: n/d
Obrigatório: não | | `--unit` `VALUE` | A unidade para filtrar os alarmes. Somente alarmes nas estatísticas especificadas serão incluídos. Se isso não for especificado, os alarmes em qualquer unidade serão incluídos. Se o alarme não tiver uma unidade especificada, a única maneira de procurar o alarme será omitir essa opção.
Tipo: enumeração
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-describe-alarms-for-metric.html)
Padrão: n/d
Obrigatório: não | ## Opções comuns | 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.
Tipo: string
Valores válidos: um caminho válido para um arquivo contendo seu ID da chave de acesso e sua chave de acesso secreta.
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.
Tipo: string
Valores válidos: um caminho de arquivo válido para o arquivo PEM fornecido pelo Amazon EC2 ou pelo AWS Identity and Access Management.
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.
Tipo: inteiro
Valores válidos: qualquer número positivo.
Padrão: 30 | | `--delimiter` `VALUE` | O delimitador a ser usado quando são exibidos resultados delimitados (longos).
Tipo: string
Valores válidos: qualquer string.
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.
Tipo: sinalizador
Valores válidos: quando presente, exibe cabeçalhos.
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.
Tipo: string
Valores válidos: um ID da chave de acesso válido.
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.
Tipo: string
Valores válidos: o caminho para uma chave privada ASN.1 válida.
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).
Tipo: string
Valores válidos: qualquer região da AWS, por exemplo, us-east-1.
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.
Tipo: string
Valores válidos: seu ID da chave de acesso.
Padrão: nenhum | | `--show-empty-fields` `` | Exibe campos vazios usando (nil) como espaço reservado para indicar que esses dados não foram solicitados.
Tipo: sinalizador
Valores válidos: nenhum
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.
Tipo: sinalizador
Valores válidos: nenhum
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`.
Tipo: sinalizador
Valores válidos: nenhum
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.
Tipo: string
Valores válidos: uma URL HTTP ou HTTPS válida.
Padrão: usa o valor especificado em `AWS_CLOUDWATCH_URL`, se estiver definido. | ## Output Esse comando retorna uma tabela que contém o seguinte: + ALARM: nome do alarme. + DESCRIPTION: a descrição do alarme. Essa coluna só é mostrada na exibição --show-long. + STATE: o estado do alarme. + STATE\_REASON: uma razão legível por humano do estado. Essa coluna só é mostrada na exibição --show-long. + STATE\_REASON\_DATA: uma razão legível por máquina para o estado (formato JSON). Essa coluna só é mostrada na exibição --show-long. + ENABLED: habilita ou desabilita ações. Essa coluna só é mostrada na exibição --show-long. + OK\_ACTIONS: a ação a ser executada no status OK. Essa coluna só é mostrada na exibição --show-long. + ALARM\_ACTIONS: a ação a ser executada no status ALARM. + INSUFFICIENT\_DATA\_ACTIONS: a ação a ser executada no status INSUFICIENT\_DATA. Essa coluna só é mostrada na exibição --show-long. + NAMESPACE: um namespace da métrica. + METRIC\_NAME: o nome da métrica. + DIMENSIONS: as dimensões da métrica. Essa coluna só é mostrada na exibição --show-long. + PERIOD: o período. + STATISTIC: a estatística (Average, Minimum, Maximum, Sum e SampleCount). + EXTENDEDSSTATISTIC: a estatística de percentil. + UNIT: a unidade. Essa coluna só é mostrada na exibição --show-long. + EVAL\_PERIODS: o número de períodos para avaliar a métrica. + COMPARISON: o operador de comparação. + THRESHOLD: o limite. A CLI do Amazon CloudWatch exibe erros em stderr. ## Exemplos ### Exemplo de solicitação Este exemplo descreve um alarme para uma determinada métrica. ``` mon-describe-alarms-for-metric--metric-name CPUUtilization --namespace AWS/EC2 --dimensions InstanceId=i-abcdef ``` Essa é uma saída de exemplo desse comando. ``` ALARM STATE ALARM_ACTIONS NAMESPACE METRIC_NAME PERIOD STATISTIC EVAL_PERIODS COMPARISON THRESHOLD my-alarm1 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 3 GreaterThanThreshold 100.0 my-alarm2 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 5 GreaterThanThreshold 80.0 ``` ## Tópicos relacionados ### Baixar + [Configurar a interface de linha de comando](SetupCLI.md) ### Ação relacionada + [DescribeAlarmForMetric](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmsForMetric.html) ### Comandos relacionados + [mon-describe-alarm-history](cli-mon-describe-alarm-history.md) + [mon-describe-alarms](cli-mon-describe-alarms.md)