使用 Route 53 的解析器示例 Amazon CLI - Amazon Command Line Interface
操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 Route 53 的解析器示例 Amazon CLI

以下代码示例向您展示了如何使用与 Route 53 Resolver Amazon Command Line Interface 配合使用来执行操作和实现常见场景。

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景和跨服务示例的上下文查看操作。

场景是展示如何通过在同一服务中调用多个函数来完成特定任务任务的代码示例。

每个示例都包含一个指向的链接 GitHub，您可以在其中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

以下代码示例演示如何使用 associate-firewall-rule-group。

Amazon CLI

将防火墙规则组与 VPC 关联

以下associate-firewall-rule-group示例将 DNS 防火墙规则组与 Amazon VPC 关联起来。

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

输出：

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

有关更多信息，请参阅《亚马逊 Route 53 开发者指南》中的管理您的 VPC 和 Route 53 解析器 DNS 防火墙规则组之间的关联。

以下代码示例演示如何使用 associate-resolver-endpoint-ip-address。

Amazon CLI

将另一个 IP 地址与解析器端点相关联

以下associate-resolver-endpoint-ip-address示例将另一个 IP 地址与入站 Resolver 端点相关联。如果您仅指定子网 ID 而在--ip-address参数中省略了 IP 地址，则 Resolver 会从指定子网中的可用 IP 地址中为您选择一个 IP 地址。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的您在创建或编辑入站终端节点时指定的值。

以下代码示例演示如何使用 associate-resolver-rule。

Amazon CLI

将解析器规则与 VPC 关联

以下associate-resolver-rule示例将解析器规则与 Amazon VPC 关联起来。运行命令后，Resolver 开始根据规则中的设置（例如转发的查询的域名）将 DNS 查询转发到您的网络。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的将出站 DNS 查询转发到您的网络。

以下代码示例演示如何使用 create-firewall-domain-list。

Amazon CLI

创建 Route 53 解析器 DNS 防火墙域列表

以下create-firewall-domain-list示例在您的 Amazon 账户中创建名为 test 的 Route 53 Resolver DNS 防火墙域列表。

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

输出：

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

有关更多信息，请参阅《Amazon Route 53 开发者指南》中的管理自己的域名列表。

以下代码示例演示如何使用 create-firewall-rule-group。

Amazon CLI

创建防火墙规则组

以下create-firewall-rule-group示例创建 DNS 防火墙规则组。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理 DNS 防火墙中的规则组和规则。

以下代码示例演示如何使用 create-firewall-rule。

Amazon CLI

创建防火墙规则

以下create-firewall-rule示例在 DNS 防火墙规则中为 DNS 防火墙域列表中列出的域创建防火墙规则。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理 DNS 防火墙中的规则组和规则。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考CreateFirewallRule中的。

以下代码示例演示如何使用 create-resolver-endpoint。

Amazon CLI

创建入站解析器端点

以下create-resolver-endpoint示例创建了一个入站解析器端点。您可以使用相同的命令来创建入站和出站终端节点。

aws route53resolver — create-resolver-endpoint name — creator-request-id 2020-01-01-18:47 — “sg-f62bexam” — security-group-ids “sg-f62be my-inbound-endpoint xam” — direction INBOUND — ip-addressions =subnet-ba47exam，Ip=192.0.2.255 =subnet-12d8exam，Ip=192.0.2.254 SubnetId SubnetId

输出：

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

创建出站解析器终端节点

以下create-resolver-endpoint示例使用 JSON 格式文档中的值创建出站解析器端点。create-outbound-resolver-endpoint.json

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

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

有关更多信息，请参阅 Amazon Route 53 Developer Guide 中解析 VPC 与您的网络之间的 DNS 查询。

以下代码示例演示如何使用 create-resolver-rule。

Amazon CLI

创建解析器规则

以下create-resolver-rule示例创建了 Resolver 转发规则。该规则使用出站终端节点 rslvr-out-d 5e5920e37example 将 DNS 查询转发到 IP 地址 10.24.8.75 和 10.24. example.com 8.156。

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"

输出：

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

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考CreateResolverRule中的。

以下代码示例演示如何使用 delete-firewall-domain-list。

Amazon CLI

删除 Route 53 解析器 DNS 防火墙域列表

以下delete-firewall-domain-list示例删除了您 Amazon 账户中名为 test 的 Route 53 Resolver DNS 防火墙域列表。

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

输出：

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

有关更多信息，请参阅《Amazon Route 53 开发者指南》中的管理自己的域名列表。

以下代码示例演示如何使用 delete-firewall-rule-group。

Amazon CLI

删除防火墙规则组

以下delete-firewall-rule-group示例删除防火墙规则组。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理 DNS 防火墙中的规则组和规则。

以下代码示例演示如何使用 delete-firewall-rule。

Amazon CLI

