Exemples d'utilisation de Network Flow Monitor AWS CLI

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 la section Créer un moniteur dans Network Flow Monitor dans le guide de CloudWatch l'utilisateur Amazon.

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 la section Composants et fonctionnalités de Network Flow Monitor dans le guide de CloudWatch l'utilisateur Amazon.

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 CloudWatch l'utilisateur Amazon.

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 la section Composants et fonctionnalités de Network Flow Monitor dans le guide de CloudWatch l'utilisateur Amazon.

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 la section Composants et fonctionnalités de Network Flow Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour extraire 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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

Pour extraire 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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

Pour extraire le statut de la requête

L’exemple get-query-status-monitor-top-contributors suivant affiche le statut 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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

Pour extraire le statut de la requête

L’exemple get-query-status-workload-insights-top-contributors-data suivant affiche le statut 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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

Pour extraire le statut de la requête

L’exemple get-query-status-workload-insights-top-contributors suivant affiche le statut 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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

Pour extraire des informations sur une portée

L’exemple get-scope suivant affiche des informations sur une portée, telles que le statut, 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 la section Composants et fonctionnalités de Network Flow Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour extraire 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 la section Composants et fonctionnalités de Network Flow Monitor dans le guide de CloudWatch l'utilisateur Amazon.

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 la section Composants et fonctionnalités de Network Flow Monitor dans le guide de CloudWatch l'utilisateur Amazon.

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 la section Marquage de vos CloudWatch ressources Amazon dans le guide de l' CloudWatch utilisateur Amazon.

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 extraire 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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

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 extraire 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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

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 extraire 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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

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 la section Évaluer les flux réseau à l'aide d'informations sur la charge de travail dans le guide de CloudWatch l'utilisateur Amazon.

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 la section Marquage de vos CloudWatch ressources Amazon dans le guide de l' CloudWatch utilisateur Amazon.

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 la section Marquage de vos CloudWatch ressources Amazon dans le guide de l' CloudWatch utilisateur Amazon.

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 la section Composants et fonctionnalités de Network Flow Monitor dans le guide de CloudWatch l'utilisateur Amazon.