aws-sdk-servicediscovery 1.30.0 → 1.35.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +188 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-servicediscovery.rb +2 -2
- data/lib/aws-sdk-servicediscovery/client.rb +140 -114
- data/lib/aws-sdk-servicediscovery/client_api.rb +17 -7
- data/lib/aws-sdk-servicediscovery/errors.rb +1 -1
- data/lib/aws-sdk-servicediscovery/resource.rb +1 -1
- data/lib/aws-sdk-servicediscovery/types.rb +501 -538
- metadata +11 -9
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -69,6 +69,7 @@ module Aws::ServiceDiscovery
|
|
69
69
|
HttpProperties = Shapes::StructureShape.new(name: 'HttpProperties')
|
70
70
|
Instance = Shapes::StructureShape.new(name: 'Instance')
|
71
71
|
InstanceHealthStatusMap = Shapes::MapShape.new(name: 'InstanceHealthStatusMap')
|
72
|
+
InstanceId = Shapes::StringShape.new(name: 'InstanceId')
|
72
73
|
InstanceIdList = Shapes::ListShape.new(name: 'InstanceIdList')
|
73
74
|
InstanceNotFound = Shapes::StructureShape.new(name: 'InstanceNotFound')
|
74
75
|
InstanceSummary = Shapes::StructureShape.new(name: 'InstanceSummary')
|
@@ -92,6 +93,9 @@ module Aws::ServiceDiscovery
|
|
92
93
|
NamespaceFilterName = Shapes::StringShape.new(name: 'NamespaceFilterName')
|
93
94
|
NamespaceFilters = Shapes::ListShape.new(name: 'NamespaceFilters')
|
94
95
|
NamespaceName = Shapes::StringShape.new(name: 'NamespaceName')
|
96
|
+
NamespaceNameHttp = Shapes::StringShape.new(name: 'NamespaceNameHttp')
|
97
|
+
NamespaceNamePrivate = Shapes::StringShape.new(name: 'NamespaceNamePrivate')
|
98
|
+
NamespaceNamePublic = Shapes::StringShape.new(name: 'NamespaceNamePublic')
|
95
99
|
NamespaceNotFound = Shapes::StructureShape.new(name: 'NamespaceNotFound')
|
96
100
|
NamespaceProperties = Shapes::StructureShape.new(name: 'NamespaceProperties')
|
97
101
|
NamespaceSummariesList = Shapes::ListShape.new(name: 'NamespaceSummariesList')
|
@@ -133,6 +137,8 @@ module Aws::ServiceDiscovery
|
|
133
137
|
ServiceNotFound = Shapes::StructureShape.new(name: 'ServiceNotFound')
|
134
138
|
ServiceSummariesList = Shapes::ListShape.new(name: 'ServiceSummariesList')
|
135
139
|
ServiceSummary = Shapes::StructureShape.new(name: 'ServiceSummary')
|
140
|
+
ServiceType = Shapes::StringShape.new(name: 'ServiceType')
|
141
|
+
ServiceTypeOption = Shapes::StringShape.new(name: 'ServiceTypeOption')
|
136
142
|
Tag = Shapes::StructureShape.new(name: 'Tag')
|
137
143
|
TagKey = Shapes::StringShape.new(name: 'TagKey')
|
138
144
|
TagKeyList = Shapes::ListShape.new(name: 'TagKeyList')
|
@@ -151,7 +157,7 @@ module Aws::ServiceDiscovery
|
|
151
157
|
Attributes.key = Shapes::ShapeRef.new(shape: AttrKey)
|
152
158
|
Attributes.value = Shapes::ShapeRef.new(shape: AttrValue)
|
153
159
|
|
154
|
-
CreateHttpNamespaceRequest.add_member(:name, Shapes::ShapeRef.new(shape:
|
160
|
+
CreateHttpNamespaceRequest.add_member(:name, Shapes::ShapeRef.new(shape: NamespaceNameHttp, required: true, location_name: "Name"))
|
155
161
|
CreateHttpNamespaceRequest.add_member(:creator_request_id, Shapes::ShapeRef.new(shape: ResourceId, location_name: "CreatorRequestId", metadata: {"idempotencyToken"=>true}))
|
156
162
|
CreateHttpNamespaceRequest.add_member(:description, Shapes::ShapeRef.new(shape: ResourceDescription, location_name: "Description"))
|
157
163
|
CreateHttpNamespaceRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
|
@@ -160,7 +166,7 @@ module Aws::ServiceDiscovery
|
|
160
166
|
CreateHttpNamespaceResponse.add_member(:operation_id, Shapes::ShapeRef.new(shape: OperationId, location_name: "OperationId"))
|
161
167
|
CreateHttpNamespaceResponse.struct_class = Types::CreateHttpNamespaceResponse
|
162
168
|
|
163
|
-
CreatePrivateDnsNamespaceRequest.add_member(:name, Shapes::ShapeRef.new(shape:
|
169
|
+
CreatePrivateDnsNamespaceRequest.add_member(:name, Shapes::ShapeRef.new(shape: NamespaceNamePrivate, required: true, location_name: "Name"))
|
164
170
|
CreatePrivateDnsNamespaceRequest.add_member(:creator_request_id, Shapes::ShapeRef.new(shape: ResourceId, location_name: "CreatorRequestId", metadata: {"idempotencyToken"=>true}))
|
165
171
|
CreatePrivateDnsNamespaceRequest.add_member(:description, Shapes::ShapeRef.new(shape: ResourceDescription, location_name: "Description"))
|
166
172
|
CreatePrivateDnsNamespaceRequest.add_member(:vpc, Shapes::ShapeRef.new(shape: ResourceId, required: true, location_name: "Vpc"))
|
@@ -170,7 +176,7 @@ module Aws::ServiceDiscovery
|
|
170
176
|
CreatePrivateDnsNamespaceResponse.add_member(:operation_id, Shapes::ShapeRef.new(shape: OperationId, location_name: "OperationId"))
|
171
177
|
CreatePrivateDnsNamespaceResponse.struct_class = Types::CreatePrivateDnsNamespaceResponse
|
172
178
|
|
173
|
-
CreatePublicDnsNamespaceRequest.add_member(:name, Shapes::ShapeRef.new(shape:
|
179
|
+
CreatePublicDnsNamespaceRequest.add_member(:name, Shapes::ShapeRef.new(shape: NamespaceNamePublic, required: true, location_name: "Name"))
|
174
180
|
CreatePublicDnsNamespaceRequest.add_member(:creator_request_id, Shapes::ShapeRef.new(shape: ResourceId, location_name: "CreatorRequestId", metadata: {"idempotencyToken"=>true}))
|
175
181
|
CreatePublicDnsNamespaceRequest.add_member(:description, Shapes::ShapeRef.new(shape: ResourceDescription, location_name: "Description"))
|
176
182
|
CreatePublicDnsNamespaceRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
|
@@ -187,6 +193,7 @@ module Aws::ServiceDiscovery
|
|
187
193
|
CreateServiceRequest.add_member(:health_check_config, Shapes::ShapeRef.new(shape: HealthCheckConfig, location_name: "HealthCheckConfig"))
|
188
194
|
CreateServiceRequest.add_member(:health_check_custom_config, Shapes::ShapeRef.new(shape: HealthCheckCustomConfig, location_name: "HealthCheckCustomConfig"))
|
189
195
|
CreateServiceRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
|
196
|
+
CreateServiceRequest.add_member(:type, Shapes::ShapeRef.new(shape: ServiceTypeOption, location_name: "Type"))
|
190
197
|
CreateServiceRequest.struct_class = Types::CreateServiceRequest
|
191
198
|
|
192
199
|
CreateServiceResponse.add_member(:service, Shapes::ShapeRef.new(shape: Service, location_name: "Service"))
|
@@ -217,6 +224,7 @@ module Aws::ServiceDiscovery
|
|
217
224
|
DiscoverInstancesRequest.add_member(:service_name, Shapes::ShapeRef.new(shape: ServiceName, required: true, location_name: "ServiceName"))
|
218
225
|
DiscoverInstancesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: DiscoverMaxResults, location_name: "MaxResults"))
|
219
226
|
DiscoverInstancesRequest.add_member(:query_parameters, Shapes::ShapeRef.new(shape: Attributes, location_name: "QueryParameters"))
|
227
|
+
DiscoverInstancesRequest.add_member(:optional_parameters, Shapes::ShapeRef.new(shape: Attributes, location_name: "OptionalParameters"))
|
220
228
|
DiscoverInstancesRequest.add_member(:health_status, Shapes::ShapeRef.new(shape: HealthStatusFilter, location_name: "HealthStatus"))
|
221
229
|
DiscoverInstancesRequest.struct_class = Types::DiscoverInstancesRequest
|
222
230
|
|
@@ -286,11 +294,11 @@ module Aws::ServiceDiscovery
|
|
286
294
|
HealthCheckConfig.add_member(:failure_threshold, Shapes::ShapeRef.new(shape: FailureThreshold, location_name: "FailureThreshold"))
|
287
295
|
HealthCheckConfig.struct_class = Types::HealthCheckConfig
|
288
296
|
|
289
|
-
HealthCheckCustomConfig.add_member(:failure_threshold, Shapes::ShapeRef.new(shape: FailureThreshold, location_name: "FailureThreshold"))
|
297
|
+
HealthCheckCustomConfig.add_member(:failure_threshold, Shapes::ShapeRef.new(shape: FailureThreshold, deprecated: true, location_name: "FailureThreshold", metadata: {"deprecatedMessage"=>"Configurable FailureThreshold of HealthCheckCustomConfig is deprecated. It will always have value 1."}))
|
290
298
|
HealthCheckCustomConfig.struct_class = Types::HealthCheckCustomConfig
|
291
299
|
|
292
300
|
HttpInstanceSummary.add_member(:instance_id, Shapes::ShapeRef.new(shape: ResourceId, location_name: "InstanceId"))
|
293
|
-
HttpInstanceSummary.add_member(:namespace_name, Shapes::ShapeRef.new(shape:
|
301
|
+
HttpInstanceSummary.add_member(:namespace_name, Shapes::ShapeRef.new(shape: NamespaceNameHttp, location_name: "NamespaceName"))
|
294
302
|
HttpInstanceSummary.add_member(:service_name, Shapes::ShapeRef.new(shape: ServiceName, location_name: "ServiceName"))
|
295
303
|
HttpInstanceSummary.add_member(:health_status, Shapes::ShapeRef.new(shape: HealthStatus, location_name: "HealthStatus"))
|
296
304
|
HttpInstanceSummary.add_member(:attributes, Shapes::ShapeRef.new(shape: Attributes, location_name: "Attributes"))
|
@@ -437,7 +445,7 @@ module Aws::ServiceDiscovery
|
|
437
445
|
OperationTargetsMap.value = Shapes::ShapeRef.new(shape: ResourceId)
|
438
446
|
|
439
447
|
RegisterInstanceRequest.add_member(:service_id, Shapes::ShapeRef.new(shape: ResourceId, required: true, location_name: "ServiceId"))
|
440
|
-
RegisterInstanceRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape:
|
448
|
+
RegisterInstanceRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location_name: "InstanceId"))
|
441
449
|
RegisterInstanceRequest.add_member(:creator_request_id, Shapes::ShapeRef.new(shape: ResourceId, location_name: "CreatorRequestId", metadata: {"idempotencyToken"=>true}))
|
442
450
|
RegisterInstanceRequest.add_member(:attributes, Shapes::ShapeRef.new(shape: Attributes, required: true, location_name: "Attributes"))
|
443
451
|
RegisterInstanceRequest.struct_class = Types::RegisterInstanceRequest
|
@@ -464,6 +472,7 @@ module Aws::ServiceDiscovery
|
|
464
472
|
Service.add_member(:description, Shapes::ShapeRef.new(shape: ResourceDescription, location_name: "Description"))
|
465
473
|
Service.add_member(:instance_count, Shapes::ShapeRef.new(shape: ResourceCount, location_name: "InstanceCount"))
|
466
474
|
Service.add_member(:dns_config, Shapes::ShapeRef.new(shape: DnsConfig, location_name: "DnsConfig"))
|
475
|
+
Service.add_member(:type, Shapes::ShapeRef.new(shape: ServiceType, location_name: "Type"))
|
467
476
|
Service.add_member(:health_check_config, Shapes::ShapeRef.new(shape: HealthCheckConfig, location_name: "HealthCheckConfig"))
|
468
477
|
Service.add_member(:health_check_custom_config, Shapes::ShapeRef.new(shape: HealthCheckCustomConfig, location_name: "HealthCheckCustomConfig"))
|
469
478
|
Service.add_member(:create_date, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreateDate"))
|
@@ -495,6 +504,7 @@ module Aws::ServiceDiscovery
|
|
495
504
|
ServiceSummary.add_member(:id, Shapes::ShapeRef.new(shape: ResourceId, location_name: "Id"))
|
496
505
|
ServiceSummary.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, location_name: "Arn"))
|
497
506
|
ServiceSummary.add_member(:name, Shapes::ShapeRef.new(shape: ServiceName, location_name: "Name"))
|
507
|
+
ServiceSummary.add_member(:type, Shapes::ShapeRef.new(shape: ServiceType, location_name: "Type"))
|
498
508
|
ServiceSummary.add_member(:description, Shapes::ShapeRef.new(shape: ResourceDescription, location_name: "Description"))
|
499
509
|
ServiceSummary.add_member(:instance_count, Shapes::ShapeRef.new(shape: ResourceCount, location_name: "InstanceCount"))
|
500
510
|
ServiceSummary.add_member(:dns_config, Shapes::ShapeRef.new(shape: DnsConfig, location_name: "DnsConfig"))
|
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -14,7 +14,7 @@ module Aws::ServiceDiscovery
|
|
14
14
|
# data as a hash:
|
15
15
|
#
|
16
16
|
# {
|
17
|
-
# name: "
|
17
|
+
# name: "NamespaceNameHttp", # required
|
18
18
|
# creator_request_id: "ResourceId",
|
19
19
|
# description: "ResourceDescription",
|
20
20
|
# tags: [
|
@@ -32,7 +32,7 @@ module Aws::ServiceDiscovery
|
|
32
32
|
# @!attribute [rw] creator_request_id
|
33
33
|
# A unique string that identifies the request and that allows failed
|
34
34
|
# `CreateHttpNamespace` requests to be retried without the risk of
|
35
|
-
#
|
35
|
+
# running the operation twice. `CreatorRequestId` can be any unique
|
36
36
|
# string, for example, a date/time stamp.
|
37
37
|
#
|
38
38
|
# **A suitable default value is auto-generated.** You should normally
|
@@ -45,9 +45,9 @@ module Aws::ServiceDiscovery
|
|
45
45
|
#
|
46
46
|
# @!attribute [rw] tags
|
47
47
|
# The tags to add to the namespace. Each tag consists of a key and an
|
48
|
-
# optional value
|
49
|
-
#
|
50
|
-
#
|
48
|
+
# optional value that you define. Tags keys can be up to 128
|
49
|
+
# characters in length, and tag values can be up to 256 characters in
|
50
|
+
# length.
|
51
51
|
# @return [Array<Types::Tag>]
|
52
52
|
#
|
53
53
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/CreateHttpNamespaceRequest AWS API Documentation
|
@@ -83,7 +83,7 @@ module Aws::ServiceDiscovery
|
|
83
83
|
# data as a hash:
|
84
84
|
#
|
85
85
|
# {
|
86
|
-
# name: "
|
86
|
+
# name: "NamespaceNamePrivate", # required
|
87
87
|
# creator_request_id: "ResourceId",
|
88
88
|
# description: "ResourceDescription",
|
89
89
|
# vpc: "ResourceId", # required
|
@@ -105,8 +105,8 @@ module Aws::ServiceDiscovery
|
|
105
105
|
# @!attribute [rw] creator_request_id
|
106
106
|
# A unique string that identifies the request and that allows failed
|
107
107
|
# `CreatePrivateDnsNamespace` requests to be retried without the risk
|
108
|
-
# of
|
109
|
-
#
|
108
|
+
# of running the operation twice. `CreatorRequestId` can be any unique
|
109
|
+
# string, for example, a date/timestamp.
|
110
110
|
#
|
111
111
|
# **A suitable default value is auto-generated.** You should normally
|
112
112
|
# not need to pass this option.
|
@@ -123,9 +123,9 @@ module Aws::ServiceDiscovery
|
|
123
123
|
#
|
124
124
|
# @!attribute [rw] tags
|
125
125
|
# The tags to add to the namespace. Each tag consists of a key and an
|
126
|
-
# optional value
|
127
|
-
#
|
128
|
-
#
|
126
|
+
# optional value that you define. Tags keys can be up to 128
|
127
|
+
# characters in length, and tag values can be up to 256 characters in
|
128
|
+
# length.
|
129
129
|
# @return [Array<Types::Tag>]
|
130
130
|
#
|
131
131
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/CreatePrivateDnsNamespaceRequest AWS API Documentation
|
@@ -162,7 +162,7 @@ module Aws::ServiceDiscovery
|
|
162
162
|
# data as a hash:
|
163
163
|
#
|
164
164
|
# {
|
165
|
-
# name: "
|
165
|
+
# name: "NamespaceNamePublic", # required
|
166
166
|
# creator_request_id: "ResourceId",
|
167
167
|
# description: "ResourceDescription",
|
168
168
|
# tags: [
|
@@ -180,8 +180,8 @@ module Aws::ServiceDiscovery
|
|
180
180
|
# @!attribute [rw] creator_request_id
|
181
181
|
# A unique string that identifies the request and that allows failed
|
182
182
|
# `CreatePublicDnsNamespace` requests to be retried without the risk
|
183
|
-
# of
|
184
|
-
#
|
183
|
+
# of running the operation twice. `CreatorRequestId` can be any unique
|
184
|
+
# string, for example, a date/timestamp.
|
185
185
|
#
|
186
186
|
# **A suitable default value is auto-generated.** You should normally
|
187
187
|
# not need to pass this option.
|
@@ -193,9 +193,9 @@ module Aws::ServiceDiscovery
|
|
193
193
|
#
|
194
194
|
# @!attribute [rw] tags
|
195
195
|
# The tags to add to the namespace. Each tag consists of a key and an
|
196
|
-
# optional value
|
197
|
-
#
|
198
|
-
#
|
196
|
+
# optional value that you define. Tags keys can be up to 128
|
197
|
+
# characters in length, and tag values can be up to 256 characters in
|
198
|
+
# length.
|
199
199
|
# @return [Array<Types::Tag>]
|
200
200
|
#
|
201
201
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/CreatePublicDnsNamespaceRequest AWS API Documentation
|
@@ -259,19 +259,20 @@ module Aws::ServiceDiscovery
|
|
259
259
|
# value: "TagValue", # required
|
260
260
|
# },
|
261
261
|
# ],
|
262
|
+
# type: "HTTP", # accepts HTTP
|
262
263
|
# }
|
263
264
|
#
|
264
265
|
# @!attribute [rw] name
|
265
266
|
# The name that you want to assign to the service.
|
266
267
|
#
|
267
268
|
# If you want AWS Cloud Map to create an `SRV` record when you
|
268
|
-
# register an instance
|
269
|
+
# register an instance and you're using a system that requires a
|
269
270
|
# specific `SRV` format, such as [HAProxy][1], specify the following
|
270
271
|
# for `Name`\:
|
271
272
|
#
|
272
|
-
# * Start the name with an underscore (\_), such as `_exampleservice
|
273
|
+
# * Start the name with an underscore (\_), such as `_exampleservice`.
|
273
274
|
#
|
274
|
-
# * End the name with *.\_protocol*, such as `._tcp
|
275
|
+
# * End the name with *.\_protocol*, such as `._tcp`.
|
275
276
|
#
|
276
277
|
# When you register an instance, AWS Cloud Map creates an `SRV` record
|
277
278
|
# and assigns a name to the record by concatenating the service name
|
@@ -279,6 +280,15 @@ module Aws::ServiceDiscovery
|
|
279
280
|
#
|
280
281
|
# `_exampleservice._tcp.example.com`
|
281
282
|
#
|
283
|
+
# <note markdown="1"> For services that are accessible by DNS queries, you can't create
|
284
|
+
# multiple services with names that differ only by case (such as
|
285
|
+
# EXAMPLE and example). Otherwise, these services have the same DNS
|
286
|
+
# name and can't be distinguished. However, if you use a namespace
|
287
|
+
# that's only accessible by API calls, then you can create services
|
288
|
+
# that with names that differ only by case.
|
289
|
+
#
|
290
|
+
# </note>
|
291
|
+
#
|
282
292
|
#
|
283
293
|
#
|
284
294
|
# [1]: http://www.haproxy.org/
|
@@ -286,13 +296,15 @@ module Aws::ServiceDiscovery
|
|
286
296
|
#
|
287
297
|
# @!attribute [rw] namespace_id
|
288
298
|
# The ID of the namespace that you want to use to create the service.
|
299
|
+
# The namespace ID must be specified, but it can be specified either
|
300
|
+
# here or in the `DnsConfig` object.
|
289
301
|
# @return [String]
|
290
302
|
#
|
291
303
|
# @!attribute [rw] creator_request_id
|
292
304
|
# A unique string that identifies the request and that allows failed
|
293
|
-
# `CreateService` requests to be retried without the risk of
|
305
|
+
# `CreateService` requests to be retried without the risk of running
|
294
306
|
# the operation twice. `CreatorRequestId` can be any unique string,
|
295
|
-
# for example, a date/
|
307
|
+
# for example, a date/timestamp.
|
296
308
|
#
|
297
309
|
# **A suitable default value is auto-generated.** You should normally
|
298
310
|
# not need to pass this option.
|
@@ -339,11 +351,18 @@ module Aws::ServiceDiscovery
|
|
339
351
|
#
|
340
352
|
# @!attribute [rw] tags
|
341
353
|
# The tags to add to the service. Each tag consists of a key and an
|
342
|
-
# optional value
|
343
|
-
#
|
344
|
-
#
|
354
|
+
# optional value that you define. Tags keys can be up to 128
|
355
|
+
# characters in length, and tag values can be up to 256 characters in
|
356
|
+
# length.
|
345
357
|
# @return [Array<Types::Tag>]
|
346
358
|
#
|
359
|
+
# @!attribute [rw] type
|
360
|
+
# If present, specifies that the service instances are only
|
361
|
+
# discoverable using the `DiscoverInstances` API operation. No DNS
|
362
|
+
# records will be registered for the service instances. The only valid
|
363
|
+
# value is `HTTP`.
|
364
|
+
# @return [String]
|
365
|
+
#
|
347
366
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/CreateServiceRequest AWS API Documentation
|
348
367
|
#
|
349
368
|
class CreateServiceRequest < Struct.new(
|
@@ -354,7 +373,8 @@ module Aws::ServiceDiscovery
|
|
354
373
|
:dns_config,
|
355
374
|
:health_check_config,
|
356
375
|
:health_check_custom_config,
|
357
|
-
:tags
|
376
|
+
:tags,
|
377
|
+
:type)
|
358
378
|
SENSITIVE = []
|
359
379
|
include Aws::Structure
|
360
380
|
end
|
@@ -371,8 +391,8 @@ module Aws::ServiceDiscovery
|
|
371
391
|
include Aws::Structure
|
372
392
|
end
|
373
393
|
|
374
|
-
# The health check for the instance that
|
375
|
-
# `InstanceId`
|
394
|
+
# The health check for the instance that's specified by `ServiceId` and
|
395
|
+
# `InstanceId` isn't a custom health check.
|
376
396
|
#
|
377
397
|
# @!attribute [rw] message
|
378
398
|
# @return [String]
|
@@ -502,12 +522,15 @@ module Aws::ServiceDiscovery
|
|
502
522
|
# query_parameters: {
|
503
523
|
# "AttrKey" => "AttrValue",
|
504
524
|
# },
|
525
|
+
# optional_parameters: {
|
526
|
+
# "AttrKey" => "AttrValue",
|
527
|
+
# },
|
505
528
|
# health_status: "HEALTHY", # accepts HEALTHY, UNHEALTHY, ALL
|
506
529
|
# }
|
507
530
|
#
|
508
531
|
# @!attribute [rw] namespace_name
|
509
|
-
# The name of the namespace
|
510
|
-
#
|
532
|
+
# The `HttpName` name of the namespace, found in the `HttpProperties`
|
533
|
+
# member of the `Properties` member of the namespace.
|
511
534
|
# @return [String]
|
512
535
|
#
|
513
536
|
# @!attribute [rw] service_name
|
@@ -523,10 +546,18 @@ module Aws::ServiceDiscovery
|
|
523
546
|
# @return [Integer]
|
524
547
|
#
|
525
548
|
# @!attribute [rw] query_parameters
|
526
|
-
#
|
527
|
-
#
|
528
|
-
#
|
529
|
-
#
|
549
|
+
# Filters to scope the results based on custom attributes for the
|
550
|
+
# instance. For example, `\{version=v1, az=1a\}`. Only instances that
|
551
|
+
# match all the specified key-value pairs are returned.
|
552
|
+
# @return [Hash<String,String>]
|
553
|
+
#
|
554
|
+
# @!attribute [rw] optional_parameters
|
555
|
+
# Opportunistic filters to scope the results based on custom
|
556
|
+
# attributes. If there are instances that match both the filters
|
557
|
+
# specified in both the `QueryParameters` parameter and this
|
558
|
+
# parameter, they are returned. Otherwise, these filters are ignored
|
559
|
+
# and only instances that match the filters specified in the
|
560
|
+
# `QueryParameters` parameter are returned.
|
530
561
|
# @return [Hash<String,String>]
|
531
562
|
#
|
532
563
|
# @!attribute [rw] health_status
|
@@ -540,6 +571,7 @@ module Aws::ServiceDiscovery
|
|
540
571
|
:service_name,
|
541
572
|
:max_results,
|
542
573
|
:query_parameters,
|
574
|
+
:optional_parameters,
|
543
575
|
:health_status)
|
544
576
|
SENSITIVE = []
|
545
577
|
include Aws::Structure
|
@@ -592,46 +624,46 @@ module Aws::ServiceDiscovery
|
|
592
624
|
#
|
593
625
|
# You can specify the following values:
|
594
626
|
#
|
595
|
-
#
|
627
|
+
# MULTIVALUE
|
596
628
|
#
|
597
|
-
# If you define a health check for the service and the health check
|
598
|
-
#
|
599
|
-
#
|
629
|
+
# : If you define a health check for the service and the health check
|
630
|
+
# is healthy, Route 53 returns the applicable value for up to eight
|
631
|
+
# instances.
|
600
632
|
#
|
601
|
-
#
|
602
|
-
#
|
603
|
-
#
|
604
|
-
#
|
605
|
-
#
|
606
|
-
#
|
633
|
+
# For example, suppose that the service includes configurations for
|
634
|
+
# one `A` record and a health check. You use the service to register
|
635
|
+
# 10 instances. Route 53 responds to DNS queries with IP addresses
|
636
|
+
# for up to eight healthy instances. If fewer than eight instances
|
637
|
+
# are healthy, Route 53 responds to every DNS query with the IP
|
638
|
+
# addresses for all of the healthy instances.
|
607
639
|
#
|
608
|
-
#
|
609
|
-
#
|
610
|
-
#
|
640
|
+
# If you don't define a health check for the service, Route 53
|
641
|
+
# assumes that all instances are healthy and returns the values for
|
642
|
+
# up to eight instances.
|
611
643
|
#
|
612
|
-
#
|
613
|
-
#
|
644
|
+
# For more information about the multivalue routing policy, see
|
645
|
+
# [Multivalue Answer Routing][1] in the *Route 53 Developer Guide*.
|
614
646
|
#
|
615
|
-
#
|
647
|
+
# WEIGHTED
|
616
648
|
#
|
617
|
-
# Route 53 returns the applicable value from one randomly selected
|
618
|
-
#
|
619
|
-
#
|
620
|
-
#
|
649
|
+
# : Route 53 returns the applicable value from one randomly selected
|
650
|
+
# instance from among the instances that you registered using the
|
651
|
+
# same service. Currently, all records have the same weight, so you
|
652
|
+
# can't route more or less traffic to any instances.
|
621
653
|
#
|
622
|
-
#
|
623
|
-
#
|
624
|
-
#
|
625
|
-
#
|
626
|
-
#
|
627
|
-
#
|
654
|
+
# For example, suppose that the service includes configurations for
|
655
|
+
# one `A` record and a health check. You use the service to register
|
656
|
+
# 10 instances. Route 53 responds to DNS queries with the IP address
|
657
|
+
# for one randomly selected instance from among the healthy
|
658
|
+
# instances. If no instances are healthy, Route 53 responds to DNS
|
659
|
+
# queries as if all of the instances were healthy.
|
628
660
|
#
|
629
|
-
#
|
630
|
-
#
|
631
|
-
#
|
661
|
+
# If you don't define a health check for the service, Route 53
|
662
|
+
# assumes that all instances are healthy and returns the applicable
|
663
|
+
# value for one randomly selected instance.
|
632
664
|
#
|
633
|
-
#
|
634
|
-
#
|
665
|
+
# For more information about the weighted routing policy, see
|
666
|
+
# [Weighted Routing][2] in the *Route 53 Developer Guide*.
|
635
667
|
#
|
636
668
|
#
|
637
669
|
#
|
@@ -717,15 +749,15 @@ module Aws::ServiceDiscovery
|
|
717
749
|
# Route 53 returns in response to DNS queries. You can specify values
|
718
750
|
# for `Type` in the following combinations:
|
719
751
|
#
|
720
|
-
# *
|
752
|
+
# * <b> <code>A</code> </b>
|
721
753
|
#
|
722
|
-
# *
|
754
|
+
# * <b> <code>AAAA</code> </b>
|
723
755
|
#
|
724
|
-
# *
|
756
|
+
# * <b> <code>A</code> </b> and <b> <code>AAAA</code> </b>
|
725
757
|
#
|
726
|
-
# *
|
758
|
+
# * <b> <code>SRV</code> </b>
|
727
759
|
#
|
728
|
-
# *
|
760
|
+
# * <b> <code>CNAME</code> </b>
|
729
761
|
#
|
730
762
|
# If you want AWS Cloud Map to create a Route 53 alias record when you
|
731
763
|
# register an instance, specify `A` or `AAAA` for `Type`.
|
@@ -736,62 +768,81 @@ module Aws::ServiceDiscovery
|
|
736
768
|
#
|
737
769
|
# The following values are supported:
|
738
770
|
#
|
739
|
-
#
|
740
|
-
#
|
741
|
-
#
|
742
|
-
#
|
743
|
-
#
|
744
|
-
#
|
745
|
-
#
|
746
|
-
#
|
747
|
-
#
|
748
|
-
#
|
749
|
-
#
|
750
|
-
#
|
751
|
-
#
|
752
|
-
#
|
753
|
-
#
|
754
|
-
#
|
755
|
-
#
|
756
|
-
#
|
757
|
-
#
|
758
|
-
#
|
759
|
-
#
|
760
|
-
#
|
761
|
-
#
|
762
|
-
#
|
763
|
-
#
|
764
|
-
#
|
765
|
-
#
|
766
|
-
#
|
767
|
-
#
|
768
|
-
#
|
769
|
-
#
|
770
|
-
#
|
771
|
-
#
|
772
|
-
#
|
773
|
-
#
|
774
|
-
#
|
775
|
-
#
|
776
|
-
#
|
777
|
-
#
|
778
|
-
#
|
779
|
-
#
|
780
|
-
#
|
781
|
-
#
|
782
|
-
#
|
783
|
-
#
|
784
|
-
#
|
785
|
-
#
|
786
|
-
#
|
787
|
-
#
|
788
|
-
#
|
789
|
-
#
|
790
|
-
#
|
771
|
+
# A
|
772
|
+
#
|
773
|
+
# : Route 53 returns the IP address of the resource in IPv4 format,
|
774
|
+
# such as 192.0.2.44.
|
775
|
+
#
|
776
|
+
# AAAA
|
777
|
+
#
|
778
|
+
# : Route 53 returns the IP address of the resource in IPv6 format,
|
779
|
+
# such as 2001:0db8:85a3:0000:0000:abcd:0001:2345.
|
780
|
+
#
|
781
|
+
# CNAME
|
782
|
+
#
|
783
|
+
# : Route 53 returns the domain name of the resource, such as
|
784
|
+
# www.example.com. Note the following:
|
785
|
+
#
|
786
|
+
# * You specify the domain name that you want to route traffic to
|
787
|
+
# when you register an instance. For more information, see
|
788
|
+
# [Attributes][2] in the topic [RegisterInstance][1].
|
789
|
+
#
|
790
|
+
# * You must specify `WEIGHTED` for the value of `RoutingPolicy`.
|
791
|
+
#
|
792
|
+
# * You can't specify both `CNAME` for `Type` and settings for
|
793
|
+
# `HealthCheckConfig`. If you do, the request will fail with an
|
794
|
+
# `InvalidInput` error.
|
795
|
+
#
|
796
|
+
# SRV
|
797
|
+
#
|
798
|
+
# : Route 53 returns the value for an `SRV` record. The value for an
|
799
|
+
# `SRV` record uses the following values:
|
800
|
+
#
|
801
|
+
# `priority weight port service-hostname`
|
802
|
+
#
|
803
|
+
# Note the following about the values:
|
804
|
+
#
|
805
|
+
# * The values of `priority` and `weight` are both set to `1` and
|
806
|
+
# can't be changed.
|
807
|
+
#
|
808
|
+
# * The value of `port` comes from the value that you specify for
|
809
|
+
# the `AWS_INSTANCE_PORT` attribute when you submit a
|
810
|
+
# [RegisterInstance][1] request.
|
811
|
+
#
|
812
|
+
# * The value of `service-hostname` is a concatenation of the
|
813
|
+
# following values:
|
814
|
+
#
|
815
|
+
# * The value that you specify for `InstanceId` when you register
|
816
|
+
# an instance.
|
817
|
+
#
|
818
|
+
# * The name of the service.
|
819
|
+
#
|
820
|
+
# * The name of the namespace.
|
821
|
+
#
|
822
|
+
# For example, if the value of `InstanceId` is `test`, the name of
|
823
|
+
# the service is `backend`, and the name of the namespace is
|
824
|
+
# `example.com`, the value of `service-hostname` is the following:
|
825
|
+
#
|
826
|
+
# `test.backend.example.com`
|
827
|
+
#
|
828
|
+
# If you specify settings for an `SRV` record, note the following:
|
829
|
+
#
|
830
|
+
# * If you specify values for `AWS_INSTANCE_IPV4`,
|
831
|
+
# `AWS_INSTANCE_IPV6`, or both in the `RegisterInstance` request,
|
832
|
+
# AWS Cloud Map automatically creates `A` and/or `AAAA` records
|
833
|
+
# that have the same name as the value of `service-hostname` in
|
834
|
+
# the `SRV` record. You can ignore these records.
|
835
|
+
#
|
836
|
+
# * If you're using a system that requires a specific `SRV` format,
|
837
|
+
# such as HAProxy, see the [Name][3] element in the documentation
|
838
|
+
# about `CreateService` for information about how to specify the
|
839
|
+
# correct name format.
|
791
840
|
#
|
792
841
|
#
|
793
842
|
#
|
794
843
|
# [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html
|
844
|
+
# [2]: https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html#cloudmap-RegisterInstance-request-Attributes
|
845
|
+
# [3]: https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html#cloudmap-CreateService-request-Name
|
795
846
|
# @return [String]
|
796
847
|
#
|
797
848
|
# @!attribute [rw] ttl
|
@@ -1064,54 +1115,55 @@ module Aws::ServiceDiscovery
|
|
1064
1115
|
#
|
1065
1116
|
# Note the following about configuring health checks.
|
1066
1117
|
#
|
1067
|
-
#
|
1118
|
+
# A and AAAA records
|
1068
1119
|
#
|
1069
|
-
# If `DnsConfig` includes configurations for both `A` and `AAAA`
|
1070
|
-
#
|
1071
|
-
#
|
1072
|
-
#
|
1073
|
-
#
|
1120
|
+
# : If `DnsConfig` includes configurations for both `A` and `AAAA`
|
1121
|
+
# records, AWS Cloud Map creates a health check that uses the IPv4
|
1122
|
+
# address to check the health of the resource. If the endpoint that is
|
1123
|
+
# specified by the IPv4 address is unhealthy, Route 53 considers both
|
1124
|
+
# the `A` and `AAAA` records to be unhealthy.
|
1074
1125
|
#
|
1075
|
-
#
|
1126
|
+
# CNAME records
|
1076
1127
|
#
|
1077
|
-
# You can't specify settings for `HealthCheckConfig` when the
|
1078
|
-
#
|
1079
|
-
#
|
1128
|
+
# : You can't specify settings for `HealthCheckConfig` when the
|
1129
|
+
# `DNSConfig` includes `CNAME` for the value of `Type`. If you do, the
|
1130
|
+
# `CreateService` request will fail with an `InvalidInput` error.
|
1080
1131
|
#
|
1081
|
-
#
|
1132
|
+
# Request interval
|
1082
1133
|
#
|
1083
|
-
# A Route 53 health checker in each health-checking region sends a
|
1084
|
-
#
|
1085
|
-
# endpoint receives a health check request about every two
|
1086
|
-
# However, health checkers don't coordinate with one
|
1087
|
-
# you'll sometimes see several requests per second
|
1088
|
-
# seconds with no health checks at all.
|
1134
|
+
# : A Route 53 health checker in each health-checking region sends a
|
1135
|
+
# health check request to an endpoint every 30 seconds. On average,
|
1136
|
+
# your endpoint receives a health check request about every two
|
1137
|
+
# seconds. However, health checkers don't coordinate with one
|
1138
|
+
# another, so you'll sometimes see several requests per second
|
1139
|
+
# followed by a few seconds with no health checks at all.
|
1089
1140
|
#
|
1090
|
-
#
|
1141
|
+
# Health checking regions
|
1091
1142
|
#
|
1092
|
-
# Health checkers perform checks from all Route 53 health-checking
|
1093
|
-
#
|
1143
|
+
# : Health checkers perform checks from all Route 53 health-checking
|
1144
|
+
# regions. For a list of the current regions, see [Regions][2].
|
1094
1145
|
#
|
1095
|
-
#
|
1146
|
+
# Alias records
|
1096
1147
|
#
|
1097
|
-
# When you register an instance, if you include the
|
1098
|
-
# attribute, AWS Cloud Map creates a Route 53
|
1099
|
-
# following:
|
1148
|
+
# : When you register an instance, if you include the
|
1149
|
+
# `AWS_ALIAS_DNS_NAME` attribute, AWS Cloud Map creates a Route 53
|
1150
|
+
# alias record. Note the following:
|
1100
1151
|
#
|
1101
|
-
#
|
1102
|
-
#
|
1103
|
-
#
|
1104
|
-
#
|
1152
|
+
# * Route 53 automatically sets `EvaluateTargetHealth` to true for
|
1153
|
+
# alias records. When `EvaluateTargetHealth` is true, the alias
|
1154
|
+
# record inherits the health of the referenced AWS resource. such as
|
1155
|
+
# an ELB load balancer. For more information, see
|
1156
|
+
# [EvaluateTargetHealth][3].
|
1105
1157
|
#
|
1106
|
-
#
|
1107
|
-
#
|
1108
|
-
#
|
1158
|
+
# * If you include `HealthCheckConfig` and then use the service to
|
1159
|
+
# register an instance that creates an alias record, Route 53
|
1160
|
+
# doesn't create the health check.
|
1109
1161
|
#
|
1110
|
-
#
|
1162
|
+
# Charges for health checks
|
1111
1163
|
#
|
1112
|
-
# Health checks are basic Route 53 health checks that monitor an AWS
|
1113
|
-
#
|
1114
|
-
# Route 53 Pricing][1].
|
1164
|
+
# : Health checks are basic Route 53 health checks that monitor an AWS
|
1165
|
+
# endpoint. For information about pricing for health checks, see
|
1166
|
+
# [Amazon Route 53 Pricing][1].
|
1115
1167
|
#
|
1116
1168
|
#
|
1117
1169
|
#
|
@@ -1163,8 +1215,8 @@ module Aws::ServiceDiscovery
|
|
1163
1215
|
#
|
1164
1216
|
# @!attribute [rw] resource_path
|
1165
1217
|
# The path that you want Route 53 to request when performing health
|
1166
|
-
# checks. The path can be any value for which your endpoint
|
1167
|
-
#
|
1218
|
+
# checks. The path can be any value for which your endpoint returns an
|
1219
|
+
# HTTP status code of a 2xx or 3xx format when the endpoint is
|
1168
1220
|
# healthy, such as the file `/docs/route53-health-check.html`.
|
1169
1221
|
# Route 53 automatically adds the DNS name for the service. If you
|
1170
1222
|
# don't specify a value for `ResourcePath`, the default value is `/`.
|
@@ -1176,9 +1228,9 @@ module Aws::ServiceDiscovery
|
|
1176
1228
|
# @!attribute [rw] failure_threshold
|
1177
1229
|
# The number of consecutive health checks that an endpoint must pass
|
1178
1230
|
# or fail for Route 53 to change the current status of the endpoint
|
1179
|
-
# from unhealthy to healthy or
|
1180
|
-
# [How Route 53 Determines Whether an Endpoint Is
|
1181
|
-
# *Route 53 Developer Guide*.
|
1231
|
+
# from unhealthy to healthy or the other way around. For more
|
1232
|
+
# information, see [How Route 53 Determines Whether an Endpoint Is
|
1233
|
+
# Healthy][1] in the *Route 53 Developer Guide*.
|
1182
1234
|
#
|
1183
1235
|
#
|
1184
1236
|
#
|
@@ -1261,20 +1313,19 @@ module Aws::ServiceDiscovery
|
|
1261
1313
|
# }
|
1262
1314
|
#
|
1263
1315
|
# @!attribute [rw] failure_threshold
|
1316
|
+
# This parameter has been deprecated and is always set to 1. AWS Cloud
|
1317
|
+
# Map waits for approximately 30 seconds after receiving an
|
1318
|
+
# `UpdateInstanceCustomHealthStatus` request before changing the
|
1319
|
+
# status of the service instance.
|
1320
|
+
#
|
1264
1321
|
# The number of 30-second intervals that you want AWS Cloud Map to
|
1265
1322
|
# wait after receiving an `UpdateInstanceCustomHealthStatus` request
|
1266
|
-
# before it changes the health status of a service instance.
|
1267
|
-
# example, suppose you specify a value of `2` for `FailureTheshold`,
|
1268
|
-
# and then your application sends an
|
1269
|
-
# `UpdateInstanceCustomHealthStatus` request. AWS Cloud Map waits for
|
1270
|
-
# approximately 60 seconds (2 x 30) before changing the status of the
|
1271
|
-
# service instance based on that request.
|
1323
|
+
# before it changes the health status of a service instance.
|
1272
1324
|
#
|
1273
1325
|
# Sending a second or subsequent `UpdateInstanceCustomHealthStatus`
|
1274
|
-
# request with the same value before
|
1275
|
-
#
|
1276
|
-
#
|
1277
|
-
# change.
|
1326
|
+
# request with the same value before 30 seconds has passed doesn't
|
1327
|
+
# accelerate the change. AWS Cloud Map still waits `30` seconds after
|
1328
|
+
# the first request to make the change.
|
1278
1329
|
# @return [Integer]
|
1279
1330
|
#
|
1280
1331
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/HealthCheckCustomConfig AWS API Documentation
|
@@ -1299,8 +1350,9 @@ module Aws::ServiceDiscovery
|
|
1299
1350
|
# @return [String]
|
1300
1351
|
#
|
1301
1352
|
# @!attribute [rw] namespace_name
|
1302
|
-
# The name of the namespace
|
1303
|
-
#
|
1353
|
+
# ` </p> The HttpName name of the namespace, found in the
|
1354
|
+
# HttpProperties member of the Properties member of the namespace.
|
1355
|
+
# `
|
1304
1356
|
# @return [String]
|
1305
1357
|
#
|
1306
1358
|
# @!attribute [rw] service_name
|
@@ -1399,87 +1451,94 @@ module Aws::ServiceDiscovery
|
|
1399
1451
|
#
|
1400
1452
|
# Supported attribute keys include the following:
|
1401
1453
|
#
|
1402
|
-
#
|
1454
|
+
# AWS\_ALIAS\_DNS\_NAME
|
1403
1455
|
#
|
1404
|
-
#
|
1456
|
+
# : If you want AWS Cloud Map to create a Route 53 alias record that
|
1457
|
+
# routes traffic to an Elastic Load Balancing load balancer, specify
|
1458
|
+
# the DNS name that is associated with the load balancer. For
|
1459
|
+
# information about how to get the DNS name, see
|
1460
|
+
# [AliasTarget->DNSName][1] in the *Route 53 API Reference*.
|
1405
1461
|
#
|
1406
|
-
#
|
1407
|
-
# routes traffic to an Elastic Load Balancing load balancer, specify
|
1408
|
-
# the DNS name that is associated with the load balancer. For
|
1409
|
-
# information about how to get the DNS name, see "DNSName" in the
|
1410
|
-
# topic [AliasTarget][1].
|
1462
|
+
# Note the following:
|
1411
1463
|
#
|
1412
|
-
#
|
1464
|
+
# * The configuration for the service that is specified by
|
1465
|
+
# `ServiceId` must include settings for an `A` record, an `AAAA`
|
1466
|
+
# record, or both.
|
1413
1467
|
#
|
1414
|
-
#
|
1415
|
-
#
|
1416
|
-
# both.
|
1468
|
+
# * In the service that is specified by `ServiceId`, the value of
|
1469
|
+
# `RoutingPolicy` must be `WEIGHTED`.
|
1417
1470
|
#
|
1418
|
-
#
|
1419
|
-
#
|
1471
|
+
# * If the service that is specified by `ServiceId` includes
|
1472
|
+
# `HealthCheckConfig` settings, AWS Cloud Map creates the health
|
1473
|
+
# check, but it won't associate the health check with the alias
|
1474
|
+
# record.
|
1420
1475
|
#
|
1421
|
-
#
|
1422
|
-
#
|
1423
|
-
#
|
1424
|
-
# record.
|
1476
|
+
# * Auto naming currently doesn't support creating alias records
|
1477
|
+
# that route traffic to AWS resources other than ELB load
|
1478
|
+
# balancers.
|
1425
1479
|
#
|
1426
|
-
#
|
1427
|
-
#
|
1480
|
+
# * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
|
1481
|
+
# values for any of the `AWS_INSTANCE` attributes.
|
1428
1482
|
#
|
1429
|
-
#
|
1430
|
-
# values for any of the `AWS_INSTANCE` attributes.
|
1483
|
+
# AWS\_EC2\_INSTANCE\_ID
|
1431
1484
|
#
|
1432
|
-
#
|
1485
|
+
# : *HTTP namespaces only.* The Amazon EC2 instance ID for the
|
1486
|
+
# instance. The `AWS_INSTANCE_IPV4` attribute contains the primary
|
1487
|
+
# private IPv4 address.
|
1433
1488
|
#
|
1434
|
-
#
|
1435
|
-
# The `AWS_INSTANCE_IPV4` attribute contains the primary private IPv4
|
1436
|
-
# address.
|
1489
|
+
# AWS\_INIT\_HEALTH\_STATUS
|
1437
1490
|
#
|
1438
|
-
#
|
1491
|
+
# : If the service configuration includes `HealthCheckCustomConfig`,
|
1492
|
+
# you can optionally use `AWS_INIT_HEALTH_STATUS` to specify the
|
1493
|
+
# initial status of the custom health check, `HEALTHY` or
|
1494
|
+
# `UNHEALTHY`. If you don't specify a value for
|
1495
|
+
# `AWS_INIT_HEALTH_STATUS`, the initial status is `HEALTHY`.
|
1439
1496
|
#
|
1440
|
-
#
|
1441
|
-
# name that you want Route 53 to return in response to DNS queries,
|
1442
|
-
# for example, `example.com`.
|
1497
|
+
# AWS\_INSTANCE\_CNAME
|
1443
1498
|
#
|
1444
|
-
#
|
1445
|
-
#
|
1499
|
+
# : If the service configuration includes a `CNAME` record, the domain
|
1500
|
+
# name that you want Route 53 to return in response to DNS queries,
|
1501
|
+
# for example, `example.com`.
|
1446
1502
|
#
|
1447
|
-
#
|
1503
|
+
# This value is required if the service specified by `ServiceId`
|
1504
|
+
# includes settings for an `CNAME` record.
|
1448
1505
|
#
|
1449
|
-
#
|
1450
|
-
# address that you want Route 53 to return in response to DNS queries,
|
1451
|
-
# for example, `192.0.2.44`.
|
1506
|
+
# AWS\_INSTANCE\_IPV4
|
1452
1507
|
#
|
1453
|
-
#
|
1454
|
-
#
|
1455
|
-
#
|
1456
|
-
# `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
|
1508
|
+
# : If the service configuration includes an `A` record, the IPv4
|
1509
|
+
# address that you want Route 53 to return in response to DNS
|
1510
|
+
# queries, for example, `192.0.2.44`.
|
1457
1511
|
#
|
1458
|
-
#
|
1512
|
+
# This value is required if the service specified by `ServiceId`
|
1513
|
+
# includes settings for an `A` record. If the service includes
|
1514
|
+
# settings for an `SRV` record, you must specify a value for
|
1515
|
+
# `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
|
1459
1516
|
#
|
1460
|
-
#
|
1461
|
-
# address that you want Route 53 to return in response to DNS queries,
|
1462
|
-
# for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
|
1517
|
+
# AWS\_INSTANCE\_IPV6
|
1463
1518
|
#
|
1464
|
-
#
|
1465
|
-
#
|
1466
|
-
#
|
1467
|
-
# `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
|
1519
|
+
# : If the service configuration includes an `AAAA` record, the IPv6
|
1520
|
+
# address that you want Route 53 to return in response to DNS
|
1521
|
+
# queries, for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
|
1468
1522
|
#
|
1469
|
-
#
|
1523
|
+
# This value is required if the service specified by `ServiceId`
|
1524
|
+
# includes settings for an `AAAA` record. If the service includes
|
1525
|
+
# settings for an `SRV` record, you must specify a value for
|
1526
|
+
# `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
|
1470
1527
|
#
|
1471
|
-
#
|
1472
|
-
# Route 53 to return for the port.
|
1528
|
+
# AWS\_INSTANCE\_PORT
|
1473
1529
|
#
|
1474
|
-
# If the service includes `
|
1475
|
-
#
|
1530
|
+
# : If the service includes an `SRV` record, the value that you want
|
1531
|
+
# Route 53 to return for the port.
|
1476
1532
|
#
|
1477
|
-
#
|
1478
|
-
#
|
1533
|
+
# If the service includes `HealthCheckConfig`, the port on the
|
1534
|
+
# endpoint that you want Route 53 to send requests to.
|
1479
1535
|
#
|
1536
|
+
# This value is required if you specified settings for an `SRV`
|
1537
|
+
# record or a Route 53 health check when you created the service.
|
1480
1538
|
#
|
1481
1539
|
#
|
1482
|
-
#
|
1540
|
+
#
|
1541
|
+
# [1]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-DNSName
|
1483
1542
|
# @return [Hash<String,String>]
|
1484
1543
|
#
|
1485
1544
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/Instance AWS API Documentation
|
@@ -1523,31 +1582,48 @@ module Aws::ServiceDiscovery
|
|
1523
1582
|
#
|
1524
1583
|
# Supported attribute keys include the following:
|
1525
1584
|
#
|
1526
|
-
#
|
1527
|
-
#
|
1528
|
-
#
|
1585
|
+
# AWS\_ALIAS\_DNS\_NAME
|
1586
|
+
#
|
1587
|
+
# : For an alias record that routes traffic to an Elastic Load
|
1588
|
+
# Balancing load balancer, the DNS name that is associated with the
|
1589
|
+
# load balancer.
|
1529
1590
|
#
|
1530
|
-
#
|
1531
|
-
# instance ID for the instance. When the `AWS_EC2_INSTANCE_ID`
|
1532
|
-
# attribute is specified, then the `AWS_INSTANCE_IPV4` attribute
|
1533
|
-
# contains the primary private IPv4 address.
|
1591
|
+
# AWS\_EC2\_INSTANCE\_ID (HTTP namespaces only)
|
1534
1592
|
#
|
1535
|
-
#
|
1536
|
-
#
|
1537
|
-
# `
|
1593
|
+
# : The Amazon EC2 instance ID for the instance. When the
|
1594
|
+
# `AWS_EC2_INSTANCE_ID` attribute is specified, then the
|
1595
|
+
# `AWS_INSTANCE_IPV4` attribute contains the primary private IPv4
|
1596
|
+
# address.
|
1538
1597
|
#
|
1539
|
-
#
|
1540
|
-
# Route 53 returns in response to DNS queries, for example,
|
1541
|
-
# `192.0.2.44`.
|
1598
|
+
# AWS\_INIT\_HEALTH\_STATUS
|
1542
1599
|
#
|
1543
|
-
#
|
1544
|
-
#
|
1600
|
+
# : If the service configuration includes `HealthCheckCustomConfig`,
|
1601
|
+
# you can optionally use `AWS_INIT_HEALTH_STATUS` to specify the
|
1602
|
+
# initial status of the custom health check, `HEALTHY` or
|
1603
|
+
# `UNHEALTHY`. If you don't specify a value for
|
1604
|
+
# `AWS_INIT_HEALTH_STATUS`, the initial status is `HEALTHY`.
|
1605
|
+
#
|
1606
|
+
# AWS\_INSTANCE\_CNAME
|
1607
|
+
#
|
1608
|
+
# : For a `CNAME` record, the domain name that Route 53 returns in
|
1609
|
+
# response to DNS queries, for example, `example.com`.
|
1610
|
+
#
|
1611
|
+
# AWS\_INSTANCE\_IPV4
|
1612
|
+
#
|
1613
|
+
# : For an `A` record, the IPv4 address that Route 53 returns in
|
1614
|
+
# response to DNS queries, for example, `192.0.2.44`.
|
1615
|
+
#
|
1616
|
+
# AWS\_INSTANCE\_IPV6
|
1617
|
+
#
|
1618
|
+
# : For an `AAAA` record, the IPv6 address that Route 53 returns in
|
1619
|
+
# response to DNS queries, for example,
|
1545
1620
|
# `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
|
1546
1621
|
#
|
1547
|
-
#
|
1548
|
-
#
|
1549
|
-
#
|
1550
|
-
#
|
1622
|
+
# AWS\_INSTANCE\_PORT
|
1623
|
+
#
|
1624
|
+
# : For an `SRV` record, the value that Route 53 returns for the port.
|
1625
|
+
# In addition, if the service includes `HealthCheckConfig`, the port
|
1626
|
+
# on the endpoint that Route 53 sends requests to.
|
1551
1627
|
# @return [Hash<String,String>]
|
1552
1628
|
#
|
1553
1629
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/InstanceSummary AWS API Documentation
|
@@ -1940,14 +2016,20 @@ module Aws::ServiceDiscovery
|
|
1940
2016
|
# The type of the namespace. The methods for discovering instances
|
1941
2017
|
# depends on the value that you specify:
|
1942
2018
|
#
|
1943
|
-
#
|
1944
|
-
#
|
2019
|
+
# HTTP
|
2020
|
+
#
|
2021
|
+
# : Instances can be discovered only programmatically, using the AWS
|
2022
|
+
# Cloud Map `DiscoverInstances` API.
|
1945
2023
|
#
|
1946
|
-
#
|
1947
|
-
# queries and using the `DiscoverInstances` API.
|
2024
|
+
# DNS\_PUBLIC
|
1948
2025
|
#
|
1949
|
-
#
|
1950
|
-
#
|
2026
|
+
# : Instances can be discovered using public DNS queries and using the
|
2027
|
+
# `DiscoverInstances` API.
|
2028
|
+
#
|
2029
|
+
# DNS\_PRIVATE
|
2030
|
+
#
|
2031
|
+
# : Instances can be discovered using DNS queries in VPCs and using
|
2032
|
+
# the `DiscoverInstances` API.
|
1951
2033
|
# @return [String]
|
1952
2034
|
#
|
1953
2035
|
# @!attribute [rw] description
|
@@ -1973,7 +2055,7 @@ module Aws::ServiceDiscovery
|
|
1973
2055
|
#
|
1974
2056
|
# @!attribute [rw] creator_request_id
|
1975
2057
|
# A unique string that identifies the request and that allows failed
|
1976
|
-
# requests to be retried without the risk of
|
2058
|
+
# requests to be retried without the risk of running an operation
|
1977
2059
|
# twice.
|
1978
2060
|
# @return [String]
|
1979
2061
|
#
|
@@ -2045,14 +2127,20 @@ module Aws::ServiceDiscovery
|
|
2045
2127
|
# `ListNamespaces` returns a namespace. Valid values for `condition`
|
2046
2128
|
# include:
|
2047
2129
|
#
|
2048
|
-
#
|
2049
|
-
#
|
2050
|
-
#
|
2130
|
+
# EQ
|
2131
|
+
#
|
2132
|
+
# : When you specify `EQ` for the condition, you can choose to list
|
2133
|
+
# only public namespaces or private namespaces, but not both. `EQ`
|
2134
|
+
# is the default condition and can be omitted.
|
2135
|
+
#
|
2136
|
+
# IN
|
2051
2137
|
#
|
2052
|
-
#
|
2053
|
-
#
|
2138
|
+
# : When you specify `IN` for the condition, you can choose to list
|
2139
|
+
# public namespaces, private namespaces, or both.
|
2054
2140
|
#
|
2055
|
-
#
|
2141
|
+
# BETWEEN
|
2142
|
+
#
|
2143
|
+
# : Not applicable
|
2056
2144
|
# @return [String]
|
2057
2145
|
#
|
2058
2146
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/NamespaceFilter AWS API Documentation
|
@@ -2129,8 +2217,7 @@ module Aws::ServiceDiscovery
|
|
2129
2217
|
# @return [Integer]
|
2130
2218
|
#
|
2131
2219
|
# @!attribute [rw] properties
|
2132
|
-
#
|
2133
|
-
# namespace type.
|
2220
|
+
# The properties of the namespace.
|
2134
2221
|
# @return [Types::NamespaceProperties]
|
2135
2222
|
#
|
2136
2223
|
# @!attribute [rw] create_date
|
@@ -2165,15 +2252,21 @@ module Aws::ServiceDiscovery
|
|
2165
2252
|
# @!attribute [rw] status
|
2166
2253
|
# The status of the operation. Values include the following:
|
2167
2254
|
#
|
2168
|
-
#
|
2169
|
-
# submit a request.
|
2255
|
+
# SUBMITTED
|
2170
2256
|
#
|
2171
|
-
#
|
2257
|
+
# : This is the initial state immediately after you submit a request.
|
2172
2258
|
#
|
2173
|
-
#
|
2259
|
+
# PENDING
|
2174
2260
|
#
|
2175
|
-
#
|
2176
|
-
#
|
2261
|
+
# : AWS Cloud Map is performing the operation.
|
2262
|
+
#
|
2263
|
+
# SUCCESS
|
2264
|
+
#
|
2265
|
+
# : The operation succeeded.
|
2266
|
+
#
|
2267
|
+
# FAIL
|
2268
|
+
#
|
2269
|
+
# : The operation failed. For the failure reason, see `ErrorMessage`.
|
2177
2270
|
# @return [String]
|
2178
2271
|
#
|
2179
2272
|
# @!attribute [rw] error_message
|
@@ -2219,14 +2312,17 @@ module Aws::ServiceDiscovery
|
|
2219
2312
|
# @!attribute [rw] targets
|
2220
2313
|
# The name of the target entity that is associated with the operation:
|
2221
2314
|
#
|
2222
|
-
#
|
2223
|
-
# property.
|
2315
|
+
# NAMESPACE
|
2224
2316
|
#
|
2225
|
-
#
|
2226
|
-
# property.
|
2317
|
+
# : The namespace ID is returned in the `ResourceId` property.
|
2227
2318
|
#
|
2228
|
-
#
|
2229
|
-
#
|
2319
|
+
# SERVICE
|
2320
|
+
#
|
2321
|
+
# : The service ID is returned in the `ResourceId` property.
|
2322
|
+
#
|
2323
|
+
# INSTANCE
|
2324
|
+
#
|
2325
|
+
# : The instance ID is returned in the `ResourceId` property.
|
2230
2326
|
# @return [Hash<String,String>]
|
2231
2327
|
#
|
2232
2328
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/Operation AWS API Documentation
|
@@ -2375,7 +2471,7 @@ module Aws::ServiceDiscovery
|
|
2375
2471
|
#
|
2376
2472
|
# {
|
2377
2473
|
# service_id: "ResourceId", # required
|
2378
|
-
# instance_id: "
|
2474
|
+
# instance_id: "InstanceId", # required
|
2379
2475
|
# creator_request_id: "ResourceId",
|
2380
2476
|
# attributes: { # required
|
2381
2477
|
# "AttrKey" => "AttrValue",
|
@@ -2442,101 +2538,102 @@ module Aws::ServiceDiscovery
|
|
2442
2538
|
#
|
2443
2539
|
# Supported attribute keys include the following:
|
2444
2540
|
#
|
2445
|
-
#
|
2541
|
+
# AWS\_ALIAS\_DNS\_NAME
|
2446
2542
|
#
|
2447
|
-
# If you want AWS Cloud Map to create an Amazon Route 53 alias
|
2448
|
-
#
|
2449
|
-
#
|
2450
|
-
#
|
2451
|
-
#
|
2543
|
+
# : If you want AWS Cloud Map to create an Amazon Route 53 alias
|
2544
|
+
# record that routes traffic to an Elastic Load Balancing load
|
2545
|
+
# balancer, specify the DNS name that is associated with the load
|
2546
|
+
# balancer. For information about how to get the DNS name, see
|
2547
|
+
# "DNSName" in the topic [AliasTarget][1] in the *Route 53 API
|
2548
|
+
# Reference*.
|
2452
2549
|
#
|
2453
|
-
#
|
2550
|
+
# Note the following:
|
2454
2551
|
#
|
2455
|
-
#
|
2456
|
-
#
|
2457
|
-
#
|
2552
|
+
# * The configuration for the service that is specified by
|
2553
|
+
# `ServiceId` must include settings for an `A` record, an `AAAA`
|
2554
|
+
# record, or both.
|
2458
2555
|
#
|
2459
|
-
#
|
2460
|
-
#
|
2556
|
+
# * In the service that is specified by `ServiceId`, the value of
|
2557
|
+
# `RoutingPolicy` must be `WEIGHTED`.
|
2461
2558
|
#
|
2462
|
-
#
|
2463
|
-
#
|
2464
|
-
#
|
2465
|
-
#
|
2559
|
+
# * If the service that is specified by `ServiceId` includes
|
2560
|
+
# `HealthCheckConfig` settings, AWS Cloud Map will create the
|
2561
|
+
# Route 53 health check, but it doesn't associate the health
|
2562
|
+
# check with the alias record.
|
2466
2563
|
#
|
2467
|
-
#
|
2468
|
-
#
|
2469
|
-
#
|
2564
|
+
# * Auto naming currently doesn't support creating alias records
|
2565
|
+
# that route traffic to AWS resources other than Elastic Load
|
2566
|
+
# Balancing load balancers.
|
2470
2567
|
#
|
2471
|
-
#
|
2472
|
-
#
|
2568
|
+
# * If you specify a value for `AWS_ALIAS_DNS_NAME`, don't specify
|
2569
|
+
# values for any of the `AWS_INSTANCE` attributes.
|
2473
2570
|
#
|
2474
|
-
#
|
2571
|
+
# AWS\_EC2\_INSTANCE\_ID
|
2475
2572
|
#
|
2476
|
-
# *HTTP namespaces only.* The Amazon EC2 instance ID for the
|
2477
|
-
#
|
2478
|
-
#
|
2479
|
-
#
|
2480
|
-
#
|
2481
|
-
#
|
2573
|
+
# : *HTTP namespaces only.* The Amazon EC2 instance ID for the
|
2574
|
+
# instance. If the `AWS_EC2_INSTANCE_ID` attribute is specified,
|
2575
|
+
# then the only other attribute that can be specified is
|
2576
|
+
# `AWS_INIT_HEALTH_STATUS`. When the `AWS_EC2_INSTANCE_ID` attribute
|
2577
|
+
# is specified, then the `AWS_INSTANCE_IPV4` attribute will be
|
2578
|
+
# filled out with the primary private IPv4 address.
|
2482
2579
|
#
|
2483
|
-
#
|
2580
|
+
# AWS\_INIT\_HEALTH\_STATUS
|
2484
2581
|
#
|
2485
|
-
# If the service configuration includes `HealthCheckCustomConfig`,
|
2486
|
-
#
|
2487
|
-
#
|
2488
|
-
#
|
2489
|
-
#
|
2582
|
+
# : If the service configuration includes `HealthCheckCustomConfig`,
|
2583
|
+
# you can optionally use `AWS_INIT_HEALTH_STATUS` to specify the
|
2584
|
+
# initial status of the custom health check, `HEALTHY` or
|
2585
|
+
# `UNHEALTHY`. If you don't specify a value for
|
2586
|
+
# `AWS_INIT_HEALTH_STATUS`, the initial status is `HEALTHY`.
|
2490
2587
|
#
|
2491
|
-
#
|
2588
|
+
# AWS\_INSTANCE\_CNAME
|
2492
2589
|
#
|
2493
|
-
# If the service configuration includes a `CNAME` record, the domain
|
2494
|
-
#
|
2495
|
-
#
|
2590
|
+
# : If the service configuration includes a `CNAME` record, the domain
|
2591
|
+
# name that you want Route 53 to return in response to DNS queries,
|
2592
|
+
# for example, `example.com`.
|
2496
2593
|
#
|
2497
|
-
#
|
2498
|
-
#
|
2594
|
+
# This value is required if the service specified by `ServiceId`
|
2595
|
+
# includes settings for an `CNAME` record.
|
2499
2596
|
#
|
2500
|
-
#
|
2597
|
+
# AWS\_INSTANCE\_IPV4
|
2501
2598
|
#
|
2502
|
-
# If the service configuration includes an `A` record, the IPv4
|
2503
|
-
#
|
2504
|
-
#
|
2599
|
+
# : If the service configuration includes an `A` record, the IPv4
|
2600
|
+
# address that you want Route 53 to return in response to DNS
|
2601
|
+
# queries, for example, `192.0.2.44`.
|
2505
2602
|
#
|
2506
|
-
#
|
2507
|
-
#
|
2508
|
-
#
|
2509
|
-
#
|
2603
|
+
# This value is required if the service specified by `ServiceId`
|
2604
|
+
# includes settings for an `A` record. If the service includes
|
2605
|
+
# settings for an `SRV` record, you must specify a value for
|
2606
|
+
# `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
|
2510
2607
|
#
|
2511
|
-
#
|
2608
|
+
# AWS\_INSTANCE\_IPV6
|
2512
2609
|
#
|
2513
|
-
# If the service configuration includes an `AAAA` record, the IPv6
|
2514
|
-
#
|
2515
|
-
#
|
2610
|
+
# : If the service configuration includes an `AAAA` record, the IPv6
|
2611
|
+
# address that you want Route 53 to return in response to DNS
|
2612
|
+
# queries, for example, `2001:0db8:85a3:0000:0000:abcd:0001:2345`.
|
2516
2613
|
#
|
2517
|
-
#
|
2518
|
-
#
|
2519
|
-
#
|
2520
|
-
#
|
2614
|
+
# This value is required if the service specified by `ServiceId`
|
2615
|
+
# includes settings for an `AAAA` record. If the service includes
|
2616
|
+
# settings for an `SRV` record, you must specify a value for
|
2617
|
+
# `AWS_INSTANCE_IPV4`, `AWS_INSTANCE_IPV6`, or both.
|
2521
2618
|
#
|
2522
|
-
#
|
2619
|
+
# AWS\_INSTANCE\_PORT
|
2523
2620
|
#
|
2524
|
-
# If the service includes an `SRV` record, the value that you want
|
2525
|
-
#
|
2621
|
+
# : If the service includes an `SRV` record, the value that you want
|
2622
|
+
# Route 53 to return for the port.
|
2526
2623
|
#
|
2527
|
-
#
|
2528
|
-
#
|
2624
|
+
# If the service includes `HealthCheckConfig`, the port on the
|
2625
|
+
# endpoint that you want Route 53 to send requests to.
|
2529
2626
|
#
|
2530
|
-
#
|
2531
|
-
#
|
2627
|
+
# This value is required if you specified settings for an `SRV`
|
2628
|
+
# record or a Route 53 health check when you created the service.
|
2532
2629
|
#
|
2533
|
-
#
|
2630
|
+
# Custom attributes
|
2534
2631
|
#
|
2535
|
-
# You can add up to 30 custom attributes. For each key-value pair,
|
2536
|
-
#
|
2537
|
-
#
|
2538
|
-
#
|
2539
|
-
#
|
2632
|
+
# : You can add up to 30 custom attributes. For each key-value pair,
|
2633
|
+
# the maximum length of the attribute name is 255 characters, and
|
2634
|
+
# the maximum length of the attribute value is 1,024 characters. The
|
2635
|
+
# total size of all provided attributes (sum of all keys and values)
|
2636
|
+
# must not exceed 5,000 characters.
|
2540
2637
|
#
|
2541
2638
|
#
|
2542
2639
|
#
|
@@ -2671,6 +2768,25 @@ module Aws::ServiceDiscovery
|
|
2671
2768
|
# instance.
|
2672
2769
|
# @return [Types::DnsConfig]
|
2673
2770
|
#
|
2771
|
+
# @!attribute [rw] type
|
2772
|
+
# Describes the systems that can be used to discover the service
|
2773
|
+
# instances.
|
2774
|
+
#
|
2775
|
+
# DNS\_HTTP
|
2776
|
+
#
|
2777
|
+
# : The service instances can be discovered using either DNS queries
|
2778
|
+
# or the `DiscoverInstances` API operation.
|
2779
|
+
#
|
2780
|
+
# HTTP
|
2781
|
+
#
|
2782
|
+
# : The service instances can only be discovered using the
|
2783
|
+
# `DiscoverInstances` API operation.
|
2784
|
+
#
|
2785
|
+
# DNS
|
2786
|
+
#
|
2787
|
+
# : Reserved.
|
2788
|
+
# @return [String]
|
2789
|
+
#
|
2674
2790
|
# @!attribute [rw] health_check_config
|
2675
2791
|
# *Public DNS and HTTP namespaces only.* A complex type that contains
|
2676
2792
|
# settings for an optional health check. If you specify settings for a
|
@@ -2702,9 +2818,9 @@ module Aws::ServiceDiscovery
|
|
2702
2818
|
#
|
2703
2819
|
# @!attribute [rw] creator_request_id
|
2704
2820
|
# A unique string that identifies the request and that allows failed
|
2705
|
-
# requests to be retried without the risk of
|
2821
|
+
# requests to be retried without the risk of running the operation
|
2706
2822
|
# twice. `CreatorRequestId` can be any unique string, for example, a
|
2707
|
-
# date/
|
2823
|
+
# date/timestamp.
|
2708
2824
|
# @return [String]
|
2709
2825
|
#
|
2710
2826
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/Service AWS API Documentation
|
@@ -2717,6 +2833,7 @@ module Aws::ServiceDiscovery
|
|
2717
2833
|
:description,
|
2718
2834
|
:instance_count,
|
2719
2835
|
:dns_config,
|
2836
|
+
:type,
|
2720
2837
|
:health_check_config,
|
2721
2838
|
:health_check_custom_config,
|
2722
2839
|
:create_date,
|
@@ -2776,81 +2893,15 @@ module Aws::ServiceDiscovery
|
|
2776
2893
|
# @return [String]
|
2777
2894
|
#
|
2778
2895
|
# @!attribute [rw] dns_config
|
2779
|
-
#
|
2780
|
-
#
|
2781
|
-
# instance.
|
2896
|
+
# Information about the Route 53 DNS records that you want AWS Cloud
|
2897
|
+
# Map to create when you register an instance.
|
2782
2898
|
# @return [Types::DnsConfigChange]
|
2783
2899
|
#
|
2784
2900
|
# @!attribute [rw] health_check_config
|
2785
|
-
# *Public DNS and HTTP namespaces only.*
|
2786
|
-
#
|
2787
|
-
#
|
2788
|
-
#
|
2789
|
-
#
|
2790
|
-
# If you specify a health check configuration, you can specify either
|
2791
|
-
# `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
|
2792
|
-
#
|
2793
|
-
# Health checks are basic Route 53 health checks that monitor an AWS
|
2794
|
-
# endpoint. For information about pricing for health checks, see
|
2795
|
-
# [Amazon Route 53 Pricing][1].
|
2796
|
-
#
|
2797
|
-
# Note the following about configuring health checks.
|
2798
|
-
#
|
2799
|
-
# <b> <code>A</code> and <code>AAAA</code> records</b>
|
2800
|
-
#
|
2801
|
-
# If `DnsConfig` includes configurations for both `A` and `AAAA`
|
2802
|
-
# records, AWS Cloud Map creates a health check that uses the IPv4
|
2803
|
-
# address to check the health of the resource. If the endpoint that is
|
2804
|
-
# specified by the IPv4 address is unhealthy, Route 53 considers both
|
2805
|
-
# the `A` and `AAAA` records to be unhealthy.
|
2806
|
-
#
|
2807
|
-
# <b> <code>CNAME</code> records</b>
|
2808
|
-
#
|
2809
|
-
# You can't specify settings for `HealthCheckConfig` when the
|
2810
|
-
# `DNSConfig` includes `CNAME` for the value of `Type`. If you do, the
|
2811
|
-
# `CreateService` request will fail with an `InvalidInput` error.
|
2812
|
-
#
|
2813
|
-
# **Request interval**
|
2814
|
-
#
|
2815
|
-
# A Route 53 health checker in each health-checking region sends a
|
2816
|
-
# health check request to an endpoint every 30 seconds. On average,
|
2817
|
-
# your endpoint receives a health check request about every two
|
2818
|
-
# seconds. However, health checkers don't coordinate with one
|
2819
|
-
# another, so you'll sometimes see several requests per second
|
2820
|
-
# followed by a few seconds with no health checks at all.
|
2821
|
-
#
|
2822
|
-
# **Health checking regions**
|
2823
|
-
#
|
2824
|
-
# Health checkers perform checks from all Route 53 health-checking
|
2825
|
-
# regions. For a list of the current regions, see [Regions][2].
|
2826
|
-
#
|
2827
|
-
# **Alias records**
|
2828
|
-
#
|
2829
|
-
# When you register an instance, if you include the
|
2830
|
-
# `AWS_ALIAS_DNS_NAME` attribute, AWS Cloud Map creates a Route 53
|
2831
|
-
# alias record. Note the following:
|
2832
|
-
#
|
2833
|
-
# * Route 53 automatically sets `EvaluateTargetHealth` to true for
|
2834
|
-
# alias records. When `EvaluateTargetHealth` is true, the alias
|
2835
|
-
# record inherits the health of the referenced AWS resource. such as
|
2836
|
-
# an ELB load balancer. For more information, see
|
2837
|
-
# [EvaluateTargetHealth][3].
|
2838
|
-
#
|
2839
|
-
# * If you include `HealthCheckConfig` and then use the service to
|
2840
|
-
# register an instance that creates an alias record, Route 53
|
2841
|
-
# doesn't create the health check.
|
2842
|
-
#
|
2843
|
-
# **Charges for health checks**
|
2844
|
-
#
|
2845
|
-
# Health checks are basic Route 53 health checks that monitor an AWS
|
2846
|
-
# endpoint. For information about pricing for health checks, see
|
2847
|
-
# [Amazon Route 53 Pricing][1].
|
2848
|
-
#
|
2849
|
-
#
|
2850
|
-
#
|
2851
|
-
# [1]: http://aws.amazon.com/route53/pricing/
|
2852
|
-
# [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_HealthCheckConfig.html#Route53-Type-HealthCheckConfig-Regions
|
2853
|
-
# [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth
|
2901
|
+
# *Public DNS and HTTP namespaces only.* Settings for an optional
|
2902
|
+
# health check. If you specify settings for a health check, AWS Cloud
|
2903
|
+
# Map associates the health check with the records that you specify in
|
2904
|
+
# `DnsConfig`.
|
2854
2905
|
# @return [Types::HealthCheckConfig]
|
2855
2906
|
#
|
2856
2907
|
# @see http://docs.aws.amazon.com/goto/WebAPI/servicediscovery-2017-03-14/ServiceChange AWS API Documentation
|
@@ -2938,6 +2989,25 @@ module Aws::ServiceDiscovery
|
|
2938
2989
|
# The name of the service.
|
2939
2990
|
# @return [String]
|
2940
2991
|
#
|
2992
|
+
# @!attribute [rw] type
|
2993
|
+
# Describes the systems that can be used to discover the service
|
2994
|
+
# instances.
|
2995
|
+
#
|
2996
|
+
# DNS\_HTTP
|
2997
|
+
#
|
2998
|
+
# : The service instances can be discovered using either DNS queries
|
2999
|
+
# or the `DiscoverInstances` API operation.
|
3000
|
+
#
|
3001
|
+
# HTTP
|
3002
|
+
#
|
3003
|
+
# : The service instances can only be discovered using the
|
3004
|
+
# `DiscoverInstances` API operation.
|
3005
|
+
#
|
3006
|
+
# DNS
|
3007
|
+
#
|
3008
|
+
# : Reserved.
|
3009
|
+
# @return [String]
|
3010
|
+
#
|
2941
3011
|
# @!attribute [rw] description
|
2942
3012
|
# The description that you specify when you create the service.
|
2943
3013
|
# @return [String]
|
@@ -2950,88 +3020,22 @@ module Aws::ServiceDiscovery
|
|
2950
3020
|
# @return [Integer]
|
2951
3021
|
#
|
2952
3022
|
# @!attribute [rw] dns_config
|
2953
|
-
#
|
2954
|
-
#
|
2955
|
-
# an instance.
|
3023
|
+
# Information about the Route 53 DNS records that you want AWS Cloud
|
3024
|
+
# Map to create when you register an instance.
|
2956
3025
|
# @return [Types::DnsConfig]
|
2957
3026
|
#
|
2958
3027
|
# @!attribute [rw] health_check_config
|
2959
|
-
# *Public DNS and HTTP namespaces only.*
|
2960
|
-
#
|
2961
|
-
#
|
2962
|
-
#
|
2963
|
-
#
|
2964
|
-
# If you specify a health check configuration, you can specify either
|
2965
|
-
# `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
|
2966
|
-
#
|
2967
|
-
# Health checks are basic Route 53 health checks that monitor an AWS
|
2968
|
-
# endpoint. For information about pricing for health checks, see
|
2969
|
-
# [Amazon Route 53 Pricing][1].
|
2970
|
-
#
|
2971
|
-
# Note the following about configuring health checks.
|
2972
|
-
#
|
2973
|
-
# <b> <code>A</code> and <code>AAAA</code> records</b>
|
2974
|
-
#
|
2975
|
-
# If `DnsConfig` includes configurations for both `A` and `AAAA`
|
2976
|
-
# records, AWS Cloud Map creates a health check that uses the IPv4
|
2977
|
-
# address to check the health of the resource. If the endpoint that is
|
2978
|
-
# specified by the IPv4 address is unhealthy, Route 53 considers both
|
2979
|
-
# the `A` and `AAAA` records to be unhealthy.
|
2980
|
-
#
|
2981
|
-
# <b> <code>CNAME</code> records</b>
|
2982
|
-
#
|
2983
|
-
# You can't specify settings for `HealthCheckConfig` when the
|
2984
|
-
# `DNSConfig` includes `CNAME` for the value of `Type`. If you do, the
|
2985
|
-
# `CreateService` request will fail with an `InvalidInput` error.
|
2986
|
-
#
|
2987
|
-
# **Request interval**
|
2988
|
-
#
|
2989
|
-
# A Route 53 health checker in each health-checking region sends a
|
2990
|
-
# health check request to an endpoint every 30 seconds. On average,
|
2991
|
-
# your endpoint receives a health check request about every two
|
2992
|
-
# seconds. However, health checkers don't coordinate with one
|
2993
|
-
# another, so you'll sometimes see several requests per second
|
2994
|
-
# followed by a few seconds with no health checks at all.
|
2995
|
-
#
|
2996
|
-
# **Health checking regions**
|
2997
|
-
#
|
2998
|
-
# Health checkers perform checks from all Route 53 health-checking
|
2999
|
-
# regions. For a list of the current regions, see [Regions][2].
|
3000
|
-
#
|
3001
|
-
# **Alias records**
|
3002
|
-
#
|
3003
|
-
# When you register an instance, if you include the
|
3004
|
-
# `AWS_ALIAS_DNS_NAME` attribute, AWS Cloud Map creates a Route 53
|
3005
|
-
# alias record. Note the following:
|
3006
|
-
#
|
3007
|
-
# * Route 53 automatically sets `EvaluateTargetHealth` to true for
|
3008
|
-
# alias records. When `EvaluateTargetHealth` is true, the alias
|
3009
|
-
# record inherits the health of the referenced AWS resource. such as
|
3010
|
-
# an ELB load balancer. For more information, see
|
3011
|
-
# [EvaluateTargetHealth][3].
|
3012
|
-
#
|
3013
|
-
# * If you include `HealthCheckConfig` and then use the service to
|
3014
|
-
# register an instance that creates an alias record, Route 53
|
3015
|
-
# doesn't create the health check.
|
3016
|
-
#
|
3017
|
-
# **Charges for health checks**
|
3018
|
-
#
|
3019
|
-
# Health checks are basic Route 53 health checks that monitor an AWS
|
3020
|
-
# endpoint. For information about pricing for health checks, see
|
3021
|
-
# [Amazon Route 53 Pricing][1].
|
3022
|
-
#
|
3023
|
-
#
|
3024
|
-
#
|
3025
|
-
# [1]: http://aws.amazon.com/route53/pricing/
|
3026
|
-
# [2]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_HealthCheckConfig.html#Route53-Type-HealthCheckConfig-Regions
|
3027
|
-
# [3]: https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html#Route53-Type-AliasTarget-EvaluateTargetHealth
|
3028
|
+
# *Public DNS and HTTP namespaces only.* Settings for an optional
|
3029
|
+
# health check. If you specify settings for a health check, AWS Cloud
|
3030
|
+
# Map associates the health check with the records that you specify in
|
3031
|
+
# `DnsConfig`.
|
3028
3032
|
# @return [Types::HealthCheckConfig]
|
3029
3033
|
#
|
3030
3034
|
# @!attribute [rw] health_check_custom_config
|
3031
|
-
#
|
3032
|
-
#
|
3033
|
-
#
|
3034
|
-
#
|
3035
|
+
# Information about an optional custom health check. A custom health
|
3036
|
+
# check, which requires that you use a third-party health checker to
|
3037
|
+
# evaluate the health of your resources, is useful in the following
|
3038
|
+
# circumstances:
|
3035
3039
|
#
|
3036
3040
|
# * You can't use a health check that is defined by
|
3037
3041
|
# `HealthCheckConfig` because the resource isn't available over the
|
@@ -3044,48 +3048,6 @@ module Aws::ServiceDiscovery
|
|
3044
3048
|
#
|
3045
3049
|
# If you specify a health check configuration, you can specify either
|
3046
3050
|
# `HealthCheckCustomConfig` or `HealthCheckConfig` but not both.
|
3047
|
-
#
|
3048
|
-
# To change the status of a custom health check, submit an
|
3049
|
-
# `UpdateInstanceCustomHealthStatus` request. AWS Cloud Map doesn't
|
3050
|
-
# monitor the status of the resource, it just keeps a record of the
|
3051
|
-
# status specified in the most recent
|
3052
|
-
# `UpdateInstanceCustomHealthStatus` request.
|
3053
|
-
#
|
3054
|
-
# Here's how custom health checks work:
|
3055
|
-
#
|
3056
|
-
# 1. You create a service and specify a value for `FailureThreshold`.
|
3057
|
-
#
|
3058
|
-
# The failure threshold indicates the number of 30-second
|
3059
|
-
# intervals you want AWS Cloud Map to wait between the time that
|
3060
|
-
# your application sends an [UpdateInstanceCustomHealthStatus][1]
|
3061
|
-
# request and the time that AWS Cloud Map stops routing internet
|
3062
|
-
# traffic to the corresponding resource.
|
3063
|
-
#
|
3064
|
-
# 2. You register an instance.
|
3065
|
-
#
|
3066
|
-
# 3. You configure a third-party health checker to monitor the
|
3067
|
-
# resource that is associated with the new instance.
|
3068
|
-
#
|
3069
|
-
# <note markdown="1"> AWS Cloud Map doesn't check the health of the resource
|
3070
|
-
# directly.
|
3071
|
-
#
|
3072
|
-
# </note>
|
3073
|
-
#
|
3074
|
-
# 4. The third-party health-checker determines that the resource is
|
3075
|
-
# unhealthy and notifies your application.
|
3076
|
-
#
|
3077
|
-
# 5. Your application submits an `UpdateInstanceCustomHealthStatus`
|
3078
|
-
# request.
|
3079
|
-
#
|
3080
|
-
# 6. AWS Cloud Map waits for (`FailureThreshold` x 30) seconds.
|
3081
|
-
#
|
3082
|
-
# 7. If another `UpdateInstanceCustomHealthStatus` request doesn't
|
3083
|
-
# arrive during that time to change the status back to healthy,
|
3084
|
-
# AWS Cloud Map stops routing traffic to the resource.
|
3085
|
-
#
|
3086
|
-
#
|
3087
|
-
#
|
3088
|
-
# [1]: https://docs.aws.amazon.com/cloud-map/latest/api/API_UpdateInstanceCustomHealthStatus.html
|
3089
3051
|
# @return [Types::HealthCheckCustomConfig]
|
3090
3052
|
#
|
3091
3053
|
# @!attribute [rw] create_date
|
@@ -3098,6 +3060,7 @@ module Aws::ServiceDiscovery
|
|
3098
3060
|
:id,
|
3099
3061
|
:arn,
|
3100
3062
|
:name,
|
3063
|
+
:type,
|
3101
3064
|
:description,
|
3102
3065
|
:instance_count,
|
3103
3066
|
:dns_config,
|