aws-sdk-servicediscovery 1.35.0 → 1.39.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6f73c3cba52718cd49187f0e517a50725823f9a5e93a4dc64ec8da5dc7bb1e7c
4
- data.tar.gz: 72a140daf32ced7dc254a7a10bd1ba72c1096d53b5783e5bf2318d28d0fda0dd
3
+ metadata.gz: 0ff1e6757f2b57e291824eb05948d9010ba5cb6cfe2291c232303f8892588dec
4
+ data.tar.gz: 5523eba77656bafbb1f1097b720603ad3c359173be93aeeb98c32156725e650b
5
5
  SHA512:
6
- metadata.gz: d153878e57f5dd403d3f053b910c12ab6e213cda290a6b9753fa1600678d49152046a1b4cf9344b171dfcaa7d23ec61efc63fca36dc8584b895c8289d9dc84f4
7
- data.tar.gz: 9d1c0375baaf29b0d084060f2080f59962ac05389f74e315fced821a95816e573f86ab8e0441b91f1e18391336b0b182b3fe24475a1ea9df40086bfe0e689dfa
6
+ metadata.gz: ef2bd62104b3354f9e78117a397790df821846766cd1d5c7aa788e5449eb10229710df2eec7289b0a43cc14a7cc2c629cb345903ed9ed006c7695ca6c77f3cd0
7
+ data.tar.gz: e781c3737079d304a388e5dc18e041125d072de7b1d21496d736c8d8c705f5385adc974ad446f373b2c4f0350377fb3aa07816ad3602c608d456ce50ea7e5d5a
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.39.0 (2021-07-30)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.38.0 (2021-07-28)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.37.0 (2021-06-30)
15
+ ------------------
16
+
17
+ * Feature - AWS Cloud Map now allows configuring the TTL of the SOA record for a hosted zone to control the negative caching for new services.
18
+
19
+ 1.36.0 (2021-06-01)
20
+ ------------------
21
+
22
+ * Feature - Bugfixes - The DiscoverInstances API operation now provides an option to return all instances for health-checked services when there are no healthy instances available.
23
+
4
24
  1.35.0 (2021-05-06)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.35.0
1
+ 1.39.0
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-servicediscovery/customizations'
48
48
  # @!group service
49
49
  module Aws::ServiceDiscovery
50
50
 
51
- GEM_VERSION = '1.35.0'
51
+ GEM_VERSION = '1.39.0'
52
52
 
53
53
  end
@@ -337,13 +337,13 @@ module Aws::ServiceDiscovery
337
337
 
338
338
  # @!group API Operations
339
339
 
340
- # Creates an HTTP namespace. Service instances that you register using
341
- # an HTTP namespace can be discovered using a `DiscoverInstances`
342
- # request but can't be discovered using DNS.
340
+ # Creates an HTTP namespace. Service instances registered using an HTTP
341
+ # namespace can be discovered using a `DiscoverInstances` request but
342
+ # can't be discovered using DNS.
343
343
  #
344
344
  # For the current quota on the number of namespaces that you can create
345
- # using the same AWS account, see [AWS Cloud Map quotas][1] in the *AWS
346
- # Cloud Map Developer Guide*.
345
+ # using the same account, see [Cloud Map quotas][1] in the *Cloud Map
346
+ # Developer Guide*.
347
347
  #
348
348
  #
349
349
  #
@@ -356,7 +356,7 @@ module Aws::ServiceDiscovery
356
356
  # A unique string that identifies the request and that allows failed
357
357
  # `CreateHttpNamespace` requests to be retried without the risk of
358
358
  # running the operation twice. `CreatorRequestId` can be any unique
359
- # string, for example, a date/time stamp.
359
+ # string (for example, a date/time stamp).
360
360
  #
361
361
  # **A suitable default value is auto-generated.** You should normally
362
362
  # not need to pass this option.**
@@ -420,9 +420,11 @@ module Aws::ServiceDiscovery
420
420
  # a specified Amazon VPC. The namespace defines your service naming
421
421
  # scheme. For example, if you name your namespace `example.com` and name
422
422
  # your service `backend`, the resulting DNS name for the service is
423
- # `backend.example.com`. For the current quota on the number of
424
- # namespaces that you can create using the same AWS account, see [AWS
425
- # Cloud Map Limits][1] in the *AWS Cloud Map Developer Guide*.
423
+ # `backend.example.com`. Service instances that are registered using a
424
+ # private DNS namespace can be discovered using either a
425
+ # `DiscoverInstances` request or using DNS. For the current quota on the
426
+ # number of namespaces that you can create using the same account, see
427
+ # [Cloud Map quotas][1] in the *Cloud Map Developer Guide*.
426
428
  #
427
429
  #
428
430
  #
@@ -430,14 +432,14 @@ module Aws::ServiceDiscovery
430
432
  #
431
433
  # @option params [required, String] :name
432
434
  # The name that you want to assign to this namespace. When you create a
433
- # private DNS namespace, AWS Cloud Map automatically creates an Amazon
434
- # Route 53 private hosted zone that has the same name as the namespace.
435
+ # private DNS namespace, Cloud Map automatically creates an Amazon Route
436
+ # 53 private hosted zone that has the same name as the namespace.
435
437
  #
436
438
  # @option params [String] :creator_request_id
437
439
  # A unique string that identifies the request and that allows failed
438
440
  # `CreatePrivateDnsNamespace` requests to be retried without the risk of
439
441
  # running the operation twice. `CreatorRequestId` can be any unique
440
- # string, for example, a date/timestamp.
442
+ # string (for example, a date/timestamp).
441
443
  #
