View a markdown version of this page

Contoh Resolver Route 53 menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Dokumentasi ini AWS CLI hanya untuk Versi 1.

Kami mengumumkan akhir dukungan yang akan datang untuk AWS CLI versi 1. Kami menyarankan Anda bermigrasi ke AWS CLI versi 2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, lihat pengumuman. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh Resolver Route 53 menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan Route 53 Resolver.

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

Contoh kode berikut menunjukkan cara menggunakanassociate-firewall-rule-group.

AWS CLI

Untuk mengaitkan grup aturan firewall dengan VPC

associate-firewall-rule-groupContoh berikut mengaitkan grup aturan DNS Firewall dengan Amazon VPC.

aws route53resolver associate-firewall-rule-group \
    --name test-association \
    --firewall-rule-group-id rslvr-frg-47f93271fexample \
    --vpc-id vpc-31e92222 \
    --priority 101

Output:

{
    "FirewallRuleGroupAssociation": {
        "Id": "rslvr-frgassoc-57e8873d7example",
        "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-rule-group-association/rslvr-frgassoc-57e8873d7example",
        "FirewallRuleGroupId": "rslvr-frg-47f93271fexample",
        "VpcId": "vpc-31e92222",
        "Name": "test-association",
        "Priority": 101,
        "MutationProtection": "DISABLED",
        "Status": "UPDATING",
        "StatusMessage": "Creating Firewall Rule Group Association",
        "CreatorRequestId": "2ca1a304-32b3-4f5f-bc4c-EXAMPLE11111",
        "CreationTime": "2021-05-25T21:47:48.755768Z",
        "ModificationTime": "2021-05-25T21:47:48.755768Z"
    }
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi antara grup aturan Firewall DNS VPC dan Route 53 Resolver di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanassociate-resolver-endpoint-ip-address.

AWS CLI

Untuk mengaitkan alamat IP lain dengan titik akhir Resolver

associate-resolver-endpoint-ip-addressContoh berikut mengaitkan alamat IP lain dengan titik akhir Resolver inbound. Jika Anda hanya menentukan ID subnet dan menghilangkan alamat IP dari --ip-address parameter, Resolver memilih alamat IP untuk Anda dari antara alamat IP yang tersedia di subnet yang ditentukan.

aws route53resolver associate-resolver-endpoint-ip-address \
    --resolver-endpoint-id rslvr-in-497098ad5example \
    --ip-address="SubnetId=subnet-12d8exam,Ip=192.0.2.118"

Output:

{
    "ResolverEndpoint": {
        "Id": "rslvr-in-497098ad5example",
        "CreatorRequestId": "AWSConsole.25.0123456789",
        "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-endpoint/rslvr-in-497098ad5example",
        "Name": "my-inbound-endpoint",
        "SecurityGroupIds": [
            "sg-05cd7b25d6example"
        ],
        "Direction": "INBOUND",
        "IpAddressCount": 3,
        "HostVPCId": "vpc-304bexam",
        "Status": "UPDATING",
        "StatusMessage": "Updating the Resolver Endpoint",
        "CreationTime": "2020-01-02T23:25:45.538Z",
        "ModificationTime": "2020-01-02T23:25:45.538Z"
    }
}

Untuk informasi selengkapnya, lihat Nilai yang Anda Tentukan Saat Membuat atau Mengedit Titik Akhir Masuk di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanassociate-resolver-rule.

AWS CLI

Untuk mengaitkan aturan Resolver dengan VPC

associate-resolver-ruleContoh berikut mengaitkan aturan Resolver dengan Amazon VPC. Setelah Anda menjalankan perintah, Resolver mulai meneruskan kueri DNS ke jaringan Anda berdasarkan pengaturan dalam aturan, seperti nama domain dari kueri yang diteruskan.

aws route53resolver associate-resolver-rule \
    --name my-resolver-rule-association \
    --resolver-rule-id rslvr-rr-42b60677c0example \
    --vpc-id vpc-304bexam

Output:

{
    "ResolverRuleAssociation": {
        "Id": "rslvr-rrassoc-d61cbb2c8bexample",
        "ResolverRuleId": "rslvr-rr-42b60677c0example",
        "Name": "my-resolver-rule-association",
        "VPCId": "vpc-304bexam",
        "Status": "CREATING",
        "StatusMessage": "[Trace id: 1-5dc5a8fa-ec2cc480d2ef07617example] Creating the association."
    }
}

Untuk informasi selengkapnya, lihat Meneruskan Kueri DNS Keluar ke Jaringan Anda di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakancreate-firewall-domain-list.

AWS CLI

Untuk membuat daftar domain Route 53 Resolver DNS Firewall

create-firewall-domain-listContoh berikut membuat daftar domain Route 53 Resolver DNS Firewall, bernama test, di AWS akun Anda.

aws route53resolver create-firewall-domain-list \
    --creator-request-id my-request-id \
    --name test

Output:

{
    "FirewallDomainList": {
        "Id": "rslvr-fdl-d61cbb2cbexample",
        "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-domain-list/rslvr-fdl-d61cbb2cbexample",
        "Name": "test",
        "DomainCount": 0,
        "Status": "COMPLETE",
        "StatusMessage": "Created Firewall Domain List",
        "CreatorRequestId": "my-request-id",
        "CreationTime": "2021-05-25T15:55:51.115365Z",
        "ModificationTime": "2021-05-25T15:55:51.115365Z"
    }
}

Untuk informasi selengkapnya, lihat M engelola daftar domain Anda sendiri di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakancreate-firewall-rule-group.

AWS CLI

Untuk membuat grup aturan Firewall

create-firewall-rule-groupContoh berikut membuat grup aturan DNS Firewall.

aws route53resolver create-firewall-rule-group \
    --creator-request-id my-request-id \
    --name test

Output:

{
    "FirewallRuleGroup": {
        "Id": "rslvr-frg-47f93271fexample",
        "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-rule-group/rslvr-frg-47f93271fexample",
        "Name": "test",
        "RuleCount": 0,
        "Status": "COMPLETE",
        "StatusMessage": "Created Firewall Rule Group",
        "OwnerId": "123456789012",
        "CreatorRequestId": "my-request-id",
        "ShareStatus": "NOT_SHARED",
        "CreationTime": "2021-05-25T18:59:26.490017Z",
        "ModificationTime": "2021-05-25T18:59:26.490017Z"
    }
}

Untuk informasi selengkapnya, lihat Mengelola grup aturan dan aturan di DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakancreate-firewall-rule.

AWS CLI

Untuk membuat aturan firewall

create-firewall-ruleContoh berikut membuat aturan firewall dalam aturan DNS Firewall untuk domain yang terdaftar dalam daftar domain DNS Firewall.

aws route53resolver create-firewall-rule \
    --name allow-rule \
    --firewall-rule-group-id rslvr-frg-47f93271fexample \
    --firewall-domain-list-id rslvr-fdl-9e956e9ffexample \
    --priority 101 \
    --action ALLOW

Output:

{
    "FirewallRule": {
        "FirewallRuleGroupId": "rslvr-frg-47f93271fexample",
        "FirewallDomainListId": "rslvr-fdl-9e956e9ffexample",
        "Name": "allow-rule",
        "Priority": 101,
        "Action": "ALLOW",
        "CreatorRequestId": "d81e3fb7-020b-415e-939f-EXAMPLE11111",
        "CreationTime": "2021-05-25T21:44:00.346093Z",
        "ModificationTime": "2021-05-25T21:44:00.346093Z"
    }
}

Untuk informasi selengkapnya, lihat Mengelola grup aturan dan aturan di DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakancreate-resolver-endpoint.

AWS CLI

Untuk membuat titik akhir Resolver masuk

create-resolver-endpointContoh berikut membuat titik akhir Resolver inbound. Anda dapat menggunakan perintah yang sama untuk membuat titik akhir masuk dan keluar.

aws route53resolver buat-resolver-endpoint --name my-inbound-endpoint --creator-request-id 2020-01- 01-18:47 --security-group-ids “sg-f62bexam” --arah INBOUND --ip-address =subnet-ba47exam, Ip=192.0.2.255 =subnet-12d8exam, Ip=192.0.2.254 SubnetId SubnetId

Output:

{
    "ResolverEndpoint": {
        "Id": "rslvr-in-f9ab8a03f1example",
        "CreatorRequestId": "2020-01-01-18:47",
        "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-endpoint/rslvr-in-f9ab8a03f1example",
        "Name": "my-inbound-endpoint",
        "SecurityGroupIds": [
            "sg-f62bexam"
        ],
        "Direction": "INBOUND",
        "IpAddressCount": 2,
        "HostVPCId": "vpc-304examp",
        "Status": "CREATING",
        "StatusMessage": "[Trace id: 1-5dc1ff84-f3477826e4a190025example] Creating the Resolver Endpoint",
        "CreationTime": "2020-01-01T23:02:29.583Z",
        "ModificationTime": "2020-01-01T23:02:29.583Z"
    }
}

Untuk membuat titik akhir Resolver keluar

create-resolver-endpointContoh berikut membuat titik akhir resolver keluar menggunakan nilai-nilai dalam dokumen. JSON-formatted create-outbound-resolver-endpoint.json

aws route53resolver create-resolver-endpoint \
    --cli-input-json file://c:\temp\create-outbound-resolver-endpoint.json

Isi dari create-outbound-resolver-endpoint.json:

{
   "CreatorRequestId": "2020-01-01-18:47",
   "Direction": "OUTBOUND",
   "IpAddresses": [
      {
         "Ip": "192.0.2.255",
         "SubnetId": "subnet-ba47exam"
      },
      {
         "Ip": "192.0.2.254",
         "SubnetId": "subnet-12d8exam"
      }
   ],
   "Name": "my-outbound-endpoint",
   "SecurityGroupIds": [ "sg-05cd7b25d6example" ],
   "Tags": [
      {
         "Key": "my-key-name",
         "Value": "my-key-value"
      }
   ]
}

Untuk informasi lebih lanjut, lihat Menyelesaikan permintaan DNS antara VPC dan jaringan Anda di Panduan Developer Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakancreate-resolver-rule.

AWS CLI

Untuk membuat aturan Resolver

create-resolver-ruleContoh berikut membuat aturan penerusan Resolver. Aturan menggunakan titik akhir keluar rslvr-out-d5e5920e37example untuk meneruskan kueri DNS ke alamat IP 10.24.8.75 dan 10.24.8.156. example.com

aws route53resolver create-resolver-rule \
    --creator-request-id 2020-01-02-18:47 \
    --domain-name example.com \
    --name my-rule \
    --resolver-endpoint-id rslvr-out-d5e5920e37example \
    --rule-type FORWARD \
    --target-ips "Ip=10.24.8.75" "Ip=10.24.8.156"

Output:

{
    "ResolverRule": {
        "Status": "COMPLETE",
        "RuleType": "FORWARD",
        "ResolverEndpointId": "rslvr-out-d5e5920e37example",
        "Name": "my-rule",
        "DomainName": "example.com.",
        "CreationTime": "2022-05-10T21:35:30.923187Z",
        "TargetIps": [
            {
                "Ip": "10.24.8.75",
                "Port": 53
            },
            {
                "Ip": "10.24.8.156",
                "Port": 53
            }
        ],
        "CreatorRequestId": "2022-05-10-16:33",
        "ModificationTime": "2022-05-10T21:35:30.923187Z",
        "ShareStatus": "NOT_SHARED",
        "Arn": "arn:aws:route53resolver:us-east-1:111117012054:resolver-rule/rslvr-rr-b1e0b905e93611111",
        "OwnerId": "111111111111",
        "Id": "rslvr-rr-rslvr-rr-b1e0b905e93611111",
        "StatusMessage": "[Trace id: 1-22222222-3e56afcc71a3724664f22e24] Successfully created Resolver Rule."
    }
}

Contoh kode berikut menunjukkan cara menggunakandelete-firewall-domain-list.

AWS CLI

Untuk menghapus daftar domain Route 53 Resolver DNS Firewall

delete-firewall-domain-listContoh berikut menghapus daftar domain Route 53 Resolver DNS Firewall, bernama test, di akun Anda AWS .

aws route53resolver delete-firewall-domain-list \
    --firewall-domain-list-id rslvr-fdl-9e956e9ffexample

Output:

{
    "FirewallDomainList": {
        "Id": "rslvr-fdl-9e956e9ffexample",
        "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-domain-list/rslvr-fdl-9e956e9ffexample",
        "Name": "test",
        "DomainCount": 6,
        "Status": "DELETING",
        "StatusMessage": "Deleting the Firewall Domain List",
        "CreatorRequestId": "my-request-id",
        "CreationTime": "2021-05-25T15:55:51.115365Z",
        "ModificationTime": "2021-05-25T18:58:05.588024Z"
    }
}

Untuk informasi selengkapnya, lihat M engelola daftar domain Anda sendiri di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakandelete-firewall-rule-group.

AWS CLI

Untuk menghapus grup aturan firewall

delete-firewall-rule-groupContoh berikut menghapus grup aturan firewall.

aws route53resolver delete-firewall-rule-group \
    --firewall-rule-group-id rslvr-frg-47f93271fexample

Output:

{
    "FirewallRuleGroup": {
        "Id": "rslvr-frg-47f93271fexample",
        "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-rule-group/rslvr-frg-47f93271fexample",
        "Name": "test",
        "RuleCount": 0,
        "Status": "UPDATING",
        "StatusMessage": "Updating Firewall Rule Group",
        "OwnerId": "123456789012",
        "CreatorRequestId": "my-request-id",
        "ShareStatus": "NOT_SHARED",
        "CreationTime": "2021-05-25T18:59:26.490017Z",
        "ModificationTime": "2021-05-25T21:51:53.028688Z"
    }
}

Untuk informasi selengkapnya, lihat Mengelola grup aturan dan aturan di DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakandelete-firewall-rule.

AWS CLI

Untuk menghapus aturan firewall

delete-firewall-ruleContoh berikut menghapus aturan firewall yang ditentukan.

aws route53resolver delete-firewall-rule \
    --firewall-rule-group-id rslvr-frg-47f93271fexample \
    --firewall-domain-list-id rslvr-fdl-9e956e9ffexample

Output:

{
    "FirewallRule": {
        "FirewallRuleGroupId": "rslvr-frg-47f93271fexample",
        "FirewallDomainListId": "rslvr-fdl-9e956e9ffexample",
        "Name": "allow-rule",
        "Priority": 102,
        "Action": "ALLOW",
        "CreatorRequestId": "d81e3fb7-020b-415e-939f-EXAMPLE11111",
        "CreationTime": "2021-05-25T21:44:00.346093Z",
        "ModificationTime": "2021-05-25T21:45:59.611600Z"
    }
}

Untuk informasi selengkapnya, lihat Mengelola grup aturan dan aturan di DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakandelete-resolver-endpoint.

AWS CLI

Untuk menghapus titik akhir Resolver

delete-resolver-endpointContoh berikut menghapus titik akhir yang ditentukan.

Penting Jika Anda menghapus titik akhir masuk, kueri DNS dari jaringan Anda tidak lagi diteruskan ke Resolver di VPC yang Anda tentukan di titik akhir. Jika Anda menghapus titik akhir keluar, Resolver berhenti meneruskan kueri DNS dari VPC ke jaringan untuk aturan yang menentukan titik akhir keluar yang dihapus.

aws route53resolver delete-resolver-endpoint \
    --resolver-endpoint-id rslvr-in-497098ad59example

Output:

{
    "ResolverEndpoint": {
        "Id": "rslvr-in-497098ad59example",
        "CreatorRequestId": "AWSConsole.25.157290example",
        "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-endpoint/rslvr-in-497098ad59example",
        "Name": "my-inbound-endpoint",
        "SecurityGroupIds": [
            "sg-05cd7b25d6example"
        ],
        "Direction": "INBOUND",
        "IpAddressCount": 5,
        "HostVPCId": "vpc-304bexam",
        "Status": "DELETING",
        "StatusMessage": "[Trace id: 1-5dc5b658-811b5be0922bbc382example] Deleting ResolverEndpoint.",
        "CreationTime": "2020-01-01T23:25:45.538Z",
        "ModificationTime": "2020-01-02T23:25:45.538Z"
    }
}

Contoh kode berikut menunjukkan cara menggunakandelete-resolver-rule.

AWS CLI

Untuk menghapus aturan Resolver

delete-resolver-ruleContoh berikut menghapus aturan yang ditentukan.

Catatan Jika aturan dikaitkan dengan VPC apa pun, Anda harus terlebih dahulu melepaskan aturan dari VPC sebelum Anda dapat menghapusnya.

aws route53resolver delete-resolver-rule \
    --resolver-rule-id rslvr-rr-5b3809426bexample

Output:

{
    "ResolverRule": {
        "Id": "rslvr-rr-5b3809426bexample",
        "CreatorRequestId": "2020-01-03-18:47",
        "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-rule/rslvr-rr-5b3809426bexample",
        "DomainName": "zenith.example.com.",
        "Status": "DELETING",
        "StatusMessage": "[Trace id: 1-5dc5e05b-602e67b052cb74f05example] Deleting Resolver Rule.",
        "RuleType": "FORWARD",
        "Name": "my-resolver-rule",
        "TargetIps": [
            {
                "Ip": "192.0.2.50",
                "Port": 53
            }
        ],
        "ResolverEndpointId": "rslvr-out-d5e5920e3example",
        "OwnerId": "111122223333",
        "ShareStatus": "NOT_SHARED"
    }
}

Contoh kode berikut menunjukkan cara menggunakandisassociate-firewall-rule-group.

AWS CLI

Untuk memisahkan grup aturan firewall dari VPC

disassociate-firewall-rule-groupContoh berikut memisahkan grup aturan DNS Firewall dari Amazon VPC.

aws route53resolver disassociate-firewall-rule-group \
    --firewall-rule-group-association-id rslvr-frgassoc-57e8873d7example

Output:

{
    "FirewallRuleGroupAssociation": {
        "Id": "rslvr-frgassoc-57e8873d7example",
        "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-rule-group-association/rslvr-frgassoc-57e8873d7example",
        "FirewallRuleGroupId": "rslvr-frg-47f93271fexample",
        "VpcId": "vpc-31e92222",
        "Name": "test-association",
        "Priority": 103,
        "MutationProtection": "DISABLED",
        "Status": "DELETING",
        "StatusMessage": "Deleting the Firewall Rule Group Association",
        "CreatorRequestId": "2ca1a304-32b3-4f5f-bc4c-EXAMPLE11111",
        "CreationTime": "2021-05-25T21:47:48.755768Z",
        "ModificationTime": "2021-05-25T21:51:02.377887Z"
    }
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi antara grup aturan Firewall DNS VPC dan Route 53 Resolver di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakandisassociate-resolver-endpoint-ip-address.

AWS CLI

Untuk memisahkan alamat IP dari titik akhir Resolver

disassociate-resolver-endpoint-ip-addressContoh berikut menghapus alamat IP dari titik akhir masuk atau keluar Resolver yang ditentukan.

Catatan Titik akhir harus memiliki setidaknya dua alamat IP. Jika titik akhir saat ini hanya memiliki dua alamat IP dan Anda ingin mengganti satu alamat dengan alamat lain, Anda harus terlebih dahulu menggunakan associate-resolver-endpoint-ip- alamat untuk mengaitkan alamat IP baru. Kemudian Anda dapat memisahkan salah satu alamat IP asli dari titik akhir.

aws route53resolver disassociate-resolver-endpoint-ip-address \
    --resolver-endpoint-id rslvr-in-f9ab8a03f1example \
    --ip-address="SubnetId=subnet-12d8a459,Ip=172.31.40.121"

Output:

{
    "ResolverEndpoint": {
        "Id": "rslvr-in-f9ab8a03f1example",
        "CreatorRequestId": "2020-01-01-18:47",
        "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-endpoint/rslvr-in-f9ab8a03f1example",
        "Name": "my-inbound-endpoint",
        "SecurityGroupIds": [
            "sg-f62bexam"
        ],
        "Direction": "INBOUND",
        "IpAddressCount": 3,
        "HostVPCId": "vpc-304bexam",
        "Status": "UPDATING",
        "StatusMessage": "Updating the Resolver Endpoint",
        "CreationTime": "2020-01-01T23:02:29.583Z",
        "ModificationTime": "2020-01-05T23:02:29.583Z"
    }
}

Contoh kode berikut menunjukkan cara menggunakandisassociate-resolver-rule.

AWS CLI

Untuk memisahkan aturan Resolver dari Amazon VPC

disassociate-resolver-ruleContoh berikut menghapus hubungan antara aturan Resolver yang ditentukan dan VPC yang ditentukan. Anda dapat memutuskan hubungan aturan dari VPC dalam keadaan berikut:

Untuk kueri DNS yang berasal dari VPC ini, Anda ingin Resolver menghentikan penerusan kueri ke jaringan Anda untuk nama domain yang ditentukan dalam aturan. Anda ingin menghapus aturan penerusan. Jika aturan saat ini terkait dengan satu atau beberapa VPC, Anda harus memisahkan aturan dari semua VPC sebelum dapat menghapusnya.

aws route53resolver disassociate-resolver-rule \
    --resolver-rule-id rslvr-rr-4955cb98ceexample \
    --vpc-id vpc-304bexam

Output:

{
    "ResolverRuleAssociation": {
        "Id": "rslvr-rrassoc-322f4e8b9cexample",
        "ResolverRuleId": "rslvr-rr-4955cb98ceexample",
        "Name": "my-resolver-rule-association",
        "VPCId": "vpc-304bexam",
        "Status": "DELETING",
        "StatusMessage": "[Trace id: 1-5dc5ffa2-a26c38004c1f94006example] Deleting Association"
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-firewall-config.

AWS CLI

Untuk mendapatkan konfigurasi firewall untuk VPC

get-firewall-configContoh berikut mengambil perilaku DNS Firewall untuk VPC yang ditentukan.

aws route53resolver get-firewall-config \
    --resource-id vpc-31e92222

Output:

{
    "FirewallConfig": {
        "Id": "rslvr-fc-86016850cexample",
        "ResourceId": "vpc-31e9222",
        "OwnerId": "123456789012",
        "FirewallFailOpen": "DISABLED"
    }
}

Untuk informasi selengkapnya, lihat Konfigurasi DNS Firewall VPC di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanget-firewall-domain-list.

AWS CLI

Untuk mendapatkan daftar domain Route 53 Resolver DNS Firewall

get-firewall-domain-listContoh berikut mengambil daftar domain dengan ID yang Anda tentukan.

aws route53resolver get-firewall-domain-list \
    --firewall-domain-list-id rslvr-fdl-42b60677cexample

Output:

{
    "FirewallDomainList": {
        "Id": "rslvr-fdl-9e956e9ffexample",
        "Arn": "arn:aws:route53resolver:us-west-2:123457689012:firewall-domain-list/rslvr-fdl-42b60677cexample",
        "Name": "test",
        "DomainCount": 0,
        "Status": "COMPLETE",
        "StatusMessage": "Created Firewall Domain List",
        "CreatorRequestId": "my-request-id",
        "CreationTime": "2021-05-25T15:55:51.115365Z",
        "ModificationTime": "2021-05-25T15:55:51.115365Z"
    }
}

Untuk informasi selengkapnya, lihat M engelola daftar domain Anda sendiri di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanget-firewall-rule-group-association.

AWS CLI

Untuk mendapatkan asosiasi grup aturan firewall

get-firewall-rule-group-associationContoh berikut mengambil asosiasi grup aturan firewall.

aws route53resolver get-firewall-rule-group-association \
    --firewall-rule-group-association-id rslvr-frgassoc-57e8873d7example

Output:

{
    "FirewallRuleGroupAssociation": {
        "Id": "rslvr-frgassoc-57e8873d7example",
        "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-rule-group-association/rslvr-frgassoc-57e8873d7example",
        "FirewallRuleGroupId": "rslvr-frg-47f93271fexample",
        "VpcId": "vpc-31e92222",
        "Name": "test-association",
        "Priority": 101,
        "MutationProtection": "DISABLED",
        "Status": "COMPLETE",
        "StatusMessage": "Finished rule group association update",
        "CreatorRequestId": "2ca1a304-32b3-4f5f-bc4c-EXAMPLE11111",
        "CreationTime": "2021-05-25T21:47:48.755768Z",
        "ModificationTime": "2021-05-25T21:47:48.755768Z"
    }
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi antara grup aturan Firewall DNS VPC dan Route 53 Resolver di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanget-firewall-rule-group-policy.

AWS CLI

Untuk mendapatkan kebijakan AWS IAM

get-firewall-rule-group-policyContoh berikut mendapatkan kebijakan AWS Identitas dan Manajemen Akses (AWS IAM) untuk berbagi grup aturan yang ditentukan.

aws route53resolver get-firewall-rule-group-policy \
    --arn arn:aws:route53resolver:us-west-2:AWS_ACCOUNT_ID:firewall-rule-group/rslvr-frg-47f93271fexample

Output:

{
    "FirewallRuleGroupPolicy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"test\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::AWS_ACCOUNT_ID:root\"},\"Action\":[\"route53resolver:GetFirewallRuleGroup\",\"route53resolver:ListFirewallRuleGroups\"],\"Resource\":\"arn:aws:route53resolver:us-east-1:AWS_ACCOUNT_ID:firewall-rule-group/rslvr-frg-47f93271fexample\"}]}"
}

Untuk informasi selengkapnya, lihat Mengelola grup aturan dan aturan di DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanget-firewall-rule-group.

AWS CLI

Untuk mendapatkan grup aturan Firewall

get-firewall-rule-groupContoh berikut mengambil informasi tentang grup aturan DNS Firewall dengan ID yang Anda berikan.

aws route53resolver get-firewall-rule-group \
    --firewall-rule-group-id rslvr-frg-47f93271fexample

Output:

{
    "FirewallRuleGroup": {
        "Id": "rslvr-frg-47f93271fexample",
        "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-rule-group/rslvr-frg-47f93271fexample",
        "Name": "test",
        "RuleCount": 0,
        "Status": "COMPLETE",
        "StatusMessage": "Created Firewall Rule Group",
        "OwnerId": "123456789012",
        "CreatorRequestId": "my-request-id",
        "ShareStatus": "NOT_SHARED",
        "CreationTime": "2021-05-25T18:59:26.490017Z",
        "ModificationTime": "2021-05-25T18:59:26.490017Z"
    }
}

Untuk informasi selengkapnya, lihat Mengelola grup aturan dan aturan di DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanget-resolver-endpoint.

AWS CLI

Untuk mendapatkan informasi tentang titik akhir Resolver

get-resolver-endpointContoh berikut menampilkan detail untuk titik akhir yang ditentukan keluar. Anda dapat menggunakan get-resolver-endpoint untuk titik akhir masuk dan keluar dengan menentukan ID titik akhir yang berlaku.

aws route53resolver get-resolver-endpoint \
    --resolver-endpoint-id rslvr-out-d5e5920e37example

Output:

{
    "ResolverEndpoint": {
        "Id": "rslvr-out-d5e5920e37example",
        "CreatorRequestId": "2020-01-01-18:47",
        "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-endpoint/rslvr-out-d5e5920e37example",
        "Name": "my-outbound-endpoint",
        "SecurityGroupIds": [
            "sg-05cd7b25d6example"
        ],
        "Direction": "OUTBOUND",
        "IpAddressCount": 2,
        "HostVPCId": "vpc-304bexam",
        "Status": "OPERATIONAL",
        "StatusMessage": "This Resolver Endpoint is operational.",
        "CreationTime": "2020-01-01T23:50:50.979Z",
        "ModificationTime": "2020-01-02T23:50:50.979Z"
    }
}

Untuk informasi selengkapnya, lihat Nilai yang Anda Tentukan Saat Membuat atau Mengedit Titik Akhir Masuk di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanget-resolver-rule-association.

AWS CLI

Untuk mendapatkan informasi tentang hubungan antara aturan Resolver dan VPC

get-resolver-rule-associationContoh berikut menampilkan rincian tentang hubungan antara aturan Resolver tertentu dan VPC. Anda mengaitkan aturan resolver dan VPC menggunakan asosiate-resolver-rule. 

aws route53resolver get-resolver-rule-association \
    --resolver-rule-association-id rslvr-rrassoc-d61cbb2c8bexample

Output:

{
    "ResolverRuleAssociation": {
        "Id": "rslvr-rrassoc-d61cbb2c8bexample",
        "ResolverRuleId": "rslvr-rr-42b60677c0example",
        "Name": "my-resolver-rule-association",
        "VPCId": "vpc-304bexam",
        "Status": "COMPLETE",
        "StatusMessage": ""
    }
}

Contoh kode berikut menunjukkan cara menggunakanget-resolver-rule.

AWS CLI

Untuk mendapatkan informasi tentang aturan Resolver

get-resolver-ruleContoh berikut menampilkan detail tentang aturan Resolver yang ditentukan, seperti nama domain tempat aturan meneruskan kueri DNS dan ID titik akhir resolver keluar yang terkait dengan aturan tersebut.

aws route53resolver get-resolver-rule \
    --resolver-rule-id rslvr-rr-42b60677c0example

Output:

{
    "ResolverRule": {
        "Id": "rslvr-rr-42b60677c0example",
        "CreatorRequestId": "2020-01-01-18:47",
        "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-rule/rslvr-rr-42b60677c0example",
        "DomainName": "example.com.",
        "Status": "COMPLETE",
        "StatusMessage": "[Trace id: 1-5dc4b177-ff1d9d001a0f80005example] Successfully created Resolver Rule.",
        "RuleType": "FORWARD",
        "Name": "my-rule",
        "TargetIps": [
            {
                "Ip": "192.0.2.45",
                "Port": 53
            }
        ],
        "ResolverEndpointId": "rslvr-out-d5e5920e37example",
        "OwnerId": "111122223333",
        "ShareStatus": "NOT_SHARED"
    }
}

Untuk informasi selengkapnya, lihat Nilai yang Anda Tentukan Saat Membuat atau Mengedit Aturan di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanimport-firewall-domains.

AWS CLI

Untuk mengimpor domain ke daftar domain

import-firewall-domainsContoh berikut mengimpor sekumpulan domain dari file ke dalam daftar domain DNS Firewall yang Anda tentukan.

aws route53resolver import-firewall-domains \
    --firewall-domain-list-id rslvr-fdl-d61cbb2cbexample \
    --operation REPLACE \
    --domain-file-url s3://PATH/TO/YOUR/FILE

Output:

{
    "Id": "rslvr-fdl-d61cbb2cbexample",
    "Name": "test",
    "Status": "IMPORTING",
    "StatusMessage": "Importing domains from provided file."
}

Untuk informasi selengkapnya, lihat M engelola daftar domain Anda sendiri di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-firewall-configs.

AWS CLI

Untuk membuat daftar konfigurasi firewall

list-firewall-configsContoh berikut mencantumkan konfigurasi DNS Firewall Anda.

aws route53resolver list-firewall-configs

Output:

{
    "FirewallConfigs": [
        {
            "Id": "rslvr-fc-86016850cexample",
            "ResourceId": "vpc-31e92222",
            "OwnerId": "123456789012",
            "FirewallFailOpen": "DISABLED"
        }
    ]
}

Untuk informasi selengkapnya, lihat Konfigurasi DNS Firewall VPC di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-firewall-domain-lists.

AWS CLI

Untuk mencantumkan semua daftar domain Route 53 Resolver DNS Firewall

list-firewall-domain-listsContoh berikut mencantumkan semua daftar domain.

aws route53resolver list-firewall-domain-lists

Output:

{
    "FirewallDomainLists": [
        {
            "Id": "rslvr-fdl-2c46f2ecfexample",
            "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-domain-list/rslvr-fdl-2c46f2ecfexample",
            "Name": "AWSManagedDomainsMalwareDomainList",
            "CreatorRequestId": "AWSManagedDomainsMalwareDomainList",
            "ManagedOwnerName": "Route 53 Resolver DNS Firewall"
        },
        {
            "Id": "rslvr-fdl-aa970e9e1example",
            "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-domain-list/rslvr-fdl-aa970e9e1example",
            "Name": "AWSManagedDomainsBotnetCommandandControl",
            "CreatorRequestId": "AWSManagedDomainsBotnetCommandandControl",
            "ManagedOwnerName": "Route 53 Resolver DNS Firewall"
        },
        {
            "Id": "rslvr-fdl-42b60677cexample",
            "Arn": "arn:aws:route53resolver:us-west-2:123456789111:firewall-domain-list/rslvr-fdl-42b60677cexample",
            "Name": "test",
            "CreatorRequestId": "my-request-id"
        }
    ]
}

Untuk informasi selengkapnya, lihat daftar domain Route 53 Resolver DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-firewall-domains.

AWS CLI

Untuk mencantumkan domain dalam daftar domain

list-firewall-domainsContoh berikut mencantumkan domain dalam daftar domain DNS Firewall yang Anda tentukan.

aws route53resolver list-firewall-domains \
    --firewall-domain-list-id rslvr-fdl-d61cbb2cbexample

Output:

{
    "Domains": [
        "test1.com.",
        "test2.com.",
        "test3.com."
    ]
}

Untuk informasi selengkapnya, lihat M engelola daftar domain Anda sendiri di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-firewall-rule-group-associations.

AWS CLI

Untuk membuat daftar asosiasi grup aturan Firewall DNS

list-firewall-rule-group-associationsContoh berikut mencantumkan asosiasi grup aturan Firewall DNS Anda dengan Amazon VPC.

aws route53resolver list-firewall-rule-group-associations

Output:

{
    "FirewallRuleGroupAssociations": [
        {
            "Id": "rslvr-frgassoc-57e8873d7example",
            "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-rule-group-association/rslvr-frgassoc-57e8873d7example",
            "FirewallRuleGroupId": "rslvr-frg-47f93271fexample",
            "VpcId": "vpc-31e92222",
            "Name": "test-association",
            "Priority": 101,
            "MutationProtection": "DISABLED",
            "Status": "UPDATING",
            "StatusMessage": "Creating Firewall Rule Group Association",
            "CreatorRequestId": "2ca1a304-32b3-4f5f-bc4c-EXAMPLE11111",
            "CreationTime": "2021-05-25T21:47:48.755768Z",
            "ModificationTime": "2021-05-25T21:47:48.755768Z"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi antara VPC dan grup aturan Firewall DNS Resolver Route 53 di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-firewall-rule-groups.

AWS CLI

Untuk mendapatkan daftar grup aturan Firewall

list-firewall-rule-groupsContoh berikut mencantumkan grup aturan Firewall DNS Anda.

aws route53resolver list-firewall-rule-groups

Output:

{
    "FirewallRuleGroups": [
        {
            "Id": "rslvr-frg-47f93271fexample",
            "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-rule-group/rslvr-frg-47f93271fexample",
            "Name": "test",
            "OwnerId": "123456789012",
            "CreatorRequestId": "my-request-id",
            "ShareStatus": "NOT_SHARED"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola grup aturan dan aturan di DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-firewall-rules.

AWS CLI

Untuk mencantumkan aturan firewall

list-firewall-rulesContoh berikut mencantumkan semua aturan Firewall DNS Anda dalam grup aturan firewall.

aws route53resolver list-firewall-rules \
    --firewall-rule-group-id rslvr-frg-47f93271fexample

Output:

{
    "FirewallRules": [
        {
            "FirewallRuleGroupId": "rslvr-frg-47f93271fexample",
            "FirewallDomainListId": "rslvr-fdl-9e956e9ffexample",
            "Name": "allow-rule",
            "Priority": 101,
            "Action": "ALLOW",
            "CreatorRequestId": "d81e3fb7-020b-415e-939f-EXAMPLE11111",
            "CreationTime": "2021-05-25T21:44:00.346093Z",
            "ModificationTime": "2021-05-25T21:44:00.346093Z"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola grup aturan dan aturan di DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-resolver-endpoint-ip-addresses.

AWS CLI

Untuk mencantumkan alamat IP untuk titik akhir masuk atau keluar tertentu

list-resolver-endpoint-ip-addressesContoh berikut mencantumkan informasi tentang alamat IP yang terkait dengan titik akhir masuk. rslvr-in-f9ab8a03f1example Anda juga dapat menggunakan list-resolver-endpoint-ip-addresses untuk titik akhir keluar dengan menentukan ID titik akhir yang berlaku.

aws route53resolver list-resolver-endpoint-ip-addresses \
    --resolver-endpoint-id rslvr-in-f9ab8a03f1example

Output:

{
    "MaxResults": 10,
    "IpAddresses": [
        {
            "IpId": "rni-1de60cdbfeexample",
            "SubnetId": "subnet-ba47exam",
            "Ip": "192.0.2.44",
            "Status": "ATTACHED",
            "StatusMessage": "This IP address is operational.",
            "CreationTime": "2020-01-03T23:02:29.587Z",
            "ModificationTime": "2020-01-03T23:03:05.555Z"
        },
        {
            "IpId": "rni-aac7085e38example",
            "SubnetId": "subnet-12d8exam",
            "Ip": "192.0.2.45",
            "Status": "ATTACHED",
            "StatusMessage": "This IP address is operational.",
            "CreationTime": "2020-01-03T23:02:29.593Z",
            "ModificationTime": "2020-01-03T23:02:55.060Z"
        }
    ]
}

Untuk informasi selengkapnya tentang nilai dalam output, lihat Nilai yang Anda Tentukan Saat Membuat atau Mengedit Titik Akhir Masuk, dan Nilai yang Anda Tentukan Saat Membuat atau Mengedit Titik Akhir Keluar, keduanya di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-resolver-endpoints.

AWS CLI

Untuk membuat daftar titik akhir Resolver di Wilayah AWS

list-resolver-endpointsContoh berikut mencantumkan titik akhir Resolver masuk dan keluar yang ada di akun saat ini.

aws route53resolver list-resolver-endpoints

Output:

{
    "MaxResults": 10,
    "ResolverEndpoints": [
        {
            "Id": "rslvr-in-497098ad59example",
            "CreatorRequestId": "2020-01-01-18:47",
            "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-endpoint/rslvr-in-497098ad59example",
            "Name": "my-inbound-endpoint",
            "SecurityGroupIds": [
                "sg-05cd7b25d6example"
            ],
            "Direction": "INBOUND",
            "IpAddressCount": 2,
            "HostVPCId": "vpc-304bexam",
            "Status": "OPERATIONAL",
            "StatusMessage": "This Resolver Endpoint is operational.",
            "CreationTime": "2020-01-01T23:25:45.538Z",
            "ModificationTime": "2020-01-01T23:25:45.538Z"
        },
        {
            "Id": "rslvr-out-d5e5920e37example",
            "CreatorRequestId": "2020-01-01-18:48",
            "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-endpoint/rslvr-out-d5e5920e37example",
            "Name": "my-outbound-endpoint",
            "SecurityGroupIds": [
                "sg-05cd7b25d6example"
            ],
            "Direction": "OUTBOUND",
            "IpAddressCount": 2,
            "HostVPCId": "vpc-304bexam",
            "Status": "OPERATIONAL",
            "StatusMessage": "This Resolver Endpoint is operational.",
            "CreationTime": "2020-01-01T23:50:50.979Z",
            "ModificationTime": "2020-01-01T23:50:50.979Z"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-resolver-rule-associations.

AWS CLI

Untuk membuat daftar asosiasi antara aturan Resolver dan VPC

list-resolver-rule-associationsContoh berikut mencantumkan asosiasi antara aturan resolver dan VPC di akun saat ini AWS .

aws route53resolver list-resolver-rule-associations

Output:

{
    "MaxResults": 30,
    "ResolverRuleAssociations": [
        {
            "Id": "rslvr-autodefined-assoc-vpc-304bexam-internet-resolver",
            "ResolverRuleId": "rslvr-autodefined-rr-internet-resolver",
            "Name": "System Rule Association",
            "VPCId": "vpc-304bexam",
            "Status": "COMPLETE",
            "StatusMessage": ""
        },
        {
            "Id": "rslvr-rrassoc-d61cbb2c8bexample",
            "ResolverRuleId": "rslvr-rr-42b60677c0example",
            "Name": "my-resolver-rule-association",
            "VPCId": "vpc-304bexam",
            "Status": "COMPLETE",
            "StatusMessage": ""
        }
    ]
}

Untuk informasi selengkapnya, lihat Cara Route 53 Resolver Meneruskan Kueri DNS dari VPC Anda ke Jaringan Anda di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-resolver-rules.

AWS CLI

Untuk mencantumkan aturan Resolver

list-resolver-rulesContoh berikut mencantumkan semua aturan Resolver di AWS akun saat ini.

aws route53resolver list-resolver-rules

Output:

{
    "MaxResults": 30,
    "ResolverRules": [
        {
            "Id": "rslvr-autodefined-rr-internet-resolver",
            "CreatorRequestId": "",
            "Arn": "arn:aws:route53resolver:us-west-2::autodefined-rule/rslvr-autodefined-rr-internet-resolver",
            "DomainName": ".",
            "Status": "COMPLETE",
            "RuleType": "RECURSIVE",
            "Name": "Internet Resolver",
            "OwnerId": "Route 53 Resolver",
            "ShareStatus": "NOT_SHARED"
        },
        {
            "Id": "rslvr-rr-42b60677c0example",
            "CreatorRequestId": "2020-01-01-18:47",
            "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-rule/rslvr-rr-42b60677c0bc4e299",
            "DomainName": "example.com.",
            "Status": "COMPLETE",
            "StatusMessage": "[Trace id: 1-5dc4b177-ff1d9d001a0f80005example] Successfully created Resolver Rule.",
            "RuleType": "FORWARD",
            "Name": "my-rule",
            "TargetIps": [
                {
                    "Ip": "192.0.2.45",
                    "Port": 53
                }
            ],
            "ResolverEndpointId": "rslvr-out-d5e5920e37example",
            "OwnerId": "111122223333",
            "ShareStatus": "NOT_SHARED"
        }
    ]
}

Untuk informasi selengkapnya, lihat Cara Route 53 Resolver Meneruskan Kueri DNS dari VPC Anda ke Jaringan Anda di Panduan Pengembang Amazon Route 53.

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

AWS CLI

Untuk membuat daftar tag untuk sumber Resolver

list-tags-for-resourceContoh berikut mencantumkan tag yang ditetapkan untuk aturan Resolver yang ditentukan.

aws route53resolver list-tags-for-resource \
    --resource-arn "arn:aws:route53resolver:us-west-2:111122223333:resolver-rule/rslvr-rr-42b60677c0example"

Output:

{
    "Tags": [
        {
            "Key": "my-key-1",
            "Value": "my-value-1"
        },
        {
            "Key": "my-key-2",
            "Value": "my-value-2"
        }
    ]
}

Untuk informasi tentang menggunakan tag untuk alokasi biaya, lihat Menggunakan Tag Alokasi Biaya di Panduan Pengguna Pen AWS agihan dan Manajemen Biaya.

Contoh kode berikut menunjukkan cara menggunakanput-firewall-rule-group-policy.

AWS CLI

Untuk melampirkan kebijakan AWS IAM untuk berbagi kebijakan grup aturan Firewall

put-firewall-rule-group-policyContoh berikut melampirkan kebijakan AWS Identitas dan Manajemen Akses (AWS IAM) untuk berbagi grup aturan.

aws route53resolver put-firewall-rule-group-policy \
    --arn arn:aws:route53resolver:us-east-1:AWS_ACCOUNT_ID:firewall-rule-group/rslvr-frg-47f93271fexample \
    --firewall-rule-group-policy "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"test\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::AWS_ACCOUNT_ID:root\"},\"Action\":[\"route53resolver:GetFirewallRuleGroup\",\"route53resolver:ListFirewallRuleGroups\"],\"Resource\":\"arn:aws:route53resolver:us-east-1:AWS_ACCOUNT_ID:firewall-rule-group/rslvr-frg-47f93271fexample\"}]}"

Output:

{
    "ReturnValue": true
}

Untuk informasi selengkapnya, lihat Mengelola grup aturan dan aturan di DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanput-resolver-rule-policy.

AWS CLI

Cara berbagi aturan Resolver dengan akun lain AWS

put-resolver-rule-policyContoh berikut menentukan aturan Resolver yang ingin Anda bagikan dengan AWS akun lain, akun yang ingin Anda bagikan aturan, dan operasi terkait aturan yang Anda ingin akun dapat melakukan pada aturan.

Catatan Anda harus menjalankan perintah ini menggunakan kredenSIAL dari akun yang sama yang membuat aturan.

aws route53resolver put-resolver-rule-policy \
    --region us-east-1 \
    --arn "arn:aws:route53resolver:us-east-1:111122223333:resolver-rule/rslvr-rr-42b60677c0example" \
    --resolver-rule-policy "{\"Version\": \"2012-10-17\", \
        \"Statement\": [ { \
        \"Effect\" : \"Allow\", \
        \"Principal\" : {\"AWS\" : \"444455556666\" }, \
        \"Action\" : [ \
            \"route53resolver:GetResolverRule\", \
            \"route53resolver:AssociateResolverRule\", \
            \"route53resolver:DisassociateResolverRule\", \
            \"route53resolver:ListResolverRules\", \
            \"route53resolver:ListResolverRuleAssociations\" ], \
        \"Resource\" : [ \"arn:aws:route53resolver:us-east-1:111122223333:resolver-rule/rslvr-rr-42b60677c0example\" ] } ] }"

Output:

{
    "ReturnValue": true
}

Setelah menjalankanput-resolver-rule-policy, Anda dapat menjalankan dua perintah Resource Access Manager (RAM) berikut. Anda harus menggunakan akun yang ingin Anda bagikan aturan dengan:

get-resource-share-invitationsmengembalikan nilainyaresourceShareInvitationArn. Anda memerlukan nilai ini untuk menerima undangan untuk menggunakan aturan bersama. accept-resource-share-invitationmenerima undangan untuk menggunakan aturan bersama.

Untuk informasi selengkapnya, lihat dokumentasi berikut ini:

get-resource-share- accept-resource-share-invitation Berbagi Aturan Penerusan dengan Akun Lain dan Menggunakan Aturan Bersama di Panduan Pengembang Amazon Route 53 AWS

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk mengaitkan tag dengan sumber Resolver

tag-resourceContoh berikut mengaitkan dua key/value pasangan tag dengan aturan Resolver yang ditentukan.

aws route53resolver tag-resource \
    --resource-arn "arn:aws:route53resolver:us-west-2:111122223333:resolver-rule/rslvr-rr-42b60677c0example" \
    --tags "Key=my-key-1,Value=my-value-1" "Key=my-key-2,Value=my-value-2"

Perintah ini tidak menghasilkan output.

Untuk informasi tentang menggunakan tag untuk alokasi biaya, lihat Menggunakan Tag Alokasi Biaya di Panduan Pengguna Pen AWS agihan dan Manajemen Biaya.

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

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari sumber Resolver

untag-resourceContoh berikut menghapus dua tag dari aturan Resolver yang ditentukan.

aws route53resolver untag-resource \
    --resource-arn "arn:aws:route53resolver:us-west-2:111122223333:resolver-rule/rslvr-rr-42b60677c0example" \
    --tag-keys my-key-1 my-key-2

Perintah ini tidak menghasilkan output. Untuk mengonfirmasi bahwa tag telah dihapus, Anda dapat menggunakan tag -list-for-resource.

Untuk informasi tentang menggunakan tag untuk alokasi biaya, lihat Menggunakan Tag Alokasi Biaya di Panduan Pengguna Pen AWS agihan dan Manajemen Biaya.

Contoh kode berikut menunjukkan cara menggunakanupdate-firewall-config.

AWS CLI

Untuk memperbarui konfigurasi firewall

update-firewall-configContoh berikut memperbarui konfigurasi DNS Firewall.

aws route53resolver update-firewall-config \
    --resource-id vpc-31e92222 \
    --firewall-fail-open DISABLED

Output:

{
    "FirewallConfig": {
        "Id": "rslvr-fc-86016850cexample",
        "ResourceId": "vpc-31e92222",
        "OwnerId": "123456789012",
        "FirewallFailOpen": "DISABLED"
    }
}

Untuk informasi selengkapnya, lihat Konfigurasi DNS Firewall VPC di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanupdate-firewall-domains.

AWS CLI

Untuk memperbarui daftar domain

update-firewall-domainsContoh berikut menambahkan domain ke daftar domain dengan ID yang Anda berikan.

aws route53resolver update-firewall-domains \
    --firewall-domain-list-id rslvr-fdl-42b60677cexampleb \
    --operation ADD \
    --domains test1.com test2.com test3.com

Output:

{
    "Id": "rslvr-fdl-42b60677cexample",
    "Name": "test",
    "Status": "UPDATING",
    "StatusMessage": "Updating the Firewall Domain List"
}

Untuk informasi selengkapnya, lihat M engelola daftar domain Anda sendiri di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanupdate-firewall-rule-group-association.

AWS CLI

Untuk memperbarui asosiasi grup aturan firewall

update-firewall-rule-group-associationContoh berikut memperbarui asosiasi grup aturan firewall.

aws route53resolver update-firewall-rule-group-association \
    --firewall-rule-group-association-id rslvr-frgassoc-57e8873d7example \
    --priority 103

Output:

{
    "FirewallRuleGroupAssociation": {
        "Id": "rslvr-frgassoc-57e8873d7example",
        "Arn": "arn:aws:route53resolver:us-west-2:123456789012:firewall-rule-group-association/rslvr-frgassoc-57e8873d7example",
        "FirewallRuleGroupId": "rslvr-frg-47f93271fexample",
        "VpcId": "vpc-31e92222",
        "Name": "test-association",
        "Priority": 103,
        "MutationProtection": "DISABLED",
        "Status": "UPDATING",
        "StatusMessage": "Updating the Firewall Rule Group Association Attributes",
        "CreatorRequestId": "2ca1a304-32b3-4f5f-bc4c-EXAMPLE11111",
        "CreationTime": "2021-05-25T21:47:48.755768Z",
        "ModificationTime": "2021-05-25T21:50:09.272569Z"
    }
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi antara VPC dan grup aturan Firewall DNS Resolver Route 53 di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanupdate-firewall-rule.

AWS CLI

Untuk memperbarui aturan firewall

update-firewall-ruleContoh berikut memperbarui aturan firewall dengan parameter yang Anda tentukan.

aws route53resolver update-firewall-rule \
    --firewall-rule-group-id rslvr-frg-47f93271fexample \
    --firewall-domain-list-id rslvr-fdl-9e956e9ffexample \
    --priority 102

Output:

{
    "FirewallRule": {
        "FirewallRuleGroupId": "rslvr-frg-47f93271fexample",
        "FirewallDomainListId": "rslvr-fdl-9e956e9ffexample",
        "Name": "allow-rule",
        "Priority": 102,
        "Action": "ALLOW",
        "CreatorRequestId": "d81e3fb7-020b-415e-939f-EXAMPLE11111",
        "CreationTime": "2021-05-25T21:44:00.346093Z",
        "ModificationTime": "2021-05-25T21:45:59.611600Z"
    }
}

Untuk informasi selengkapnya, lihat Mengelola grup aturan dan aturan di DNS Firewall di Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanupdate-resolver-endpoint.

AWS CLI

Untuk memperbarui nama titik akhir Resolver

update-resolver-endpointContoh berikut memperbarui nama titik akhir Resolver. Memperbarui nilai lain tidak didukung.

aws route53resolver update-resolver-endpoint \
    --resolver-endpoint-id rslvr-in-b5d45e32bdc445f09 \
    --name my-renamed-inbound-endpoint

Output:

{
    "ResolverEndpoint": {
        "Id": "rslvr-in-b5d45e32bdexample",
        "CreatorRequestId": "2020-01-02-18:48",
        "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-endpoint/rslvr-in-b5d45e32bdexample",
        "Name": "my-renamed-inbound-endpoint",
        "SecurityGroupIds": [
            "sg-f62bexam"
        ],
        "Direction": "INBOUND",
        "IpAddressCount": 2,
        "HostVPCId": "vpc-304bexam",
        "Status": "OPERATIONAL",
        "StatusMessage": "This Resolver Endpoint is operational.",
        "CreationTime": "2020-01-01T18:33:59.265Z",
        "ModificationTime": "2020-01-08T18:33:59.265Z"
    }
}

Contoh kode berikut menunjukkan cara menggunakanupdate-resolver-rule.

AWS CLI

Contoh 1: Untuk memperbarui pengaturan titik akhir Resolver

update-resolver-ruleContoh berikut memperbarui nama aturan, alamat IP di jaringan lokal tempat kueri DNS diteruskan, dan ID titik akhir Resolver keluar yang Anda gunakan untuk meneruskan kueri ke jaringan Anda.

Catatan Nilai yang TargetIps ada untuk diganti, jadi Anda harus menentukan semua alamat IP yang Anda ingin memiliki aturan setelah pembaruan.

aws route53resolver update-resolver-rule \
    --resolver-rule-id rslvr-rr-1247fa64f3example \
    --config Name="my-2nd-rule",TargetIps=[{Ip=192.0.2.45,Port=53},{Ip=192.0.2.46,Port=53}],ResolverEndpointId=rslvr-out-7b89ed0d25example

Output:

{
    "ResolverRule": {
        "Id": "rslvr-rr-1247fa64f3example",
        "CreatorRequestId": "2020-01-02-18:47",
        "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-rule/rslvr-rr-1247fa64f3example",
        "DomainName": "www.example.com.",
        "Status": "COMPLETE",
        "StatusMessage": "[Trace id: 1-5dcc90b9-8a8ee860aba1ebd89example] Successfully updated Resolver Rule.",
        "RuleType": "FORWARD",
        "Name": "my-2nd-rule",
        "TargetIps": [
            {
                "Ip": "192.0.2.45",
                "Port": 53
            },
            {
                "Ip": "192.0.2.46",
                "Port": 53
            }
        ],
        "ResolverEndpointId": "rslvr-out-7b89ed0d25example",
        "OwnerId": "111122223333",
        "ShareStatus": "NOT_SHARED"
    }
}

Contoh 2: Untuk memperbarui pengaturan titik akhir Resolver menggunakan file untuk pengaturan ``config``

Sebagai alternatif, Anda dapat menyer config takan pengaturan dalam file JSON dan kemudian menentukan file itu saat Anda memanggilupdate-resolver-rule.

aws route53resolver update-resolver-rule \
    --resolver-rule-id rslvr-rr-1247fa64f3example \
    --config file://c:\temp\update-resolver-rule.json

Isi dari update-resolver-rule.json.

{
    "Name": "my-2nd-rule",
    "TargetIps": [
        {
            "Ip": "192.0.2.45",
            "Port": 53
        },
        {
            "Ip": "192.0.2.46",
            "Port": 53
        }
    ],
    "ResolverEndpointId": "rslvr-out-7b89ed0d25example"
}

Untuk informasi selengkapnya, lihat Nilai yang Anda Tentukan Saat Membuat atau Mengedit Aturan di Panduan Pengembang Amazon Route 53.