# Exemplos do Route 53 Resolver usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Route 53 Resolver.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `associate-firewall-rule-group`
O código de exemplo a seguir mostra como usar `associate-firewall-rule-group`.
**AWS CLI**
**Para associar um grupo de regras do firewall a uma VPC**
O exemplo `associate-firewall-rule-group` a seguir associa um grupo de regras do Firewall DNS a uma Amazon VPC.
```
aws route53resolver associate-firewall-rule-group \
--name test-association \
--firewall-rule-group-id rslvr-frg-47f93271fexample \
--vpc-id vpc-31e92222 \
--priority 101
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciar associações entre a sua VPC e grupos de regras do Firewall DNS do Route 53 Resolver](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-vpc-associating-rule-group.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [AssociateFirewallRuleGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/associate-firewall-rule-group.html) na *Referência de comandos da AWS CLI*.
### `associate-resolver-endpoint-ip-address`
O código de exemplo a seguir mostra como usar `associate-resolver-endpoint-ip-address`.
**AWS CLI**
**Como associar outro endereço IP a um endpoint do Resolver**
O exemplo `associate-resolver-endpoint-ip-address` a seguir associa outro endereço IP a um endpoint do Resolver de entrada. Se você especificar somente um ID de sub-rede e omitir o endereço IP do parâmetro `--ip-address`, o Resolver escolherá um endereço IP para você entre os disponíveis na sub-rede especificada.
```
aws route53resolver associate-resolver-endpoint-ip-address \
--resolver-endpoint-id rslvr-in-497098ad5example \
--ip-address="SubnetId=subnet-12d8exam,Ip=192.0.2.118"
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Valores que você especifica ao criar ou editar endpoints de entrada](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-forwarding-inbound-queries.html#resolver-forwarding-inbound-queries-values) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [AssociateResolverEndpointIpAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/associate-resolver-endpoint-ip-address.html) na *Referência de comandos da AWS CLI*.
### `associate-resolver-rule`
O código de exemplo a seguir mostra como usar `associate-resolver-rule`.
**AWS CLI**
**Como associar uma regra do Resolver a uma VPC**
O exemplo `associate-resolver-rule` a seguir associa uma regra do Resolver a uma Amazon VPC. Depois de executar o comando, o Resolver começa a encaminhar consultas ao DNS para sua rede com base nas configurações da regra, como o nome de domínio das consultas que são encaminhadas.
```
aws route53resolver associate-resolver-rule \
--name my-resolver-rule-association \
--resolver-rule-id rslvr-rr-42b60677c0example \
--vpc-id vpc-304bexam
```
Resultado:
```
{
"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."
}
}
```
Para obter mais informações, consulte [Encaminhamento de consultas ao DNS de entrada para a sua rede](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-forwarding-outbound-queries.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [AssociateResolverRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/associate-resolver-rule.html) na *Referência de comandos da AWS CLI*.
### `create-firewall-domain-list`
O código de exemplo a seguir mostra como usar `create-firewall-domain-list`.
**AWS CLI**
**Para criar uma lista de domínios do Firewall DNS do Route 53 Resolver**
O exemplo `create-firewall-domain-list` a seguir cria uma lista de domínios do Firewall DNS do Route 53 Resolver, chamada test, em sua conta da AWS.
```
aws route53resolver create-firewall-domain-list \
--creator-request-id my-request-id \
--name test
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciar suas próprias listas de domínios](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-user-managed-domain-lists.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [CreateFirewallDomainList](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/create-firewall-domain-list.html) na *Referência de comandos da AWS CLI*.
### `create-firewall-rule-group`
O código de exemplo a seguir mostra como usar `create-firewall-rule-group`.
**AWS CLI**
**Para criar grupo de regras de firewall**
O exemplo `create-firewall-rule-group` a seguir cria um grupo de regras do Firewall DNS.
```
aws route53resolver create-firewall-rule-group \
--creator-request-id my-request-id \
--name test
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciamento de grupos de regras e regras no Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-rule-group-managing.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [CreateFirewallRuleGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/create-firewall-rule-group.html) na *Referência de comandos da AWS CLI*.
### `create-firewall-rule`
O código de exemplo a seguir mostra como usar `create-firewall-rule`.
**AWS CLI**
**Para criar uma regra de firewall**
O exemplo `create-firewall-rule` a seguir cria uma regra de firewall em uma regra do Firewall DNS para domínios listados em uma lista de domínios do Firewall 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
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciamento de grupos de regras e regras no Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-rule-group-managing.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [CreateFirewallRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/create-firewall-rule.html) na *Referência de comandos da AWS CLI*.
### `create-resolver-endpoint`
O código de exemplo a seguir mostra como usar `create-resolver-endpoint`.
**AWS CLI**
**Para criar um endpoint de entrada do Resolver**
O exemplo `create-resolver-endpoint` a seguir cria um endpoint do Resolver de entrada. Você pode usar o mesmo comando para criar endpoints de entrada e saída.
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-addresses SubnetId=subnet-ba47exam,Ip=192.0.2.255 SubnetId=subnet-12d8exam,Ip=192.0.2.254
Resultado:
```
{
"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"
}
}
```
**Para criar um endpoint de saída do Resolver**
O exemplo `create-resolver-endpoint` a seguir cria um endpoint do Resolver de saída usando os valores no documento formatado em JSON `create-outbound-resolver-endpoint.json`.
```
aws route53resolver create-resolver-endpoint \
--cli-input-json file://c:\temp\create-outbound-resolver-endpoint.json
```
Conteúdo de `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"
}
]
}
```
Para obter mais informações, consulte [Resolver consultas de DNS entre VPCs e sua rede ](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver.html) no *Manual do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [CreateResolverEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/create-resolver-endpoint.html) na *Referência de comandos da AWS CLI*.
### `create-resolver-rule`
O código de exemplo a seguir mostra como usar `create-resolver-rule`.
**AWS CLI**
**Para criar regra do Resolver**
O exemplo `create-resolver-rule` a seguir cria uma regra de encaminhamento do Resolver. A regra usa o endpoint de saída rslvr-out-d5e5920e37example para encaminhar consultas ao DNS de `example.com` para os endereços IP 10.24.8.75 e 10.24.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"
```
Resultado:
```
{
"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."
}
}
```
+ Para ver detalhes da API, consulte [CreateResolverRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/create-resolver-rule.html) na *Referência de comandos da AWS CLI*.
### `delete-firewall-domain-list`
O código de exemplo a seguir mostra como usar `delete-firewall-domain-list`.
**AWS CLI**
**Para excluir uma lista de domínios do Firewall DNS do Route 53 Resolver**
O exemplo `delete-firewall-domain-list` a seguir exclui uma lista de domínios do Firewall DNS do Route 53 Resolver, chamada test, em sua conta da AWS.
```
aws route53resolver delete-firewall-domain-list \
--firewall-domain-list-id rslvr-fdl-9e956e9ffexample
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciar suas próprias listas de domínios](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-user-managed-domain-lists.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [DeleteFirewallDomainList](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/delete-firewall-domain-list.html) na *Referência de comandos da AWS CLI*.
### `delete-firewall-rule-group`
O código de exemplo a seguir mostra como usar `delete-firewall-rule-group`.
**AWS CLI**
**Para excluir um grupo de regras de firewall**
O exemplo `delete-firewall-rule-group` a seguir exclui um grupo de regras de firewall.
```
aws route53resolver delete-firewall-rule-group \
--firewall-rule-group-id rslvr-frg-47f93271fexample
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciamento de grupos de regras e regras no Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-rule-group-managing.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [DeleteFirewallRuleGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/delete-firewall-rule-group.html) na *Referência de comandos da AWS CLI*.
### `delete-firewall-rule`
O código de exemplo a seguir mostra como usar `delete-firewall-rule`.
**AWS CLI**
**Para excluir uma regra de firewall**
O exemplo `delete-firewall-rule` a seguir exclui a regra de firewall especificada.
```
aws route53resolver delete-firewall-rule \
--firewall-rule-group-id rslvr-frg-47f93271fexample \
--firewall-domain-list-id rslvr-fdl-9e956e9ffexample
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciamento de grupos de regras e regras no Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-rule-group-managing.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [DeleteFirewallRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/delete-firewall-rule.html) na *Referência de comandos da AWS CLI*.
### `delete-resolver-endpoint`
O código de exemplo a seguir mostra como usar `delete-resolver-endpoint`.
**AWS CLI**
**Para excluir um endpoint do Resolver**
O exemplo `delete-resolver-endpoint` a seguir exclui o endpoint especificado.
**Importante** se você excluir um endpoint de entrada, as consultas ao DNS da sua rede não serão mais encaminhadas para o Resolver na VPC especificada no endpoint. Se você excluir um endpoint de saída, o Resolver irá parar de encaminhar consultas de DNS de sua VPC à rede para regras que especificam o endpoint de saída excluído.
```
aws route53resolver delete-resolver-endpoint \
--resolver-endpoint-id rslvr-in-497098ad59example
```
Resultado:
```
{
"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"
}
}
```
+ Para ver detalhes da API, consulte [DeleteResolverEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/delete-resolver-endpoint.html) na *Referência de comandos da AWS CLI*.
### `delete-resolver-rule`
O código de exemplo a seguir mostra como usar `delete-resolver-rule`.
**AWS CLI**
**Para excluir uma regra do Resolver**
O exemplo de `delete-resolver-rule` a seguir exclui a regra especificada.
**Observação** Se uma regra estiver associada a alguma VPC, é necessário desassociar a regra dessas VPCs primeiro antes de excluí-la.
```
aws route53resolver delete-resolver-rule \
--resolver-rule-id rslvr-rr-5b3809426bexample
```
Resultado:
```
{
"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"
}
}
```
+ Para ver detalhes da API, consulte [DeleteResolverRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/delete-resolver-rule.html) na *Referência de comandos da AWS CLI*.
### `disassociate-firewall-rule-group`
O código de exemplo a seguir mostra como usar `disassociate-firewall-rule-group`.
**AWS CLI**
**Para desassociar um grupo de regras de firewall de uma VPC**
O exemplo `disassociate-firewall-rule-group` a seguir desassocia um grupo de regras do Firewall DNS de uma Amazon VPC.
```
aws route53resolver disassociate-firewall-rule-group \
--firewall-rule-group-association-id rslvr-frgassoc-57e8873d7example
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciar associações entre a sua VPC e grupos de regras do Firewall DNS do Route 53 Resolver](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-vpc-associating-rule-group.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [DisassociateFirewallRuleGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/disassociate-firewall-rule-group.html) na *Referência de comandos da AWS CLI*.
### `disassociate-resolver-endpoint-ip-address`
O código de exemplo a seguir mostra como usar `disassociate-resolver-endpoint-ip-address`.
**AWS CLI**
**Para desassociar um endereço IP de um endpoint do Resolver**
O exemplo `disassociate-resolver-endpoint-ip-address` a seguir remove um endereço IP de um endpoint de entrada ou saída do Resolver especificado.
**Observação** Um endpoint deve ter pelo menos dois endereços IP. Se um endpoint atualmente tiver apenas dois endereços IP e você quiser substituir um endereço por outro, primeiro use [associate-resolver-endpoint-ip-address](https://docs.aws.amazon.com/cli/latest/reference/route53resolver/associate-resolver-endpoint-ip-address.html) para associar o novo endereço IP. Em seguida, você pode desassociar um dos endereços IP originais do endpoint.
```
aws route53resolver disassociate-resolver-endpoint-ip-address \
--resolver-endpoint-id rslvr-in-f9ab8a03f1example \
--ip-address="SubnetId=subnet-12d8a459,Ip=172.31.40.121"
```
Resultado:
```
{
"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"
}
}
```
+ Para ver detalhes da API, consulte [DisassociateResolverEndpointIpAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/disassociate-resolver-endpoint-ip-address.html) na *Referência de comandos da AWS CLI*.
### `disassociate-resolver-rule`
O código de exemplo a seguir mostra como usar `disassociate-resolver-rule`.
**AWS CLI**
**Como dissociar uma regra do Resolver de uma Amazon VPC**
O exemplo `disassociate-resolver-rule` a seguir remove a associação entre a regra do Resolver especificada e a VPC especificada. Desassocie uma regra de uma VPC nas seguintes circunstâncias:
Para consultas ao DNS originadas nessa VPC, você quer que o Resolver pare de encaminhar consultas à sua rede do nome de domínio especificado na regra. Você quer excluir a regra de encaminhamento. Se uma regra está atualmente associada a uma ou mais VPCs, é necessário desassociar a regra de todas as VPCs antes de excluí-la.
```
aws route53resolver disassociate-resolver-rule \
--resolver-rule-id rslvr-rr-4955cb98ceexample \
--vpc-id vpc-304bexam
```
Resultado:
```
{
"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"
}
}
```
+ Para ver detalhes da API, consulte [DisassociateResolverRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/disassociate-resolver-rule.html) na *Referência de comandos da AWS CLI*.
### `get-firewall-config`
O código de exemplo a seguir mostra como usar `get-firewall-config`.
**AWS CLI**
**Para obter uma configuração de firewall para uma VPC**
O exemplo `get-firewall-config` a seguir recupera o comportamento do Firewall DNS para a VPC especificada.
```
aws route53resolver get-firewall-config \
--resource-id vpc-31e92222
```
Resultado:
```
{
"FirewallConfig": {
"Id": "rslvr-fc-86016850cexample",
"ResourceId": "vpc-31e9222",
"OwnerId": "123456789012",
"FirewallFailOpen": "DISABLED"
}
}
```
Para obter mais informações, consulte [Configuração da VPC do Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-vpc-configuration.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [GetFirewallConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/get-firewall-config.html) na *Referência de comandos da AWS CLI*.
### `get-firewall-domain-list`
O código de exemplo a seguir mostra como usar `get-firewall-domain-list`.
**AWS CLI**
**Para obter uma lista de domínios do Firewall DNS do Route 53 Resolver**
O exemplo `get-firewall-domain-list` a seguir recupera a lista de domínios com o ID especificado.
```
aws route53resolver get-firewall-domain-list \
--firewall-domain-list-id rslvr-fdl-42b60677cexample
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciar suas próprias listas de domínios](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-user-managed-domain-lists.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [GetFirewallDomainList](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/get-firewall-domain-list.html) na *Referência de comandos da AWS CLI*.
### `get-firewall-rule-group-association`
O código de exemplo a seguir mostra como usar `get-firewall-rule-group-association`.
**AWS CLI**
**Para obter uma associação de grupo de regras de firewall**
O exemplo `get-firewall-rule-group-association` a seguir recupera uma associação de grupo de regras de firewall.
```
aws route53resolver get-firewall-rule-group-association \
--firewall-rule-group-association-id rslvr-frgassoc-57e8873d7example
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciar associações entre a sua VPC e grupos de regras do Firewall DNS do Route 53 Resolver](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-vpc-associating-rule-group.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [GetFirewallRuleGroupAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/get-firewall-rule-group-association.html) na *Referência de comandos da AWS CLI*.
### `get-firewall-rule-group-policy`
O código de exemplo a seguir mostra como usar `get-firewall-rule-group-policy`.
**AWS CLI**
**Para obter uma política do AWS IAM**
O exemplo `get-firewall-rule-group-policy` a seguir obtém a política do AWS Identity and Access Management (AWS IAM) para compartilhar o grupo de regras especificado.
```
aws route53resolver get-firewall-rule-group-policy \
--arn arn:aws:route53resolver:us-west-2:AWS_ACCOUNT_ID:firewall-rule-group/rslvr-frg-47f93271fexample
```
Resultado:
```
{
"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\"}]}"
}
```
Para obter mais informações, consulte [Gerenciamento de grupos de regras e regras no Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-rule-group-managing.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [GetFirewallRuleGroupPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/get-firewall-rule-group-policy.html) na *Referência de comandos da AWS CLI*.
### `get-firewall-rule-group`
O código de exemplo a seguir mostra como usar `get-firewall-rule-group`.
**AWS CLI**
**Para obter um grupo de regras de firewall**
O exemplo `get-firewall-rule-group` a seguir recupera informações sobre um grupo de regras do Firewall DNS com o ID fornecido por você.
```
aws route53resolver get-firewall-rule-group \
--firewall-rule-group-id rslvr-frg-47f93271fexample
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciamento de grupos de regras e regras no Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-rule-group-managing.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [GetFirewallRuleGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/get-firewall-rule-group.html) na *Referência de comandos da AWS CLI*.
### `get-resolver-endpoint`
O código de exemplo a seguir mostra como usar `get-resolver-endpoint`.
**AWS CLI**
**Para obter informações sobre um endpoint do Resolver**
O exemplo `get-resolver-endpoint` a seguir exibe detalhes do endpoint de saída especificado. Você pode usar `get-resolver-endpoint` para endpoints de entrada e saída especificando o ID do endpoint aplicável.
```
aws route53resolver get-resolver-endpoint \
--resolver-endpoint-id rslvr-out-d5e5920e37example
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Valores que você especifica ao criar ou editar endpoints de entrada](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-forwarding-inbound-queries.html#resolver-forwarding-inbound-queries-values) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para receber detalhes da API, consulte [GetResolverEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/get-resolver-endpoint.html) na *Referência de comandos da AWS CLI*.
### `get-resolver-rule-association`
O código de exemplo a seguir mostra como usar `get-resolver-rule-association`.
**AWS CLI**
**Para obter informações sobre a associação entre uma regra do Resolver e uma VPC**
O exemplo `get-resolver-rule-association` a seguir mostra detalhes sobre a associação entre uma regra do Resolver especificada e uma VPC. Você associa uma regra de resolução e uma VPC usando [associate-resolver-rule](https://docs.aws.amazon.com/cli/latest/reference/route53resolver/associate-resolver-rule.html).
```
aws route53resolver get-resolver-rule-association \
--resolver-rule-association-id rslvr-rrassoc-d61cbb2c8bexample
```
Resultado:
```
{
"ResolverRuleAssociation": {
"Id": "rslvr-rrassoc-d61cbb2c8bexample",
"ResolverRuleId": "rslvr-rr-42b60677c0example",
"Name": "my-resolver-rule-association",
"VPCId": "vpc-304bexam",
"Status": "COMPLETE",
"StatusMessage": ""
}
}
```
+ Consulte detalhes da API em [GetResolverRuleAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/get-resolver-rule-association.html) na *Referência de comandos da AWS CLI*.
### `get-resolver-rule`
O código de exemplo a seguir mostra como usar `get-resolver-rule`.
**AWS CLI**
**Para obter informações sobre uma regra do Resolver**
O exemplo `get-resolver-rule` a seguir exibe detalhes sobre a regra do Resolver especificada, como o nome do domínio para o qual a regra encaminha consultas ao DNS e o ID do endpoint do resolvedor de saída ao qual a regra está associada.
```
aws route53resolver get-resolver-rule \
--resolver-rule-id rslvr-rr-42b60677c0example
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Valores que você especifica ao criar ou editar regras](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-forwarding-outbound-queries.html#resolver-forwarding-outbound-queries-rule-values) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [GetResolverRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/get-resolver-rule.html) na *Referência de comandos da AWS CLI*.
### `import-firewall-domains`
O código de exemplo a seguir mostra como usar `import-firewall-domains`.
**AWS CLI**
**Para importar domínios para uma lista de domínios**
O exemplo `import-firewall-domains` a seguir importa um conjunto de domínios de um arquivo para uma lista de domínios do Firewall DNS especificada por você.
```
aws route53resolver import-firewall-domains \
--firewall-domain-list-id rslvr-fdl-d61cbb2cbexample \
--operation REPLACE \
--domain-file-url s3://PATH/TO/YOUR/FILE
```
Resultado:
```
{
"Id": "rslvr-fdl-d61cbb2cbexample",
"Name": "test",
"Status": "IMPORTING",
"StatusMessage": "Importing domains from provided file."
}
```
Para obter mais informações, consulte [Gerenciar suas próprias listas de domínios](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-user-managed-domain-lists.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ImportFirewallDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/import-firewall-domains.html) na *Referência de comandos da AWS CLI*.
### `list-firewall-configs`
O código de exemplo a seguir mostra como usar `list-firewall-configs`.
**AWS CLI**
**Para listar as configurações de firewall**
O exemplo `list-firewall-configs` a seguir lista suas configurações do Firewall DNS.
```
aws route53resolver list-firewall-configs
```
Resultado:
```
{
"FirewallConfigs": [
{
"Id": "rslvr-fc-86016850cexample",
"ResourceId": "vpc-31e92222",
"OwnerId": "123456789012",
"FirewallFailOpen": "DISABLED"
}
]
}
```
Para obter mais informações, consulte [Configuração da VPC do Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-vpc-configuration.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ListFirewallConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-firewall-configs.html) na *Referência de comandos da AWS CLI*.
### `list-firewall-domain-lists`
O código de exemplo a seguir mostra como usar `list-firewall-domain-lists`.
**AWS CLI**
**Para listar todos os domínios do Firewall DNS do Route 53 Resolver**
O exemplo `list-firewall-domain-lists` a seguir exibe todas as listas de domínio.
```
aws route53resolver list-firewall-domain-lists
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Listas de domínio do DNS Firewall do Route 53 Resolver](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-domain-lists.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ListFirewallDomainLists](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-firewall-domain-lists.html) na *Referência de comandos da AWS CLI*.
### `list-firewall-domains`
O código de exemplo a seguir mostra como usar `list-firewall-domains`.
**AWS CLI**
**Para listar domínios em uma lista de domínios**
O exemplo `list-firewall-domains` a seguir lista os domínios em uma lista de domínios do Firewall DNS que você especifica.
```
aws route53resolver list-firewall-domains \
--firewall-domain-list-id rslvr-fdl-d61cbb2cbexample
```
Resultado:
```
{
"Domains": [
"test1.com.",
"test2.com.",
"test3.com."
]
}
```
Para obter mais informações, consulte [Gerenciar suas próprias listas de domínios](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-user-managed-domain-lists.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ListFirewallDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-firewall-domains.html) na *Referência de comandos da AWS CLI*.
### `list-firewall-rule-group-associations`
O código de exemplo a seguir mostra como usar `list-firewall-rule-group-associations`.
**AWS CLI**
**Para listar associações de grupos de regras do Firewall DNS**
O exemplo `list-firewall-rule-group-associations` a seguir lista suas associações de grupos de regras do Firewall DNS com Amazon VPCs.
```
aws route53resolver list-firewall-rule-group-associations
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Gerenciar associações entre a sua VPC e grupos de regras do Firewall DNS do Route 53 Resolver](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-vpc-associating-rule-group.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ListFirewallRuleGroupAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-firewall-rule-group-associations.html) na *Referência de comandos da AWS CLI*.
### `list-firewall-rule-groups`
O código de exemplo a seguir mostra como usar `list-firewall-rule-groups`.
**AWS CLI**
**Para obter uma lista dos grupos de regras do firewall**
O exemplo `list-firewall-rule-groups` a seguir lista seus grupos de regras do Firewall DNS.
```
aws route53resolver list-firewall-rule-groups
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Gerenciamento de grupos de regras e regras no Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-rule-group-managing.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ListFirewallRuleGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-firewall-rule-groups.html) na *Referência de comandos da AWS CLI*.
### `list-firewall-rules`
O código de exemplo a seguir mostra como usar `list-firewall-rules`.
**AWS CLI**
**Para listar as regras de firewall**
O exemplo `list-firewall-rules` a seguir lista todas as suas regras de Firewall DNS em um grupo de regras de firewall.
```
aws route53resolver list-firewall-rules \
--firewall-rule-group-id rslvr-frg-47f93271fexample
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Gerenciamento de grupos de regras e regras no Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-rule-group-managing.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ListFirewallRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-firewall-rules.html) na *Referência de comandos da AWS CLI*.
### `list-resolver-endpoint-ip-addresses`
O código de exemplo a seguir mostra como usar `list-resolver-endpoint-ip-addresses`.
**AWS CLI**
**Para listar endereços IP para um endpoint de entrada ou saída especificado**
O exemplo `list-resolver-endpoint-ip-addresses` a seguir lista informações sobre os endereços IP associados ao endpoint de entrada `rslvr-in-f9ab8a03f1example`. Você também pode usar `list-resolver-endpoint-ip-addresses` para endpoints de saída especificando o ID do endpoint aplicável.
```
aws route53resolver list-resolver-endpoint-ip-addresses \
--resolver-endpoint-id rslvr-in-f9ab8a03f1example
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações sobre os valores na saída, consulte [Valores que você especifica ao criar ou editar endpoints de entrada](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-forwarding-inbound-queries.html#resolver-forwarding-inbound-queries-values) e [Valores que você especifica ao criar ou editar endpoints de saída](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-forwarding-outbound-queries.html#resolver-forwarding-outbound-queries-endpoint-values), ambos no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ListResolverEndpointIpAddresses](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-resolver-endpoint-ip-addresses.html) na *Referência de comandos da AWS CLI*.
### `list-resolver-endpoints`
O código de exemplo a seguir mostra como usar `list-resolver-endpoints`.
**AWS CLI**
**Para listar endpoints do Resolver em uma região da AWS**
O exemplo `list-resolver-endpoints` a seguir lista os endpoints de entrada e saída do Resolver que existem na conta atual.
```
aws route53resolver list-resolver-endpoints
```
Resultado:
```
{
"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"
}
]
}
```
+ Para ver detalhes da API, consulte [ListResolverEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-resolver-endpoints.html) na *Referência de comandos da AWS CLI*.
### `list-resolver-rule-associations`
O código de exemplo a seguir mostra como usar `list-resolver-rule-associations`.
**AWS CLI**
**Para listar associações entre regras do Resolver e VPCs**
O exemplo `list-resolver-rule-associations` a seguir lista as associações entre as regras do Resolver e as VPCs na conta da AWS atual.
```
aws route53resolver list-resolver-rule-associations
```
Resultado:
```
{
"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": ""
}
]
}
```
Para obter mais informações, consulte [Como o Route 53 Resolver encaminha consultas ao DNS de suas VPCs para a sua rede](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver.html#resolver-overview-forward-vpc-to-network) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ListResolverRuleAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-resolver-rule-associations.html) na *Referência de comandos da AWS CLI*.
### `list-resolver-rules`
O código de exemplo a seguir mostra como usar `list-resolver-rules`.
**AWS CLI**
**Para listar regras do Resolver**
O exemplo `list-resolver-rules` a seguir lista todas as regras do Resolver na conta da AWS atual.
```
aws route53resolver list-resolver-rules
```
Resultado:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Como o Route 53 Resolver encaminha consultas ao DNS de suas VPCs para a sua rede](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver.html#resolver-overview-forward-vpc-to-network) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [ListResolverRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-resolver-rules.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Para listar as tags de um recurso do Resolver**
O exemplo `list-tags-for-resource` a seguir lista as tags atribuídas à regra do Resolver especificada.
```
aws route53resolver list-tags-for-resource \
--resource-arn "arn:aws:route53resolver:us-west-2:111122223333:resolver-rule/rslvr-rr-42b60677c0example"
```
Resultado:
```
{
"Tags": [
{
"Key": "my-key-1",
"Value": "my-value-1"
},
{
"Key": "my-key-2",
"Value": "my-value-2"
}
]
}
```
Para obter informações sobre como usar tags de alocação de custos, consulte [Usar tags de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Guia do usuário de Gerenciamento de custos e faturamento da AWS*.
+ Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/list-tags-for-resource.html) na *AWS CLI Command Reference*.
### `put-firewall-rule-group-policy`
O código de exemplo a seguir mostra como usar `put-firewall-rule-group-policy`.
**AWS CLI**
**Como anexar uma política do AWS IAM para compartilhar uma política de grupo de regras de firewall**
O exemplo `put-firewall-rule-group-policy` a seguir anexa uma política do AWS Identity and Access Management (AWS IAM) para compartilhar o grupo de regras.
```
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\"}]}"
```
Resultado:
```
{
"ReturnValue": true
}
```
Para obter mais informações, consulte [Gerenciamento de grupos de regras e regras no Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-rule-group-managing.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [PutFirewallRuleGroupPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/put-firewall-rule-group-policy.html) na *Referência de comandos da AWS CLI*.
### `put-resolver-rule-policy`
O código de exemplo a seguir mostra como usar `put-resolver-rule-policy`.
**AWS CLI**
**Como compartilhar uma regra do Resolver com outra conta da AWS**
O exemplo `put-resolver-rule-policy` a seguir especifica uma regra do Resolver que você deseja compartilhar com outra conta da AWS, a conta com a qual você deseja compartilhar a regra e as operações relacionadas à regra que você deseja que a conta possa executar com base nas regras.
**Observação** Você deve executar esse comando usando credenciais da mesma conta que criou a regra.
```
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\" ] } ] }"
```
Resultado:
```
{
"ReturnValue": true
}
```
Depois de executar `put-resolver-rule-policy`, você pode executar os dois comandos do Resource Access Manager (RAM) a seguir. Você deve usar a conta com a qual você deseja compartilhar a regra:
O `get-resource-share-invitations` retorna o valor `resourceShareInvitationArn`. Você precisa desse valor para aceitar o convite para usar a regra compartilhada. O `accept-resource-share-invitation` aceita o convite para usar a regra compartilhada.
Para saber mais, consulte a documentação a seguir:
[get-resource-share-invitations](https://docs.aws.amazon.com/cli/latest/reference/ram/get-resource-share-invitations.html)[accept-resource-share-invitations](https://docs.aws.amazon.com/cli/latest/reference/ram/accept-resource-share-invitation.html)[Compartilhar regras de encaminhamento com outras contas da AWS e usar regras compartilhadas](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-rules-managing.html#resolver-rules-managing-sharing) no *Guia do desenvolvedor do Amazon Route 53*
+ Consulte detalhes da API em [PutResolverRulePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/put-resolver-rule-policy.html) na *Referência de comandos da AWS CLI*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Como associar tags a um recurso do Resolver**
O exemplo `tag-resource` a seguir associa dois pares de chave-valor de tag à regra do Resolver especificada.
```
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"
```
Este comando não produz saída.
Para obter informações sobre como usar tags de alocação de custos, consulte [Usar tags de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Guia do usuário de Gerenciamento de custos e faturamento da AWS*.
+ Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/tag-resource.html) na *Referência de comandos da AWS CLI*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Para remover as tags de um recurso do Resolver**
O exemplo `untag-resource` a seguir remove duas tags da regra do Resolver especificada.
```
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
```
Este comando não produz saída. Para confirmar que as tags foram removidas, você pode usar [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/route53resolver/list-tags-for-resource.html).
Para obter informações sobre como usar tags de alocação de custos, consulte [Usar tags de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Guia do usuário de Gerenciamento de custos e faturamento da AWS*.
+ Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/untag-resource.html) na *Referência de comandos da AWS CLI*.
### `update-firewall-config`
O código de exemplo a seguir mostra como usar `update-firewall-config`.
**AWS CLI**
**Para atualizar uma configuração de firewall**
O exemplo `update-firewall-config` a seguir atualiza a configuração do Firewall DNS.
```
aws route53resolver update-firewall-config \
--resource-id vpc-31e92222 \
--firewall-fail-open DISABLED
```
Resultado:
```
{
"FirewallConfig": {
"Id": "rslvr-fc-86016850cexample",
"ResourceId": "vpc-31e92222",
"OwnerId": "123456789012",
"FirewallFailOpen": "DISABLED"
}
}
```
Para obter mais informações, consulte [Configuração da VPC do Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-vpc-configuration.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [UpdateFirewallConfig](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/update-firewall-config.html) na *Referência de comandos da AWS CLI*.
### `update-firewall-domains`
O código de exemplo a seguir mostra como usar `update-firewall-domains`.
**AWS CLI**
**Para atualizar uma lista de domínios**
O exemplo `update-firewall-domains` a seguir adiciona os domínios a uma lista de domínios com o ID fornecido por você.
```
aws route53resolver update-firewall-domains \
--firewall-domain-list-id rslvr-fdl-42b60677cexampleb \
--operation ADD \
--domains test1.com test2.com test3.com
```
Resultado:
```
{
"Id": "rslvr-fdl-42b60677cexample",
"Name": "test",
"Status": "UPDATING",
"StatusMessage": "Updating the Firewall Domain List"
}
```
Para obter mais informações, consulte [Gerenciar suas próprias listas de domínios](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-user-managed-domain-lists.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [UpdateFirewallDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/update-firewall-domains.html) na *Referência de comandos da AWS CLI*.
### `update-firewall-rule-group-association`
O código de exemplo a seguir mostra como usar `update-firewall-rule-group-association`.
**AWS CLI**
**Para atualizar uma associação de grupo de regras de firewall**
O exemplo `update-firewall-rule-group-association` a seguir atualiza uma associação de grupo de regras de firewall.
```
aws route53resolver update-firewall-rule-group-association \
--firewall-rule-group-association-id rslvr-frgassoc-57e8873d7example \
--priority 103
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciar associações entre a sua VPC e grupos de regras do Firewall DNS do Route 53 Resolver](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-vpc-associating-rule-group.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [UpdateFirewallRuleGroupAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/update-firewall-rule-group-association.html) na *Referência de comandos da AWS CLI*.
### `update-firewall-rule`
O código de exemplo a seguir mostra como usar `update-firewall-rule`.
**AWS CLI**
**Para atualizar uma regra de firewall**
O exemplo `update-firewall-rule` a seguir atualiza uma regra de firewall com os parâmetros que você especifica.
```
aws route53resolver update-firewall-rule \
--firewall-rule-group-id rslvr-frg-47f93271fexample \
--firewall-domain-list-id rslvr-fdl-9e956e9ffexample \
--priority 102
```
Resultado:
```
{
"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"
}
}
```
Para obter mais informações, consulte [Gerenciamento de grupos de regras e regras no Firewall DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-rule-group-managing.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [UpdateFirewallRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/update-firewall-rule.html) na *Referência de comandos da AWS CLI*.
### `update-resolver-endpoint`
O código de exemplo a seguir mostra como usar `update-resolver-endpoint`.
**AWS CLI**
**Para atualizar o nome de um endpoint do Resolver**
O exemplo `update-resolver-endpoint` a seguir atualiza o nome de um endpoint do Resolver. A atualização de outros valores não é compatível.
```
aws route53resolver update-resolver-endpoint \
--resolver-endpoint-id rslvr-in-b5d45e32bdc445f09 \
--name my-renamed-inbound-endpoint
```
Resultado:
```
{
"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"
}
}
```
+ Para ver detalhes da API, consulte [UpdateResolverEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/update-resolver-endpoint.html) na *Referência de comandos da AWS CLI*.
### `update-resolver-rule`
O código de exemplo a seguir mostra como usar `update-resolver-rule`.
**AWS CLI**
**Exemplo 1: atualizar as configurações do endpoint do Resolver**
O exemplo `update-resolver-rule` a seguir atualiza o nome da regra, os endereços IP em sua rede on-premises para os quais as consultas ao DNS são encaminhadas e o ID do endpoint do Resolver de saída que você está usando para encaminhar consultas para sua rede.
**Observação** Os valores existentes para `TargetIps` são substituídos, portanto, você deve especificar todos os endereços IP que deseja que a regra tenha após a atualização.
```
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
```
Resultado:
```
{
"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"
}
}
```
**Exemplo 2: atualizar as configurações do endpoint do Resolver usando um arquivo para configurações ``config``**
Como alternativa, você pode incluir as configurações `config` em um arquivo JSON e depois especificar esse arquivo ao chamar `update-resolver-rule`.
```
aws route53resolver update-resolver-rule \
--resolver-rule-id rslvr-rr-1247fa64f3example \
--config file://c:\temp\update-resolver-rule.json
```
Conteúdo de `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"
}
```
Para obter mais informações, consulte [Valores que você especifica ao criar ou editar regras](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-forwarding-outbound-queries.html#resolver-forwarding-outbound-queries-rule-values) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para ver detalhes da API, consulte [UpdateResolverRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53resolver/update-resolver-rule.html) na *Referência de comandos da AWS CLI*.