442
444
  # **A suitable default value is auto-generated.** You should normally
443
445
  # not need to pass this option.**
@@ -454,6 +456,9 @@ module Aws::ServiceDiscovery
454
456
  # optional value that you define. Tags keys can be up to 128 characters
455
457
  # in length, and tag values can be up to 256 characters in length.
456
458
  #
459
+ # @option params [Types::PrivateDnsNamespaceProperties] :properties
460
+ # Properties for the private DNS namespace.
461
+ #
457
462
  # @return [Types::CreatePrivateDnsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
458
463
  #
459
464
  # * {Types::CreatePrivateDnsNamespaceResponse#operation_id #operation_id} => String
@@ -487,6 +492,13 @@ module Aws::ServiceDiscovery
487
492
  # value: "TagValue", # required
488
493
  # },
489
494
  # ],
495
+ # properties: {
496
+ # dns_properties: { # required
497
+ # soa: { # required
498
+ # ttl: 1, # required
499
+ # },
500
+ # },
501
+ # },
490
502
  # })
491
503
  #
492
504
  # @example Response structure
@@ -506,9 +518,11 @@ module Aws::ServiceDiscovery
506
518
  # internet. The namespace defines your service naming scheme. For
507
519
  # example, if you name your namespace `example.com` and name your
508
520
  # service `backend`, the resulting DNS name for the service is
509
- # `backend.example.com`. For the current quota on the number of
510
- # namespaces that you can create using the same AWS account, see [AWS
511
- # Cloud Map Limits][1] in the *AWS Cloud Map Developer Guide*.
521
+ # `backend.example.com`. You can discover instances that were registered
522
+ # with a public DNS namespace by using either a `DiscoverInstances`
523
+ # request or using DNS. For the current quota on the number of
524
+ # namespaces that you can create using the same account, see [Cloud Map
525
+ # quotas][1] in the *Cloud Map Developer Guide*.
512
526
  #
513
527
  #
514
528
  #
@@ -521,7 +535,7 @@ module Aws::ServiceDiscovery
521
535
  # A unique string that identifies the request and that allows failed
522
536
  # `CreatePublicDnsNamespace` requests to be retried without the risk of
523
537
  # running the operation twice. `CreatorRequestId` can be any unique
524
- # string, for example, a date/timestamp.
538
+ # string (for example, a date/timestamp).
525
539
  #
526
540
  # **A suitable default value is auto-generated.** You should normally
527
541
  # not need to pass this option.**
@@ -534,6 +548,9 @@ module Aws::ServiceDiscovery
534
548
  # optional value that you define. Tags keys can be up to 128 characters
535
549
  # in length, and tag values can be up to 256 characters in length.
536
550
  #
551
+ # @option params [Types::PublicDnsNamespaceProperties] :properties
552
+ # Properties for the public DNS namespace.
553
+ #
537
554
  # @return [Types::CreatePublicDnsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
538
555
  #
539
556
  # * {Types::CreatePublicDnsNamespaceResponse#operation_id #operation_id} => String
@@ -566,6 +583,13 @@ module Aws::ServiceDiscovery
566
583
  # value: "TagValue", # required
567
584
  # },
568
585
  # ],
586
+ # properties: {
587
+ # dns_properties: { # required
588
+ # soa: { # required
589
+ # ttl: 1, # required
590
+ # },
591
+ # },
592
+ # },
569
593
  # })
570
594
  #
571
595
  # @example Response structure
@@ -581,11 +605,11 @@ module Aws::ServiceDiscovery
581
605
  req.send_request(options)
582
606
  end
583
607
 
584
- # Creates a service, which defines the configuration for the following
585
- # entities:
608
+ # Creates a service. This action defines the configuration for the
609
+ # following entities:
586
610
  #
587
611
  # * For public and private DNS namespaces, one of the following
588
- # combinations of DNS records in Amazon Route 53:
612
+ # combinations of DNS records in Amazon Route 53:
589
613
  #
590
614
  # * `A`
591
615
  #
@@ -600,12 +624,12 @@ module Aws::ServiceDiscovery
600
624
  # * Optionally, a health check
601
625
  #
602
626
  # After you create the service, you can submit a [RegisterInstance][1]
603
- # request, and AWS Cloud Map uses the values in the configuration to
604
- # create the specified entities.
627
+ # request, and Cloud Map uses the values in the configuration to create
628
+ # the specified entities.
605
629
  #
606
630
  # For the current quota on the number of instances that you can register
607
- # using the same namespace and using the same service, see [AWS Cloud
608
- # Map Limits][2] in the *AWS Cloud Map Developer Guide*.
631
+ # using the same namespace and using the same service, see [Cloud Map
632
+ # quotas][2] in the *Cloud Map Developer Guide*.
609
633
  #
610
634
  #
611
635
  #
@@ -615,19 +639,19 @@ module Aws::ServiceDiscovery
615
639
  # @option params [required, String] :name
616
640
  # The name that you want to assign to the service.
617
641
  #
618
- # If you want AWS Cloud Map to create an `SRV` record when you register
619
- # an instance and you're using a system that requires a specific `SRV`
642
+ # If you want Cloud Map to create an `SRV` record when you register an
643
+ # instance and you're using a system that requires a specific `SRV`
620
644
  # format, such as [HAProxy][1], specify the following for `Name`\:
621
645
  #
622
646
  # * Start the name with an underscore (\_), such as `_exampleservice`.
623
647
  #
624
648
  # * End the name with *.\_protocol*, such as `._tcp`.
625
649
  #
