Exemples d’utilisation de l’AWS CLI avec Network Flow Monitor

Pour créer un moniteur

L’exemple create-monitor suivant crée un moniteur nommé demo dans le compte spécifié.

aws networkflowmonitor create-monitor \
    --monitor-name demo \
    --local-resources type="AWS::EC2::VPC",identifier="arn:aws:ec2:us-east-1:123456789012:vpc/vpc-03ea55eeda25adbb0"  \
    --scope-arn arn:aws:networkflowmonitor:us-east-1:123456789012:scope/e21cda79-30a0-4c12-9299-d8629d76d8cf

Sortie :

{
    "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/demo",
    "monitorName": "demo",
    "monitorStatus": "ACTIVE",
    "tags": {}
}

Pour plus d’informations, consultez Créer un moniteur dans Network Flow Monitor dans le Guide de l’utilisateur Amazon CloudWatch.

Pour créer une portée

L’exemple create-scope suivant crée une portée qui inclut un ensemble de ressources pour lesquelles Network Flow Monitor générera des métriques de trafic réseau.

aws networkflowmonitor create-scope \
    --targets '[{"targetIdentifier":{"targetId":{"accountId":"123456789012"},"targetType":"ACCOUNT"},"region":"us-east-1"}]'

Sortie :

{
    "scopeId": "97626f8d-8a21-4b5d-813a-1a0962dd4615",
    "status": "IN_PROGRESS",
    "tags": {}
}

Pour plus d’informations, consultez Composants et fonctionnalités de Network Flow Monitor dans le Guide de l’utilisateur Amazon CloudWatch.

Pour supprimer un moniteur

L’exemple delete-monitor suivant supprime un moniteur nommé demo dans le compte spécifié.

aws networkflowmonitor delete-monitor \
    --monitor-name demo

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Supprimer un moniteur dans Network Flow Monitor dans le Guide de l’utilisateur Amazon CloudWatch.

Pour supprimer une portée

L’exemple delete-scope suivant supprime une portée spécifiée.

aws networkflowmonitor delete-scope \
    --scope-id fdc20616-6bb4-4242-a24e-a748e65ca7ac

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Composants et fonctionnalités de Network Flow Monitor dans le Guide de l’utilisateur Amazon CloudWatch.

Pour récupérer les informations sur un moniteur

L’exemple get-monitor suivant affiche les informations sur le moniteur nommé demo dans le compte spécifié.

aws networkflowmonitor get-monitor \
    --monitor-name Demo

Sortie :

{
    "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo",
    "monitorName": "Demo",
    "monitorStatus": "ACTIVE",
    "localResources": [
        {
            "type": "AWS::EC2::VPC",
            "identifier": "arn:aws:ec2:us-east-1:123456789012:vpc/vpc-03ea55eeda25adbb0"
        }
    ],
    "remoteResources": [],
    "createdAt": "2024-12-09T12:21:51.616000-06:00",
    "modifiedAt": "2024-12-09T12:21:55.412000-06:00",
    "tags": {}
}

Pour plus d’informations, consultez Composants et fonctionnalités de Network Flow Monitor dans le Guide de l’utilisateur Amazon CloudWatch.

Pour récupérer les données des meilleurs contributeurs sur les informations relatives à la charge de travail

L’exemple get-query-results-workload-insights-top-contributors-data suivant renvoie les données pour la requête spécifiée.

aws networkflowmonitor get-query-results-workload-insights-top-contributors-data \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id cc4f4ab3-3103-33b8-80ff-d6597a0c6cea

Sortie :

{
    "datapoints": [
        {
            "timestamps": [
                "2024-12-09T19:00:00+00:00",
                "2024-12-09T19:05:00+00:00",
                "2024-12-09T19:10:00+00:00"
            ],
            "values": [
                259943.0,
                194856.0,
                216432.0
            ],
            "label": "use1-az6"
        }
    ],
    "unit": "Bytes"
}

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour récupérer les meilleurs contributeurs sur les informations relatives à la charge de travail

L’exemple get-query-results-workload-insights-top-contributors suivant renvoie les données pour la requête spécifiée.

aws networkflowmonitor get-query-results-workload-insights-top-contributors \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id 1fc423d3-b144-37a6-80e6-e2c7d26eea0c

