aws-sdk-route53resolver 1.18.0 → 1.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -27,6 +27,7 @@ module Aws::Route53Resolver
27
27
  # See {Seahorse::Client::RequestContext} for more information.
28
28
  #
29
29
  # ## Error Classes
30
+ # * {AccessDeniedException}
30
31
  # * {InternalServiceErrorException}
31
32
  # * {InvalidNextTokenException}
32
33
  # * {InvalidParameterException}
@@ -47,6 +48,21 @@ module Aws::Route53Resolver
47
48
 
48
49
  extend Aws::Errors::DynamicErrors
49
50
 
51
+ class AccessDeniedException < ServiceError
52
+
53
+ # @param [Seahorse::Client::RequestContext] context
54
+ # @param [String] message
55
+ # @param [Aws::Route53Resolver::Types::AccessDeniedException] data
56
+ def initialize(context, message, data = Aws::EmptyStructure.new)
57
+ super(context, message, data)
58
+ end
59
+
60
+ # @return [String]
61
+ def message
62
+ @message || @data[:message]
63
+ end
64
+ end
65
+
50
66
  class InternalServiceErrorException < ServiceError
51
67
 
52
68
  # @param [Seahorse::Client::RequestContext] context
@@ -10,6 +10,20 @@
10
10
  module Aws::Route53Resolver
11
11
  module Types
12
12
 
13
+ # The current account doesn't have the IAM permissions required to
14
+ # perform the specified Resolver operation.
15
+ #
16
+ # @!attribute [rw] message
17
+ # @return [String]
18
+ #
19
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/AccessDeniedException AWS API Documentation
20
+ #
21
+ class AccessDeniedException < Struct.new(
22
+ :message)
23
+ SENSITIVE = []
24
+ include Aws::Structure
25
+ end
26
+
13
27
  # @note When making an API call, you may pass AssociateResolverEndpointIpAddressRequest
14
28
  # data as a hash:
15
29
  #
@@ -23,12 +37,12 @@ module Aws::Route53Resolver
23
37
  # }
24
38
  #
25
39
  # @!attribute [rw] resolver_endpoint_id
26
- # The ID of the resolver endpoint that you want to associate IP
40
+ # The ID of the Resolver endpoint that you want to associate IP
27
41
  # addresses with.
28
42
  # @return [String]
29
43
  #
30
44
  # @!attribute [rw] ip_address
31
- # Either the IPv4 address that you want to add to a resolver endpoint
45
+ # Either the IPv4 address that you want to add to a Resolver endpoint
32
46
  # or a subnet ID. If you specify a subnet ID, Resolver chooses an IP
33
47
  # address for you from the available IPs in the specified subnet.
34
48
  # @return [Types::IpAddressUpdate]
@@ -54,6 +68,51 @@ module Aws::Route53Resolver
54
68
  include Aws::Structure
55
69
  end
56
70
 
71
+ # @note When making an API call, you may pass AssociateResolverQueryLogConfigRequest
72
+ # data as a hash:
73
+ #
74
+ # {
75
+ # resolver_query_log_config_id: "ResourceId", # required
76
+ # resource_id: "ResourceId", # required
77
+ # }
78
+ #
79
+ # @!attribute [rw] resolver_query_log_config_id
80
+ # The ID of the query logging configuration that you want to associate
81
+ # a VPC with.
82
+ # @return [String]
83
+ #
84
+ # @!attribute [rw] resource_id
85
+ # The ID of an Amazon VPC that you want this query logging
86
+ # configuration to log queries for.
87
+ #
88
+ # <note markdown="1"> The VPCs and the query logging configuration must be in the same
89
+ # Region.
90
+ #
91
+ # </note>
92
+ # @return [String]
93
+ #
94
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/AssociateResolverQueryLogConfigRequest AWS API Documentation
95
+ #
96
+ class AssociateResolverQueryLogConfigRequest < Struct.new(
97
+ :resolver_query_log_config_id,
98
+ :resource_id)
99
+ SENSITIVE = []
100
+ include Aws::Structure
101
+ end
102
+
103
+ # @!attribute [rw] resolver_query_log_config_association
104
+ # A complex type that contains settings for a specified association
105
+ # between an Amazon VPC and a query logging configuration.
106
+ # @return [Types::ResolverQueryLogConfigAssociation]
107
+ #
108
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/AssociateResolverQueryLogConfigResponse AWS API Documentation
109
+ #
110
+ class AssociateResolverQueryLogConfigResponse < Struct.new(
111
+ :resolver_query_log_config_association)
112
+ SENSITIVE = []
113
+ include Aws::Structure
114
+ end
115
+
57
116
  # @note When making an API call, you may pass AssociateResolverRuleRequest
58
117
  # data as a hash:
59
118
  #
@@ -64,17 +123,21 @@ module Aws::Route53Resolver
64
123
  # }
65
124
  #
66
125
  # @!attribute [rw] resolver_rule_id
67
- # The ID of the resolver rule that you want to associate with the VPC.
68
- # To list the existing resolver rules, use ListResolverRules.
126
+ # The ID of the Resolver rule that you want to associate with the VPC.
127
+ # To list the existing Resolver rules, use [ListResolverRules][1].
128
+ #
129
+ #
130
+ #
131
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRules.html
69
132
  # @return [String]
70
133
  #
71
134
  # @!attribute [rw] name
72
- # A name for the association that you're creating between a resolver
135
+ # A name for the association that you're creating between a Resolver
73
136
  # rule and a VPC.
74
137
  # @return [String]
75
138
  #
76
139
  # @!attribute [rw] vpc_id
77
- # The ID of the VPC that you want to associate the resolver rule with.
140
+ # The ID of the VPC that you want to associate the Resolver rule with.
78
141
  # @return [String]
79
142
  #
80
143
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/AssociateResolverRuleRequest AWS API Documentation
@@ -116,8 +179,8 @@ module Aws::Route53Resolver
116
179
  # ],
117
180
  # tags: [
118
181
  # {
119
- # key: "TagKey",
120
- # value: "TagValue",
182
+ # key: "TagKey", # required
183
+ # value: "TagValue", # required
121
184
  # },
122
185
  # ],
123
186
  # }
@@ -137,25 +200,27 @@ module Aws::Route53Resolver
137
200
  # @!attribute [rw] security_group_ids
138
201
  # The ID of one or more security groups that you want to use to
139
202
  # control access to this VPC. The security group that you specify must
140
- # include one or more inbound rules (for inbound resolver endpoints)
141
- # or outbound rules (for outbound resolver endpoints).
203
+ # include one or more inbound rules (for inbound Resolver endpoints)
204
+ # or outbound rules (for outbound Resolver endpoints). Inbound and
205
+ # outbound rules must allow TCP and UDP access. For inbound access,
206
+ # open port 53. For outbound access, open the port that you're using
207
+ # for DNS queries on your network.
142
208
  # @return [Array<String>]
143
209
  #
144
210
  # @!attribute [rw] direction
145
211
  # Specify the applicable value:
146
212
  #
147
213
  # * `INBOUND`\: Resolver forwards DNS queries to the DNS service for a
148
- # VPC from your network or another VPC
214
+ # VPC from your network
149
215
  #
150
216
  # * `OUTBOUND`\: Resolver forwards DNS queries from the DNS service
151
- # for a VPC to your network or another VPC
217
+ # for a VPC to your network
152
218
  # @return [String]
153
219
  #
154
220
  # @!attribute [rw] ip_addresses
155
- # The subnets and IP addresses in your VPC that you want DNS queries
156
- # to pass through on the way from your VPCs to your network (for
157
- # outbound endpoints) or on the way from your network to your VPCs
158
- # (for inbound resolver endpoints).
221
+ # The subnets and IP addresses in your VPC that DNS queries originate
222
+ # from (for outbound endpoints) or that you forward DNS queries to
223
+ # (for inbound endpoints). The subnet ID uniquely identifies a VPC.
159
224
  # @return [Array<Types::IpAddressRequest>]
160
225
  #
161
226
  # @!attribute [rw] tags
@@ -189,6 +254,87 @@ module Aws::Route53Resolver
189
254
  include Aws::Structure
190
255
  end
191
256
 
257
+ # @note When making an API call, you may pass CreateResolverQueryLogConfigRequest
258
+ # data as a hash:
259
+ #
260
+ # {
261
+ # name: "ResolverQueryLogConfigName", # required
262
+ # destination_arn: "DestinationArn", # required
263
+ # creator_request_id: "CreatorRequestId", # required
264
+ # tags: [
265
+ # {
266
+ # key: "TagKey", # required
267
+ # value: "TagValue", # required
268
+ # },
269
+ # ],
270
+ # }
271
+ #
272
+ # @!attribute [rw] name
273
+ # The name that you want to give the query logging configuration
274
+ # @return [String]
275
+ #
276
+ # @!attribute [rw] destination_arn
277
+ # The ARN of the resource that you want Resolver to send query logs.
278
+ # You can send query logs to an S3 bucket, a CloudWatch Logs log
279
+ # group, or a Kinesis Data Firehose delivery stream. Examples of valid
280
+ # values include the following:
281
+ #
282
+ # * **S3 bucket**\:
283
+ #
284
+ # `arn:aws:s3:::examplebucket`
285
+ #
286
+ # You can optionally append a file prefix to the end of the ARN.
287
+ #
288
+ # `arn:aws:s3:::examplebucket/development/`
289
+ #
290
+ # * **CloudWatch Logs log group**\:
291
+ #
292
+ # `arn:aws:logs:us-west-1:123456789012:log-group:/mystack-testgroup-12ABC1AB12A1:*`
293
+ #
294
+ # * **Kinesis Data Firehose delivery stream**\:
295
+ #
296
+ # `arn:aws:kinesis:us-east-2:0123456789:stream/my_stream_name`
297
+ # @return [String]
298
+ #
299
+ # @!attribute [rw] creator_request_id
300
+ # A unique string that identifies the request and that allows failed
301
+ # requests to be retried without the risk of executing the operation
302
+ # twice. `CreatorRequestId` can be any unique string, for example, a
303
+ # date/time stamp.
304
+ #
305
+ # **A suitable default value is auto-generated.** You should normally
306
+ # not need to pass this option.
307
+ # @return [String]
308
+ #
309
+ # @!attribute [rw] tags
310
+ # A list of the tag keys and values that you want to associate with
311
+ # the query logging configuration.
312
+ # @return [Array<Types::Tag>]
313
+ #
314
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/CreateResolverQueryLogConfigRequest AWS API Documentation
315
+ #
316
+ class CreateResolverQueryLogConfigRequest < Struct.new(
317
+ :name,
318
+ :destination_arn,
319
+ :creator_request_id,
320
+ :tags)
321
+ SENSITIVE = []
322
+ include Aws::Structure
323
+ end
324
+
325
+ # @!attribute [rw] resolver_query_log_config
326
+ # Information about the `CreateResolverQueryLogConfig` request,
327
+ # including the status of the request.
328
+ # @return [Types::ResolverQueryLogConfig]
329
+ #
330
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/CreateResolverQueryLogConfigResponse AWS API Documentation
331
+ #
332
+ class CreateResolverQueryLogConfigResponse < Struct.new(
333
+ :resolver_query_log_config)
334
+ SENSITIVE = []
335
+ include Aws::Structure
336
+ end
337
+
192
338
  # @note When making an API call, you may pass CreateResolverRuleRequest
193
339
  # data as a hash:
194
340
  #
@@ -206,8 +352,8 @@ module Aws::Route53Resolver
206
352
  # resolver_endpoint_id: "ResourceId",
207
353
  # tags: [
208
354
  # {
209
- # key: "TagKey",
210
- # value: "TagValue",
355
+ # key: "TagKey", # required
356
+ # value: "TagValue", # required
211
357
  # },
212
358
  # ],
213
359
  # }
@@ -225,24 +371,41 @@ module Aws::Route53Resolver
225
371
  # @return [String]
226
372
  #
227
373
  # @!attribute [rw] rule_type
228
- # Specify `FORWARD`. Other resolver rule types aren't supported.
374
+ # When you want to forward DNS queries for specified domain name to
375
+ # resolvers on your network, specify `FORWARD`.
376
+ #
377
+ # When you have a forwarding rule to forward DNS queries for a domain
378
+ # to your network and you want Resolver to process queries for a
379
+ # subdomain of that domain, specify `SYSTEM`.
380
+ #
381
+ # For example, to forward DNS queries for example.com to resolvers on
382
+ # your network, you create a rule and specify `FORWARD` for
383
+ # `RuleType`. To then have Resolver process queries for
384
+ # apex.example.com, you create a rule and specify `SYSTEM` for
385
+ # `RuleType`.
386
+ #
387
+ # Currently, only Resolver can create rules that have a value of
388
+ # `RECURSIVE` for `RuleType`.
229
389
  # @return [String]
230
390
  #
231
391
  # @!attribute [rw] domain_name