626
- # When you register an instance, AWS Cloud Map creates an `SRV` record
627
- # and assigns a name to the record by concatenating the service name and
628
- # the namespace name, for example:
650
+ # When you register an instance, Cloud Map creates an `SRV` record and
651
+ # assigns a name to the record by concatenating the service name and the
652
+ # namespace name (for example,
629
653
  #
630
- # `_exampleservice._tcp.example.com`
654
+ # `_exampleservice._tcp.example.com`).
631
655
  #
632
656
  # <note markdown="1"> For services that are accessible by DNS queries, you can't create
633
657
  # multiple services with names that differ only by case (such as EXAMPLE
@@ -650,8 +674,8 @@ module Aws::ServiceDiscovery
650
674
  # @option params [String] :creator_request_id
651
675
  # A unique string that identifies the request and that allows failed
652
676
  # `CreateService` requests to be retried without the risk of running the
653
- # operation twice. `CreatorRequestId` can be any unique string, for
654
- # example, a date/timestamp.
677
+ # operation twice. `CreatorRequestId` can be any unique string (for
678
+ # example, a date/timestamp).
655
679
  #
656
680
  # **A suitable default value is auto-generated.** You should normally
657
681
  # not need to pass this option.**
@@ -660,21 +684,21 @@ module Aws::ServiceDiscovery
660
684
  # A description for the service.
661
685
  #
662
686
  # @option params [Types::DnsConfig] :dns_config
663
- # A complex type that contains information about the Amazon Route 53
664
- # records that you want AWS Cloud Map to create when you register an
687
+ # A complex type that contains information about the Amazon Route 53
688
+ # records that you want Cloud Map to create when you register an
665
689
  # instance.
666
690
  #
667
691
  # @option params [Types::HealthCheckConfig] :health_check_config
668
692
  # *Public DNS and HTTP namespaces only.* A complex type that contains
669
- # settings for an optional Route 53 health check. If you specify
670
- # settings for a health check, AWS Cloud Map associates the health check
671
- # with all the Route 53 DNS records that you specify in `DnsConfig`.
693
+ # settings for an optional Route 53 health check. If you specify
694
+ # settings for a health check, Cloud Map associates the health check
695
+ # with all the Route 53 DNS records that you specify in `DnsConfig`.
672
696
  #
673
697
  # If you specify a health check configuration, you can specify either
674
698
  # `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
675
699
  #
676
- # For information about the charges for health checks, see [AWS Cloud
677
- # Map Pricing][1].
700
+ # For information about the charges for health checks, see [Cloud Map
701
+ # Pricing][1].
678
702
  #
679
703
  #
680
704
  #
@@ -697,7 +721,7 @@ module Aws::ServiceDiscovery
697
721
  #
698
722
  # @option params [String] :type
699
723
  # If present, specifies that the service instances are only discoverable
700
- # using the `DiscoverInstances` API operation. No DNS records will be
724
+ # using the `DiscoverInstances` API operation. No DNS records is
701
725
  # registered for the service instances. The only valid value is `HTTP`.
702
726
  #
703
727
  # @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -890,8 +914,8 @@ module Aws::ServiceDiscovery
890
914
  req.send_request(options)
891
915
  end
892
916
 
893
- # Deletes the Amazon Route 53 DNS records and health check, if any, that
894
- # AWS Cloud Map created for the specified instance.
917
+ # Deletes the Amazon Route 53 DNS records and health check, if any, that
918
+ # Cloud Map created for the specified instance.
895
919
  #
896
920
  # @option params [required, String] :service_id
897
921
  # The ID of the service that the instance is associated with.
@@ -949,33 +973,53 @@ module Aws::ServiceDiscovery
949
973
  # queries to discover instances.
950
974
  #
951
975
  # @option params [required, String] :namespace_name
952
- # The `HttpName` name of the namespace, found in the `HttpProperties`
953
- # member of the `Properties` member of the namespace.
976
+ # The `HttpName` name of the namespace. It's found in the
977
+ # `HttpProperties` member of the `Properties` member of the namespace.
954
978
  #
955
979
  # @option params [required, String] :service_name
956
980
  # The name of the service that you specified when you registered the
957
981
  # instance.
958
982
  #
959
983
  # @option params [Integer] :max_results
960
- # The maximum number of instances that you want AWS Cloud Map to return
961
- # in the response to a `DiscoverInstances` request. If you don't
962
- # specify a value for `MaxResults`, AWS Cloud Map returns up to 100
963
- # instances.
984
+ # The maximum number of instances that you want Cloud Map to return in
985
+ # the response to a `DiscoverInstances` request. If you don't specify a
986
+ # value for `MaxResults`, Cloud Map returns up to 100 instances.
964
987
  #
965
988
  # @option params [Hash<String,String>] :query_parameters
966
989
  # Filters to scope the results based on custom attributes for the
967
- # instance. For example, `\{version=v1, az=1a\}`. Only instances that
990
+ # instance (for example, `\{version=v1, az=1a\}`). Only instances that
968
991
  # match all the specified key-value pairs are returned.
969
992
  #
970
993
  # @option params [Hash<String,String>] :optional_parameters
971
994
  # Opportunistic filters to scope the results based on custom attributes.
972
995
  # If there are instances that match both the filters specified in both
973
- # the `QueryParameters` parameter and this parameter, they are returned.
974
- # Otherwise, these filters are ignored and only instances that match the
975
- # filters specified in the `QueryParameters` parameter are returned.
996
+ # the `QueryParameters` parameter and this parameter, all of these
997
+ # instances are returned. Otherwise, the filters are ignored, and only
998
+ # instances that match the filters that are specified in the
999
+ # `QueryParameters` parameter are returned.
976
1000
  #
977
1001
  # @option params [String] :health_status
