Esempi di Network Flow Monitor che utilizzano AWS CLI

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

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

Azioni

L’esempio di codice seguente mostra come utilizzare create-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.

Per i dettagli sulle API, consulta la sezione CreateMonitor AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-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.

Per i dettagli sulle API, consulta la sezione CreateScope AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-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.

Per i dettagli sulle API, consulta la sezione DeleteMonitor AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-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.

Per i dettagli sulle API, consulta la sezione DeleteScope AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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.

Per i dettagli sulle API, consulta la sezione GetMonitor AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta GetQueryResultsWorkloadInsightsTopContributorsData AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta GetQueryResultsWorkloadInsightsTopContributors AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta GetQueryStatusMonitorTopContributors AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta GetQueryStatusWorkloadInsightsTopContributorsData AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon User Guide. https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-NetworkFlowMonitor-configure-evaluate-flows.html CloudWatch

Per i dettagli sulle API, consulta GetQueryStatusWorkloadInsightsTopContributors AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-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.

Per i dettagli sulle API, consulta la sezione GetScope AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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.

Per i dettagli sulle API, consulta la sezione ListMonitors AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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.

Per i dettagli sulle API, consulta la sezione ListScopes AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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 Tagging your Amazon CloudWatch resources nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta la sezione ListTagsForResource AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare start-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta StartQueryMonitorTopContributors AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare start-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta StartQueryWorkloadInsightsTopContributorsData AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare start-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta StartQueryWorkloadInsightsTopContributors AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare stop-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta StopQueryMonitorTopContributors AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare stop-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta StopQueryWorkloadInsightsTopContributorsData AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare stop-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 Valutare i flussi di rete con informazioni sui carichi di lavoro nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta StopQueryWorkloadInsightsTopContributors AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare tag-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 Tagging your Amazon CloudWatch resources nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta la sezione TagResource AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare untag-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 Tagging your Amazon CloudWatch resources nella Amazon CloudWatch User Guide.

Per i dettagli sulle API, consulta la sezione UntagResource AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare update-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.

Per i dettagli sulle API, consulta la sezione UpdateMonitor AWS CLI Command Reference.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

MSK Amazon

Network Manager