232
392
  # DNS queries for this domain name are forwarded to the IP addresses
233
393
  # that you specify in `TargetIps`. If a query matches multiple
234
- # resolver rules (example.com and www.example.com), outbound DNS
235
- # queries are routed using the resolver rule that contains the most
394
+ # Resolver rules (example.com and www.example.com), outbound DNS
395
+ # queries are routed using the Resolver rule that contains the most
236
396
  # specific domain name (www.example.com).
237
397
  # @return [String]
238
398
  #
239
399
  # @!attribute [rw] target_ips
240
400
  # The IPs that you want Resolver to forward DNS queries to. You can
241
401
  # specify only IPv4 addresses. Separate IP addresses with a comma.
402
+ #
403
+ # `TargetIps` is available only when the value of `Rule type` is
404
+ # `FORWARD`.
242
405
  # @return [Array<Types::TargetAddress>]
243
406
  #
244
407
  # @!attribute [rw] resolver_endpoint_id
245
- # The ID of the outbound resolver endpoint that you want to use to
408
+ # The ID of the outbound Resolver endpoint that you want to use to
246
409
  # route DNS queries to the IP addresses that you specify in
247
410
  # `TargetIps`.
248
411
  # @return [String]
@@ -287,7 +450,7 @@ module Aws::Route53Resolver
287
450
  # }
288
451
  #
289
452
  # @!attribute [rw] resolver_endpoint_id
290
- # The ID of the resolver endpoint that you want to delete.
453
+ # The ID of the Resolver endpoint that you want to delete.
291
454
  # @return [String]
292
455
  #
293
456
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/DeleteResolverEndpointRequest AWS API Documentation
@@ -311,6 +474,38 @@ module Aws::Route53Resolver
311
474
  include Aws::Structure
312
475
  end
313
476
 
477
+ # @note When making an API call, you may pass DeleteResolverQueryLogConfigRequest
478
+ # data as a hash:
479
+ #
480
+ # {
481
+ # resolver_query_log_config_id: "ResourceId", # required
482
+ # }
483
+ #
484
+ # @!attribute [rw] resolver_query_log_config_id
485
+ # The ID of the query logging configuration that you want to delete.
486
+ # @return [String]
487
+ #
488
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/DeleteResolverQueryLogConfigRequest AWS API Documentation
489
+ #
490
+ class DeleteResolverQueryLogConfigRequest < Struct.new(
491
+ :resolver_query_log_config_id)
492
+ SENSITIVE = []
493
+ include Aws::Structure
494
+ end
495
+
496
+ # @!attribute [rw] resolver_query_log_config
497
+ # Information about the query logging configuration that you deleted,
498
+ # including the status of the request.
499
+ # @return [Types::ResolverQueryLogConfig]
500
+ #
501
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/DeleteResolverQueryLogConfigResponse AWS API Documentation
502
+ #
503
+ class DeleteResolverQueryLogConfigResponse < Struct.new(
504
+ :resolver_query_log_config)
505
+ SENSITIVE = []
506
+ include Aws::Structure
507
+ end
508
+
314
509
  # @note When making an API call, you may pass DeleteResolverRuleRequest
315
510
  # data as a hash:
316
511
  #
@@ -319,7 +514,7 @@ module Aws::Route53Resolver
319
514
  # }
320
515
  #
321
516
  # @!attribute [rw] resolver_rule_id
322
- # The ID of the resolver rule that you want to delete.
517
+ # The ID of the Resolver rule that you want to delete.
323
518
  # @return [String]
324
519
  #
325
520
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/DeleteResolverRuleRequest AWS API Documentation
@@ -356,12 +551,12 @@ module Aws::Route53Resolver
356
551
  # }
357
552
  #
358
553
  # @!attribute [rw] resolver_endpoint_id
359
- # The ID of the resolver endpoint that you want to disassociate an IP
554
+ # The ID of the Resolver endpoint that you want to disassociate an IP
360
555
  # address from.
361
556
  # @return [String]
362
557
  #
363
558
  # @!attribute [rw] ip_address
364
- # The IPv4 address that you want to remove from a resolver endpoint.
559
+ # The IPv4 address that you want to remove from a Resolver endpoint.
365
560
  # @return [Types::IpAddressUpdate]
366
561
  #
367
562
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/DisassociateResolverEndpointIpAddressRequest AWS API Documentation
@@ -385,6 +580,46 @@ module Aws::Route53Resolver
385
580
  include Aws::Structure
386
581
  end
387
582
 
583
+ # @note When making an API call, you may pass DisassociateResolverQueryLogConfigRequest
584
+ # data as a hash:
585
+ #
586
+ # {
587
+ # resolver_query_log_config_id: "ResourceId", # required
588
+ # resource_id: "ResourceId", # required
589
+ # }
590
+ #
591
+ # @!attribute [rw] resolver_query_log_config_id
592
+ # The ID of the query logging configuration that you want to
593
+ # disassociate a specified VPC from.
594
+ # @return [String]
595
+ #
596
+ # @!attribute [rw] resource_id
597
+ # The ID of the Amazon VPC that you want to disassociate from a
598
+ # specified query logging configuration.
599
+ # @return [String]
600
+ #
601
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/DisassociateResolverQueryLogConfigRequest AWS API Documentation
602
+ #
603
+ class DisassociateResolverQueryLogConfigRequest < Struct.new(
604
+ :resolver_query_log_config_id,
605
+ :resource_id)
606
+ SENSITIVE = []
607
+ include Aws::Structure
608
+ end
609
+
610
+ # @!attribute [rw] resolver_query_log_config_association
611
+ # A complex type that contains settings for the association that you
612
+ # deleted between an Amazon VPC and a query logging configuration.
613
+ # @return [Types::ResolverQueryLogConfigAssociation]
614
+ #
615
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/DisassociateResolverQueryLogConfigResponse AWS API Documentation
616
+ #
617
+ class DisassociateResolverQueryLogConfigResponse < Struct.new(
618
+ :resolver_query_log_config_association)
619
+ SENSITIVE = []
620
+ include Aws::Structure
621
+ end
622
+
388
623
  # @note When making an API call, you may pass DisassociateResolverRuleRequest
389
624
  # data as a hash:
390
625
  #
@@ -394,12 +629,12 @@ module Aws::Route53Resolver
394
629
  # }
395
630
  #
396
631
  # @!attribute [rw] vpc_id
397
- # The ID of the VPC that you want to disassociate the resolver rule
632
+ # The ID of the VPC that you want to disassociate the Resolver rule
398
633
  # from.
399
634
  # @return [String]
400
635
  #
401
636
  # @!attribute [rw] resolver_rule_id
402
- # The ID of the resolver rule that you want to disassociate from the
637
+ # The ID of the Resolver rule that you want to disassociate from the
403
638
  # specified VPC.
404
639
  # @return [String]
405
640
  #
@@ -425,8 +660,24 @@ module Aws::Route53Resolver
425
660
  include Aws::Structure
426
661
  end
427
662
 
428
- # For `List` operations, an optional specification to return a subset of
429
- # objects, such as resolver endpoints or resolver rules.
663
+ # For Resolver list operations ([ListResolverEndpoints][1],
664
+ # [ListResolverRules][2], [ListResolverRuleAssociations][3],
665
+ # [ListResolverQueryLogConfigs][4], and
666
+ # [ListResolverQueryLogConfigAssociations][5]), an optional
667
+ # specification to return a subset of objects.
668
+ #
669
+ # To filter objects, such as Resolver endpoints or Resolver rules, you
670
+ # specify `Name` and `Values`. For example, to list only inbound
671
+ # Resolver endpoints, specify `Direction` for `Name` and specify
672
+ # `INBOUND` for `Values`.
673
+ #
674
+ #
675
+ #
676
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverEndpoints.html
677
+ # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRules.html
678
+ # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRuleAssociations.html
679
+ # [4]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverQueryLogConfigs.html
680
+ # [5]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverQueryLogConfigAssociations.html
430
681
  #
431
682
  # @note When making an API call, you may pass Filter
432
683
  # data as a hash:
@@ -437,19 +688,194 @@ module Aws::Route53Resolver
437
688
  # }
438
689
  #
439
690
  # @!attribute [rw] name
440
- # When you're using a `List` operation and you want the operation to
441
- # return a subset of objects, such as resolver endpoints or resolver
442
- # rules, the name of the parameter that you want to use to filter
443
- # objects. For example, to list only inbound resolver endpoints,
444
- # specify `Direction` for the value of `Name`.
691
+ # The name of the parameter that you want to use to filter objects.
692
+ #
693
+ # The valid values for `Name` depend on the action that you're
694
+ # including the filter in, [ListResolverEndpoints][1],
695
+ # [ListResolverRules][2], [ListResolverRuleAssociations][3],
696
+ # [ListResolverQueryLogConfigs][4], or
697
+ # [ListResolverQueryLogConfigAssociations][5].
698
+ #
699
+ # <note markdown="1"> In early versions of Resolver, values for `Name` were listed as
700
+ # uppercase, with underscore (\_) delimiters. For example,
701
+ # `CreatorRequestId` was originally listed as `CREATOR_REQUEST_ID`.
702
+ # Uppercase values for `Name` are still supported.
703
+ #
704
+ # </note>
705
+ #
706
+ # **ListResolverEndpoints**
707
+ #
708
+ # Valid values for `Name` include the following:
709
+ #
710
+ # * `CreatorRequestId`\: The value that you specified when you created
711
+ # the Resolver endpoint.
712
+ #
713
+ # * `Direction`\: Whether you want to return inbound or outbound
714
+ # Resolver endpoints. If you specify `DIRECTION` for `Name`, specify
715
+ # `INBOUND` or `OUTBOUND` for `Values`.
716
+ #
717
+ # * `HostVpcId`\: The ID of the VPC that inbound DNS queries pass
718
+ # through on the way from your network to your VPCs in a region, or
719
+ # the VPC that outbound queries pass through on the way from your
720
+ # VPCs to your network. In a [CreateResolverEndpoint][6] request,
721
+ # `SubnetId` indirectly identifies the VPC. In a
722
+ # [GetResolverEndpoint][7] request, the VPC ID for a Resolver
723
+ # endpoint is returned in the `HostVPCId` element.
724
+ #
725
+ # * `IpAddressCount`\: The number of IP addresses that you have
726
+ # associated with the Resolver endpoint.
727
+ #
728
+ # * `Name`\: The name of the Resolver endpoint.
729
+ #
730
+ # * `SecurityGroupIds`\: The IDs of the VPC security groups that you
731
+ # specified when you created the Resolver endpoint.
732
+ #
733
+ # * `Status`\: The status of the Resolver endpoint. If you specify
734
+ # `Status` for `Name`, specify one of the following status codes for
735
+ # `Values`\: `CREATING`, `OPERATIONAL`, `UPDATING`,
736
+ # `AUTO_RECOVERING`, `ACTION_NEEDED`, or `DELETING`. For more
737
+ # information, see `Status` in [ResolverEndpoint][8].
738
+ #
739
+ # **ListResolverRules**
740
+ #
741
+ # Valid values for `Name` include the following:
742
+ #
743
+ # * `CreatorRequestId`\: The value that you specified when you created
744
+ # the Resolver rule.
745
+ #
746
+ # * `DomainName`\: The domain name for which Resolver is forwarding
747
+ # DNS queries to your network. In the value that you specify for
748
+ # `Values`, include a trailing dot (.) after the domain name. For
749
+ # example, if the domain name is example.com, specify the following
750
+ # value. Note the "." after `com`\:
751
+ #
752
+ # `example.com.`
753
+ #
754
+ # * `Name`\: The name of the Resolver rule.
755
+ #
756
+ # * `ResolverEndpointId`\: The ID of the Resolver endpoint that the
757
+ # Resolver rule is associated with.
758
+ #
759
+ # <note markdown="1"> You can filter on the Resolver endpoint only for rules that have a
760
+ # value of `FORWARD` for `RuleType`.
761
+ #
762
+ # </note>
763
+ #
764
+ # * `Status`\: The status of the Resolver rule. If you specify
765
+ # `Status` for `Name`, specify one of the following status codes for
766
+ # `Values`\: `COMPLETE`, `DELETING`, `UPDATING`, or `FAILED`.
767
+ #
768
+ # * `Type`\: The type of the Resolver rule. If you specify `TYPE` for
769
+ # `Name`, specify `FORWARD` or `SYSTEM` for `Values`.
770
+ #
771
+ # **ListResolverRuleAssociations**
772
+ #
773
+ # Valid values for `Name` include the following:
774
+ #
775
+ # * `Name`\: The name of the Resolver rule association.
776
+ #
777
+ # * `ResolverRuleId`\: The ID of the Resolver rule that is associated
778
+ # with one or more VPCs.
779
+ #
780
+ # * `Status`\: The status of the Resolver rule association. If you
781
+ # specify `Status` for `Name`, specify one of the following status
782
+ # codes for `Values`\: `CREATING`, `COMPLETE`, `DELETING`, or
783
+ # `FAILED`.
784
+ #
785
+ # * `VPCId`\: The ID of the VPC that the Resolver rule is associated
786
+ # with.
787
+ #
788
+ # **ListResolverQueryLogConfigs**
789
+ #
790
+ # Valid values for `Name` include the following:
791
+ #
792
+ # * `Arn`\: The ARN for the query logging configuration.
793
+ #
794
+ # * `AssociationCount`\: The number of VPCs that are associated with
795
+ # the query logging configuration.
796
+ #
797
+ # * `CreationTime`\: The date and time that the query logging
798
+ # configuration was created, in Unix time format and Coordinated
799
+ # Universal Time (UTC).
800
+ #
801
+ # * `CreatorRequestId`\: A unique string that identifies the request
802
+ # that created the query logging configuration.
803
+ #
804
+ # * `Destination`\: The AWS service that you want to forward query
805
+ # logs to. Valid values include the following:
806
+ #
807
+ # * `S3`
808
+ #
809
+ # * `CloudWatchLogs`
810
+ #
811
+ # * `KinesisFirehose`
812
+ #
813
+ # * `DestinationArn`\: The ARN of the location that Resolver is
814
+ # sending query logs to. This value can be the ARN for an S3 bucket,
815
+ # a CloudWatch Logs log group, or a Kinesis Data Firehose delivery
816
+ # stream.
817
+ #
818
+ # * `Id`\: The ID of the query logging configuration
819
+ #
820
+ # * `Name`\: The name of the query logging configuration
821
+ #
822
+ # * `OwnerId`\: The AWS account ID for the account that created the
823
+ # query logging configuration.
824
+ #
825
+ # * `ShareStatus`\: An indication of whether the query logging
826
+ # configuration is shared with other AWS accounts, or was shared
827
+ # with the current account by another AWS account. Valid values
828
+ # include: `NOT_SHARED`, `SHARED_WITH_ME`, or `SHARED_BY_ME`.
829
+ #
830
+ # * `Status`\: The status of the query logging configuration. If you
831
+ # specify `Status` for `Name`, specify the applicable status code
832
+ # for `Values`\: `CREATING`, `CREATED`, `DELETING`, or `FAILED`. For
833
+ # more information, see [Status][9].
834
+ #
835
+ # **ListResolverQueryLogConfigAssociations**
836
+ #
837
+ # Valid values for `Name` include the following:
838
+ #
839
+ # * `CreationTime`\: The date and time that the VPC was associated
840
+ # with the query logging configuration, in Unix time format and
841
+ # Coordinated Universal Time (UTC).
842
+ #
843
+ # * `Error`\: If the value of `Status` is `FAILED`, specify the cause:
844
+ # `DESTINATION_NOT_FOUND` or `ACCESS_DENIED`.
845
+ #
846
+ # * `Id`\: The ID of the query logging association.
847
+ #
848
+ # * `ResolverQueryLogConfigId`\: The ID of the query logging
849
+ # configuration that a VPC is associated with.
850
+ #
851
+ # * `ResourceId`\: The ID of the Amazon VPC that is associated with
852
+ # the query logging configuration.
853
+ #
854
+ # * `Status`\: The status of the query logging association. If you
855
+ # specify `Status` for `Name`, specify the applicable status code
856
+ # for `Values`\: `CREATING`, `CREATED`, `DELETING`, or `FAILED`. For
857
+ # more information, see [Status][10].
858
+ #
859
+ #
860
+ #
861
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverEndpoints.html
862
+ # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRules.html
863
+ # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRuleAssociations.html
864
+ # [4]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverQueryLogConfigs.html
865
+ # [5]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverQueryLogConfigAssociations.html
866
+ # [6]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_CreateResolverEndpoint.html
867
+ # [7]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverEndpoint.html
868
+ # [8]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ResolverEndpoint.html
869
+ # [9]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ResolverQueryLogConfig.html#Route53Resolver-Type-route53resolver_ResolverQueryLogConfig-Status
870
+ # [10]: https://docs.aws.amazon.com/API_route53resolver_ResolverQueryLogConfigAssociation.html#Route53Resolver-Type-route53resolver_ResolverQueryLogConfigAssociation-Status
445
871
  # @return [String]