Sortie :

{
    "topContributors": [
        {
            "accountId": "123456789012",
            "localSubnetId": "subnet-0a5b30fb95dca2c14",
            "localAz": "use1-az6",
            "localVpcId": "vpc-03ea55eeda25adbb0",
            "localRegion": "us-east-1",
            "remoteIdentifier": "",
            "value": 908443,
            "localSubnetArn": "arn:aws:ec2:us-east-1:123456789012:subnet/subnet-0a5b30fb95dca2c14",
            "localVpcArn": "arn:aws:ec2:us-east-1:123456789012:vpc/vpc-03ea55eeda25adbb0"
        }
    ]
}

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour récupérer le statut de la requête

L’exemple get-query-status-monitor-top-contributors suivant affiche l’état actuel de la requête dans le compte spécifié.

aws networkflowmonitor get-query-status-monitor-top-contributors \
    --monitor-name Demo \
    --query-id 5398eabd-bc40-3f5f-aba3-bcb639d3c7ca

Sortie :

{
    "status": "SUCCEEDED"
}

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour récupérer le statut de la requête

L’exemple get-query-status-workload-insights-top-contributors-data suivant affiche l’état actuel de la requête dans le compte spécifié.

aws networkflowmonitor get-query-status-workload-insights-top-contributors-data \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id 4333754d-8ae1-3f29-b6b7-c36db2e7f8ac

Sortie :

{
    "status": "SUCCEEDED"
}

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour récupérer le statut de la requête

L’exemple get-query-status-workload-insights-top-contributors suivant affiche l’état actuel de la requête dans le compte spécifié.

aws networkflowmonitor get-query-status-workload-insights-top-contributors \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id f2a87c70-3e5a-362e-8beb-4747d13d8419

Sortie :

{
    "status": "SUCCEEDED"
}

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour récupérer les informations sur une portée

L’exemple get-scope suivant affiche les informations sur une portée, telles que l’état, les balises, le nom et les détails de la cible.

aws networkflowmonitor get-scope \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf

Sortie :

{
    "scopeId": "e21cda79-30a0-4c12-9299-d8629d76d8cf",
    "status": "SUCCEEDED",
    "scopeArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:scope/e21cda79-30a0-4c12-9299-d8629d76d8cf",
    "targets": [
        {
            "targetIdentifier": {
                "targetId": {
                    "accountId": "123456789012"
                },
                "targetType": "ACCOUNT"
            },
            "region": "us-east-1"
        }
    ],
    "tags": {}
}

Pour plus d’informations, consultez Composants et fonctionnalités de Network Flow Monitor dans le Guide de l’utilisateur Amazon CloudWatch.

Pour récupérer une liste de moniteurs

L’exemple list-monitors suivant renvoie tous les moniteurs du compte spécifié.

aws networkflowmonitor list-monitors

Sortie :

{
    "monitors": [
        {
            "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo",
            "monitorName": "Demo",
            "monitorStatus": "ACTIVE"
        }
    ]
}

Pour plus d’informations, consultez Composants et fonctionnalités de Network Flow Monitor dans le Guide de l’utilisateur Amazon CloudWatch.

Pour récupérer une liste de portées

L’exemple list-scopes suivant répertorie toutes les portées du compte spécifié.

aws networkflowmonitor list-scopes

Sortie :

{
    "scopes": [
        {
            "scopeId": "fdc20616-6bb4-4242-a24e-a748e65ca7ac",
            "status": "SUCCEEDED",
            "scopeArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:scope/fdc20616-6bb4-4242-a24e-a748e65ca7ac"
        }
    ]
}

Pour plus d’informations, consultez Composants et fonctionnalités de Network Flow Monitor dans le Guide de l’utilisateur Amazon CloudWatch.

Pour répertorier les balises

L’exemple list-tags-for-resource suivant renvoie toutes les balises associées à la ressource spécifiée.

aws networkflowmonitor list-tags-for-resource \
    --resource-arn arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo

Sortie :

{
    "tags": {
        "Value": "Production",
        "Key": "stack"
    }
}

Pour plus d’informations, consultez Balisage de vos ressources Amazon CloudWatch dans le Guide de l’utilisateur Amazon CloudWatch.

