Exemples d'utilisation de Network Flow Monitor AWS CLI

Pour créer un moniteur

L'create-monitorexemple 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 un scope

L'create-scopeexemple suivant crée une étendue 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'delete-monitorexemple suivant supprime un moniteur nommé demo dans le compte spécifié.

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

Cette commande ne produit aucun résultat.

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'delete-scopeexemple suivant supprime une étendue spécifiée.

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

Cette commande ne produit aucun résultat.

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 des informations sur un moniteur

L'get-monitorexemple suivant affiche des 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 récupérer les données des principaux contributeurs sur les informations relatives à la charge de travail

L'get-query-results-workload-insights-top-contributors-dataexemple 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 obtenir des informations sur les principaux contributeurs en matière de charge de travail

L'get-query-results-workload-insights-top-contributorsexemple 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 récupérer le statut de la requête

L'get-query-status-monitor-top-contributorsexemple suivant montre 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 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 récupérer le statut de la requête

L'get-query-status-workload-insights-top-contributors-dataexemple suivant montre 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 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 récupérer le statut de la requête

L'get-query-status-workload-insights-top-contributorsexemple suivant montre 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 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 récupérer des informations sur un scope

L'get-scopeexemple suivant affiche des informations sur une étendue, 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 récupérer une liste de moniteurs

L'list-monitorsexemple 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 scopes

L'list-scopesexemple suivant répertorie toutes les étendues 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 tags

L'list-tags-for-resourceexemple 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'start-query-monitor-top-contributorsexemple suivant lance la requête qui renvoie un ID de requête pour récupérer les principaux 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'start-query-workload-insights-top-contributors-dataexemple suivant lance la requête qui renvoie un ID de requête pour récupérer les principaux 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'start-query-workload-insights-top-contributorsexemple suivant lance la requête qui renvoie un ID de requête pour récupérer les principaux 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'stop-query-monitor-top-contributorsexemple 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 aucun résultat.

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'stop-query-workload-insights-top-contributors-dataexemple 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 aucun résultat.

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'stop-query-workload-insights-top-contributorsexemple 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 aucun résultat.

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 un tag à la ressource spécifiée

L'tag-resourceexemple 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 aucun résultat.

Pour plus d'informations, consultez la section Marquage de vos CloudWatch ressources Amazon dans le guide de l' CloudWatch utilisateur Amazon.

Pour supprimer un tag de la ressource spécifiée

L'untag-resourceexemple 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 aucun résultat.

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'update-monitorexemple 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.