删除防火墙规则

以下delete-firewall-rule示例删除了指定的防火墙规则。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理 DNS 防火墙中的规则组和规则。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考DeleteFirewallRule中的。

以下代码示例演示如何使用 delete-resolver-endpoint。

Amazon CLI

删除解析器端点

以下delete-resolver-endpoint示例删除了指定的端点。

重要信息如果您删除入站终端节点，则来自您的网络的 DNS 查询将不再转发到您在终端节点中指定的 VPC 中的 Resolver。如果您删除了出站端点，对于指定了所删除端点的规则，Resolver 会停止将 DNS 查询从您的 VPC 转发到您的网络。

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

输出：

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

以下代码示例演示如何使用 delete-resolver-rule。

Amazon CLI

删除解析器规则

以下delete-resolver-rule示例删除了指定的规则。

注意如果规则与任何 VPC 关联，则必须先取消该规则与 VPC 的关联，然后才能将其删除。

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

输出：

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

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考DeleteResolverRule中的。

以下代码示例演示如何使用 disassociate-firewall-rule-group。

Amazon CLI

取消防火墙规则组与 VPC 的关联

以下disassociate-firewall-rule-group示例取消了 DNS 防火墙规则组与 Amazon VPC 的关联。

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

输出：

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

有关更多信息，请参阅《亚马逊 Route 53 开发者指南》中的管理您的 VPC 和 Route 53 解析器 DNS 防火墙规则组之间的关联。

以下代码示例演示如何使用 disassociate-resolver-endpoint-ip-address。

Amazon CLI

解除 IP 地址与解析器端点的关联

以下disassociate-resolver-endpoint-ip-address示例从指定的 Resolver 入站或出站终端节点中删除 IP 地址。

注意一个端点必须至少有两个 IP 地址。如果一个端点当前只有两个 IP 地址，并且您想将一个地址替换为另一个地址，则必须先使用 associate-resolver-endpoint-ip-address 来关联新的 IP 地址。然后，您可以取消其中一个原始 IP 地址与终端节点的关联。

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

输出：

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

以下代码示例演示如何使用 disassociate-resolver-rule。

Amazon CLI

取消解析程序规则与 Amazon VPC 的关联

以下disassociate-resolver-rule示例删除了指定的 Resolver 规则与指定 VPC 之间的关联。在以下情况下，您可以取消规则与 VPC 的关联：

对于源自此 VPC 的 DNS 查询，您希望 Resolver 停止向您的网络转发规则中指定的域名的查询。您想删除转发规则。如果规则当前与一个或多个 VPC 关联，您必须先从所有 VPC 上解除规则的关联，然后才能删除规则。

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

输出：

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

以下代码示例演示如何使用 get-firewall-config。

Amazon CLI

获取 VPC 的防火墙配置

以下get-firewall-config示例检索指定 VPC 的 DNS 防火墙行为。

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

输出：

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

有关更多信息，请参阅《亚马逊 Route 53 开发者指南》中的 DNS 防火墙 VPC 配置。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考GetFirewallConfig中的。

以下代码示例演示如何使用 get-firewall-domain-list。

Amazon CLI

获取 Route 53 解析器 DNS 防火墙域名列表

以下get-firewall-domain-list示例使用您指定 ID 检索域列表。

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

输出：

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

有关更多信息，请参阅《Amazon Route 53 开发者指南》中的管理自己的域名列表。

以下代码示例演示如何使用 get-firewall-rule-group-association。

Amazon CLI

获取防火墙规则组关联

以下get-firewall-rule-group-association示例检索防火墙规则组关联。

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

输出：

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

有关更多信息，请参阅《亚马逊 Route 53 开发者指南》中的管理您的 VPC 和 Route 53 解析器 DNS 防火墙规则组之间的关联。

以下代码示例演示如何使用 get-firewall-rule-group-policy。

Amazon CLI

获取 Amazon IAM 政策

以下get-firewall-rule-group-policy示例获取了用于共享指定规则组的 Ident Amazon ity and Access Management (Amazon IAM) 策略。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理 DNS 防火墙中的规则组和规则。

以下代码示例演示如何使用 get-firewall-rule-group。

Amazon CLI

获取防火墙规则组

以下get-firewall-rule-group示例使用您提供的 ID 检索有关 DNS 防火墙规则组的信息。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理 DNS 防火墙中的规则组和规则。

以下代码示例演示如何使用 get-resolver-endpoint。

Amazon CLI

获取有关解析器端点的信息

以下get-resolver-endpoint示例显示出站指定终端节点的详细信息。您可以通过指定适用的终端节点 ID 来同时get-resolver-endpoint用于入站和出站终端节点。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的您在创建或编辑入站终端节点时指定的值。

以下代码示例演示如何使用 get-resolver-rule-association。

Amazon CLI