978
- # The health status of the instances that you want to discover.
1002
+ # The health status of the instances that you want to discover. This
1003
+ # parameter is ignored for services that don't have a health check
1004
+ # configured, and all instances are returned.
1005
+ #
1006
+ # HEALTHY
1007
+ #
1008
+ # : Returns healthy instances.
1009
+ #
1010
+ # UNHEALTHY
1011
+ #
1012
+ # : Returns unhealthy instances.
1013
+ #
1014
+ # ALL
1015
+ #
1016
+ # : Returns all instances.
1017
+ #
1018
+ # HEALTHY\_OR\_ELSE\_ALL
1019
+ #
1020
+ # : Returns healthy instances, unless none are reporting a healthy
1021
+ # state. In that case, return all instances. This is also called
1022
+ # failing open.
979
1023
  #
980
1024
  # @return [Types::DiscoverInstancesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
981
1025
  #
@@ -1021,7 +1065,7 @@ module Aws::ServiceDiscovery
1021
1065
  # optional_parameters: {
1022
1066
  # "AttrKey" => "AttrValue",
1023
1067
  # },
1024
- # health_status: "HEALTHY", # accepts HEALTHY, UNHEALTHY, ALL
1068
+ # health_status: "HEALTHY", # accepts HEALTHY, UNHEALTHY, ALL, HEALTHY_OR_ELSE_ALL
1025
1069
  # })
1026
1070
  #
1027
1071
  # @example Response structure
@@ -1105,7 +1149,7 @@ module Aws::ServiceDiscovery
1105
1149
  # Gets the current health status (`Healthy`, `Unhealthy`, or `Unknown`)
1106
1150
  # of one or more instances that are associated with a specified service.
1107
1151
  #
1108
- # <note markdown="1"> There is a brief delay between when you register an instance and when
1152
+ # <note markdown="1"> There's a brief delay between when you register an instance and when
1109
1153
  # the health status for the instance is available.
1110
1154
  #
1111
1155
  # </note>
@@ -1117,8 +1161,8 @@ module Aws::ServiceDiscovery
1117
1161
  # An array that contains the IDs of all the instances that you want to
1118
1162
  # get the health status for.
1119
1163
  #
1120
- # If you omit `Instances`, AWS Cloud Map returns the health status for
1121
- # all the instances that are associated with the specified service.
1164
+ # If you omit `Instances`, Cloud Map returns the health status for all
1165
+ # the instances that are associated with the specified service.
1122
1166
  #
1123
1167
  # <note markdown="1"> To get the IDs for the instances that you've registered by using a
1124
1168
  # specified service, submit a [ListInstances][1] request.
@@ -1130,9 +1174,9 @@ module Aws::ServiceDiscovery
1130
1174
  # [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_ListInstances.html
1131
1175
  #
1132
1176
  # @option params [Integer] :max_results
1133
- # The maximum number of instances that you want AWS Cloud Map to return
1134
- # in the response to a `GetInstancesHealthStatus` request. If you don't
1135
- # specify a value for `MaxResults`, AWS Cloud Map returns up to 100
1177
+ # The maximum number of instances that you want Cloud Map to return in
1178
+ # the response to a `GetInstancesHealthStatus` request. If you don't
1179
+ # specify a value for `MaxResults`, Cloud Map returns up to 100
1136
1180
  # instances.
1137
1181
  #
1138
1182
  # @option params [String] :next_token
@@ -1244,6 +1288,7 @@ module Aws::ServiceDiscovery
1244
1288
  # resp.namespace.description #=> String
1245
1289
  # resp.namespace.service_count #=> Integer
1246
1290
  # resp.namespace.properties.dns_properties.hosted_zone_id #=> String
1291
+ # resp.namespace.properties.dns_properties.soa.ttl #=> Integer
1247
1292
  # resp.namespace.properties.http_properties.http_name #=> String
1248
1293
  # resp.namespace.create_date #=> Time
1249
1294
  # resp.namespace.creator_request_id #=> String
@@ -1308,7 +1353,7 @@ module Aws::ServiceDiscovery
1308
1353
  # @example Response structure
1309
1354
  #
1310
1355
  # resp.operation.id #=> String
1311
- # resp.operation.type #=> String, one of "CREATE_NAMESPACE", "DELETE_NAMESPACE", "UPDATE_SERVICE", "REGISTER_INSTANCE", "DEREGISTER_INSTANCE"
1356
+ # resp.operation.type #=> String, one of "CREATE_NAMESPACE", "DELETE_NAMESPACE", "UPDATE_NAMESPACE", "UPDATE_SERVICE", "REGISTER_INSTANCE", "DEREGISTER_INSTANCE"
1312
1357
  # resp.operation.status #=> String, one of "SUBMITTED", "PENDING", "SUCCESS", "FAIL"
1313
1358
  # resp.operation.error_message #=> String
1314
1359
  # resp.operation.error_code #=> String
@@ -1413,9 +1458,9 @@ module Aws::ServiceDiscovery
1413
1458
  # in the next request.
1414
1459
  #
1415
1460
  # @option params [Integer] :max_results
1416
- # The maximum number of instances that you want AWS Cloud Map to return
1417
- # in the response to a `ListInstances` request. If you don't specify a
1418
- # value for `MaxResults`, AWS Cloud Map returns up to 100 instances.
1461
+ # The maximum number of instances that you want Cloud Map to return in
1462
+ # the response to a `ListInstances` request. If you don't specify a
1463
+ # value for `MaxResults`, Cloud Map returns up to 100 instances.
1419
1464
  #
1420
1465
  # @return [Types::ListInstancesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1421
1466
  #