446
872
  #
447
873
  # @!attribute [rw] values
448
874
  # When you're using a `List` operation and you want the operation to
449
- # return a subset of objects, such as resolver endpoints or resolver
875
+ # return a subset of objects, such as Resolver endpoints or Resolver
450
876
  # rules, the value of the parameter that you want to use to filter
451
- # objects. For example, to list only inbound resolver endpoints,
452
- # specify `INBOUND` for the value of `Values`.
877
+ # objects. For example, to list only inbound Resolver endpoints,
878
+ # specify `Direction` for `Name` and specify `INBOUND` for `Values`.
453
879
  # @return [Array<String>]
454
880
  #
455
881
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/Filter AWS API Documentation
@@ -469,7 +895,7 @@ module Aws::Route53Resolver
469
895
  # }
470
896
  #
471
897
  # @!attribute [rw] resolver_endpoint_id
472
- # The ID of the resolver endpoint that you want to get information
898
+ # The ID of the Resolver endpoint that you want to get information
473
899
  # about.
474
900
  # @return [String]
475
901
  #
@@ -482,7 +908,7 @@ module Aws::Route53Resolver
482
908
  end
483
909
 
484
910
  # @!attribute [rw] resolver_endpoint
485
- # Information about the resolver endpoint that you specified in a
911
+ # Information about the Resolver endpoint that you specified in a
486
912
  # `GetResolverEndpoint` request.
487
913
  # @return [Types::ResolverEndpoint]
488
914
  #
@@ -494,6 +920,107 @@ module Aws::Route53Resolver
494
920
  include Aws::Structure
495
921
  end
496
922
 
923
+ # @note When making an API call, you may pass GetResolverQueryLogConfigAssociationRequest
924
+ # data as a hash:
925
+ #
926
+ # {
927
+ # resolver_query_log_config_association_id: "ResourceId", # required
928
+ # }
929
+ #
930
+ # @!attribute [rw] resolver_query_log_config_association_id
931
+ # The ID of the Resolver query logging configuration association that
932
+ # you want to get information about.
933
+ # @return [String]
934
+ #
935
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/GetResolverQueryLogConfigAssociationRequest AWS API Documentation
936
+ #
937
+ class GetResolverQueryLogConfigAssociationRequest < Struct.new(
938
+ :resolver_query_log_config_association_id)
939
+ SENSITIVE = []
940
+ include Aws::Structure
941
+ end
942
+
943
+ # @!attribute [rw] resolver_query_log_config_association
944
+ # Information about the Resolver query logging configuration
945
+ # association that you specified in a `GetQueryLogConfigAssociation`
946
+ # request.
947
+ # @return [Types::ResolverQueryLogConfigAssociation]
948
+ #
949
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/GetResolverQueryLogConfigAssociationResponse AWS API Documentation
950
+ #
951
+ class GetResolverQueryLogConfigAssociationResponse < Struct.new(
952
+ :resolver_query_log_config_association)
953
+ SENSITIVE = []
954
+ include Aws::Structure
955
+ end
956
+
957
+ # @note When making an API call, you may pass GetResolverQueryLogConfigPolicyRequest
958
+ # data as a hash:
959
+ #
960
+ # {
961
+ # arn: "Arn", # required
962
+ # }
963
+ #
964
+ # @!attribute [rw] arn
965
+ # The ARN of the query logging configuration that you want to get the
966
+ # query logging policy for.
967
+ # @return [String]
968
+ #
969
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/GetResolverQueryLogConfigPolicyRequest AWS API Documentation
970
+ #
971
+ class GetResolverQueryLogConfigPolicyRequest < Struct.new(
972
+ :arn)
973
+ SENSITIVE = []
974
+ include Aws::Structure
975
+ end
976
+
977
+ # @!attribute [rw] resolver_query_log_config_policy
978
+ # Information about the query logging policy for the query logging
979
+ # configuration that you specified in a
980
+ # `GetResolverQueryLogConfigPolicy` request.
981
+ # @return [String]
982
+ #
983
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/GetResolverQueryLogConfigPolicyResponse AWS API Documentation
984
+ #
985
+ class GetResolverQueryLogConfigPolicyResponse < Struct.new(
986
+ :resolver_query_log_config_policy)
987
+ SENSITIVE = []
988
+ include Aws::Structure
989
+ end
990
+
991
+ # @note When making an API call, you may pass GetResolverQueryLogConfigRequest
992
+ # data as a hash:
993
+ #
994
+ # {
995
+ # resolver_query_log_config_id: "ResourceId", # required
996
+ # }
997
+ #
998
+ # @!attribute [rw] resolver_query_log_config_id
999
+ # The ID of the Resolver query logging configuration that you want to
1000
+ # get information about.
1001
+ # @return [String]
1002
+ #
1003
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/GetResolverQueryLogConfigRequest AWS API Documentation
1004
+ #
1005
+ class GetResolverQueryLogConfigRequest < Struct.new(
1006
+ :resolver_query_log_config_id)
1007
+ SENSITIVE = []
1008
+ include Aws::Structure
1009
+ end
1010
+
1011
+ # @!attribute [rw] resolver_query_log_config
1012
+ # Information about the Resolver query logging configuration that you
1013
+ # specified in a `GetQueryLogConfig` request.
1014
+ # @return [Types::ResolverQueryLogConfig]
1015
+ #
1016
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/GetResolverQueryLogConfigResponse AWS API Documentation
1017
+ #
1018
+ class GetResolverQueryLogConfigResponse < Struct.new(
1019
+ :resolver_query_log_config)
1020
+ SENSITIVE = []
1021
+ include Aws::Structure
1022
+ end
1023
+
497
1024
  # @note When making an API call, you may pass GetResolverRuleAssociationRequest
498
1025
  # data as a hash:
499
1026
  #
@@ -502,7 +1029,7 @@ module Aws::Route53Resolver
502
1029
  # }
503
1030
  #
504
1031
  # @!attribute [rw] resolver_rule_association_id
505
- # The ID of the resolver rule association that you want to get
1032
+ # The ID of the Resolver rule association that you want to get
506
1033
  # information about.
507
1034
  # @return [String]
508
1035
  #
@@ -515,7 +1042,7 @@ module Aws::Route53Resolver
515
1042
  end
516
1043
 
517
1044
  # @!attribute [rw] resolver_rule_association
518
- # Information about the resolver rule association that you specified
1045
+ # Information about the Resolver rule association that you specified
519
1046
  # in a `GetResolverRuleAssociation` request.
520
1047
  # @return [Types::ResolverRuleAssociation]
521
1048
  #
@@ -535,7 +1062,7 @@ module Aws::Route53Resolver
535
1062
  # }
536
1063
  #
537
1064
  # @!attribute [rw] arn
538
- # The ID of the resolver rule policy that you want to get information
1065
+ # The ID of the Resolver rule policy that you want to get information
539
1066
  # about.
540
1067
  # @return [String]
541
1068
  #
@@ -548,7 +1075,7 @@ module Aws::Route53Resolver
548
1075
  end
549
1076
 
550
1077
  # @!attribute [rw] resolver_rule_policy
551
- # Information about the resolver rule policy that you specified in a
1078
+ # Information about the Resolver rule policy that you specified in a
552
1079
  # `GetResolverRulePolicy` request.
553
1080
  # @return [String]
554
1081
  #
@@ -568,7 +1095,7 @@ module Aws::Route53Resolver
568
1095
  # }
569
1096
  #
570
1097
  # @!attribute [rw] resolver_rule_id
571
- # The ID of the resolver rule that you want to get information about.
1098
+ # The ID of the Resolver rule that you want to get information about.
572
1099
  # @return [String]
573
1100
  #
574
1101
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/GetResolverRuleRequest AWS API Documentation
@@ -580,7 +1107,7 @@ module Aws::Route53Resolver
580
1107
  end
581
1108
 
582
1109
  # @!attribute [rw] resolver_rule
583
- # Information about the resolver rule that you specified in a
1110
+ # Information about the Resolver rule that you specified in a
584
1111
  # `GetResolverRule` request.
585
1112
  # @return [Types::ResolverRule]
586
1113
  #
@@ -638,7 +1165,7 @@ module Aws::Route53Resolver
638
1165
  include Aws::Structure
639
1166
  end
640
1167
 
641
- # The specified resolver rule policy is invalid.
1168
+ # The specified Resolver rule policy is invalid.
642
1169
  #
643
1170
  # @!attribute [rw] message
644
1171
  # @return [String]
@@ -677,8 +1204,14 @@ module Aws::Route53Resolver
677
1204
  include Aws::Structure
678
1205
  end
679
1206
 
