Esempi di Network Flow Monitor utilizzando AWS CLI - AWS Command Line Interface
Azioni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi di Network Flow Monitor utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando Network Flow Monitor. AWS Command Line Interface

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-monitor.

AWS CLI

Come creare un monitoraggio

L’esempio create-monitor seguente crea un monitoraggio denominato demo nell’account specificato.

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

Output:

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

Per ulteriori informazioni, consulta Creare un monitor in Network Flow Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarecreate-scope.

AWS CLI

Come creare un ambito

L’esempio create-scope seguente crea un ambito che include un set di risorse per le quali Network Flow Monitor genererà le metriche del traffico di rete.

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

Output:

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

Per ulteriori informazioni, consulta Componenti e funzionalità di Network Flow Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-monitor.

AWS CLI

Come eliminare un monitoraggio

L’esempio delete-monitor seguente elimina un monitor denominato demo nell’account specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Eliminare un monitor in Network Flow Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-scope.

AWS CLI

Come eliminare un ambito

L’esempio delete-scope seguente elimina un ambito specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Componenti e funzionalità di Network Flow Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-monitor.

AWS CLI

Come recuperare le informazioni relative a un monitoraggio

L’esempio get-monitor seguente visualizza le informazioni sul monitoraggio denominato demo nell’account specificato.

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

Output:

{
    "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": {}
}

Per ulteriori informazioni, consulta Componenti e funzionalità di Network Flow Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-query-results-workload-insights-top-contributors-data.

AWS CLI

Come recuperare i dati dei principali contributor sugli approfondimenti relativi al carico di lavoro

L’esempio get-query-results-workload-insights-top-contributors-data seguente restituisce i dati per la query specificata.

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

Output:

{
    "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"
}

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-query-results-workload-insights-top-contributors.

AWS CLI

Come recuperare i principali contributor sugli approfondimenti relativi al carico di lavoro

L’esempio get-query-results-workload-insights-top-contributors seguente restituisce i dati per la query specificata.

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

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-query-status-monitor-top-contributors.

AWS CLI

Come recuperare lo stato della query

L’esempio get-query-status-monitor-top-contributors seguente visualizza lo stato corrente della query nell’account specificato.

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

Output:

{
    "status": "SUCCEEDED"
}

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-query-status-workload-insights-top-contributors-data.

AWS CLI

Come recuperare lo stato della query

L’esempio get-query-status-workload-insights-top-contributors-data seguente visualizza lo stato corrente della query nell’account specificato.

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

Output:

{
    "status": "SUCCEEDED"
}

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-query-status-workload-insights-top-contributors.

AWS CLI

Come recuperare lo stato della query

L’esempio get-query-status-workload-insights-top-contributors seguente visualizza lo stato corrente della query nell’account specificato.

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

Output:

{
    "status": "SUCCEEDED"
}

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-scope.

AWS CLI

Come recuperare le informazioni relative a un ambito

L’esempio get-scope seguente mostra le informazioni su un ambito, come lo stato, i tag, il nome e i dettagli di destinazione.

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

Output:

{
    "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": {}
}

Per ulteriori informazioni, consulta Componenti e funzionalità di Network Flow Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarelist-monitors.

AWS CLI

Come recuperare un elenco di monitoraggi

L’elenco list-monitors seguente restituisce tutti i monitor dell’account specificato.

aws networkflowmonitor list-monitors

Output:

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

Per ulteriori informazioni, consulta Componenti e funzionalità di Network Flow Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarelist-scopes.

AWS CLI

Come recuperare un elenco di ambiti

L’esempio list-scopes seguente elenca tutti gli ambiti nell’account specificato.

aws networkflowmonitor list-scopes

Output:

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

Per ulteriori informazioni, consulta Componenti e funzionalità di Network Flow Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Come elencare i tag

L’esempio list-tags-for-resource seguente restituisce tutti i tag associati alla risorsa specificata.

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

Output:

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

Per ulteriori informazioni, consulta Taggare le CloudWatch risorse Amazon nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarestart-query-monitor-top-contributors.

AWS CLI

Come avviare una query

L’esempio start-query-monitor-top-contributors seguente avvia la query che restituisce un ID di query per recuperare i principali contributor.

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

Output:

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

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarestart-query-workload-insights-top-contributors-data.

AWS CLI

Come avviare una query

L’esempio start-query-workload-insights-top-contributors-data seguente avvia la query che restituisce un ID di query per recuperare i principali contributor.

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

Output:

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

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarestart-query-workload-insights-top-contributors.

AWS CLI

Come avviare una query

L’esempio start-query-workload-insights-top-contributors seguente avvia la query che restituisce un ID di query per recuperare i principali contributor.

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

Output:

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

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarestop-query-monitor-top-contributors.

AWS CLI

Come arrestare una query

L’esempio stop-query-monitor-top-contributors seguente arresta la query nell’account specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarestop-query-workload-insights-top-contributors-data.

AWS CLI

Come arrestare una query

L’esempio stop-query-workload-insights-top-contributors-data seguente arresta la query nell’account specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarestop-query-workload-insights-top-contributors.

AWS CLI

Come arrestare una query

L’esempio stop-query-workload-insights-top-contributors seguente arresta la query nell’account specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Valuta i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come aggiungere un tag alla risorsa specificata

L’esempio tag-resource seguente aggiunge un tag al monitor nell’account specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Taggare le CloudWatch risorse Amazon nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere tutti i tag dalla risorsa specificata

L’esempio untag-resource seguente rimuove un tag dal monitor nell’account specificato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Taggare le CloudWatch risorse Amazon nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareupdate-monitor.

AWS CLI

Come aggiornare un monitoraggio esistente

L’esempio update-monitor seguente aggiorna il monitor denominato Demo nell’account specificato.

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"

Output:

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

Per ulteriori informazioni, consulta Componenti e funzionalità di Network Flow Monitor nella Amazon CloudWatch User Guide.