获取有关解析器规则和 VPC 之间关联的信息

以下get-resolver-rule-association示例显示了有关指定解析器规则与 VPC 之间关联的详细信息。您可以使用关联解析器规则和 VP associate-resolver-ruleC。

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

输出：

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

以下代码示例演示如何使用 get-resolver-rule。

Amazon CLI

获取有关解析器规则的信息

以下get-resolver-rule示例显示有关指定解析器规则的详细信息，例如该规则转发 DNS 查询的域名以及与该规则关联的出站解析器终端节点的 ID。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的您在创建或编辑规则时指定的值。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考GetResolverRule中的。

以下代码示例演示如何使用 import-firewall-domains。

Amazon CLI

将域名导入域名列表

以下import-firewall-domains示例将一组域从文件导入到您指定的 DNS 防火墙域列表中。

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

输出：

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

有关更多信息，请参阅《Amazon Route 53 开发者指南》中的管理自己的域名列表。

以下代码示例演示如何使用 list-firewall-configs。

Amazon CLI

列出防火墙配置

以下list-firewall-configs示例列出了您的 DNS 防火墙配置。

aws route53resolver list-firewall-configs

输出：

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

有关更多信息，请参阅《亚马逊 Route 53 开发者指南》中的 DNS 防火墙 VPC 配置。

以下代码示例演示如何使用 list-firewall-domain-lists。

Amazon CLI

列出所有 Route 53 解析器 DNS 防火墙域列表

以下list-firewall-domain-lists示例列出了所有域名列表。

aws route53resolver list-firewall-domain-lists

输出：

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

有关更多信息，请参阅《亚马逊 Route 53 开发者指南》中的 Route 53 Resolver DNS 防火墙域列表。

以下代码示例演示如何使用 list-firewall-domains。

Amazon CLI

在域列表中列出域名

以下list-firewall-domains示例列出了您指定的 DNS 防火墙域列表中的域。

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

输出：

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

有关更多信息，请参阅《Amazon Route 53 开发者指南》中的管理自己的域名列表。

以下代码示例演示如何使用 list-firewall-rule-group-associations。

Amazon CLI

列出 DNS 防火墙规则组关联

以下list-firewall-rule-group-associations示例列出了您与 Amazon VPC 的 DNS 防火墙规则组关联。

aws route53resolver list-firewall-rule-group-associations

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理您的 VPC 和 Route 53 Resolver DNS 防火墙规则组之间的关联。

以下代码示例演示如何使用 list-firewall-rule-groups。

Amazon CLI

获取您的防火墙规则组列表

以下list-firewall-rule-groups示例列出了您的 DNS 防火墙规则组。

aws route53resolver list-firewall-rule-groups

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理 DNS 防火墙中的规则组和规则。

以下代码示例演示如何使用 list-firewall-rules。

Amazon CLI

列出防火墙规则

以下list-firewall-rules示例列出了防火墙规则组中的所有 DNS 防火墙规则。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理 DNS 防火墙中的规则组和规则。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考ListFirewallRules中的。

以下代码示例演示如何使用 list-resolver-endpoint-ip-addresses。

Amazon CLI

列出指定入站或出站终端节点的 IP 地址

以下list-resolver-endpoint-ip-addresses示例列出了与入站终端节点关联的 IP 地址的相关信息rslvr-in-f9ab8a03f1example。您也可以通过指定适用的终端节点 ID 来list-resolver-endpoint-ip-addresses用于出站终端节点。

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

输出：

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

有关输出中值的更多信息，请参阅 Amazon Route 53 开发者指南中创建或编辑入站终端节点时指定的值以及创建或编辑出站终端节点时指定的值。

以下代码示例演示如何使用 list-resolver-endpoints。

Amazon CLI

列出某个 Amazon 区域中的解析器终端节点

以下list-resolver-endpoints示例列出了当前账户中存在的入站和出站 Resolver 终端节点。

aws route53resolver list-resolver-endpoints

输出：

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

以下代码示例演示如何使用 list-resolver-rule-associations。

Amazon CLI

列出解析器规则和 VPC 之间的关联

以下list-resolver-rule-associations示例列出了当前 Amazon 账户中解析器规则与VPC之间的关联。

aws route53resolver list-resolver-rule-associations

输出：

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

有关更多信息，请参阅《亚马逊 Route 53 开发者指南》中的 Rou te 53 解析器如何将 DNS 查询从您的 VPC 转发到您的网络。

以下代码示例演示如何使用 list-resolver-rules。

Amazon CLI

列出解析器规则

以下list-resolver-rules示例列出了当前 Amazon 账户中的所有 Resolver 规则。

aws route53resolver list-resolver-rules

输出：

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

有关更多信息，请参阅《亚马逊 Route 53 开发者指南》中的 Rou te 53 解析器如何将 DNS 查询从您的 VPC 转发到您的网络。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考ListResolverRules中的。

