Uso de la AWS CLI para configurar la recopilación de datos de inventario
En los siguientes procedimientos se presenta el proceso de configuración de AWS Systems Manager Inventory para la recopilación de metadatos desde los nodos administrados. Cuando configure la recopilación de inventario, empiece creando una asociación de Systems Manager State Manager. Systems Manager recopila los datos de inventario cuando se ejecuta la asociación. Si no crea la asociación en primer lugar e intenta invocar el complemento aws:softwareInventory
mediante, por ejemplo, el uso de Systems Manager Run Command, el sistema regresará el siguiente error:
The
.aws:softwareInventory
plugin can only be invoked via
ssm-associate
nota
Un nodo solo puede tener una única asociación a inventario configurada a la vez. Si configura un nodo con dos o más asociaciones a inventario, la asociación no funciona y no se recopilan los datos de inventario.
Configuración rápida de todos los nodos administrados para Inventory (CLI)
Puede configurar rápidamente todos los nodos administrados en la Cuenta de AWS y en la región actual para la recopilación de datos de inventario. Esto se conoce como creación de una asociación de inventario global. Para crear una asociación de inventario global mediante la AWS CLI, utilice la opción comodín del valor instanceIds
, tal y como se muestra en el siguiente procedimiento:
Para configurar el inventario para todos los nodos administrados en la Cuenta de AWS y en la región actual (CLI)
Si aún no lo ha hecho, instale y configure la AWS Command Line Interface (AWS CLI).
Para obtener más información, consulte Instalación o actualización de la última versión de la AWS CLI.
-
Ejecute el siguiente comando de la .
nota
Este comando no permite que Inventory recopile metadatos para los archivos o el registro de Windows. Para inventariar estos tipos de datos, utilice el siguiente procedimiento.
Configuración manual de Inventory en los nodos administrados (CLI)
Utilice el siguiente procedimiento para configurar manualmente AWS Systems Manager Inventory en los nodos administrados mediante ID o etiquetas de nodo.
Para configurar manualmente los nodos administrados para Inventory (CLI)
Si aún no lo ha hecho, instale y configure la AWS Command Line Interface (AWS CLI).
Para obtener más información, consulte Instalación o actualización de la última versión de la AWS CLI.
-
Ejecute el siguiente comando para crear una asociación de State Manager que ejecute Systems Manager Inventory en el nodo. Reemplace cada
example resource placeholder
con su propia información. Este comando configura que el servicio se ejecute cada seis horas y que se recopilen los metadatos de configuración de la red, de Windows Update y de las aplicaciones de un nodo.El sistema devuelve información similar a la siguiente.
{ "AssociationDescription": { "ScheduleExpression": "rate(240 minutes)", "OutputLocation": { "S3Location": { "OutputS3KeyPrefix": "Test", "OutputS3BucketName": "Test bucket", "OutputS3Region": "us-east-2" } }, "Name": "
The name you specified
", "Parameters": { "applications": [ "Enabled" ], "networkConfig": [ "Enabled" ], "windowsUpdates": [ "Enabled" ] }, "Overview": { "Status": "Pending", "DetailedStatus": "Creating" }, "AssociationId": "1a2b3c4d5e6f7g-1a2b3c-1a2b3c-1a2b3c-1a2b3c4d5e6f7g", "DocumentVersion": "$DEFAULT", "LastUpdateAssociationDate": 1480544990.06, "Date": 1480544990.06, "Targets": [ { "Values": [ "i-02573cafcfEXAMPLE" ], "Key": "InstanceIds" } ] } }Puede dirigirse a grandes grupos de nodos de destino mediante el parámetro
Targets
con etiquetas de EC2. Consulte el siguiente ejemplo.También puede realizar un inventario de claves de archivos y del registro de Windows en un nodo de Windows Server mediante los tipos de inventario
files
ywindowsRegistry
con expresiones. Para obtener más información acerca de estos tipos de inventario, consulte Uso del inventario de archivos y del registro de Windows. -
Ejecute el siguiente comando para ver el estado de la asociación.
aws ssm describe-instance-associations-status --instance-id
an_instance_ID
El sistema devuelve información similar a la siguiente.
{ "InstanceAssociationStatusInfos": [ { "Status": "Pending", "DetailedStatus": "Associated", "Name": "reInvent2016PolicyDocumentTest", "InstanceId": "i-1a2b3c4d5e6f7g", "AssociationId": "1a2b3c4d5e6f7g-1a2b3c-1a2b3c-1a2b3c-1a2b3c4d5e6f7g", "DocumentVersion": "1" } ] }