Contoh Network Flow Monitor menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan Network Flow Monitor.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

buat-monitor

Contoh kode berikut menunjukkan cara menggunakancreate-monitor.

AWS CLI

Untuk membuat monitor

create-monitorContoh berikut membuat monitor bernama demo di akun yang ditentukan.

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

Untuk informasi selengkapnya, lihat Membuat monitor di Monitor Aliran Jaringan di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat CreateMonitor di Refer AWS CLI ensi Perintah.

buat-cakupan

Contoh kode berikut menunjukkan cara menggunakancreate-scope.

AWS CLI

Untuk membuat cakupan

create-scopeContoh berikut membuat cakupan yang mencakup sekumpulan sumber daya yang Monitor Aliran Jaringan akan menghasilkan metrik lalu lintas jaringan.

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Monitor Ali ran Jaringan di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat CreateScope di Refer AWS CLI ensi Perintah.

hapus monitor

Contoh kode berikut menunjukkan cara menggunakandelete-monitor.

AWS CLI

Untuk menghapus monitor

delete-monitorContoh berikut menghapus monitor bernama demo di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengh apus monitor di Monitor Ali ran Jaringan di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat DeleteMonitor di Refer AWS CLI ensi Perintah.

hapus-lingkup

Contoh kode berikut menunjukkan cara menggunakandelete-scope.

AWS CLI

Untuk menghapus cakupan

delete-scopeContoh berikut menghapus cakupan tertentu.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Komponen dan fitur Monitor Ali ran Jaringan di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat DeleteScope di Refer AWS CLI ensi Perintah.

dapatkan-monitor

Contoh kode berikut menunjukkan cara menggunakanget-monitor.

AWS CLI

Untuk mengambil informasi tentang monitor

get-monitorContoh berikut menampilkan informasi tentang monitor yang dinamai demo dalam akun yang ditentukan.

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Monitor Ali ran Jaringan di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat GetMonitor di Refer AWS CLI ensi Perintah.

dapatkan-kueri-hasil-beban-kerja-wawasan-data kontributor teratas

Contoh kode berikut menunjukkan cara menggunakanget-query-results-workload-insights-top-contributors-data.

AWS CLI

Untuk mengambil data kontributor teratas pada wawasan beban kerja

get-query-results-workload-insights-top-contributors-dataContoh berikut mengembalikan data untuk query yang ditentukan.

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

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat GetQueryResultsWorkloadInsightsTopContributorsData di Refer AWS CLI ensi Perintah.

dapatkan-kueri-hasil-beban-kerja-wawasan-kontributor teratas

Contoh kode berikut menunjukkan cara menggunakanget-query-results-workload-insights-top-contributors.

AWS CLI

Untuk mengambil kontributor teratas pada wawasan beban kerja

get-query-results-workload-insights-top-contributorsContoh berikut mengembalikan data untuk query yang ditentukan.

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

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat GetQueryResultsWorkloadInsightsTopContributors di Refer AWS CLI ensi Perintah.

get-query-status-monitor-kontributor-teratas

Contoh kode berikut menunjukkan cara menggunakanget-query-status-monitor-top-contributors.

AWS CLI

Untuk mengambil status kueri

get-query-status-monitor-top-contributorsContoh berikut menampilkan status kueri saat ini di akun yang ditentukan.

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

Output:

{
    "status": "SUCCEEDED"
}

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat GetQueryStatusMonitorTopContributors di Refer AWS CLI ensi Perintah.

dapatkan-kueri-status-beban-kerja-wawasan-data kontributor-teratas

Contoh kode berikut menunjukkan cara menggunakanget-query-status-workload-insights-top-contributors-data.

AWS CLI

Untuk mengambil status kueri

get-query-status-workload-insights-top-contributors-dataContoh berikut menampilkan status kueri saat ini di akun yang ditentukan.

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

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat GetQueryStatusWorkloadInsightsTopContributorsData di Refer AWS CLI ensi Perintah.

dapatkan-kueri-status-workload-wawasan-kontributor teratas

Contoh kode berikut menunjukkan cara menggunakanget-query-status-workload-insights-top-contributors.

AWS CLI

Untuk mengambil status kueri

get-query-status-workload-insights-top-contributorsContoh berikut menampilkan status kueri saat ini di akun yang ditentukan.

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

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat GetQueryStatusWorkloadInsightsTopContributors di Refer AWS CLI ensi Perintah.

dapatkan-cakupan

Contoh kode berikut menunjukkan cara menggunakanget-scope.

AWS CLI

Untuk mengambil informasi tentang ruang lingkup

