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 +4 -4
- data/CHANGELOG.md +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-servicediscovery.rb +1 -1
- data/lib/aws-sdk-servicediscovery/client.rb +311 -119
- data/lib/aws-sdk-servicediscovery/client_api.rb +123 -0
- data/lib/aws-sdk-servicediscovery/types.rb +860 -314
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 0ff1e6757f2b57e291824eb05948d9010ba5cb6cfe2291c232303f8892588dec
|
4
|
+
data.tar.gz: 5523eba77656bafbb1f1097b720603ad3c359173be93aeeb98c32156725e650b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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.
|
1
|
+
1.39.0
|
@@ -337,13 +337,13 @@ module Aws::ServiceDiscovery
|
|
337
337
|
|
338
338
|
# @!group API Operations
|
339
339
|
|
340
|
-
# Creates an HTTP namespace. Service instances
|
341
|
-
#
|
342
|
-
#
|
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
|
346
|
-
#
|
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
|
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`.
|
424
|
-
#
|
425
|
-
#
|
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,
|
434
|
-
#
|
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
|
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`.
|
510
|
-
#
|
511
|
-
#
|
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
|
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
|
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
|
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
|
604
|
-
#
|
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 [
|
608
|
-
#
|
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
|
619
|
-
#
|
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,
|
627
|
-
#
|
628
|
-
#
|
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
|
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
|
664
|
-
# records that you want
|
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
|
670
|
-
# settings for a health check,
|
671
|
-
# with all the Route
|
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 [
|
677
|
-
#
|
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
|
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
|
894
|
-
#
|
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
|
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
|
961
|
-
#
|
962
|
-
#
|
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
|
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,
|
974
|
-
# Otherwise,
|
975
|
-
#
|
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
|
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`,
|
1121
|
-
#
|
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
|
1134
|
-
#
|
1135
|
-
# specify a value for `MaxResults`,
|
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
|
1417
|
-
#
|
1418
|
-
# value for `MaxResults`,
|
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
|
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">
|
1485
|
-
#
|
1486
|
-
#
|
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
|
1494
|
-
#
|
1495
|
-
# value for `MaxResults`,
|
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">
|
1617
|
-
#
|
1618
|
-
#
|
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
|
1626
|
-
#
|
1627
|
-
#
|
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">
|
1721
|
-
#
|
1722
|
-
#
|
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
|
1730
|
-
#
|
1731
|
-
# value for `MaxResults`,
|
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
|
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
|
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
|
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 [
|
1906
|
-
#
|
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
|
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 > 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
|
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`,
|
1932
|
-
#
|
1933
|
-
# existing health check,
|
1934
|
-
#
|
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
|
1971
|
-
#
|
1972
|
-
#
|
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
|
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
|
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
|
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
|
1986
|
-
# `HealthCheckConfig` settings,
|
1987
|
-
#
|
1988
|
-
#
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
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,
|
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.
|
2577
|
+
context[:gem_version] = '1.39.0'
|
2386
2578
|
Seahorse::Client::Request.new(handlers, context)
|
2387
2579
|
end
|
2388
2580
|
|