Introducción
Un equipo de informes necesita revisar sus configuraciones de prueba de finanzas sin cambiar las de producción ni las de otro equipo. Encontrarás los recursos correctos, harás que la lista sea más fácil de leer y actualizarás el formato de exportación a CSV.
Completa primero los laboratorios del espacio de trabajo y de recursos regionales. La conexión de la CLI y los recursos están preparados en un entorno nuevo; no se necesitan archivos ni credenciales anteriores. Utiliza Terminal para los comandos y AWS View en la parte superior para observar los cambios.
Relación con las certificaciones
| Certificación | Tarea del examen | Práctica |
|---|---|---|
| Cloud Practitioner (CLF-C02) | Tarea 3.1 | Consultas de recursos mediante CLI e inventarios operativos delimitados. |
Vista general del laboratorio
Encuentra las configuraciones de prueba de finanzas
En este paso, reducirás una lista de recursos mezclados a las configuraciones de finanzas asignadas a esta revisión.
El laboratorio anterior mostró cómo la región selecciona una ubicación. Aquí, el valor predeterminado preparado es us-east-1: los comandos sin --region utilizan esa ubicación. También puedes indicar --region us-east-1 explícitamente.
Un inventario de recursos es una lista de recursos. Consulta el inventario de parámetros preparado:
aws ssm describe-parameters
Observa cada Name y Description. Staging es un entorno de prueba utilizado antes de cambiar producción, donde se ejecuta el trabajo habitual de la empresa. La lista incluye configuraciones de staging de finanzas, de producción de finanzas y de staging de recursos humanos (HR). Tus dos recursos comienzan por /labex/inventory/finance/staging/.
La Console oficial presenta los metadatos de los parámetros en una tabla de recursos. Compara sus columnas Name y Type con los campos que devuelve describe-parameters. Los nombres del ejemplo son distintos; este laboratorio utiliza parámetros String:
La lista es lo bastante pequeña para revisarla a simple vista, pero un filtro aclara el alcance. --parameter-filters solicita al servicio que devuelva registros coincidentes. Key=Name selecciona los nombres, Option=BeginsWith compara su comienzo y Values=... proporciona ese comienzo:
aws ssm describe-parameters --parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/
Verás dos nombres: report-format y report-owner; el orden puede variar. El filtro selecciona los recursos de esta tarea sin cambiar su configuración.
Muestra los nombres y actualiza el formato de exportación
En este paso, mostrarás solo los nombres coincidentes y después cambiarás el formato de exportación de staging de finanzas.
La respuesta contiene más campos de los que necesitas ahora. --query selecciona partes de una respuesta; no cambia los datos almacenados. En 'Parameters[].Name', Parameters[] representa los registros devueltos y .Name selecciona sus nombres. Mantén la expresión entre comillas simples.
Añade esa selección al filtro existente:
aws ssm describe-parameters \
--parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ \
--query 'Parameters[].Name'
La respuesta enumera los dos nombres coincidentes. El filtro elige recursos; la consulta elige campos.
Para una presentación más compacta, añade --output table:
aws ssm describe-parameters \
--parameter-filters Key=Name,Option=BeginsWith,Values=/labex/inventory/finance/staging/ \
--query 'Parameters[].Name' \
--output table
Los mismos dos nombres aparecen en una tabla. Solo cambia la presentación.
Lee por su nombre exacto la configuración del formato de staging:
aws ssm get-parameter --name /labex/inventory/finance/staging/report-format
Busca Value: es json. Este es el formato de exportación de la aplicación, distinto del formato JSON de respuesta de la CLI. El importador de informes que recibe la exportación necesita CSV, así que actualiza esa configuración:
aws ssm put-parameter \
--name /labex/inventory/finance/staging/report-format \
--type String \
--value csv \
--overwrite
Léela de nuevo:
aws ssm get-parameter --name /labex/inventory/finance/staging/report-format
Su valor ahora es csv. En AWS View, compara finance staging, production y HR. Solo cambió el formato de staging; production sigue en json y HR en xlsx.
Confirma las configuraciones y termina la revisión
En este paso, confirmarás el formato seleccionado y su equipo propietario.
También puedes seleccionar un campo de un único recurso. 'Parameter.Value' lee el valor dentro de Parameter; --output text lo muestra sin comillas JSON:
aws ssm get-parameter \
--name /labex/inventory/finance/staging/report-format \
--query 'Parameter.Value' \
--output text
La respuesta es csv. Confirma quién es el propietario de esta configuración de informes:
aws ssm get-parameter \
--name /labex/inventory/finance/staging/report-owner \
--query 'Parameter.Value' \
--output text
La respuesta es finance. Estos son valores almacenados; la lista de metadatos anterior mostraba nombres y descripciones.
Los valores confirman la configuración seleccionada: formato csv y propietario finance. Los otros grupos no cambian. Después, agrupa recursos sin prefijo común mediante etiquetas.
Resumen
Encontraste las configuraciones de finance staging, seleccionaste campos útiles y cambiaste solo el formato previsto. Continúa organizando recursos por equipo y entorno con etiquetas.
Para ampliar este tema, consulta la referencia de AWS: Filtros del servidor y consultas del cliente en la CLI.