get-scopeContoh berikut menampilkan informasi tentang cakupan, seperti status, tag, nama, dan detail target.

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Monitor Ali ran Jaringan di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat GetScope di Refer AWS CLI ensi Perintah.

daftar monitor

Contoh kode berikut menunjukkan cara menggunakanlist-monitors.

AWS CLI

Untuk mengambil daftar monitor

list-monitorsContoh berikut mengembalikan semua monitor di akun yang ditentukan.

aws networkflowmonitor list-monitors

Output:

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Monitor Ali ran Jaringan di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat ListMonitors di Refer AWS CLI ensi Perintah.

lingkup daftar

Contoh kode berikut menunjukkan cara menggunakanlist-scopes.

AWS CLI

Untuk mengambil daftar cakupan

list-scopesContoh berikut mencantumkan semua cakupan dalam akun yang ditentukan.

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Monitor Ali ran Jaringan di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat ListScopes di Refer AWS CLI ensi Perintah.

list-tags-for-resource

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk mencantumkan tag

list-tags-for-resourceContoh berikut mengembalikan semua tag yang terkait dengan sumber daya yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Menandai CloudWatch sumber daya Amazon Anda di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat ListTagsForResource di Refer AWS CLI ensi Perintah.

start-query-monitor-kontributor teratas

Contoh kode berikut menunjukkan cara menggunakanstart-query-monitor-top-contributors.

AWS CLI

Untuk memulai kueri

start-query-monitor-top-contributorsContoh berikut memulai query yang mengembalikan ID kueri untuk mengambil kontributor teratas.

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

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat StartQueryMonitorTopContributors di Refer AWS CLI ensi Perintah.

awal-kueri-beban-kerja-wawasan-data kontributor teratas

Contoh kode berikut menunjukkan cara menggunakanstart-query-workload-insights-top-contributors-data.

AWS CLI

Untuk memulai kueri

start-query-workload-insights-top-contributors-dataContoh berikut memulai query yang mengembalikan ID kueri untuk mengambil kontributor teratas.

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

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat StartQueryWorkloadInsightsTopContributorsData di Refer AWS CLI ensi Perintah.

awal-kueri-beban kerja-wawasan-kontributor teratas

Contoh kode berikut menunjukkan cara menggunakanstart-query-workload-insights-top-contributors.

AWS CLI

Untuk memulai kueri

start-query-workload-insights-top-contributorsContoh berikut memulai query yang mengembalikan ID kueri untuk mengambil kontributor teratas.

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

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat StartQueryWorkloadInsightsTopContributors di Refer AWS CLI ensi Perintah.

stop-query-monitor-kontributor-teratas

Contoh kode berikut menunjukkan cara menggunakanstop-query-monitor-top-contributors.

AWS CLI

Untuk menghentikan kueri

stop-query-monitor-top-contributorsContoh berikut menghentikan kueri di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat StopQueryMonitorTopContributors di Refer AWS CLI ensi Perintah.

hentikan kueri-beban-kerja-wawasan-data kontributor-teratas

Contoh kode berikut menunjukkan cara menggunakanstop-query-workload-insights-top-contributors-data.

AWS CLI

Untuk menghentikan kueri

stop-query-workload-insights-top-contributors-dataContoh berikut menghentikan kueri di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat StopQueryWorkloadInsightsTopContributorsData di Refer AWS CLI ensi Perintah.

hentikan kueri-beban kerja-wawasan-kontributor teratas

Contoh kode berikut menunjukkan cara menggunakanstop-query-workload-insights-top-contributors.

AWS CLI

Untuk menghentikan kueri

stop-query-workload-insights-top-contributorsContoh berikut menghentikan kueri di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat StopQueryWorkloadInsightsTopContributors di Refer AWS CLI ensi Perintah.

tag-resource

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menambahkan tag ke sumber daya yang ditentukan

tag-resourceContoh berikut menambahkan tag ke monitor di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai CloudWatch sumber daya Amazon Anda di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat TagResource di Refer AWS CLI ensi Perintah.

untag-resource

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari sumber daya yang ditentukan

untag-resourceContoh berikut menghapus tag dari monitor di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai CloudWatch sumber daya Amazon Anda di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat UntagResource di Refer AWS CLI ensi Perintah.

pembaruan-monitor

Contoh kode berikut menunjukkan cara menggunakanupdate-monitor.

AWS CLI

Untuk memperbarui monitor yang ada

update-monitorContoh berikut memperbarui monitor yang dinamai Demo di akun yang ditentukan.

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Monitor Ali ran Jaringan di Panduan CloudWatch Pengguna Amazon.

• Untuk detail API, lihat UpdateMonitor di Refer AWS CLI ensi Perintah.