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à.
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando Network Flow Monitor. AWS Command Line Interface
Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.
Argomenti
Azioni
Il seguente esempio di codice mostra come utilizzarecreate-monitor
.
- AWS CLI
-
Per creare un monitor
L'
create-monitor
esempio seguente crea un monitor denominatodemo
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-arnarn: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 sull'API, consulta CreateMonitor AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzarecreate-scope
.
- AWS CLI
-
Per creare un ambito
L'
create-scope
esempio seguente crea un ambito che include un set di risorse per le quali Network Flow Monitor genererà 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 sull'API, consulta CreateScope AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzaredelete-monitor
.
- AWS CLI
-
Per eliminare un monitor
L'
delete-monitor
esempio seguente elimina un monitor denominatodemo
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 sull'API, consulta DeleteMonitor AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzaredelete-scope
.
- AWS CLI
-
Per eliminare un ambito
L'
delete-scope
esempio 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 sull'API, consulta DeleteScope AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzareget-monitor
.
- AWS CLI
-
Per recuperare informazioni su un monitor
L'
get-monitor
esempio seguente visualizza informazioni sul monitor denominatodemo
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 sull'API, consulta GetMonitor AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzareget-query-results-workload-insights-top-contributors-data
.
- AWS CLI
-
Per recuperare i dati dei principali contributori su Workload Insights
L'
get-query-results-workload-insights-top-contributors-data
esempio 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-idcc4f4ab3-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.
-
Per i dettagli sull'API, consulta GetQueryResultsWorkloadInsightsTopContributorsData AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzareget-query-results-workload-insights-top-contributors
.
- AWS CLI
-
Per recuperare i principali contributori su Workload Insights
L'
get-query-results-workload-insights-top-contributors
esempio 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-id1fc423d3-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.
-
Per i dettagli sull'API, consulta GetQueryResultsWorkloadInsightsTopContributors AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzareget-query-status-monitor-top-contributors
.
- AWS CLI
-
Per recuperare lo stato della query
L'
get-query-status-monitor-top-contributors
esempio seguente visualizza lo stato corrente della query nell'account specificato.aws networkflowmonitor get-query-status-monitor-top-contributors \ --monitor-name
Demo
\ --query-id5398eabd-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.
-
Per i dettagli sull'API, consulta GetQueryStatusMonitorTopContributors AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzareget-query-status-workload-insights-top-contributors-data
.
- AWS CLI
-
Per recuperare lo stato della query
L'
get-query-status-workload-insights-top-contributors-data
esempio 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-id4333754d-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.
-
Per i dettagli sull'API, consulta GetQueryStatusWorkloadInsightsTopContributorsData AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzareget-query-status-workload-insights-top-contributors
.
- AWS CLI
-
Per recuperare lo stato della query
L'
get-query-status-workload-insights-top-contributors
esempio 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-idf2a87c70-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.
-
Per i dettagli sull'API, consulta GetQueryStatusWorkloadInsightsTopContributors AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzareget-scope
.
- AWS CLI
-
Per recuperare informazioni su un ambito
L'
get-scope
esempio seguente visualizza informazioni su un ambito, come lo stato, i tag, il nome e i dettagli dell'obiettivo.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 sull'API, consulta GetScope AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzarelist-monitors
.
- AWS CLI
-
Per recuperare un elenco di monitor
L'
list-monitors
esempio 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 sull'API, consulta ListMonitors AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzarelist-scopes
.
- AWS CLI
-
Per recuperare un elenco di ambiti
L'
list-scopes
esempio 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 sull'API, consulta ListScopes AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource
.
- AWS CLI
-
Per elencare i tag
L'
list-tags-for-resource
esempio 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.
-
Per i dettagli sull'API, consulta ListTagsForResource AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzarestart-query-monitor-top-contributors
.
- AWS CLI
-
Per avviare una query
L'
start-query-monitor-top-contributors
esempio seguente avvia la query che restituisce un ID di query per recuperare i principali collaboratori.aws networkflowmonitor start-query-monitor-top-contributors \ --monitor-name
Demo
\ --start-time2024-12-09T19:00:00Z
\ --end-time2024-12-09T19:15:00Z
\ --metric-nameDATA_TRANSFERRED
\ --destination-categoryUNCLASSIFIED
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.
-
Per i dettagli sull'API, consulta StartQueryMonitorTopContributors AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzarestart-query-workload-insights-top-contributors-data
.
- AWS CLI
-
Per avviare una query
L'
start-query-workload-insights-top-contributors-data
esempio seguente avvia la query che restituisce un ID di query per recuperare i principali collaboratori.aws networkflowmonitor start-query-workload-insights-top-contributors-data \ --scope-id
e21cda79-30a0-4c12-9299-d8629d76d8cf
\ --start-time2024-12-09T19:00:00Z
\ --end-time2024-12-09T19:15:00Z
\ --metric-nameDATA_TRANSFERRED
\ --destination-categoryUNCLASSIFIED
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.
-
Per i dettagli sull'API, consulta StartQueryWorkloadInsightsTopContributorsData AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzarestart-query-workload-insights-top-contributors
.
- AWS CLI
-
Per avviare una query
L'
start-query-workload-insights-top-contributors
esempio seguente avvia la query che restituisce un ID di query per recuperare i principali collaboratori.aws networkflowmonitor start-query-workload-insights-top-contributors \ --scope-id
e21cda79-30a0-4c12-9299-d8629d76d8cf
\ --start-time2024-12-09T19:00:00Z
\ --end-time2024-12-09T19:15:00Z
\ --metric-nameDATA_TRANSFERRED
\ --destination-categoryUNCLASSIFIED
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.
-
Per i dettagli sull'API, consulta StartQueryWorkloadInsightsTopContributors AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzarestop-query-monitor-top-contributors
.
- AWS CLI
-
Per interrompere un'interrogazione
L'
stop-query-monitor-top-contributors
esempio seguente interrompe la query nell'account specificato.aws networkflowmonitor stop-query-monitor-top-contributors \ --monitor-name
Demo
\ --query-idaecd3a88-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.
-
Per i dettagli sull'API, consulta StopQueryMonitorTopContributors AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzarestop-query-workload-insights-top-contributors-data
.
- AWS CLI
-
Per interrompere un'interrogazione
L'
stop-query-workload-insights-top-contributors-data
esempio seguente interrompe la query nell'account specificato.aws networkflowmonitor stop-query-workload-insights-top-contributors-data \ --scope-id
e21cda79-30a0-4c12-9299-d8629d76d8cf
\ --query-idcc4f4ab3-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.
-
Per i dettagli sull'API, consulta StopQueryWorkloadInsightsTopContributorsData AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzarestop-query-workload-insights-top-contributors
.
- AWS CLI
-
Per interrompere un'interrogazione
L'
stop-query-workload-insights-top-contributors
esempio seguente interrompe la query nell'account specificato.aws networkflowmonitor stop-query-workload-insights-top-contributors \ --scope-id
e21cda79-30a0-4c12-9299-d8629d76d8cf
\ --query-id1fc423d3-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.
-
Per i dettagli sull'API, consulta StopQueryWorkloadInsightsTopContributors AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzaretag-resource
.
- AWS CLI
-
Per aggiungere un tag alla risorsa specificata
L'
tag-resource
esempio seguente aggiunge un tag al monitor dell'account specificato.aws networkflowmonitor tag-resource \ --resource-arn
arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo
\ --tagsKey=stack,Value=Production
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta Taggare le CloudWatch risorse Amazon nella Amazon CloudWatch User Guide.
-
Per i dettagli sull'API, consulta TagResource AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzareuntag-resource
.
- AWS CLI
-
Per rimuovere un tag dalla risorsa specificata
L'
untag-resource
esempio seguente rimuove un tag dal monitor dell'account specificato.aws networkflowmonitor untag-resource \ --resource-arn
arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo
\ --tag-keysstack
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta Taggare le CloudWatch risorse Amazon nella Amazon CloudWatch User Guide.
-
Per i dettagli sull'API, consulta UntagResource AWS CLI
Command Reference.
-
Il seguente esempio di codice mostra come utilizzareupdate-monitor
.
- AWS CLI
-
Per aggiornare un monitor esistente
L'
update-monitor
esempio seguente aggiorna il monitor denominatoDemo
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 sull'API, consulta UpdateMonitor AWS CLI
Command Reference.
-