@@ -1472,7 +1517,7 @@ module Aws::ServiceDiscovery
1472
1517
  end
1473
1518
 
1474
1519
  # Lists summary information about the namespaces that were created by
1475
- # the current AWS account.
1520
+ # the current account.
1476
1521
  #
1477
1522
  # @option params [String] :next_token
1478
1523
  # For the first `ListNamespaces` request, omit this value.
@@ -1481,18 +1526,18 @@ module Aws::ServiceDiscovery
1481
1526
  # request to get the next group of results. Specify the value of
1482
1527
  # `NextToken` from the previous response in the next request.
1483
1528
  #
1484
- # <note markdown="1"> AWS Cloud Map gets `MaxResults` namespaces and then filters them based
1485
- # on the specified criteria. It's possible that no namespaces in the
1486
- # first `MaxResults` namespaces matched the specified criteria but that
1529
+ # <note markdown="1"> Cloud Map gets `MaxResults` namespaces and then filters them based on
1530
+ # the specified criteria. It's possible that no namespaces in the first
1531
+ # `MaxResults` namespaces matched the specified criteria but that
1487
1532
  # subsequent groups of `MaxResults` namespaces do contain namespaces
1488
1533
  # that match the criteria.
1489
1534
  #
1490
1535
  # </note>
1491
1536
  #
1492
1537
  # @option params [Integer] :max_results
1493
- # The maximum number of namespaces that you want AWS Cloud Map to return
1494
- # in the response to a `ListNamespaces` request. If you don't specify a
1495
- # value for `MaxResults`, AWS Cloud Map returns up to 100 namespaces.
1538
+ # The maximum number of namespaces that you want Cloud Map to return in
1539
+ # the response to a `ListNamespaces` request. If you don't specify a
1540
+ # value for `MaxResults`, Cloud Map returns up to 100 namespaces.
1496
1541
  #
1497
1542
  # @option params [Array<Types::NamespaceFilter>] :filters
1498
1543
  # A complex type that contains specifications for the namespaces that
@@ -1591,6 +1636,7 @@ module Aws::ServiceDiscovery
1591
1636
  # resp.namespaces[0].description #=> String
1592
1637
  # resp.namespaces[0].service_count #=> Integer
1593
1638
  # resp.namespaces[0].properties.dns_properties.hosted_zone_id #=> String
1639
+ # resp.namespaces[0].properties.dns_properties.soa.ttl #=> Integer
1594
1640
  # resp.namespaces[0].properties.http_properties.http_name #=> String
1595
1641
  # resp.namespaces[0].create_date #=> Time
1596
1642
  # resp.next_token #=> String
@@ -1613,18 +1659,18 @@ module Aws::ServiceDiscovery
1613
1659
  # request to get the next group of results. Specify the value of
1614
1660
  # `NextToken` from the previous response in the next request.
1615
1661
  #
1616
- # <note markdown="1"> AWS Cloud Map gets `MaxResults` operations and then filters them based
1617
- # on the specified criteria. It's possible that no operations in the
1618
- # first `MaxResults` operations matched the specified criteria but that
1662
+ # <note markdown="1"> Cloud Map gets `MaxResults` operations and then filters them based on
1663
+ # the specified criteria. It's possible that no operations in the first
1664
+ # `MaxResults` operations matched the specified criteria but that
1619
1665
  # subsequent groups of `MaxResults` operations do contain operations
1620
1666
  # that match the criteria.
1621
1667
  #
1622
1668
  # </note>
1623
1669
  #
1624
1670
  # @option params [Integer] :max_results
1625
- # The maximum number of items that you want AWS Cloud Map to return in
1626
- # the response to a `ListOperations` request. If you don't specify a
1627
- # value for `MaxResults`, AWS Cloud Map returns up to 100 operations.
1671
+ # The maximum number of items that you want Cloud Map to return in the
1672
+ # response to a `ListOperations` request. If you don't specify a value
1673
+ # for `MaxResults`, Cloud Map returns up to 100 operations.
1628
1674
  #
1629
1675
  # @option params [Array<Types::OperationFilter>] :filters
1630
1676
  # A complex type that contains specifications for the operations that
@@ -1717,18 +1763,18 @@ module Aws::ServiceDiscovery
1717
1763
  # request to get the next group of results. Specify the value of
1718
1764
  # `NextToken` from the previous response in the next request.
1719
1765
  #
1720
- # <note markdown="1"> AWS Cloud Map gets `MaxResults` services and then filters them based
1721
- # on the specified criteria. It's possible that no services in the
1722
- # first `MaxResults` services matched the specified criteria but that
1766
+ # <note markdown="1"> Cloud Map gets `MaxResults` services and then filters them based on
1767
+ # the specified criteria. It's possible that no services in the first
1768
+ # `MaxResults` services matched the specified criteria but that
1723
1769
  # subsequent groups of `MaxResults` services do contain services that
1724
1770
  # match the criteria.
1725
1771
  #
1726
1772
  # </note>
1727
1773
  #
1728
1774
  # @option params [Integer] :max_results
1729
- # The maximum number of services that you want AWS Cloud Map to return
1730
- # in the response to a `ListServices` request. If you don't specify a
1731
- # value for `MaxResults`, AWS Cloud Map returns up to 100 services.
1775
+ # The maximum number of services that you want Cloud Map to return in
1776
+ # the response to a `ListServices` request. If you don't specify a
1777
+ # value for `MaxResults`, Cloud Map returns up to 100 services.
1732
1778
  #
1733
1779
  # @option params [Array<Types::ServiceFilter>] :filters
1734
1780
  # A complex type that contains specifications for the namespaces that
