mon-set-alarm-state

Descripción

Cambia temporalmente el estado de la alarma especificada. En el siguiente periodo, la alarma se establece en su estado real.

Sintaxis

mon-set-alarm-state AlarmName --state-reason value --state-value value [--state-reason-data value] [Common Options]

Opciones

Nombre	Descripción
AlarmName	El nombre de la alarma. Puede establecer también este valor mediante --alarm-name: Tipo: argumento Valores válidos: una cadena UTF-8. Valor predeterminado: n/a Obligatorio: sí
--state-reason VALUE	La razón por la que esta alarma se ha establecido en este estado (legible). Tipo: String Valores válidos: una cadena UTF-8 de entre 1 y 1023 caracteres. Valor predeterminado: n/a Obligatorio: sí
--state-reason-data VALUE	La razón por la que esta alarma se ha establecido en este estado. Estos datos se han diseñado para que tengan un formato JSON legibles electrónicamente. Tipo: String Valores válidos: una cadena JSON legible electrónicamente válida de entre 1 y 4000 caracteres. Valor predeterminado: n/a Obligatorio: no
--state-value VALUE	El estado de la alarma en que debe establecerse. Tipo: enumeración Valores válidos: ALARM, OK o INSUFFICIENT_DATA Valor predeterminado: n/a Obligatorio: sí

Opciones comunes

Nombre	Descripción
--aws-credential-file VALUE	La ubicación del archivo de credenciales de AWS. Puede establecer este valor mediante la variable de entorno AWS_CREDENTIAL_FILE. Si define la variable de entorno o proporciona la ruta de acceso al archivo de credenciales, el archivo debe existir o, de lo contrario, se produce un error en la solicitud. Las solicitudes de CloudWatch deben firmarse con un ID de clave de acceso y una clave de acceso secreta. Tipo: String Valores válidos: Ruta de acceso válida de un archivo que contenga el ID de clave de acceso y la clave de acceso secreta. Valor predeterminado: Utiliza la variable de entorno AWS_CREDENTIAL_FILE, si se establece.
-C, --ec2-cert-file-path VALUE	La ubicación del archivo del certificado EC2 para las solicitudes de firma. Puede utilizar la variable de entorno EC2_CERT para especificar este valor. Tipo: String Valores válidos: una ruta de archivo válida al archivo PEM que Amazon EC2 o AWS Identity and Access Management proporcionan. Valor predeterminado: Utiliza la variable de entorno EC2_CERT, si se establece.
--connection-timeout VALUE	El valor del tiempo de espera de la conexión en segundos. Tipo: entero Valores válidos: Cualquier número positivo. Predeterminado: 30
--delimiter VALUE	El delimitador que se va a utilizar al mostrar resultados delimitados (largos). Tipo: String Valores válidos: Cualquier cadena. Valor predeterminado: Coma (,)
--headers	Si muestra resultados tabulares o delimitados, incluya las cabeceras de columna. Si muestra resultados XML, devuelva las cabeceras HTTP de la solicitud de servicio, si corresponde. Tipo: Flag Valores válidos: Cuando hay, muestra cabeceras. Valor predeterminado: La opción --headers está deshabilitada de forma predeterminada.
-I, --access-key-id VALUE	El ID de clave de acceso que se utilizará, en combinación con la clave secreta, para firmar la solicitud. Esto se debe utilizar en combinación con la clave secreta, de lo contrario, se ignora la opción. Todas las solicitudes a CloudWatch deben estar firmadas; de lo contrario, la solicitud se rechaza. Tipo: String Valores válidos: Un ID de clave de acceso válido. Valor predeterminado: None
-K, --ec2-private-key-file-path VALUE	La clave privada que se va a utilizar para firmar la solicitud. El uso de claves públicas o privadas hace que la CLI utilice SOAP. La solicitud se firma con un certificado público y una clave privada. Este parámetro se debe usar junto con EC2_CERT, de lo contrario, el valor no se tiene en cuenta. El valor de la variable de entorno EC2_PRIVATE_KEY se usará si está configurado, y esta opción no está especificada. Esta opción se pasa por alto si la variable de entorno AWS_CREDENTIAL_FILE está establecida, o se utiliza --aws-credentials-file. Todas las solicitudes a CloudWatch deben estar firmadas; de lo contrario, la solicitud se rechaza. Tipo: String Valores válidos: Ruta de acceso a una clave privada ASN.1 válida. Valor predeterminado: None
--region VALUE	Las solicitudes de región se dirigen a. Puede utilizar la variable de entorno EC2_REGION para especificar el valor. La región se utiliza para crear la URL que se utiliza para llamar a CloudWatch, y debe ser una Región (de AWS) válida de Amazon Web Services. Tipo: String Valores válidos: Cualquier Región de AWS, por ejemplo, us-east-1. Valor predeterminado: us-east-1, a menos que la variable de entorno EC2_REGION esté establecida.
S, --secret-key VALUE	La clave de acceso secreta que se utilizará para firmar la solicitud, junto con un ID de clave de acceso. Este parámetro se debe usar junto con --access-key-id, de lo contrario, la opción no en tiene en cuenta. Tipo: String Valores válidos: ID de clave de acceso. Valor predeterminado: None
--show-empty-fields	Muestra campos vacíos al utilizar (nulo) como espacio disponible para indicar que no se solicitaron estos datos. Tipo: Flag Valores válidos: Ninguno Valor predeterminado: Los campos vacíos no se muestran de forma predeterminada.
--show-request	Muestra la URL que utiliza la CLI para llamar a AWS. Tipo: Flag Valores válidos: Ninguno Valor predeterminado: falso
--show-table, --show-long, --show-xml, --quiet	Especifica cómo se muestran los resultados: en una tabla, delimitados (largos), XML o sin salida (silenciosos). La pantalla --show-table muestra un subconjunto de los datos en forma de ancho de columna fija; --show-long muestra todos los valores devueltos delimitados por un carácter; --show-xml es el retorno sin procesar del servicio; y --quiet suprime toda la salida estándar. Todas las opciones son mutuamente excluyentes, con la prioridad --show-table, --show-long, --show-xml y --quiet. Tipo: Flag Valores válidos: Ninguno Valor predeterminado: --show-table
-U, --url VALUE	La dirección URL que se utiliza para contactarse con CloudWatch. Puede establecer este valor mediante la variable de entorno AWS_CLOUDWATCH_URL. Este valor se usa en combinación con --region para crear la URL esperada. Esta opción anula la dirección URL de la llamada de servicio. Tipo: String Valores válidos: Una dirección HTTP o HTTPS válida. Valor predeterminado: utiliza el valor que se especifica en AWS_CLOUDWATCH_URL, si se establece.

Output

Este comando cambia temporalmente el estado de una alarma y muestra OK-Set alarm state value cuando la solicitud se realiza correctamente.

La CLI de Amazon CloudWatch muestra errores en stderr.

Ejemplos

Ejemplo de solicitud

Este ejemplo establece el estado de la alarma denominada my-alarm en OK.

mon-set-alarm-state --alarm-name my-alarm --state OK

Temas relacionados

Descargar

• Configurar la interfaz de línea de comandos

Acción relacionada

• SetAlarmState

Comando relacionado

• mon-describe-alarms