680
- # In an CreateResolverEndpoint request, a subnet and IP address that you
681
- # want to use for DNS queries.
1207
+ # In a [CreateResolverEndpoint][1] request, the IP address that DNS
1208
+ # queries originate from (for outbound endpoints) or that you forward
1209
+ # DNS queries to (for inbound endpoints). `IpAddressRequest` also
1210
+ # includes the ID of the subnet that contains the IP address.
1211
+ #
1212
+ #
1213
+ #
1214
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_CreateResolverEndpoint.html
682
1215
  #
683
1216
  # @note When making an API call, you may pass IpAddressRequest
684
1217
  # data as a hash:
@@ -689,7 +1222,7 @@ module Aws::Route53Resolver
689
1222
  # }
690
1223
  #
691
1224
  # @!attribute [rw] subnet_id
692
- # The subnet that contains the IP address.
1225
+ # The ID of the subnet that contains the IP address.
693
1226
  # @return [String]
694
1227
  #
695
1228
  # @!attribute [rw] ip
@@ -705,8 +1238,13 @@ module Aws::Route53Resolver
705
1238
  include Aws::Structure
706
1239
  end
707
1240
 
708
- # In the response to a GetResolverEndpoint request, information about
709
- # the IP addresses that the resolver endpoint uses for DNS queries.
1241
+ # In the response to a [GetResolverEndpoint][1] request, information
1242
+ # about the IP addresses that the Resolver endpoint uses for DNS
1243
+ # queries.
1244
+ #
1245
+ #
1246
+ #
1247
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverEndpoint.html
710
1248
  #
711
1249
  # @!attribute [rw] ip_id
712
1250
  # The ID of one IP address.
@@ -717,7 +1255,7 @@ module Aws::Route53Resolver
717
1255
  # @return [String]
718
1256
  #
719
1257
  # @!attribute [rw] ip
720
- # One IP address that the resolver endpoint uses for DNS queries.
1258
+ # One IP address that the Resolver endpoint uses for DNS queries.
721
1259
  # @return [String]
722
1260
  #
723
1261
  # @!attribute [rw] status
@@ -753,8 +1291,12 @@ module Aws::Route53Resolver
753
1291
  include Aws::Structure
754
1292
  end
755
1293
 
756
- # In an UpdateResolverEndpoint request, information about an IP address
757
- # to update.
1294
+ # In an [UpdateResolverEndpoint][1] request, information about an IP
1295
+ # address to update.
1296
+ #
1297
+ #
1298
+ #
1299
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_UpdateResolverEndpoint.html
758
1300
  #
759
1301
  # @note When making an API call, you may pass IpAddressUpdate
760
1302
  # data as a hash:
@@ -766,14 +1308,22 @@ module Aws::Route53Resolver
766
1308
  # }
767
1309
  #
768
1310
  # @!attribute [rw] ip_id
769
- # *Only when removing an IP address from a resolver endpoint*\: The ID
1311
+ # *Only when removing an IP address from a Resolver endpoint*\: The ID
770
1312
  # of the IP address that you want to remove. To get this ID, use
771
- # GetResolverEndpoint.
1313
+ # [GetResolverEndpoint][1].
1314
+ #
1315
+ #
1316
+ #
1317
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverEndpoint.html
772
1318
  # @return [String]
773
1319
  #
774
1320
  # @!attribute [rw] subnet_id
775
1321
  # The ID of the subnet that includes the IP address that you want to
776
- # update. To get this ID, use GetResolverEndpoint.
1322
+ # update. To get this ID, use [GetResolverEndpoint][1].
1323
+ #
1324
+ #
1325
+ #
1326
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverEndpoint.html
777
1327
  # @return [String]
778
1328
  #
779
1329
  # @!attribute [rw] ip
@@ -819,7 +1369,7 @@ module Aws::Route53Resolver
819
1369
  # }
820
1370
  #
821
1371
  # @!attribute [rw] resolver_endpoint_id
822
- # The ID of the resolver endpoint that you want to get IP addresses
1372
+ # The ID of the Resolver endpoint that you want to get IP addresses
823
1373
  # for.
824
1374
  # @return [String]
825
1375
  #
@@ -834,50 +1384,294 @@ module Aws::Route53Resolver
834
1384
  # For the first `ListResolverEndpointIpAddresses` request, omit this
835
1385
  # value.
836
1386
  #
837
- # If the specified resolver endpoint has more than `MaxResults` IP
1387
+ # If the specified Resolver endpoint has more than `MaxResults` IP
838
1388
  # addresses, you can submit another `ListResolverEndpointIpAddresses`
839
1389
  # request to get the next group of IP addresses. In the next request,
840
1390
  # specify the value of `NextToken` from the previous response.
841
1391
  # @return [String]
842
1392
  #
843
- # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverEndpointIpAddressesRequest AWS API Documentation
1393
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverEndpointIpAddressesRequest AWS API Documentation
1394
+ #
1395
+ class ListResolverEndpointIpAddressesRequest < Struct.new(
1396
+ :resolver_endpoint_id,
1397
+ :max_results,
1398
+ :next_token)
1399
+ SENSITIVE = []
1400
+ include Aws::Structure
1401
+ end
1402
+
1403
+ # @!attribute [rw] next_token
1404
+ # If the specified endpoint has more than `MaxResults` IP addresses,
1405
+ # you can submit another `ListResolverEndpointIpAddresses` request to
1406
+ # get the next group of IP addresses. In the next request, specify the
1407
+ # value of `NextToken` from the previous response.
1408
+ # @return [String]
1409
+ #
1410
+ # @!attribute [rw] max_results
1411
+ # The value that you specified for `MaxResults` in the request.
1412
+ # @return [Integer]
1413
+ #
1414
+ # @!attribute [rw] ip_addresses
1415
+ # Information about the IP addresses in your VPC that DNS queries
1416
+ # originate from (for outbound endpoints) or that you forward DNS
1417
+ # queries to (for inbound endpoints).
1418
+ # @return [Array<Types::IpAddressResponse>]
1419
+ #
1420
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverEndpointIpAddressesResponse AWS API Documentation
1421
+ #
1422
+ class ListResolverEndpointIpAddressesResponse < Struct.new(
1423
+ :next_token,
1424
+ :max_results,
1425
+ :ip_addresses)
1426
+ SENSITIVE = []
1427
+ include Aws::Structure
1428
+ end
1429
+
1430
+ # @note When making an API call, you may pass ListResolverEndpointsRequest
1431
+ # data as a hash:
1432
+ #
1433
+ # {
1434
+ # max_results: 1,
1435
+ # next_token: "NextToken",
1436
+ # filters: [
1437
+ # {
1438
+ # name: "FilterName",
1439
+ # values: ["FilterValue"],
1440
+ # },
1441
+ # ],
1442
+ # }
1443
+ #
1444
+ # @!attribute [rw] max_results
1445
+ # The maximum number of Resolver endpoints that you want to return in
1446
+ # the response to a `ListResolverEndpoints` request. If you don't
1447
+ # specify a value for `MaxResults`, Resolver returns up to 100
1448
+ # Resolver endpoints.
1449
+ # @return [Integer]
1450
+ #
1451
+ # @!attribute [rw] next_token
1452
+ # For the first `ListResolverEndpoints` request, omit this value.
1453
+ #
1454
+ # If you have more than `MaxResults` Resolver endpoints, you can
1455
+ # submit another `ListResolverEndpoints` request to get the next group
1456
+ # of Resolver endpoints. In the next request, specify the value of
1457
+ # `NextToken` from the previous response.
1458
+ # @return [String]
1459
+ #
1460
+ # @!attribute [rw] filters
1461
+ # An optional specification to return a subset of Resolver endpoints,
1462
+ # such as all inbound Resolver endpoints.
1463
+ #
1464
+ # <note markdown="1"> If you submit a second or subsequent `ListResolverEndpoints` request
1465
+ # and specify the `NextToken` parameter, you must use the same values
1466
+ # for `Filters`, if any, as in the previous request.
1467
+ #
1468
+ # </note>
1469
+ # @return [Array<Types::Filter>]
1470
+ #
1471
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverEndpointsRequest AWS API Documentation
1472
+ #
1473
+ class ListResolverEndpointsRequest < Struct.new(
1474
+ :max_results,
1475
+ :next_token,
1476
+ :filters)
1477
+ SENSITIVE = []
1478
+ include Aws::Structure
1479
+ end
1480
+
1481
+ # @!attribute [rw] next_token
1482
+ # If more than `MaxResults` IP addresses match the specified criteria,
1483
+ # you can submit another `ListResolverEndpoint` request to get the
1484
+ # next group of results. In the next request, specify the value of
1485
+ # `NextToken` from the previous response.
1486
+ # @return [String]
1487
+ #
1488
+ # @!attribute [rw] max_results
1489
+ # The value that you specified for `MaxResults` in the request.
1490
+ # @return [Integer]
1491
+ #
1492
+ # @!attribute [rw] resolver_endpoints
1493
+ # The Resolver endpoints that were created by using the current AWS
1494
+ # account, and that match the specified filters, if any.
1495
+ # @return [Array<Types::ResolverEndpoint>]
1496
+ #
1497
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverEndpointsResponse AWS API Documentation
1498
+ #
1499
+ class ListResolverEndpointsResponse < Struct.new(
1500
+ :next_token,
1501
+ :max_results,
1502
+ :resolver_endpoints)
1503
+ SENSITIVE = []
1504
+ include Aws::Structure
1505
+ end
1506
+
1507
+ # @note When making an API call, you may pass ListResolverQueryLogConfigAssociationsRequest
1508
+ # data as a hash:
1509
+ #
1510
+ # {
1511
+ # max_results: 1,
1512
+ # next_token: "NextToken",
1513
+ # filters: [
1514
+ # {
1515
+ # name: "FilterName",
1516
+ # values: ["FilterValue"],
1517
+ # },
1518
+ # ],
1519
+ # sort_by: "SortByKey",
1520
+ # sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
1521
+ # }
1522
+ #
1523
+ # @!attribute [rw] max_results
1524
+ # The maximum number of query logging associations that you want to
1525
+ # return in the response to a `ListResolverQueryLogConfigAssociations`
1526
+ # request. If you don't specify a value for `MaxResults`, Resolver
1527
+ # returns up to 100 query logging associations.
1528
+ # @return [Integer]
1529
+ #
1530
+ # @!attribute [rw] next_token
1531
+ # For the first `ListResolverQueryLogConfigAssociations` request, omit
1532
+ # this value.
1533
+ #
1534
+ # If there are more than `MaxResults` query logging associations that
1535
+ # match the values that you specify for `Filters`, you can submit
1536
+ # another `ListResolverQueryLogConfigAssociations` request to get the
1537
+ # next group of associations. In the next request, specify the value
1538
+ # of `NextToken` from the previous response.
1539
+ # @return [String]
1540
+ #
1541
+ # @!attribute [rw] filters
1542
+ # An optional specification to return a subset of query logging
1543
+ # associations.
1544
+ #
1545
+ # <note markdown="1"> If you submit a second or subsequent
1546
+ # `ListResolverQueryLogConfigAssociations` request and specify the
1547
+ # `NextToken` parameter, you must use the same values for `Filters`,
1548
+ # if any, as in the previous request.
1549
+ #
1550
+ # </note>
1551
+ # @return [Array<Types::Filter>]
1552
+ #
1553
+ # @!attribute [rw] sort_by
1554
+ # The element that you want Resolver to sort query logging
1555
+ # associations by.
1556
+ #
1557
+ # <note markdown="1"> If you submit a second or subsequent
1558
+ # `ListResolverQueryLogConfigAssociations` request and specify the
1559
+ # `NextToken` parameter, you must use the same value for `SortBy`, if
1560
+ # any, as in the previous request.
1561
+ #
1562
+ # </note>
1563
+ #
1564
+ # Valid values include the following elements:
1565
+ #
1566
+ # * `CreationTime`\: The ID of the query logging association.
1567
+ #
1568
+ # * `Error`\: If the value of `Status` is `FAILED`, the value of
1569
+ # `Error` indicates the cause:
1570
+ #
1571
+ # * `DESTINATION_NOT_FOUND`\: The specified destination (for
1572
+ # example, an Amazon S3 bucket) was deleted.
1573
+ #
1574
+ # * `ACCESS_DENIED`\: Permissions don't allow sending logs to the
1575
+ # destination.
1576
+ #
1577
+ # If `Status` is a value other than `FAILED`, `ERROR` is null.
1578
+ #
1579
+ # * `Id`\: The ID of the query logging association
1580
+ #
1581
+ # * `ResolverQueryLogConfigId`\: The ID of the query logging
1582
+ # configuration
1583
+ #
1584
+ # * `ResourceId`\: The ID of the VPC that is associated with the query
1585
+ # logging configuration
1586
+ #
1587
+ # * `Status`\: The current status of the configuration. Valid values
1588
+ # include the following:
1589
+ #
1590
+ # * `CREATING`\: Resolver is creating an association between an
1591
+ # Amazon VPC and a query logging configuration.
1592
+ #
1593
+ # * `CREATED`\: The association between an Amazon VPC and a query
1594
+ # logging configuration was successfully created. Resolver is
1595
+ # logging queries that originate in the specified VPC.
1596
+ #
1597
+ # * `DELETING`\: Resolver is deleting this query logging
1598
+ # association.
1599
+ #
1600
+ # * `FAILED`\: Resolver either couldn't create or couldn't delete
1601
+ # the query logging association. Here are two common causes:
1602
+ #
1603
+ # * The specified destination (for example, an Amazon S3 bucket)
1604
+ # was deleted.
1605
+ #
1606
+ # * Permissions don't allow sending logs to the destination.
1607
+ # @return [String]
1608
+ #
1609
+ # @!attribute [rw] sort_order
1610
+ # If you specified a value for `SortBy`, the order that you want query
1611
+ # logging associations to be listed in, `ASCENDING` or `DESCENDING`.
1612
+ #
1613
+ # <note markdown="1"> If you submit a second or subsequent
1614
+ # `ListResolverQueryLogConfigAssociations` request and specify the
1615
+ # `NextToken` parameter, you must use the same value for `SortOrder`,
1616
+ # if any, as in the previous request.
1617
+ #
1618
+ # </note>
1619
+ # @return [String]
1620
+ #
1621
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverQueryLogConfigAssociationsRequest AWS API Documentation
844
1622
  #