以下代码示例演示如何使用 list-tags-for-resource。

Amazon CLI

列出解析器资源的标签

以下list-tags-for-resource示例列出了分配给指定解析器规则的标签。

aws route53resolver list-tags-for-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"
        }
    ]
}

有关使用标签进行成本分配的信息，请参阅《B Amazon illing and Cost Management 用户指南》中的使用成本分配标签。

以下代码示例演示如何使用 put-firewall-rule-group-policy。

Amazon CLI

附加 Amazon IAM 策略以共享防火墙规则组策略

以下put-firewall-rule-group-policy示例附加了用于共享规则组的 I Amazon dentity and Access Management (Amazon IAM) 策略。

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

输出：

{
    "ReturnValue": true
}

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理 DNS 防火墙中的规则组和规则。

以下代码示例演示如何使用 put-resolver-rule-policy。

Amazon CLI

与其他账户共享 Resolver 规则 Amazon

以下put-resolver-rule-policy示例指定了您要与其他 Amazon 账户共享的 Resolver 规则、要与之共享规则的账户，以及您希望该账户能够对规则执行的与规则相关的操作。

注意您必须使用创建规则的同一账户的凭据运行此命令。

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

输出：

{
    "ReturnValue": true
}

运行后put-resolver-rule-policy，您可以运行以下两个 Resource Access Manager (RAM) 命令。您必须使用要与之共享规则的账户：

get-resource-share-invitations返回值resourceShareInvitationArn。您需要此值才能接受使用共享规则的邀请。 accept-resource-share-invitation接受使用共享规则的邀请。

有关更多信息，请参阅 文档：

get-resource-share-invitationsaccept-resource-share-invitationsAmazon Route 53 开发者指南中的与其他 Amazon 账户共享转发规则并使用共享规则

以下代码示例演示如何使用 tag-resource。

Amazon CLI

将标签与解析器资源相关联

以下tag-resource示例将两个标签键/值对与指定的 Resolver 规则关联起来。

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"

此命令不生成任何输出。

有关使用标签进行成本分配的信息，请参阅《B Amazon illing and Cost Management 用户指南》中的使用成本分配标签。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考TagResource中的。

以下代码示例演示如何使用 untag-resource。

Amazon CLI

从解析器资源中移除标签

以下untag-resource示例从指定的 Resolver 规则中删除两个标签。

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

此命令不生成任何输出。要确认标签已被删除，可以使用list-tags-for-resource。

有关使用标签进行成本分配的信息，请参阅《B Amazon illing and Cost Management 用户指南》中的使用成本分配标签。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考UntagResource中的。

以下代码示例演示如何使用 update-firewall-config。

Amazon CLI

更新防火墙配置

以下update-firewall-config示例更新 DNS 防火墙配置。

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

输出：

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

有关更多信息，请参阅《亚马逊 Route 53 开发者指南》中的 DNS 防火墙 VPC 配置。

以下代码示例演示如何使用 update-firewall-domains。

Amazon CLI

更新域名列表

以下update-firewall-domains示例使用您提供的 ID 将域名添加到域名列表中。

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

输出：

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

有关更多信息，请参阅《Amazon Route 53 开发者指南》中的管理自己的域名列表。

以下代码示例演示如何使用 update-firewall-rule-group-association。

Amazon CLI

更新防火墙规则组关联

以下update-firewall-rule-group-association示例更新了防火墙规则组关联。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理您的 VPC 和 Route 53 Resolver DNS 防火墙规则组之间的关联。

以下代码示例演示如何使用 update-firewall-rule。

Amazon CLI

更新防火墙规则

以下update-firewall-rule示例使用您指定的参数更新防火墙规则。

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

输出：

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的管理 DNS 防火墙中的规则组和规则。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考UpdateFirewallRule中的。

以下代码示例演示如何使用 update-resolver-endpoint。

Amazon CLI

更新解析器端点的名称

以下update-resolver-endpoint示例更新了解析器端点的名称。不支持更新其他值。

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

输出：

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

以下代码示例演示如何使用 update-resolver-rule。

Amazon CLI

示例 1：更新设置解析器端点

以下update-resolver-rule示例更新了规则的名称、将 DNS 查询转发到的本地网络上的 IP 地址以及用于将查询转发到网络的出站 Resolver 端点的 ID。

注意的现有值TargetIps会被覆盖，因此您必须指定更新后希望规则拥有的所有 IP 地址。

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

输出：

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

示例 2：使用文件进行 “配置” 设置更新解析器端点

或者，您可以将config设置包含在 JSON 文件中，然后在调用时指定该文件update-resolver-rule。

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

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

有关更多信息，请参阅 Amazon Route 53 开发者指南中的您在创建或编辑规则时指定的值。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考UpdateResolverRule中的。