Pour démarrer une requête

L’exemple start-query-monitor-top-contributors suivant lance la requête qui renvoie un ID de requête pour récupérer les meilleurs contributeurs.

aws networkflowmonitor start-query-monitor-top-contributors \
    --monitor-name Demo \
    --start-time 2024-12-09T19:00:00Z \
    --end-time 2024-12-09T19:15:00Z \
    --metric-name DATA_TRANSFERRED \
    --destination-category UNCLASSIFIED

Sortie :

{
    "queryId": "aecd3a88-0283-35b0-a17d-6e944dc8531d"
}

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour démarrer une requête

L’exemple start-query-workload-insights-top-contributors-data suivant lance la requête qui renvoie un ID de requête pour récupérer les meilleurs contributeurs.

aws networkflowmonitor start-query-workload-insights-top-contributors-data \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --start-time 2024-12-09T19:00:00Z \
    --end-time 2024-12-09T19:15:00Z \
    --metric-name DATA_TRANSFERRED \
    --destination-category UNCLASSIFIED

Sortie :

{
    "queryId": "cc4f4ab3-3103-33b8-80ff-d6597a0c6cea"
}

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour démarrer une requête

L’exemple start-query-workload-insights-top-contributors suivant lance la requête qui renvoie un ID de requête pour récupérer les meilleurs contributeurs.

aws networkflowmonitor start-query-workload-insights-top-contributors \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --start-time 2024-12-09T19:00:00Z \
    --end-time 2024-12-09T19:15:00Z \
    --metric-name DATA_TRANSFERRED \
    --destination-category UNCLASSIFIED

Sortie :

{
    "queryId": "1fc423d3-b144-37a6-80e6-e2c7d26eea0c"
}

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour arrêter une requête

L’exemple stop-query-monitor-top-contributors suivant arrête la requête dans le compte spécifié.

aws networkflowmonitor stop-query-monitor-top-contributors \
    --monitor-name Demo \
    --query-id aecd3a88-0283-35b0-a17d-6e944dc8531d

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour arrêter une requête

L’exemple stop-query-workload-insights-top-contributors-data suivant arrête la requête dans le compte spécifié.

aws networkflowmonitor stop-query-workload-insights-top-contributors-data \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id cc4f4ab3-3103-33b8-80ff-d6597a0c6cea

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour arrêter une requête

L’exemple stop-query-workload-insights-top-contributors suivant arrête la requête dans le compte spécifié.

aws networkflowmonitor stop-query-workload-insights-top-contributors \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id 1fc423d3-b144-37a6-80e6-e2c7d26eea0c

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Évaluer les flux réseau avec des informations sur la charge de travail dans le Guide de l’utilisateur Amazon CloudWatch.

Pour ajouter une balise à la ressource spécifiée

L’exemple tag-resource suivant ajoute une balise au moniteur dans le compte spécifié.

aws networkflowmonitor tag-resource \
    --resource-arn arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo \
    --tags Key=stack,Value=Production

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Balisage de vos ressources Amazon CloudWatch dans le Guide de l’utilisateur Amazon CloudWatch.

Pour supprimer une balise de la ressource spécifiée

L’exemple untag-resource suivant supprime une balise du moniteur dans le compte spécifié.

aws networkflowmonitor untag-resource \
    --resource-arn arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo \
    --tag-keys stack

Cette commande ne produit aucune sortie.

Pour plus d’informations, consultez Balisage de vos ressources Amazon CloudWatch dans le Guide de l’utilisateur Amazon CloudWatch.

Pour mettre à jour un moniteur existant

L’exemple update-monitor suivant met à jour le moniteur nommé Demo dans le compte spécifié.

aws networkflowmonitor update-monitor \
    --monitor-name Demo \
    --local-resources-to-add type="AWS::EC2::VPC",identifier="arn:aws:ec2:us-east-1:123456789012:vpc/vpc-048d08dfbec623f94"

Sortie :

{
    "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo",
    "monitorName": "Demo",
    "monitorStatus": "ACTIVE",
    "tags": {
        "Value": "Production",
        "Key": "stack"
    }
}

Pour plus d’informations, consultez Composants et fonctionnalités de Network Flow Monitor dans le Guide de l’utilisateur Amazon CloudWatch.