845
- class ListResolverEndpointIpAddressesRequest < Struct.new(
846
- :resolver_endpoint_id,
1623
+ class ListResolverQueryLogConfigAssociationsRequest < Struct.new(
847
1624
  :max_results,
848
- :next_token)
1625
+ :next_token,
1626
+ :filters,
1627
+ :sort_by,
1628
+ :sort_order)
849
1629
  SENSITIVE = []
850
1630
  include Aws::Structure
851
1631
  end
852
1632
 
853
1633
  # @!attribute [rw] next_token
854
- # If the specified endpoint has more than `MaxResults` IP addresses,
855
- # you can submit another `ListResolverEndpointIpAddresses` request to
856
- # get the next group of IP addresses. In the next request, specify the
857
- # value of `NextToken` from the previous response.
858
- # @return [String]
1634
+ # If there are more than `MaxResults` query logging associations, you
1635
+ # can submit another `ListResolverQueryLogConfigAssociations` request
1636
+ # to get the next group of associations. In the next request, specify
1637
+ # the value of `NextToken` from the previous response.
1638
+ # @return [String]
1639
+ #
1640
+ # @!attribute [rw] total_count
1641
+ # The total number of query logging associations that were created by
1642
+ # the current account in the specified Region. This count can differ
1643
+ # from the number of associations that are returned in a
1644
+ # `ListResolverQueryLogConfigAssociations` response, depending on the
1645
+ # values that you specify in the request.
1646
+ # @return [Integer]
859
1647
  #
860
- # @!attribute [rw] max_results
861
- # The value that you specified for `MaxResults` in the request.
1648
+ # @!attribute [rw] total_filtered_count
1649
+ # The total number of query logging associations that were created by
1650
+ # the current account in the specified Region and that match the
1651
+ # filters that were specified in the
1652
+ # `ListResolverQueryLogConfigAssociations` request. For the total
1653
+ # number of associations that were created by the current account in
1654
+ # the specified Region, see `TotalCount`.
862
1655
  # @return [Integer]
863
1656
  #
864
- # @!attribute [rw] ip_addresses
865
- # The IP addresses that DNS queries pass through on their way to your
866
- # network (outbound endpoint) or on the way to Resolver (inbound
867
- # endpoint).
868
- # @return [Array<Types::IpAddressResponse>]
1657
+ # @!attribute [rw] resolver_query_log_config_associations
1658
+ # A list that contains one `ResolverQueryLogConfigAssociations`
1659
+ # element for each query logging association that matches the values
1660
+ # that you specified for `Filter`.
1661
+ # @return [Array<Types::ResolverQueryLogConfigAssociation>]
869
1662
  #
870
- # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverEndpointIpAddressesResponse AWS API Documentation
1663
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverQueryLogConfigAssociationsResponse AWS API Documentation
871
1664
  #
872
- class ListResolverEndpointIpAddressesResponse < Struct.new(
1665
+ class ListResolverQueryLogConfigAssociationsResponse < Struct.new(
873
1666
  :next_token,
874
- :max_results,
875
- :ip_addresses)
1667
+ :total_count,
1668
+ :total_filtered_count,
1669
+ :resolver_query_log_config_associations)
876
1670
  SENSITIVE = []
877
1671
  include Aws::Structure
878
1672
  end
879
1673
 
880
- # @note When making an API call, you may pass ListResolverEndpointsRequest
1674
+ # @note When making an API call, you may pass ListResolverQueryLogConfigsRequest
881
1675
  # data as a hash:
882
1676
  #
883
1677
  # {
@@ -889,67 +1683,158 @@ module Aws::Route53Resolver
889
1683
  # values: ["FilterValue"],
890
1684
  # },
891
1685
  # ],
1686
+ # sort_by: "SortByKey",
1687
+ # sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
892
1688
  # }
893
1689
  #
894
1690
  # @!attribute [rw] max_results
895
- # The maximum number of resolver endpoints that you want to return in
896
- # the response to a `ListResolverEndpoints` request. If you don't
897
- # specify a value for `MaxResults`, Resolver returns up to 100
898
- # resolver endpoints.
1691
+ # The maximum number of query logging configurations that you want to
1692
+ # return in the response to a `ListResolverQueryLogConfigs` request.
1693
+ # If you don't specify a value for `MaxResults`, Resolver returns up
1694
+ # to 100 query logging configurations.
899
1695
  # @return [Integer]
900
1696
  #
901
1697
  # @!attribute [rw] next_token
902
- # For the first `ListResolverEndpoints` request, omit this value.
1698
+ # For the first `ListResolverQueryLogConfigs` request, omit this
1699
+ # value.
903
1700
  #
904
- # If you have more than `MaxResults` resolver endpoints, you can
905
- # submit another `ListResolverEndpoints` request to get the next group
906
- # of resolver endpoints. In the next request, specify the value of
1701
+ # If there are more than `MaxResults` query logging configurations
1702
+ # that match the values that you specify for `Filters`, you can submit
1703
+ # another `ListResolverQueryLogConfigs` request to get the next group
1704
+ # of configurations. In the next request, specify the value of
907
1705
  # `NextToken` from the previous response.
908
1706
  # @return [String]
909
1707
  #
910
1708
  # @!attribute [rw] filters
911
- # An optional specification to return a subset of resolver endpoints,
912
- # such as all inbound resolver endpoints.
1709
+ # An optional specification to return a subset of query logging
1710
+ # configurations.
913
1711
  #
914
- # <note markdown="1"> If you submit a second or subsequent `ListResolverEndpoints` request
915
- # and specify the `NextToken` parameter, you must use the same values
916
- # for `Filters`, if any, as in the previous request.
1712
+ # <note markdown="1"> If you submit a second or subsequent `ListResolverQueryLogConfigs`
1713
+ # request and specify the `NextToken` parameter, you must use the same
1714
+ # values for `Filters`, if any, as in the previous request.
917
1715
  #
918
1716
  # </note>
919
1717
  # @return [Array<Types::Filter>]
920
1718
  #
921
- # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverEndpointsRequest AWS API Documentation
1719
+ # @!attribute [rw] sort_by
1720
+ # The element that you want Resolver to sort query logging
1721
+ # configurations by.
922
1722
  #
923
- class ListResolverEndpointsRequest < Struct.new(
1723
+ # <note markdown="1"> If you submit a second or subsequent `ListResolverQueryLogConfigs`
1724
+ # request and specify the `NextToken` parameter, you must use the same
1725
+ # value for `SortBy`, if any, as in the previous request.
1726
+ #
1727
+ # </note>
1728
+ #
1729
+ # Valid values include the following elements:
1730
+ #
1731
+ # * `Arn`\: The ARN of the query logging configuration
1732
+ #
1733
+ # * `AssociationCount`\: The number of VPCs that are associated with
1734
+ # the specified configuration
1735
+ #
1736
+ # * `CreationTime`\: The date and time that Resolver returned when the
1737
+ # configuration was created
1738
+ #
1739
+ # * `CreatorRequestId`\: The value that was specified for
1740
+ # `CreatorRequestId` when the configuration was created
1741
+ #
1742
+ # * `DestinationArn`\: The location that logs are sent to
1743
+ #
1744
+ # * `Id`\: The ID of the configuration
1745
+ #
1746
+ # * `Name`\: The name of the configuration
1747
+ #
1748
+ # * `OwnerId`\: The AWS account number of the account that created the
1749
+ # configuration
1750
+ #
1751
+ # * `ShareStatus`\: Whether the configuration is shared with other AWS
1752
+ # accounts or shared with the current account by another AWS
1753
+ # account. Sharing is configured through AWS Resource Access Manager
1754
+ # (AWS RAM).
1755
+ #
1756
+ # * `Status`\: The current status of the configuration. Valid values
1757
+ # include the following:
1758
+ #
1759
+ # * `CREATING`\: Resolver is creating the query logging
1760
+ # configuration.
1761
+ #
1762
+ # * `CREATED`\: The query logging configuration was successfully
1763
+ # created. Resolver is logging queries that originate in the
1764
+ # specified VPC.
1765
+ #
1766
+ # * `DELETING`\: Resolver is deleting this query logging
1767
+ # configuration.
1768
+ #
1769
+ # * `FAILED`\: Resolver either couldn't create or couldn't delete
1770
+ # the query logging configuration. Here are two common causes:
1771
+ #
1772
+ # * The specified destination (for example, an Amazon S3 bucket)
1773
+ # was deleted.
1774
+ #
1775
+ # * Permissions don't allow sending logs to the destination.
1776
+ # @return [String]
1777
+ #
1778
+ # @!attribute [rw] sort_order
1779
+ # If you specified a value for `SortBy`, the order that you want query
1780
+ # logging configurations to be listed in, `ASCENDING` or `DESCENDING`.
1781
+ #
1782
+ # <note markdown="1"> If you submit a second or subsequent `ListResolverQueryLogConfigs`
1783
+ # request and specify the `NextToken` parameter, you must use the same
1784
+ # value for `SortOrder`, if any, as in the previous request.
1785
+ #
1786
+ # </note>
1787
+ # @return [String]
1788
+ #
1789
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverQueryLogConfigsRequest AWS API Documentation
1790
+ #
1791
+ class ListResolverQueryLogConfigsRequest < Struct.new(
924
1792
  :max_results,
925
1793
  :next_token,
926
- :filters)
1794
+ :filters,
1795
+ :sort_by,
1796
+ :sort_order)
927
1797
  SENSITIVE = []
928
1798
  include Aws::Structure
929
1799
  end
930
1800
 
931
1801
  # @!attribute [rw] next_token
932
- # If more than `MaxResults` IP addresses match the specified criteria,
933
- # you can submit another `ListResolverEndpoint` request to get the
934
- # next group of results. In the next request, specify the value of
935
- # `NextToken` from the previous response.
1802
+ # If there are more than `MaxResults` query logging configurations,
1803
+ # you can submit another `ListResolverQueryLogConfigs` request to get
1804
+ # the next group of configurations. In the next request, specify the
1805
+ # value of `NextToken` from the previous response.
936
1806
  # @return [String]
937
1807
  #
938
- # @!attribute [rw] max_results
939
- # The value that you specified for `MaxResults` in the request.
1808
+ # @!attribute [rw] total_count
1809
+ # The total number of query logging configurations that were created
1810
+ # by the current account in the specified Region. This count can
1811
+ # differ from the number of query logging configurations that are
1812
+ # returned in a `ListResolverQueryLogConfigs` response, depending on
1813
+ # the values that you specify in the request.
940
1814
  # @return [Integer]
941
1815
  #
942
- # @!attribute [rw] resolver_endpoints
943
- # The resolver endpoints that were created by using the current AWS
944
- # account, and that match the specified filters, if any.
945
- # @return [Array<Types::ResolverEndpoint>]
1816
+ # @!attribute [rw] total_filtered_count
1817
+ # The total number of query logging configurations that were created
1818
+ # by the current account in the specified Region and that match the
1819
+ # filters that were specified in the `ListResolverQueryLogConfigs`
1820
+ # request. For the total number of query logging configurations that
1821
+ # were created by the current account in the specified Region, see
1822
+ # `TotalCount`.
1823
+ # @return [Integer]
946
1824
  #
947
- # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverEndpointsResponse AWS API Documentation
1825
+ # @!attribute [rw] resolver_query_log_configs
1826
+ # A list that contains one `ResolverQueryLogConfig` element for each
1827
+ # query logging configuration that matches the values that you
1828
+ # specified for `Filter`.
1829
+ # @return [Array<Types::ResolverQueryLogConfig>]
948
1830
  #