@@ -1875,9 +1921,9 @@ module Aws::ServiceDiscovery
1875
1921
  # health check based on the settings in a specified service. When you
1876
1922
  # submit a `RegisterInstance` request, the following occurs:
1877
1923
  #
1878
- # * For each DNS record that you define in the service that is specified
1924
+ # * For each DNS record that you define in the service that's specified
1879
1925
  # by `ServiceId`, a record is created or updated in the hosted zone
1880
- # that is associated with the corresponding namespace.
1926
+ # that's associated with the corresponding namespace.
1881
1927
  #
1882
1928
  # * If the service includes `HealthCheckConfig`, a health check is
1883
1929
  # created based on the settings in the health check configuration.
@@ -1890,7 +1936,7 @@ module Aws::ServiceDiscovery
1890
1936
  #
1891
1937
  # For more information, see [CreateService][1].
1892
1938
  #
1893
- # When AWS Cloud Map receives a DNS query for the specified DNS name, it
1939
+ # When Cloud Map receives a DNS query for the specified DNS name, it
1894
1940
  # returns the applicable value:
1895
1941
  #
1896
1942
  # * **If the health check is healthy**\: returns all the records
@@ -1902,8 +1948,8 @@ module Aws::ServiceDiscovery
1902
1948
  # all the records
1903
1949
  #
1904
1950
  # For the current quota on the number of instances that you can register
1905
- # using the same namespace and using the same service, see [AWS Cloud
1906
- # Map Limits][2] in the *AWS Cloud Map Developer Guide*.
1951
+ # using the same namespace and using the same service, see [Cloud Map
1952
+ # quotas][2] in the *Cloud Map Developer Guide*.
1907
1953
  #
1908
1954
  #
1909
1955
  #
@@ -1918,20 +1964,20 @@ module Aws::ServiceDiscovery
1918
1964
  # An identifier that you want to associate with the instance. Note the
1919
1965
  # following:
1920
1966
  #
1921
- # * If the service that is specified by `ServiceId` includes settings
1967
+ # * If the service that's specified by `ServiceId` includes settings
1922
1968
  # for an `SRV` record, the value of `InstanceId` is automatically
1923
1969
  # included as part of the value for the `SRV` record. For more
1924
1970
  # information, see [DnsRecord &gt; Type][1].
1925
1971
  #
1926
1972
  # * You can use this value to update an existing instance.
1927
1973
  #
1928
- # * To register a new instance, you must specify a value that is unique
1974
+ # * To register a new instance, you must specify a value that's unique
1929
1975
  # among instances that you register by using the same service.
1930
1976
  #
1931
- # * If you specify an existing `InstanceId` and `ServiceId`, AWS Cloud
1932
- # Map updates the existing DNS records, if any. If there's also an
1933
- # existing health check, AWS Cloud Map deletes the old health check
1934
- # and creates a new one.
1977
+ # * If you specify an existing `InstanceId` and `ServiceId`, Cloud Map
1978
+ # updates the existing DNS records, if any. If there's also an
1979
+ # existing health check, Cloud Map deletes the old health check and
1980
+ # creates a new one.
1935
1981
  #
1936
1982
  # <note markdown="1"> The health check isn't deleted immediately, so it will still appear
1937
1983
  # for a while if you submit a `ListHealthChecks` request, for example.
@@ -1948,8 +1994,8 @@ module Aws::ServiceDiscovery
1948
1994
  # executing the operation twice. You must use a unique
1949
1995
  # `CreatorRequestId` string every time you submit a `RegisterInstance`
1950
1996
  # request if you're registering additional instances for the same
1951
- # namespace and service. `CreatorRequestId` can be any unique string,
1952
- # for example, a date/time stamp.
1997
+ # namespace and service. `CreatorRequestId` can be any unique string
1998
+ # (for example, a date/time stamp).
1953
1999
  #
1954
2000
  # **A suitable default value is auto-generated.** You should normally
1955
2001
  # not need to pass this option.**
@@ -1967,29 +2013,29 @@ module Aws::ServiceDiscovery
1967
2013
  #
1968
2014
  # AWS\_ALIAS\_DNS\_NAME
1969
2015
  #
1970
- # : If you want AWS Cloud Map to create an Amazon Route 53 alias record
1971
- # that routes traffic to an Elastic Load Balancing load balancer,
1972
- # specify the DNS name that is associated with the load balancer. For
2016
+ # : If you want Cloud Map to create an Amazon Route 53 alias record that
2017
+ # routes traffic to an Elastic Load Balancing load balancer, specify
2018
+ # the DNS name that's associated with the load balancer. For
1973
2019
  # information about how to get the DNS name, see "DNSName" in the
1974
- # topic [AliasTarget][1] in the *Route 53 API Reference*.
2020
+ # topic [AliasTarget][1] in the *Route 53 API Reference*.
1975
2021
  #
1976
2022
  # Note the following:
1977
2023
  #
1978
- # * The configuration for the service that is specified by `ServiceId`
2024
+ # * The configuration for the service that's specified by `ServiceId`
1979
2025
  # must include settings for an `A` record, an `AAAA` record, or
1980
2026
  # both.
1981
2027
  #
1982
- # * In the service that is specified by `ServiceId`, the value of
2028
+ # * In the service that's specified by `ServiceId`, the value of
1983
2029
  # `RoutingPolicy` must be `WEIGHTED`.
1984
2030
  #
1985
- # * If the service that is specified by `ServiceId` includes
1986
- # `HealthCheckConfig` settings, AWS Cloud Map will create the
1987
- # Route 53 health check, but it doesn't associate the health check
1988
- # with the alias record.
2031
+ # * If the service that's specified by `ServiceId` includes
2032
+ # `HealthCheckConfig` settings, Cloud Map will create the Route 53
2033
+ # health check, but it doesn't associate the health check with the
2034
+ # alias record.
1989
2035
  #
