Contoh Route 53 Resolver menggunakan AWS CLI - AWS Contoh Kode SDK
Tindakan

Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh SDK AWS Doc. GitHub

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

Contoh Route 53 Resolver menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan 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 selengkapnya, lihat Mengelola asosiasi antara grup aturan VPC dan Route 53 Resolver DNS Firewall 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 masuk. Jika Anda hanya menentukan subnet ID 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 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 VPC Amazon. Setelah Anda menjalankan perintah, Resolver mulai meneruskan kueri DNS ke jaringan Anda berdasarkan pengaturan dalam aturan, seperti nama domain 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 akun Anda. AWS 

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 Mengelola 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 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 tercantum 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 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 menciptakan titik akhir Resolver inbound. Anda dapat menggunakan perintah yang sama untuk membuat endpoint masuk dan keluar.

aws route53resolver create-resolver-endpoint --name my-inbound-endpoint -- creator-request-id 2020-01- 01-18:47 -- security-group-ids “sg-f62bexam” --direction 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 endpoint resolver keluar menggunakan nilai-nilai dalam dokumen berformat JSON. 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 selengkapnya, lihat Menyelesaikan Kueri DNS Antara VPCs dan Jaringan Anda di Panduan Pengembang 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 rslvr-out-d contoh titik akhir 5e5920e37outbound 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 Mengelola 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 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 tertentu.

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 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 aturan apapun VPCs, Anda harus terlebih dahulu memisahkan aturan dari VPCs 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 VPC Amazon.

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 selengkapnya, lihat Mengelola asosiasi antara grup aturan VPC dan Route 53 Resolver DNS Firewall 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 tertentu.

Catatan Endpoint 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-address 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 VPC Amazon

disassociate-resolver-ruleContoh berikut menghapus hubungan antara aturan Resolver yang ditentukan dan VPC yang ditentukan. Anda dapat memisahkan 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 dikaitkan dengan satu atau lebih VPCs, Anda harus memisahkan aturan dari semua VPCs sebelum Anda 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 Mengelola 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 selengkapnya, lihat Mengelola asosiasi antara grup aturan VPC dan Route 53 Resolver DNS Firewall 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 Identity and Access Management (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 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 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 rincian untuk titik akhir yang ditentukan keluar. Anda dapat menggunakan get-resolver-endpoint 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 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 detail tentang hubungan antara aturan Resolver tertentu dan VPC. Anda mengaitkan aturan resolver dan VPC menggunakan. associate-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 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 dalam daftar domain

import-firewall-domainsContoh berikut mengimpor satu set 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 Mengelola 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 membuat daftar 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 membuat daftar 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 Mengelola daftar domain Anda sendiri di Panduan Pengembang Amazon Route 53.

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

AWS CLI

Untuk mencantumkan asosiasi grup aturan DNS Firewall

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

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 Anda dan grup aturan Route 53 Resolver DNS Firewall di Panduan Pengembang Amazon Route 53.

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

AWS CLI

Untuk mendapatkan daftar grup aturan Firewall Anda

list-firewall-rule-groupsContoh berikut mencantumkan grup aturan DNS Firewall 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 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 daftar aturan firewall

list-firewall-rulesContoh berikut mencantumkan semua aturan DNS Firewall 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 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 daftar 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 rslvr-in-f9ab8a03f1example masuk. Anda juga dapat menggunakan list-resolver-endpoint-ip-addresses 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 dalam Panduan Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-resolver-endpoints.

AWS CLI

Untuk mencantumkan 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 VPCs

list-resolver-rule-associationsContoh berikut mencantumkan asosiasi antara aturan resolver dan VPCs 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 Memajukan Kueri DNS dari Jaringan Anda ke Jaringan Anda di Panduan VPCs Pengembang Amazon Route 53.

Contoh kode berikut menunjukkan cara menggunakanlist-resolver-rules.

AWS CLI

Untuk membuat daftar aturan Resolver

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

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 Memajukan Kueri DNS dari Jaringan Anda ke Jaringan Anda di Panduan VPCs Pengembang Amazon Route 53.

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

AWS CLI

Untuk mencantumkan tag untuk sumber daya Resolver

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

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 penggunaan tag untuk alokasi biaya, lihat Menggunakan Tag Alokasi Biaya di Panduan Pengguna AWS Billing and Cost Management.

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

AWS CLI

Untuk melampirkan kebijakan AWS IAM untuk membagikan kebijakan grup aturan Firewall

put-firewall-rule-group-policyContoh berikut melampirkan kebijakan AWS Identity and Access Management (AWS IAM) untuk berbagi grup aturan.

aws route53resolver put-firewall-rule-group-policy \
    --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 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

Untuk 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 aturannya, dan operasi terkait aturan yang Anda inginkan agar akun dapat dilakukan sesuai aturan.

Catatan Anda harus menjalankan perintah ini menggunakan kredensyal 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 aturannya:

get-resource-share-invitationsmengembalikan nilairesourceShareInvitationArn. 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-invitationsaccept-resource-share-invitationsBerbagi Aturan Penerusan dengan AWS Akun Lain dan Menggunakan Aturan Bersama di Panduan Pengembang Amazon Route 53

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk mengaitkan tag dengan sumber daya 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 penggunaan tag untuk alokasi biaya, lihat Menggunakan Tag Alokasi Biaya di Panduan Pengguna AWS Billing and Cost Management.

  • Untuk detail API, lihat TagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari sumber daya 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 list-tags-for-resource.

Untuk informasi tentang penggunaan tag untuk alokasi biaya, lihat Menggunakan Tag Alokasi Biaya di Panduan Pengguna AWS Billing and Cost Management.

  • Untuk detail API, lihat UntagResourcedi Referensi AWS CLI Perintah.

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 Mengelola 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 Anda dan grup aturan Route 53 Resolver DNS Firewall 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 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 ditimpa, jadi Anda harus menentukan semua alamat IP yang ingin Anda miliki 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``

Anda juga dapat menyertakan config pengaturan dalam file JSON dan kemudian menentukan file itu saat Anda meneleponupdate-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 selengkapnya, lihat Nilai yang Anda Tentukan Saat Membuat atau Mengedit Aturan di Panduan Pengembang Amazon Route 53.