949
- class ListResolverEndpointsResponse < Struct.new(
1831
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ListResolverQueryLogConfigsResponse AWS API Documentation
1832
+ #
1833
+ class ListResolverQueryLogConfigsResponse < Struct.new(
950
1834
  :next_token,
951
- :max_results,
952
- :resolver_endpoints)
1835
+ :total_count,
1836
+ :total_filtered_count,
1837
+ :resolver_query_log_configs)
953
1838
  SENSITIVE = []
954
1839
  include Aws::Structure
955
1840
  end
@@ -986,8 +1871,8 @@ module Aws::Route53Resolver
986
1871
  # @return [String]
987
1872
  #
988
1873
  # @!attribute [rw] filters
989
- # An optional specification to return a subset of resolver rules, such
990
- # as resolver rules that are associated with the same VPC ID.
1874
+ # An optional specification to return a subset of Resolver rules, such
1875
+ # as Resolver rules that are associated with the same VPC ID.
991
1876
  #
992
1877
  # <note markdown="1"> If you submit a second or subsequent `ListResolverRuleAssociations`
993
1878
  # request and specify the `NextToken` parameter, you must use the same
@@ -1018,7 +1903,7 @@ module Aws::Route53Resolver
1018
1903
  # @return [Integer]
1019
1904
  #
1020
1905
  # @!attribute [rw] resolver_rule_associations
1021
- # The associations that were created between resolver rules and VPCs
1906
+ # The associations that were created between Resolver rules and VPCs
1022
1907
  # using the current AWS account, and that match the specified filters,
1023
1908
  # if any.
1024
1909
  # @return [Array<Types::ResolverRuleAssociation>]
@@ -1048,23 +1933,23 @@ module Aws::Route53Resolver
1048
1933
  # }
1049
1934
  #
1050
1935
  # @!attribute [rw] max_results
1051
- # The maximum number of resolver rules that you want to return in the
1936
+ # The maximum number of Resolver rules that you want to return in the
1052
1937
  # response to a `ListResolverRules` request. If you don't specify a
1053
- # value for `MaxResults`, Resolver returns up to 100 resolver rules.
1938
+ # value for `MaxResults`, Resolver returns up to 100 Resolver rules.
1054
1939
  # @return [Integer]
1055
1940
  #
1056
1941
  # @!attribute [rw] next_token
1057
1942
  # For the first `ListResolverRules` request, omit this value.
1058
1943
  #
1059
- # If you have more than `MaxResults` resolver rules, you can submit
1944
+ # If you have more than `MaxResults` Resolver rules, you can submit
1060
1945
  # another `ListResolverRules` request to get the next group of
1061
- # resolver rules. In the next request, specify the value of
1946
+ # Resolver rules. In the next request, specify the value of
1062
1947
  # `NextToken` from the previous response.
1063
1948
  # @return [String]
1064
1949
  #
1065
1950
  # @!attribute [rw] filters
1066
- # An optional specification to return a subset of resolver rules, such
1067
- # as all resolver rules that are associated with the same resolver
1951
+ # An optional specification to return a subset of Resolver rules, such
1952
+ # as all Resolver rules that are associated with the same Resolver
1068
1953
  # endpoint.
1069
1954
  #
1070
1955
  # <note markdown="1"> If you submit a second or subsequent `ListResolverRules` request and
@@ -1085,7 +1970,7 @@ module Aws::Route53Resolver
1085
1970
  end
1086
1971
 
1087
1972
  # @!attribute [rw] next_token
1088
- # If more than `MaxResults` resolver rules match the specified
1973
+ # If more than `MaxResults` Resolver rules match the specified
1089
1974
  # criteria, you can submit another `ListResolverRules` request to get
1090
1975
  # the next group of results. In the next request, specify the value of
1091
1976
  # `NextToken` from the previous response.
@@ -1096,7 +1981,7 @@ module Aws::Route53Resolver
1096
1981
  # @return [Integer]
1097
1982
  #
1098
1983
  # @!attribute [rw] resolver_rules
1099
- # The resolver rules that were created using the current AWS account
1984
+ # The Resolver rules that were created using the current AWS account
1100
1985
  # and that match the specified filters, if any.
1101
1986
  # @return [Array<Types::ResolverRule>]
1102
1987
  #
@@ -1170,6 +2055,63 @@ module Aws::Route53Resolver
1170
2055
  include Aws::Structure
1171
2056
  end
1172
2057
 
2058
+ # @note When making an API call, you may pass PutResolverQueryLogConfigPolicyRequest
2059
+ # data as a hash:
2060
+ #
2061
+ # {
2062
+ # arn: "Arn", # required
2063
+ # resolver_query_log_config_policy: "ResolverQueryLogConfigPolicy", # required
2064
+ # }
2065
+ #
2066
+ # @!attribute [rw] arn
2067
+ # The Amazon Resource Name (ARN) of the account that you want to share
2068
+ # rules with.
2069
+ # @return [String]
2070
+ #
2071
+ # @!attribute [rw] resolver_query_log_config_policy
2072
+ # An AWS Identity and Access Management policy statement that lists
2073
+ # the query logging configurations that you want to share with another
2074
+ # AWS account and the operations that you want the account to be able
2075
+ # to perform. You can specify the following operations in the
2076
+ # `Actions` section of the statement:
2077
+ #
2078
+ # * `route53resolver:AssociateResolverQueryLogConfig`
2079
+ #
2080
+ # * `route53resolver:DisassociateResolverQueryLogConfig`
2081
+ #
2082
+ # * `route53resolver:ListResolverQueryLogConfigAssociations`
2083
+ #
2084
+ # * `route53resolver:ListResolverQueryLogConfigs`
2085
+ #
2086
+ # In the `Resource` section of the statement, you specify the ARNs for
2087
+ # the query logging configurations that you want to share with the
2088
+ # account that you specified in `Arn`.
2089
+ # @return [String]
2090
+ #
2091
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/PutResolverQueryLogConfigPolicyRequest AWS API Documentation
2092
+ #
2093
+ class PutResolverQueryLogConfigPolicyRequest < Struct.new(
2094
+ :arn,
2095
+ :resolver_query_log_config_policy)
2096
+ SENSITIVE = []
2097
+ include Aws::Structure
2098
+ end
2099
+
2100
+ # The response to a `PutResolverQueryLogConfigPolicy` request.
2101
+ #
2102
+ # @!attribute [rw] return_value
2103
+ # Whether the `PutResolverQueryLogConfigPolicy` request was
2104
+ # successful.
2105
+ # @return [Boolean]
2106
+ #
2107
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/PutResolverQueryLogConfigPolicyResponse AWS API Documentation
2108
+ #
2109
+ class PutResolverQueryLogConfigPolicyResponse < Struct.new(
2110
+ :return_value)
2111
+ SENSITIVE = []
2112
+ include Aws::Structure
2113
+ end
2114
+
1173
2115
  # @note When making an API call, you may pass PutResolverRulePolicyRequest
1174
2116
  # data as a hash:
1175
2117
  #
@@ -1179,13 +2121,30 @@ module Aws::Route53Resolver
1179
2121
  # }
1180
2122
  #
1181
2123
  # @!attribute [rw] arn
1182
- # The Amazon Resource Name (ARN) of the account that you want to grant
1183
- # permissions to.
2124
+ # The Amazon Resource Name (ARN) of the account that you want to share
2125
+ # rules with.
1184
2126
  # @return [String]
1185
2127
  #
1186
2128
  # @!attribute [rw] resolver_rule_policy
1187
2129
  # An AWS Identity and Access Management policy statement that lists
1188
- # the permissions that you want to grant to another AWS account.
2130
+ # the rules that you want to share with another AWS account and the
2131
+ # operations that you want the account to be able to perform. You can
2132
+ # specify the following operations in the `Actions` section of the
2133
+ # statement:
2134
+ #
2135
+ # * `route53resolver:GetResolverRule`
2136
+ #
2137
+ # * `route53resolver:AssociateResolverRule`
2138
+ #
2139
+ # * `route53resolver:DisassociateResolverRule`
2140
+ #
2141
+ # * `route53resolver:ListResolverRules`
2142
+ #
2143
+ # * `route53resolver:ListResolverRuleAssociations`
2144
+ #
2145
+ # In the `Resource` section of the statement, you specify the ARNs for
2146
+ # the rules that you want to share with the account that you specified
2147
+ # in `Arn`.
1189
2148
  # @return [String]
1190
2149
  #
1191
2150
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/PutResolverRulePolicyRequest AWS API Documentation
@@ -1211,62 +2170,116 @@ module Aws::Route53Resolver
1211
2170
  include Aws::Structure
1212
2171
  end
1213
2172
 
1214
- # In the response to a CreateResolverEndpoint, DeleteResolverEndpoint,
1215
- # GetResolverEndpoint, ListResolverEndpoints, or UpdateResolverEndpoint
1216
- # request, a complex type that contains settings for an existing inbound
1217
- # or outbound resolver endpoint.
2173
+ # In the response to a [CreateResolverEndpoint][1],
2174
+ # [DeleteResolverEndpoint][2], [GetResolverEndpoint][3],
2175
+ # [ListResolverEndpoints][4], or [UpdateResolverEndpoint][5] request, a
2176
+ # complex type that contains settings for an existing inbound or
2177
+ # outbound Resolver endpoint.
2178
+ #
2179
+ #
2180
+ #
2181
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_CreateResolverEndpoint.html
2182
+ # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_DeleteResolverEndpoint.html
2183
+ # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverEndpoint.html
2184
+ # [4]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverEndpoints.html
2185
+ # [5]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_UpdateResolverEndpoint.html
1218
2186
  #
1219
2187
  # @!attribute [rw] id
1220
- # The ID of the resolver endpoint.
2188
+ # The ID of the Resolver endpoint.
1221
2189
  # @return [String]
1222
2190
  #
1223
2191
  # @!attribute [rw] creator_request_id
1224
2192
  # A unique string that identifies the request that created the
1225
- # resolver endpoint. The `CreatorRequestId` allows failed requests to
2193
+ # Resolver endpoint. The `CreatorRequestId` allows failed requests to
1226
2194
  # be retried without the risk of executing the operation twice.
1227
2195
  # @return [String]
1228
2196
  #
1229
2197
  # @!attribute [rw] arn
1230
- # The ARN (Amazon Resource Name) for the resolver endpoint.
2198
+ # The ARN (Amazon Resource Name) for the Resolver endpoint.
1231
2199
  # @return [String]
1232
2200
  #
1233
2201
  # @!attribute [rw] name
1234
- # The name that you assigned to the resolver endpoint when you
1235
- # submitted a CreateResolverEndpoint request.
2202
+ # The name that you assigned to the Resolver endpoint when you
2203
+ # submitted a [CreateResolverEndpoint][1] request.
2204
+ #
2205
+ #
2206
+ #
2207
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_CreateResolverEndpoint.html
1236
2208
  # @return [String]
1237
2209
  #
1238
2210
  # @!attribute [rw] security_group_ids
1239
2211
  # The ID of one or more security groups that control access to this
1240
- # VPC. The security group must include one or more inbound resolver
1241
- # rules.
2212
+ # VPC. The security group must include one or more inbound rules (for
2213
+ # inbound endpoints) or outbound rules (for outbound endpoints).
2214
+ # Inbound and outbound rules must allow TCP and UDP access. For
2215
+ # inbound access, open port 53. For outbound access, open the port
2216
+ # that you're using for DNS queries on your network.
1242
2217
  # @return [Array<String>]
1243
2218
  #
1244
2219
  # @!attribute [rw] direction
1245
- # Indicates whether the resolver endpoint allows inbound or outbound
2220
+ # Indicates whether the Resolver endpoint allows inbound or outbound
1246
2221
  # DNS queries:
1247
2222
  #
1248
- # * `INBOUND`\: allows DNS queries to your VPC from your network or
1249
- # another VPC
2223
+ # * `INBOUND`\: allows DNS queries to your VPC from your network
1250
2224
  #
1251
- # * `OUTBOUND`\: allows DNS queries from your VPC to your network or
1252
- # another VPC
2225
+ # * `OUTBOUND`\: allows DNS queries from your VPC to your network
1253
2226
  # @return [String]
1254
2227
  #
1255
2228
  # @!attribute [rw] ip_address_count
1256
- # The number of IP addresses that the resolver endpoint can use for
2229
+ # The number of IP addresses that the Resolver endpoint can use for
1257
2230
  # DNS queries.
1258
2231
  # @return [Integer]
1259
2232
  #
1260
2233
  # @!attribute [rw] host_vpc_id
1261
- # The ID of the VPC that you want to create the resolver endpoint in.
2234
+ # The ID of the VPC that you want to create the Resolver endpoint in.
1262
2235
  # @return [String]
1263
2236
  #