1990
2036
  # * Auto naming currently doesn't support creating alias records that
1991
- # route traffic to AWS resources other than Elastic Load Balancing
1992
- # load balancers.
2037
+ # route traffic to Amazon Web Services resources other than Elastic
2038
+ # Load Balancing load balancers.
1993
2039
  #
1994
2040
  # * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
1995
2041
  # values for any of the `AWS_INSTANCE` attributes.
@@ -2014,8 +2060,8 @@ module Aws::ServiceDiscovery
2014
2060
  # AWS\_INSTANCE\_CNAME
2015
2061
  #
2016
2062
  # : If the service configuration includes a `CNAME` record, the domain
2017
- # name that you want Route 53 to return in response to DNS queries,
2018
- # for example, `example.com`.
2063
+ # name that you want Route 53 to return in response to DNS queries
2064
+ # (for example, `example.com`).
2019
2065
  #
2020
2066
  # This value is required if the service specified by `ServiceId`
2021
2067
  # includes settings for an `CNAME` record.
@@ -2023,8 +2069,8 @@ module Aws::ServiceDiscovery
2023
2069
  # AWS\_INSTANCE\_IPV4
2024
2070
  #
2025
2071
  # : If the service configuration includes an `A` record, the IPv4
2026
- # address that you want Route 53 to return in response to DNS queries,
2027
- # for example, `192.0.2.44`.
2072
+ # address that you want Route 53 to return in response to DNS queries
2073
+ # (for example, `192.0.2.44`).
2028
2074
  #
2029
2075
  # This value is required if the service specified by `ServiceId`
2030
2076
  # includes settings for an `A` record. If the service includes
@@ -2034,8 +2080,8 @@ module Aws::ServiceDiscovery
2034
2080
  # AWS\_INSTANCE\_IPV6
2035
2081
  #
2036
2082
  # : If the service configuration includes an `AAAA` record, the IPv6
2037
- # address that you want Route 53 to return in response to DNS queries,
2038
- # for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
2083
+ # address that you want Route 53 to return in response to DNS queries
2084
+ # (for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`).
2039
2085
  #
2040
2086
  # This value is required if the service specified by `ServiceId`
2041
2087
  # includes settings for an `AAAA` record. If the service includes
@@ -2045,13 +2091,13 @@ module Aws::ServiceDiscovery
2045
2091
  # AWS\_INSTANCE\_PORT
2046
2092
  #
2047
2093
  # : If the service includes an `SRV` record, the value that you want
2048
- # Route 53 to return for the port.
2094
+ # Route 53 to return for the port.
2049
2095
  #
2050
2096
  # If the service includes `HealthCheckConfig`, the port on the
2051
- # endpoint that you want Route 53 to send requests to.
2097
+ # endpoint that you want Route 53 to send requests to.
2052
2098
  #
2053
2099
  # This value is required if you specified settings for an `SRV` record
2054
- # or a Route 53 health check when you created the service.
2100
+ # or a Route 53 health check when you created the service.
2055
2101
  #
2056
2102
  # Custom attributes
2057
2103
  #
@@ -2214,13 +2260,57 @@ module Aws::ServiceDiscovery
2214
2260
  req.send_request(options)
2215
2261
  end
2216
2262
 
2263
+ # Updates an HTTP namespace.
2264
+ #
2265
+ # @option params [required, String] :id
2266
+ # The ID of the namespace that you want to update.
2267
+ #
2268
+ # @option params [String] :updater_request_id
2269
+ # A unique string that identifies the request and that allows failed
2270
+ # `UpdateHttpNamespace` requests to be retried without the risk of
2271
+ # running the operation twice. `UpdaterRequestId` can be any unique
2272
+ # string (for example, a date/timestamp).
2273
+ #
2274
+ # **A suitable default value is auto-generated.** You should normally
2275
+ # not need to pass this option.**
2276
+ #
2277
+ # @option params [required, Types::HttpNamespaceChange] :namespace
2278
+ # Updated properties for the the HTTP namespace.
2279
+ #
2280
+ # @return [Types::UpdateHttpNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2281
+ #
2282
+ # * {Types::UpdateHttpNamespaceResponse#operation_id #operation_id} => String
2283
+ #
2284
+ # @example Request syntax with placeholder values
2285
+ #
2286
+ # resp = client.update_http_namespace({
2287
+ # id: "ResourceId", # required
2288
+ # updater_request_id: "ResourceId",
2289
+ # namespace: { # required
2290
+ # description: "ResourceDescription", # required
2291
+ # },
2292
+ # })
2293
+ #
2294
+ # @example Response structure
2295
+ #
2296
+ # resp.operation_id #=> String
2297
+ #
2298
+ # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/UpdateHttpNamespace AWS API Documentation
2299
+ #
2300
+ # @overload update_http_namespace(params = {})
2301
+ # @param [Hash] params ({})
2302
+ def update_http_namespace(params = {}, options = {})
2303
+ req = build_request(:update_http_namespace, params)
2304
+ req.send_request(options)
2305
+ end
2306
+
2217
2307
  # Submits a request to change the health status of a custom health check
2218
2308
  # to healthy or unhealthy.
2219
2309
  #
2220
2310
  # You can use `UpdateInstanceCustomHealthStatus` to change the status
2221
2311
  # only for custom health checks, which you define using
2222
2312
  # `HealthCheckCustomConfig` when you create a service. You can't use it