1264
2237
  # @!attribute [rw] status
1265
- # A code that specifies the current status of the resolver endpoint.
2238
+ # A code that specifies the current status of the Resolver endpoint.
2239
+ # Valid values include the following:
2240
+ #
2241
+ # * `CREATING`\: Resolver is creating and configuring one or more
2242
+ # Amazon VPC network interfaces for this endpoint.
2243
+ #
2244
+ # * `OPERATIONAL`\: The Amazon VPC network interfaces for this
2245
+ # endpoint are correctly configured and able to pass inbound or
2246
+ # outbound DNS queries between your network and Resolver.
2247
+ #
2248
+ # * `UPDATING`\: Resolver is associating or disassociating one or more
2249
+ # network interfaces with this endpoint.
2250
+ #
2251
+ # * `AUTO_RECOVERING`\: Resolver is trying to recover one or more of
2252
+ # the network interfaces that are associated with this endpoint.
2253
+ # During the recovery process, the endpoint functions with limited
2254
+ # capacity because of the limit on the number of DNS queries per IP
2255
+ # address (per network interface). For the current limit, see
2256
+ # [Limits on Route 53 Resolver][1].
2257
+ #
2258
+ # * `ACTION_NEEDED`\: This endpoint is unhealthy, and Resolver can't
2259
+ # automatically recover it. To resolve the problem, we recommend
2260
+ # that you check each IP address that you associated with the
2261
+ # endpoint. For each IP address that isn't available, add another
2262
+ # IP address and then delete the IP address that isn't available.
2263
+ # (An endpoint must always include at least two IP addresses.) A
2264
+ # status of `ACTION_NEEDED` can have a variety of causes. Here are
2265
+ # two common causes:
2266
+ #
2267
+ # * One or more of the network interfaces that are associated with
2268
+ # the endpoint were deleted using Amazon VPC.
2269
+ #
2270
+ # * The network interface couldn't be created for some reason
2271
+ # that's outside the control of Resolver.
2272
+ #
2273
+ # * `DELETING`\: Resolver is deleting this endpoint and the associated
2274
+ # network interfaces.
2275
+ #
2276
+ #
2277
+ #
2278
+ # [1]: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html#limits-api-entities-resolver
1266
2279
  # @return [String]
1267
2280
  #
1268
2281
  # @!attribute [rw] status_message
1269
- # A detailed description of the status of the resolver endpoint.
2282
+ # A detailed description of the status of the Resolver endpoint.
1270
2283
  # @return [String]
1271
2284
  #
1272
2285
  # @!attribute [rw] creation_time
@@ -1298,58 +2311,264 @@ module Aws::Route53Resolver
1298
2311
  include Aws::Structure
1299
2312
  end
1300
2313
 
2314
+ # In the response to a [CreateResolverQueryLogConfig][1],
2315
+ # [DeleteResolverQueryLogConfig][2], [GetResolverQueryLogConfig][3], or
2316
+ # [ListResolverQueryLogConfigs][4] request, a complex type that contains
2317
+ # settings for one query logging configuration.
2318
+ #
2319
+ #
2320
+ #
2321
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_CreateResolverQueryLogConfig.html
2322
+ # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_DeleteResolverQueryLogConfig.html
2323
+ # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverQueryLogConfig.html
2324
+ # [4]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverQueryLogConfigs.html
2325
+ #
2326
+ # @!attribute [rw] id
2327
+ # The ID for the query logging configuration.
2328
+ # @return [String]
2329
+ #
2330
+ # @!attribute [rw] owner_id
2331
+ # The AWS account ID for the account that created the query logging
2332
+ # configuration.
2333
+ # @return [String]
2334
+ #
2335
+ # @!attribute [rw] status
2336
+ # The status of the specified query logging configuration. Valid
2337
+ # values include the following:
2338
+ #
2339
+ # * `CREATING`\: Resolver is creating the query logging configuration.
2340
+ #
2341
+ # * `CREATED`\: The query logging configuration was successfully
2342
+ # created. Resolver is logging queries that originate in the
2343
+ # specified VPC.
2344
+ #
2345
+ # * `DELETING`\: Resolver is deleting this query logging
2346
+ # configuration.
2347
+ #
2348
+ # * `FAILED`\: Resolver can't deliver logs to the location that is
2349
+ # specified in the query logging configuration. Here are two common
2350
+ # causes:
2351
+ #
2352
+ # * The specified destination (for example, an Amazon S3 bucket) was
2353
+ # deleted.
2354
+ #
2355
+ # * Permissions don't allow sending logs to the destination.
2356
+ # @return [String]
2357
+ #
2358
+ # @!attribute [rw] share_status
2359
+ # An indication of whether the query logging configuration is shared
2360
+ # with other AWS accounts, or was shared with the current account by
2361
+ # another AWS account. Sharing is configured through AWS Resource
2362
+ # Access Manager (AWS RAM).
2363
+ # @return [String]
2364
+ #
2365
+ # @!attribute [rw] association_count
2366
+ # The number of VPCs that are associated with the query logging
2367
+ # configuration.
2368
+ # @return [Integer]
2369
+ #
2370
+ # @!attribute [rw] arn
2371
+ # The ARN for the query logging configuration.
2372
+ # @return [String]
2373
+ #
2374
+ # @!attribute [rw] name
2375
+ # The name of the query logging configuration.
2376
+ # @return [String]
2377
+ #
2378
+ # @!attribute [rw] destination_arn
2379
+ # The ARN of the resource that you want Resolver to send query logs:
2380
+ # an Amazon S3 bucket, a CloudWatch Logs log group, or a Kinesis Data
2381
+ # Firehose delivery stream.
2382
+ # @return [String]
2383
+ #
2384
+ # @!attribute [rw] creator_request_id
2385
+ # A unique string that identifies the request that created the query
2386
+ # logging configuration. The `CreatorRequestId` allows failed requests
2387
+ # to be retried without the risk of executing the operation twice.
2388
+ # @return [String]
2389
+ #
2390
+ # @!attribute [rw] creation_time
2391
+ # The date and time that the query logging configuration was created,
2392
+ # in Unix time format and Coordinated Universal Time (UTC).
2393
+ # @return [String]
2394
+ #
2395
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ResolverQueryLogConfig AWS API Documentation
2396
+ #
2397
+ class ResolverQueryLogConfig < Struct.new(
2398
+ :id,
2399
+ :owner_id,
2400
+ :status,
2401
+ :share_status,
2402
+ :association_count,
2403
+ :arn,
2404
+ :name,
2405
+ :destination_arn,
2406
+ :creator_request_id,
2407
+ :creation_time)
2408
+ SENSITIVE = []
2409
+ include Aws::Structure
2410
+ end
2411
+
2412
+ # In the response to an [AssociateResolverQueryLogConfig][1],
2413
+ # [DisassociateResolverQueryLogConfig][2],
2414
+ # [GetResolverQueryLogConfigAssociation][3], or
2415
+ # [ListResolverQueryLogConfigAssociations][4], request, a complex type
2416
+ # that contains settings for a specified association between an Amazon
2417
+ # VPC and a query logging configuration.
2418
+ #
2419
+ #
2420
+ #
2421
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_AssociateResolverQueryLogConfig.html
2422
+ # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_DisassociateResolverQueryLogConfig.html
2423
+ # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverQueryLogConfigAssociation.html
2424
+ # [4]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverQueryLogConfigAssociations.html
2425
+ #
2426
+ # @!attribute [rw] id
2427
+ # The ID of the query logging association.
2428
+ # @return [String]
2429
+ #
2430
+ # @!attribute [rw] resolver_query_log_config_id
2431
+ # The ID of the query logging configuration that a VPC is associated
2432
+ # with.
2433
+ # @return [String]
2434
+ #
2435
+ # @!attribute [rw] resource_id
2436
+ # The ID of the Amazon VPC that is associated with the query logging
2437
+ # configuration.
2438
+ # @return [String]
2439
+ #
2440
+ # @!attribute [rw] status
2441
+ # The status of the specified query logging association. Valid values
2442
+ # include the following:
2443
+ #
2444
+ # * `CREATING`\: Resolver is creating an association between an Amazon
2445
+ # VPC and a query logging configuration.
2446
+ #
2447
+ # * `CREATED`\: The association between an Amazon VPC and a query
2448
+ # logging configuration was successfully created. Resolver is
2449
+ # logging queries that originate in the specified VPC.
2450
+ #
2451
+ # * `DELETING`\: Resolver is deleting this query logging association.
2452
+ #
2453
+ # * `FAILED`\: Resolver either couldn't create or couldn't delete
2454
+ # the query logging association.
2455
+ # @return [String]
2456
+ #
2457
+ # @!attribute [rw] error
2458
+ # If the value of `Status` is `FAILED`, the value of `Error` indicates
2459
+ # the cause:
2460
+ #
2461
+ # * `DESTINATION_NOT_FOUND`\: The specified destination (for example,
2462
+ # an Amazon S3 bucket) was deleted.
2463
+ #
2464
+ # * `ACCESS_DENIED`\: Permissions don't allow sending logs to the
2465
+ # destination.
2466
+ #
2467
+ # If the value of `Status` is a value other than `FAILED`, `Error` is
2468
+ # null.
2469
+ # @return [String]
2470
+ #
2471
+ # @!attribute [rw] error_message
2472
+ # Contains additional information about the error. If the value or
2473
+ # `Error` is null, the value of `ErrorMessage` also is null.
2474
+ # @return [String]
2475
+ #
2476
+ # @!attribute [rw] creation_time
2477
+ # The date and time that the VPC was associated with the query logging
2478
+ # configuration, in Unix time format and Coordinated Universal Time
2479
+ # (UTC).
2480
+ # @return [String]
2481
+ #
2482
+ # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ResolverQueryLogConfigAssociation AWS API Documentation
2483
+ #
2484
+ class ResolverQueryLogConfigAssociation < Struct.new(
2485
+ :id,
2486
+ :resolver_query_log_config_id,
2487
+ :resource_id,
2488
+ :status,
2489
+ :error,
2490
+ :error_message,
2491
+ :creation_time)
2492
+ SENSITIVE = []
2493
+ include Aws::Structure
2494
+ end
2495
+
1301
2496
  # For queries that originate in your VPC, detailed information about a
1302
- # resolver rule, which specifies how to route DNS queries out of the
2497
+ # Resolver rule, which specifies how to route DNS queries out of the
1303
2498
  # VPC. The `ResolverRule` parameter appears in the response to a
1304
- # CreateResolverRule, DeleteResolverRule, GetResolverRule,
1305
- # ListResolverRules, or UpdateResolverRule request.
2499
+ # [CreateResolverRule][1], [DeleteResolverRule][2],
2500
+ # [GetResolverRule][3], [ListResolverRules][4], or
2501
+ # [UpdateResolverRule][5] request.
2502
+ #
2503
+ #
2504
+ #
2505
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_CreateResolverRule.html
2506
+ # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_DeleteResolverRule.html
2507
+ # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverRule.html
2508
+ # [4]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRules.html
2509
+ # [5]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_UpdateResolverRule.html
1306
2510
  #
1307
2511
  # @!attribute [rw] id
1308
- # The ID that Resolver assigned to the resolver rule when you created
2512
+ # The ID that Resolver assigned to the Resolver rule when you created
1309
2513
  # it.
1310
2514
  # @return [String]
1311
2515
  #
1312
2516
  # @!attribute [rw] creator_request_id
1313
- # A unique string that you specified when you created the resolver
1314
- # rule. `CreatorRequestId`identifies the request and allows failed
2517
+ # A unique string that you specified when you created the Resolver
2518
+ # rule. `CreatorRequestId` identifies the request and allows failed
1315
2519
  # requests to be retried without the risk of executing the operation
1316
2520
  # twice.
1317
2521
  # @return [String]
1318
2522
  #
1319
2523
  # @!attribute [rw] arn
1320
- # The ARN (Amazon Resource Name) for the resolver rule specified by
2524
+ # The ARN (Amazon Resource Name) for the Resolver rule specified by
1321
2525
  # `Id`.
1322
2526
  # @return [String]
1323
2527
  #
1324
2528
  # @!attribute [rw] domain_name
1325
2529
  # DNS queries for this domain name are forwarded to the IP addresses
1326
2530
  # that are specified in `TargetIps`. If a query matches multiple
1327
- # resolver rules (example.com and www.example.com), the query is
1328
- # routed using the resolver rule that contains the most specific
2531
+ # Resolver rules (example.com and www.example.com), the query is
2532
+ # routed using the Resolver rule that contains the most specific
1329
2533
  # domain name (www.example.com).
1330
2534
  # @return [String]
1331
2535
  #
1332
2536
  # @!attribute [rw] status
1333
- # A code that specifies the current status of the resolver rule.
2537
+ # A code that specifies the current status of the Resolver rule.
1334
2538
  # @return [String]
1335
2539
  #
1336
2540
  # @!attribute [rw] status_message
1337
- # A detailed description of the status of a resolver rule.
2541
+ # A detailed description of the status of a Resolver rule.
1338
2542
  # @return [String]
1339
2543
  #
1340
2544
  # @!attribute [rw] rule_type
1341
- # This value is always `FORWARD`. Other resolver rule types aren't
1342
- # supported.
2545
+ # When you want to forward DNS queries for specified domain name to
2546
+ # resolvers on your network, specify `FORWARD`.
2547
+ #
2548
+ # When you have a forwarding rule to forward DNS queries for a domain
2549
+ # to your network and you want Resolver to process queries for a
2550
+ # subdomain of that domain, specify `SYSTEM`.
2551
+ #
2552
+ # For example, to forward DNS queries for example.com to resolvers on
2553
+ # your network, you create a rule and specify `FORWARD` for
2554
+ # `RuleType`. To then have Resolver process queries for
2555
+ # apex.example.com, you create a rule and specify `SYSTEM` for
2556
+ # `RuleType`.
2557
+ #
2558
+ # Currently, only Resolver can create rules that have a value of
2559
+ # `RECURSIVE` for `RuleType`.
1343
2560
  # @return [String]
1344
2561
  #
1345
2562
  # @!attribute [rw] name
1346
- # The name for the resolver rule, which you specified when you created
1347
- # the resolver rule.
2563
+ # The name for the Resolver rule, which you specified when you created
2564
+ # the Resolver rule.
1348
2565
  # @return [String]
1349
2566
  #
1350
2567
  # @!attribute [rw] target_ips
1351
- # An array that contains the IP addresses and ports that you want to
1352
- # forward
2568
+ # An array that contains the IP addresses and ports that an outbound
2569
+ # endpoint forwards DNS queries to. Typically, these are the IP
2570
+ # addresses of DNS resolvers on your network. Specify IPv4 addresses.
2571
+ # IPv6 is not supported.
1353
2572
  # @return [Array<Types::TargetAddress>]
1354
2573
  #
1355
2574
  # @!attribute [rw] resolver_endpoint_id
@@ -1367,6 +2586,16 @@ module Aws::Route53Resolver
1367
2586
  # sharing the rule with the current account.
1368
2587
  # @return [String]
1369
2588
  #
2589
+ # @!attribute [rw] creation_time
2590
+ # The date and time that the Resolver rule was created, in Unix time
2591
+ # format and Coordinated Universal Time (UTC).
2592
+ # @return [String]
2593
+ #
2594
+ # @!attribute [rw] modification_time
2595
+ # The date and time that the Resolver rule was last updated, in Unix
2596
+ # time format and Coordinated Universal Time (UTC).
2597
+ # @return [String]
2598
+ #
1370
2599
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ResolverRule AWS API Documentation
1371
2600
  #
1372
2601
  class ResolverRule < Struct.new(
@@ -1381,42 +2610,56 @@ module Aws::Route53Resolver
1381
2610
  :target_ips,
1382
2611
  :resolver_endpoint_id,
1383
2612
  :owner_id,
1384
- :share_status)
2613
+ :share_status,
2614
+ :creation_time,
2615
+ :modification_time)
1385
2616
  SENSITIVE = []
1386
2617
  include Aws::Structure
1387
2618
  end
1388
2619
 
1389
- # In the response to an AssociateResolverRule, DisassociateResolverRule,
1390
- # or ListResolverRuleAssociations request, information about an
1391
- # association between a resolver rule and a VPC.
2620
+ # In the response to an [AssociateResolverRule][1],
2621
+ # [DisassociateResolverRule][2], or [ListResolverRuleAssociations][3]
2622
+ # request, provides information about an association between a Resolver
2623
+ # rule and a VPC. The association determines which DNS queries that
2624
+ # originate in the VPC are forwarded to your network.
2625
+ #
2626
+ #
2627
+ #
2628
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_AssociateResolverRule.html
2629
+ # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_DisassociateResolverRule.html
2630
+ # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRuleAssociations.html
1392
2631
  #
1393
2632
  # @!attribute [rw] id
1394
- # The ID of the association between a resolver rule and a VPC.
1395
- # Resolver assigns this value when you submit an AssociateResolverRule
1396
- # request.
2633
+ # The ID of the association between a Resolver rule and a VPC.
2634
+ # Resolver assigns this value when you submit an
2635
+ # [AssociateResolverRule][1] request.
2636
+ #
2637
+ #
2638
+ #
2639
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_AssociateResolverRule.html
1397
2640
  # @return [String]
1398
2641
  #
1399
2642
  # @!attribute [rw] resolver_rule_id
1400
- # The ID of the resolver rule that you associated with the VPC that is
2643
+ # The ID of the Resolver rule that you associated with the VPC that is
1401
2644
  # specified by `VPCId`.
1402
2645
  # @return [String]
1403
2646
  #
1404
2647
  # @!attribute [rw] name
1405
- # The name of an association between a resolver rule and a VPC.
2648
+ # The name of an association between a Resolver rule and a VPC.
1406
2649
  # @return [String]
1407
2650
  #
1408
2651
  # @!attribute [rw] vpc_id
1409
- # The ID of the VPC that you associated the resolver rule with.
2652
+ # The ID of the VPC that you associated the Resolver rule with.
1410
2653
  # @return [String]
1411
2654
  #
1412
2655
  # @!attribute [rw] status
1413
2656
  # A code that specifies the current status of the association between
1414
- # a resolver rule and a VPC.
2657
+ # a Resolver rule and a VPC.
1415
2658
  # @return [String]
1416
2659
  #
1417
2660
  # @!attribute [rw] status_message
1418
2661
  # A detailed description of the status of the association between a
1419
- # resolver rule and a VPC.
2662
+ # Resolver rule and a VPC.
1420
2663
  # @return [String]
1421
2664
  #
1422
2665
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/ResolverRuleAssociation AWS API Documentation
@@ -1432,8 +2675,12 @@ module Aws::Route53Resolver
1432
2675
  include Aws::Structure
1433
2676
  end
1434
2677
 
1435
- # In an UpdateResolverRule request, information about the changes that
1436
- # you want to make.
2678
+ # In an [UpdateResolverRule][1] request, information about the changes
2679
+ # that you want to make.
2680
+ #
2681
+ #
2682
+ #
2683
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_UpdateResolverRule.html
1437
2684
  #
1438
2685
  # @note When making an API call, you may pass ResolverRuleConfig
1439
2686
  # data as a hash:
@@ -1450,7 +2697,7 @@ module Aws::Route53Resolver
1450
2697
  # }
1451
2698
  #
1452
2699
  # @!attribute [rw] name
1453
- # The new name for the resolver rule. The name that you specify
2700
+ # The new name for the Resolver rule. The name that you specify
1454
2701
  # appears in the Resolver dashboard in the Route 53 console.
1455
2702
  # @return [String]
1456
2703
  #
@@ -1460,7 +2707,7 @@ module Aws::Route53Resolver
1460
2707
  # @return [Array<Types::TargetAddress>]
1461
2708
  #
1462
2709
  # @!attribute [rw] resolver_endpoint_id
1463
- # The ID of the new outbound resolver endpoint that you want to use to
2710
+ # The ID of the new outbound Resolver endpoint that you want to use to
1464
2711
  # route DNS queries to the IP addresses that you specify in
1465
2712
  # `TargetIps`.
1466
2713
  # @return [String]
@@ -1558,8 +2805,8 @@ module Aws::Route53Resolver
1558
2805
  # data as a hash:
1559
2806
  #
1560
2807
  # {
1561
- # key: "TagKey",
1562
- # value: "TagValue",
2808
+ # key: "TagKey", # required
2809
+ # value: "TagValue", # required
1563
2810
  # }
1564
2811
  #
1565
2812
  # @!attribute [rw] key
@@ -1590,8 +2837,8 @@ module Aws::Route53Resolver
1590
2837
  # resource_arn: "Arn", # required
1591
2838
  # tags: [ # required
1592
2839
  # {
1593
- # key: "TagKey",
1594
- # value: "TagValue",
2840
+ # key: "TagKey", # required
2841
+ # value: "TagValue", # required
1595
2842
  # },
1596
2843
  # ],
1597
2844
  # }
@@ -1601,17 +2848,26 @@ module Aws::Route53Resolver
1601
2848
  # tags to. To get the ARN for a resource, use the applicable `Get` or
1602
2849
  # `List` command:
1603
2850
  #
1604
- # * GetResolverEndpoint
2851
+ # * [GetResolverEndpoint][1]
2852
+ #
2853
+ # * [GetResolverRule][2]
1605
2854
  #
1606
- # * GetResolverRule
2855
+ # * [GetResolverRuleAssociation][3]
1607
2856
  #
1608
- # * GetResolverRuleAssociation
2857
+ # * [ListResolverEndpoints][4]
1609
2858
  #
1610
- # * ListResolverEndpoints
2859
+ # * [ListResolverRuleAssociations][5]
1611
2860
  #
1612
- # * ListResolverRuleAssociations
2861
+ # * [ListResolverRules][6]
1613
2862
  #
1614
- # * ListResolverRules
2863
+ #
2864
+ #
2865
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverEndpoint.html
2866
+ # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverRule.html
2867
+ # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverRuleAssociation.html
2868
+ # [4]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverEndpoints.html
2869
+ # [5]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRuleAssociations.html
2870
+ # [6]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRules.html
1615
2871
  # @return [String]
1616
2872
  #
1617
2873
  # @!attribute [rw] tags
@@ -1631,8 +2887,12 @@ module Aws::Route53Resolver
1631
2887
  #
1632
2888
  class TagResourceResponse < Aws::EmptyStructure; end
1633
2889
 
1634
- # In a CreateResolverRule request, an array of the IPs that you want to
1635
- # forward DNS queries to.
2890
+ # In a [CreateResolverRule][1] request, an array of the IPs that you
2891
+ # want to forward DNS queries to.
2892
+ #
2893
+ #
2894
+ #
2895
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_CreateResolverRule.html
1636
2896
  #
1637
2897
  # @note When making an API call, you may pass TargetAddress
1638
2898
  # data as a hash:
@@ -1699,17 +2959,26 @@ module Aws::Route53Resolver
1699
2959
  # remove tags from. To get the ARN for a resource, use the applicable
1700
2960
  # `Get` or `List` command:
1701
2961
  #
1702
- # * GetResolverEndpoint
2962
+ # * [GetResolverEndpoint][1]
2963
+ #
2964
+ # * [GetResolverRule][2]
2965
+ #
2966
+ # * [GetResolverRuleAssociation][3]
2967
+ #
2968
+ # * [ListResolverEndpoints][4]
1703
2969
  #
1704
- # * GetResolverRule
2970
+ # * [ListResolverRuleAssociations][5]
1705
2971
  #
1706
- # * GetResolverRuleAssociation
2972
+ # * [ListResolverRules][6]
1707
2973
  #
1708
- # * ListResolverEndpoints
1709
2974
  #
1710
- # * ListResolverRuleAssociations
1711
2975
  #
1712
- # * ListResolverRules
2976
+ # [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverEndpoint.html
2977
+ # [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverRule.html
2978
+ # [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_GetResolverRuleAssociation.html
2979
+ # [4]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverEndpoints.html
2980
+ # [5]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRuleAssociations.html
2981
+ # [6]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_ListResolverRules.html
1713
2982
  # @return [String]
1714
2983
  #
1715
2984
  # @!attribute [rw] tag_keys
@@ -1738,11 +3007,11 @@ module Aws::Route53Resolver
1738
3007
  # }
1739
3008
  #
1740
3009
  # @!attribute [rw] resolver_endpoint_id
1741
- # The ID of the resolver endpoint that you want to update.
3010
+ # The ID of the Resolver endpoint that you want to update.
1742
3011
  # @return [String]
1743
3012
  #
1744
3013
  # @!attribute [rw] name
1745
- # The name of the resolver endpoint that you want to update.
3014
+ # The name of the Resolver endpoint that you want to update.
1746
3015
  # @return [String]
1747
3016
  #
1748
3017
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/UpdateResolverEndpointRequest AWS API Documentation
@@ -1784,11 +3053,11 @@ module Aws::Route53Resolver
1784
3053
  # }
1785
3054
  #
1786
3055
  # @!attribute [rw] resolver_rule_id
1787
- # The ID of the resolver rule that you want to update.
3056
+ # The ID of the Resolver rule that you want to update.
1788
3057
  # @return [String]
1789
3058
  #
1790
3059
  # @!attribute [rw] config
1791
- # The new settings for the resolver rule.
3060
+ # The new settings for the Resolver rule.
1792
3061
  # @return [Types::ResolverRuleConfig]
1793
3062
  #
1794
3063
  # @see http://docs.aws.amazon.com/goto/WebAPI/route53resolver-2018-04-01/UpdateResolverRuleRequest AWS API Documentation