2223
- # to change the status for Route 53 health checks, which you define
2313
+ # to change the status for Route 53 health checks, which you define
2224
2314
  # using `HealthCheckConfig`.
2225
2315
  #
2226
2316
  # For more information, see [HealthCheckCustomConfig][1].
@@ -2270,6 +2360,108 @@ module Aws::ServiceDiscovery
2270
2360
  req.send_request(options)
2271
2361
  end
2272
2362
 
2363
+ # Updates a private DNS namespace.
2364
+ #
2365
+ # @option params [required, String] :id
2366
+ # The ID of the namespace that you want to update.
2367
+ #
2368
+ # @option params [String] :updater_request_id
2369
+ # A unique string that identifies the request and that allows failed
2370
+ # `UpdatePrivateDnsNamespace` requests to be retried without the risk of
2371
+ # running the operation twice. `UpdaterRequestId` can be any unique
2372
+ # string (for example, a date/timestamp).
2373
+ #
2374
+ # **A suitable default value is auto-generated.** You should normally
2375
+ # not need to pass this option.**
2376
+ #
2377
+ # @option params [required, Types::PrivateDnsNamespaceChange] :namespace
2378
+ # Updated properties for the private DNS namespace.
2379
+ #
2380
+ # @return [Types::UpdatePrivateDnsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2381
+ #
2382
+ # * {Types::UpdatePrivateDnsNamespaceResponse#operation_id #operation_id} => String
2383
+ #
2384
+ # @example Request syntax with placeholder values
2385
+ #
2386
+ # resp = client.update_private_dns_namespace({
2387
+ # id: "ResourceId", # required
2388
+ # updater_request_id: "ResourceId",
2389
+ # namespace: { # required
2390
+ # description: "ResourceDescription",
2391
+ # properties: {
2392
+ # dns_properties: { # required
2393
+ # soa: { # required
2394
+ # ttl: 1, # required
2395
+ # },
2396
+ # },
2397
+ # },
2398
+ # },
2399
+ # })
2400
+ #
2401
+ # @example Response structure
2402
+ #
2403
+ # resp.operation_id #=> String
2404
+ #
2405
+ # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/UpdatePrivateDnsNamespace AWS API Documentation
2406
+ #
2407
+ # @overload update_private_dns_namespace(params = {})
2408
+ # @param [Hash] params ({})
2409
+ def update_private_dns_namespace(params = {}, options = {})
2410
+ req = build_request(:update_private_dns_namespace, params)
2411
+ req.send_request(options)
2412
+ end
2413
+
2414
+ # Updates a public DNS namespace.
2415
+ #
2416
+ # @option params [required, String] :id
2417
+ # The ID of the namespace being updated.
2418
+ #
2419
+ # @option params [String] :updater_request_id
2420
+ # A unique string that identifies the request and that allows failed
2421
+ # `UpdatePublicDnsNamespace` requests to be retried without the risk of
2422
+ # running the operation twice. `UpdaterRequestId` can be any unique
2423
+ # string (for example, a date/timestamp).
2424
+ #
2425
+ # **A suitable default value is auto-generated.** You should normally
2426
+ # not need to pass this option.**
2427
+ #
2428
+ # @option params [required, Types::PublicDnsNamespaceChange] :namespace
2429
+ # Updated properties for the public DNS namespace.
2430
+ #
2431
+ # @return [Types::UpdatePublicDnsNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2432
+ #
2433
+ # * {Types::UpdatePublicDnsNamespaceResponse#operation_id #operation_id} => String
2434
+ #
2435
+ # @example Request syntax with placeholder values
2436
+ #
2437
+ # resp = client.update_public_dns_namespace({
2438
+ # id: "ResourceId", # required
2439
+ # updater_request_id: "ResourceId",
2440
+ # namespace: { # required
2441
+ # description: "ResourceDescription",
2442
+ # properties: {
2443
+ # dns_properties: { # required
2444
+ # soa: { # required
2445
+ # ttl: 1, # required
2446
+ # },
2447
+ # },
2448
+ # },
2449
+ # },
2450
+ # })
2451
+ #
2452
+ # @example Response structure
2453
+ #
2454
+ # resp.operation_id #=> String
2455
+ #
2456
+ # @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/UpdatePublicDnsNamespace AWS API Documentation
2457
+ #
2458
+ # @overload update_public_dns_namespace(params = {})
2459
+ # @param [Hash] params ({})
2460
+ def update_public_dns_namespace(params = {}, options = {})
2461
+ req = build_request(:update_public_dns_namespace, params)
2462
+ req.send_request(options)
2463
+ end
2464
+
2273
2465
  # Submits a request to perform the following operations:
2274
2466
  #
2275
2467
  # * Update the TTL setting for existing `DnsRecords` configurations
@@ -2291,7 +2483,7 @@ module Aws::ServiceDiscovery
2291
2483
  # an `UpdateService` request, the configuration isn't deleted from
2292
2484
  # the service.
2293
2485
  #
2294
- # When you update settings for a service, AWS Cloud Map also updates the
2486
+ # When you update settings for a service, Cloud Map also updates the
2295
2487
  # corresponding settings in all the records and health checks that were
2296
2488
  # created by using the specified service.
2297
2489
  #
@@ -2382,7 +2574,7 @@ module Aws::ServiceDiscovery
2382
2574
  params: params,
2383
2575
  config: config)
2384
2576
  context[:gem_name] = 'aws-sdk-servicediscovery'
2385
- context[:gem_version] = '1.35.0'
2577
+ context[:gem_version] = '1.39.0'
2386
2578
  Seahorse::Client::Request.new(handlers, context)
2387
2579
  end
2388
2580