aws-sdk-eks 1.0.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 +7 -0
- data/lib/aws-sdk-eks.rb +47 -0
- data/lib/aws-sdk-eks/client.rb +541 -0
- data/lib/aws-sdk-eks/client_api.rb +166 -0
- data/lib/aws-sdk-eks/customizations.rb +0 -0
- data/lib/aws-sdk-eks/errors.rb +14 -0
- data/lib/aws-sdk-eks/resource.rb +23 -0
- data/lib/aws-sdk-eks/types.rb +354 -0
- metadata +82 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA1:
|
3
|
+
metadata.gz: cc5fefa8278a15662556c100f0d8993576e6f250
|
4
|
+
data.tar.gz: be72c019419683c331f1ec7d7610b39a513184c9
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: c02e0338ab1e2edc49148972f679b58f6c67a876f357fb856404ff494d21e23b03de342381d40db6c01692ce412e92a5369b07e91d08da2514801af57a2d1e13
|
7
|
+
data.tar.gz: 491ac5e43b0e1dba768bd32e3b72ea41fd3ec4a18375db8450a4db42b86651044db59e5843104a9416d0e481eb5b275e5c364ef43bbdab744d09b60e609519f2
|
data/lib/aws-sdk-eks.rb
ADDED
@@ -0,0 +1,47 @@
|
|
1
|
+
# WARNING ABOUT GENERATED CODE
|
2
|
+
#
|
3
|
+
# This file is generated. See the contributing guide for more information:
|
4
|
+
# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
|
5
|
+
#
|
6
|
+
# WARNING ABOUT GENERATED CODE
|
7
|
+
|
8
|
+
require 'aws-sdk-core'
|
9
|
+
require 'aws-sigv4'
|
10
|
+
|
11
|
+
require_relative 'aws-sdk-eks/types'
|
12
|
+
require_relative 'aws-sdk-eks/client_api'
|
13
|
+
require_relative 'aws-sdk-eks/client'
|
14
|
+
require_relative 'aws-sdk-eks/errors'
|
15
|
+
require_relative 'aws-sdk-eks/resource'
|
16
|
+
require_relative 'aws-sdk-eks/customizations'
|
17
|
+
|
18
|
+
# This module provides support for Amazon Elastic Container Service for Kubernetes. This module is available in the
|
19
|
+
# `aws-sdk-eks` gem.
|
20
|
+
#
|
21
|
+
# # Client
|
22
|
+
#
|
23
|
+
# The {Client} class provides one method for each API operation. Operation
|
24
|
+
# methods each accept a hash of request parameters and return a response
|
25
|
+
# structure.
|
26
|
+
#
|
27
|
+
# See {Client} for more information.
|
28
|
+
#
|
29
|
+
# # Errors
|
30
|
+
#
|
31
|
+
# Errors returned from Amazon Elastic Container Service for Kubernetes all
|
32
|
+
# extend {Errors::ServiceError}.
|
33
|
+
#
|
34
|
+
# begin
|
35
|
+
# # do stuff
|
36
|
+
# rescue Aws::EKS::Errors::ServiceError
|
37
|
+
# # rescues all service API errors
|
38
|
+
# end
|
39
|
+
#
|
40
|
+
# See {Errors} for more information.
|
41
|
+
#
|
42
|
+
# @service
|
43
|
+
module Aws::EKS
|
44
|
+
|
45
|
+
GEM_VERSION = '1.0.0'
|
46
|
+
|
47
|
+
end
|
@@ -0,0 +1,541 @@
|
|
1
|
+
# WARNING ABOUT GENERATED CODE
|
2
|
+
#
|
3
|
+
# This file is generated. See the contributing guide for more information:
|
4
|
+
# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
|
5
|
+
#
|
6
|
+
# WARNING ABOUT GENERATED CODE
|
7
|
+
|
8
|
+
require 'seahorse/client/plugins/content_length.rb'
|
9
|
+
require 'aws-sdk-core/plugins/credentials_configuration.rb'
|
10
|
+
require 'aws-sdk-core/plugins/logging.rb'
|
11
|
+
require 'aws-sdk-core/plugins/param_converter.rb'
|
12
|
+
require 'aws-sdk-core/plugins/param_validator.rb'
|
13
|
+
require 'aws-sdk-core/plugins/user_agent.rb'
|
14
|
+
require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
|
15
|
+
require 'aws-sdk-core/plugins/retry_errors.rb'
|
16
|
+
require 'aws-sdk-core/plugins/global_configuration.rb'
|
17
|
+
require 'aws-sdk-core/plugins/regional_endpoint.rb'
|
18
|
+
require 'aws-sdk-core/plugins/response_paging.rb'
|
19
|
+
require 'aws-sdk-core/plugins/stub_responses.rb'
|
20
|
+
require 'aws-sdk-core/plugins/idempotency_token.rb'
|
21
|
+
require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
|
22
|
+
require 'aws-sdk-core/plugins/signature_v4.rb'
|
23
|
+
require 'aws-sdk-core/plugins/protocols/rest_json.rb'
|
24
|
+
|
25
|
+
Aws::Plugins::GlobalConfiguration.add_identifier(:eks)
|
26
|
+
|
27
|
+
module Aws::EKS
|
28
|
+
class Client < Seahorse::Client::Base
|
29
|
+
|
30
|
+
include Aws::ClientStubs
|
31
|
+
|
32
|
+
@identifier = :eks
|
33
|
+
|
34
|
+
set_api(ClientApi::API)
|
35
|
+
|
36
|
+
add_plugin(Seahorse::Client::Plugins::ContentLength)
|
37
|
+
add_plugin(Aws::Plugins::CredentialsConfiguration)
|
38
|
+
add_plugin(Aws::Plugins::Logging)
|
39
|
+
add_plugin(Aws::Plugins::ParamConverter)
|
40
|
+
add_plugin(Aws::Plugins::ParamValidator)
|
41
|
+
add_plugin(Aws::Plugins::UserAgent)
|
42
|
+
add_plugin(Aws::Plugins::HelpfulSocketErrors)
|
43
|
+
add_plugin(Aws::Plugins::RetryErrors)
|
44
|
+
add_plugin(Aws::Plugins::GlobalConfiguration)
|
45
|
+
add_plugin(Aws::Plugins::RegionalEndpoint)
|
46
|
+
add_plugin(Aws::Plugins::ResponsePaging)
|
47
|
+
add_plugin(Aws::Plugins::StubResponses)
|
48
|
+
add_plugin(Aws::Plugins::IdempotencyToken)
|
49
|
+
add_plugin(Aws::Plugins::JsonvalueConverter)
|
50
|
+
add_plugin(Aws::Plugins::SignatureV4)
|
51
|
+
add_plugin(Aws::Plugins::Protocols::RestJson)
|
52
|
+
|
53
|
+
# @option options [required, Aws::CredentialProvider] :credentials
|
54
|
+
# Your AWS credentials. This can be an instance of any one of the
|
55
|
+
# following classes:
|
56
|
+
#
|
57
|
+
# * `Aws::Credentials` - Used for configuring static, non-refreshing
|
58
|
+
# credentials.
|
59
|
+
#
|
60
|
+
# * `Aws::InstanceProfileCredentials` - Used for loading credentials
|
61
|
+
# from an EC2 IMDS on an EC2 instance.
|
62
|
+
#
|
63
|
+
# * `Aws::SharedCredentials` - Used for loading credentials from a
|
64
|
+
# shared file, such as `~/.aws/config`.
|
65
|
+
#
|
66
|
+
# * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
|
67
|
+
#
|
68
|
+
# When `:credentials` are not configured directly, the following
|
69
|
+
# locations will be searched for credentials:
|
70
|
+
#
|
71
|
+
# * `Aws.config[:credentials]`
|
72
|
+
# * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
|
73
|
+
# * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
|
74
|
+
# * `~/.aws/credentials`
|
75
|
+
# * `~/.aws/config`
|
76
|
+
# * EC2 IMDS instance profile - When used by default, the timeouts are
|
77
|
+
# very aggressive. Construct and pass an instance of
|
78
|
+
# `Aws::InstanceProfileCredentails` to enable retries and extended
|
79
|
+
# timeouts.
|
80
|
+
#
|
81
|
+
# @option options [required, String] :region
|
82
|
+
# The AWS region to connect to. The configured `:region` is
|
83
|
+
# used to determine the service `:endpoint`. When not passed,
|
84
|
+
# a default `:region` is search for in the following locations:
|
85
|
+
#
|
86
|
+
# * `Aws.config[:region]`
|
87
|
+
# * `ENV['AWS_REGION']`
|
88
|
+
# * `ENV['AMAZON_REGION']`
|
89
|
+
# * `ENV['AWS_DEFAULT_REGION']`
|
90
|
+
# * `~/.aws/credentials`
|
91
|
+
# * `~/.aws/config`
|
92
|
+
#
|
93
|
+
# @option options [String] :access_key_id
|
94
|
+
#
|
95
|
+
# @option options [Boolean] :convert_params (true)
|
96
|
+
# When `true`, an attempt is made to coerce request parameters into
|
97
|
+
# the required types.
|
98
|
+
#
|
99
|
+
# @option options [String] :endpoint
|
100
|
+
# The client endpoint is normally constructed from the `:region`
|
101
|
+
# option. You should only configure an `:endpoint` when connecting
|
102
|
+
# to test endpoints. This should be avalid HTTP(S) URI.
|
103
|
+
#
|
104
|
+
# @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
|
105
|
+
# The log formatter.
|
106
|
+
#
|
107
|
+
# @option options [Symbol] :log_level (:info)
|
108
|
+
# The log level to send messages to the `:logger` at.
|
109
|
+
#
|
110
|
+
# @option options [Logger] :logger
|
111
|
+
# The Logger instance to send log messages to. If this option
|
112
|
+
# is not set, logging will be disabled.
|
113
|
+
#
|
114
|
+
# @option options [String] :profile ("default")
|
115
|
+
# Used when loading credentials from the shared credentials file
|
116
|
+
# at HOME/.aws/credentials. When not specified, 'default' is used.
|
117
|
+
#
|
118
|
+
# @option options [Integer] :retry_limit (3)
|
119
|
+
# The maximum number of times to retry failed requests. Only
|
120
|
+
# ~ 500 level server errors and certain ~ 400 level client errors
|
121
|
+
# are retried. Generally, these are throttling errors, data
|
122
|
+
# checksum errors, networking errors, timeout errors and auth
|
123
|
+
# errors from expired credentials.
|
124
|
+
#
|
125
|
+
# @option options [String] :secret_access_key
|
126
|
+
#
|
127
|
+
# @option options [String] :session_token
|
128
|
+
#
|
129
|
+
# @option options [Boolean] :stub_responses (false)
|
130
|
+
# Causes the client to return stubbed responses. By default
|
131
|
+
# fake responses are generated and returned. You can specify
|
132
|
+
# the response data to return or errors to raise by calling
|
133
|
+
# {ClientStubs#stub_responses}. See {ClientStubs} for more information.
|
134
|
+
#
|
135
|
+
# ** Please note ** When response stubbing is enabled, no HTTP
|
136
|
+
# requests are made, and retries are disabled.
|
137
|
+
#
|
138
|
+
# @option options [Boolean] :validate_params (true)
|
139
|
+
# When `true`, request parameters are validated before
|
140
|
+
# sending the request.
|
141
|
+
#
|
142
|
+
def initialize(*args)
|
143
|
+
super
|
144
|
+
end
|
145
|
+
|
146
|
+
# @!group API Operations
|
147
|
+
|
148
|
+
# Creates an Amazon EKS control plane.
|
149
|
+
#
|
150
|
+
# The Amazon EKS control plane consists of control plane instances that
|
151
|
+
# run the Kubernetes software, like `etcd` and the API server. The
|
152
|
+
# control plane runs in an account managed by AWS, and the Kubernetes
|
153
|
+
# API is exposed via the Amazon EKS API server endpoint.
|
154
|
+
#
|
155
|
+
# Amazon EKS worker nodes run in your AWS account and connect to your
|
156
|
+
# cluster's control plane via the Kubernetes API server endpoint and a
|
157
|
+
# certificate file that is created for your cluster.
|
158
|
+
#
|
159
|
+
# The cluster control plane is provisioned across multiple Availability
|
160
|
+
# Zones and fronted by an Elastic Load Balancing Network Load Balancer.
|
161
|
+
# Amazon EKS also provisions elastic network interfaces in your VPC
|
162
|
+
# subnets to provide connectivity from the control plane instances to
|
163
|
+
# the worker nodes (for example, to support `kubectl exec`, `logs`, and
|
164
|
+
# `proxy` data flows).
|
165
|
+
#
|
166
|
+
# After you create an Amazon EKS cluster, you must configure your
|
167
|
+
# Kubernetes tooling to communicate with the API server and launch
|
168
|
+
# worker nodes into your cluster. For more information, see [Managing
|
169
|
+
# Cluster Authentication][1] and [Launching Amazon EKS Worker
|
170
|
+
# Nodes][2]in the *Amazon EKS User Guide*.
|
171
|
+
#
|
172
|
+
#
|
173
|
+
#
|
174
|
+
# [1]: http://docs.aws.amazon.com/eks/latest/userguide/managing-auth.html
|
175
|
+
# [2]: http://docs.aws.amazon.com/eks/latest/userguide/launch-workers.html
|
176
|
+
#
|
177
|
+
# @option params [required, String] :name
|
178
|
+
# The unique name to give to your cluster.
|
179
|
+
#
|
180
|
+
# @option params [String] :version
|
181
|
+
# The desired Kubernetes version for your cluster. If you do not specify
|
182
|
+
# a value here, the latest version available in Amazon EKS is used.
|
183
|
+
#
|
184
|
+
# @option params [required, String] :role_arn
|
185
|
+
# The Amazon Resource Name (ARN) of the IAM role that provides
|
186
|
+
# permissions for Amazon EKS to make calls to other AWS API operations
|
187
|
+
# on your behalf. For more information, see [Amazon EKS Service IAM
|
188
|
+
# Role][1] in the <i> <i>Amazon EKS User Guide</i> </i>
|
189
|
+
#
|
190
|
+
#
|
191
|
+
#
|
192
|
+
# [1]: http://docs.aws.amazon.com/eks/latest/userguide/service_IAM_role.html
|
193
|
+
#
|
194
|
+
# @option params [required, Types::VpcConfigRequest] :resources_vpc_config
|
195
|
+
# The VPC subnets and security groups used by the cluster control plane.
|
196
|
+
# Amazon EKS VPC resources have specific requirements to work properly
|
197
|
+
# with Kubernetes. For more information, see [Cluster VPC
|
198
|
+
# Considerations][1] and [Cluster Security Group Considerations][2] in
|
199
|
+
# the *Amazon EKS User Guide*.
|
200
|
+
#
|
201
|
+
#
|
202
|
+
#
|
203
|
+
# [1]: http://docs.aws.amazon.com/eks/latest/userguide/network_reqs.html
|
204
|
+
# [2]: http://docs.aws.amazon.com/eks/latest/userguide/sec-group-reqs.html
|
205
|
+
#
|
206
|
+
# @option params [String] :client_request_token
|
207
|
+
# Unique, case-sensitive identifier you provide to ensure the
|
208
|
+
# idempotency of the request.
|
209
|
+
#
|
210
|
+
# **A suitable default value is auto-generated.** You should normally
|
211
|
+
# not need to pass this option.**
|
212
|
+
#
|
213
|
+
# @return [Types::CreateClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
214
|
+
#
|
215
|
+
# * {Types::CreateClusterResponse#cluster #cluster} => Types::Cluster
|
216
|
+
#
|
217
|
+
#
|
218
|
+
# @example Example: To create a new cluster
|
219
|
+
#
|
220
|
+
# # The following example creates an Amazon EKS cluster called prod.
|
221
|
+
#
|
222
|
+
# resp = client.create_cluster({
|
223
|
+
# version: "1.10",
|
224
|
+
# name: "prod",
|
225
|
+
# client_request_token: "1d2129a1-3d38-460a-9756-e5b91fddb951",
|
226
|
+
# resources_vpc_config: {
|
227
|
+
# security_group_ids: [
|
228
|
+
# "sg-6979fe18",
|
229
|
+
# ],
|
230
|
+
# subnet_ids: [
|
231
|
+
# "subnet-6782e71e",
|
232
|
+
# "subnet-e7e761ac",
|
233
|
+
# ],
|
234
|
+
# },
|
235
|
+
# role_arn: "arn:aws:iam::012345678910:role/eks-service-role-AWSServiceRoleForAmazonEKS-J7ONKE3BQ4PI",
|
236
|
+
# })
|
237
|
+
#
|
238
|
+
# resp.to_h outputs the following:
|
239
|
+
# {
|
240
|
+
# }
|
241
|
+
#
|
242
|
+
# @example Request syntax with placeholder values
|
243
|
+
#
|
244
|
+
# resp = client.create_cluster({
|
245
|
+
# name: "ClusterName", # required
|
246
|
+
# version: "String",
|
247
|
+
# role_arn: "String", # required
|
248
|
+
# resources_vpc_config: { # required
|
249
|
+
# subnet_ids: ["String"], # required
|
250
|
+
# security_group_ids: ["String"],
|
251
|
+
# },
|
252
|
+
# client_request_token: "String",
|
253
|
+
# })
|
254
|
+
#
|
255
|
+
# @example Response structure
|
256
|
+
#
|
257
|
+
# resp.cluster.name #=> String
|
258
|
+
# resp.cluster.arn #=> String
|
259
|
+
# resp.cluster.created_at #=> Time
|
260
|
+
# resp.cluster.version #=> String
|
261
|
+
# resp.cluster.endpoint #=> String
|
262
|
+
# resp.cluster.role_arn #=> String
|
263
|
+
# resp.cluster.resources_vpc_config.subnet_ids #=> Array
|
264
|
+
# resp.cluster.resources_vpc_config.subnet_ids[0] #=> String
|
265
|
+
# resp.cluster.resources_vpc_config.security_group_ids #=> Array
|
266
|
+
# resp.cluster.resources_vpc_config.security_group_ids[0] #=> String
|
267
|
+
# resp.cluster.resources_vpc_config.vpc_id #=> String
|
268
|
+
# resp.cluster.status #=> String, one of "CREATING", "ACTIVE", "DELETING", "FAILED"
|
269
|
+
# resp.cluster.certificate_authority.data #=> String
|
270
|
+
# resp.cluster.client_request_token #=> String
|
271
|
+
#
|
272
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/CreateCluster AWS API Documentation
|
273
|
+
#
|
274
|
+
# @overload create_cluster(params = {})
|
275
|
+
# @param [Hash] params ({})
|
276
|
+
def create_cluster(params = {}, options = {})
|
277
|
+
req = build_request(:create_cluster, params)
|
278
|
+
req.send_request(options)
|
279
|
+
end
|
280
|
+
|
281
|
+
# Deletes the Amazon EKS cluster control plane.
|
282
|
+
#
|
283
|
+
# <note markdown="1"> If you have active services in your cluster that are associated with a
|
284
|
+
# load balancer, you must delete those services before deleting the
|
285
|
+
# cluster so that the load balancers are deleted properly. Otherwise,
|
286
|
+
# you can have orphaned resources in your VPC that prevent you from
|
287
|
+
# being able to delete the VPC. For more information, see [Deleting a
|
288
|
+
# Cluster][1] in the *Amazon EKS User Guide*.
|
289
|
+
#
|
290
|
+
# </note>
|
291
|
+
#
|
292
|
+
#
|
293
|
+
#
|
294
|
+
# [1]: http://docs.aws.amazon.com/eks/latest/userguide/delete-cluster.html
|
295
|
+
#
|
296
|
+
# @option params [required, String] :name
|
297
|
+
# The name of the cluster to delete.
|
298
|
+
#
|
299
|
+
# @return [Types::DeleteClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
300
|
+
#
|
301
|
+
# * {Types::DeleteClusterResponse#cluster #cluster} => Types::Cluster
|
302
|
+
#
|
303
|
+
#
|
304
|
+
# @example Example: To delete a cluster
|
305
|
+
#
|
306
|
+
# # This example command deletes a cluster named `devel` in your default region.
|
307
|
+
#
|
308
|
+
# resp = client.delete_cluster({
|
309
|
+
# name: "devel",
|
310
|
+
# })
|
311
|
+
#
|
312
|
+
# resp.to_h outputs the following:
|
313
|
+
# {
|
314
|
+
# }
|
315
|
+
#
|
316
|
+
# @example Request syntax with placeholder values
|
317
|
+
#
|
318
|
+
# resp = client.delete_cluster({
|
319
|
+
# name: "String", # required
|
320
|
+
# })
|
321
|
+
#
|
322
|
+
# @example Response structure
|
323
|
+
#
|
324
|
+
# resp.cluster.name #=> String
|
325
|
+
# resp.cluster.arn #=> String
|
326
|
+
# resp.cluster.created_at #=> Time
|
327
|
+
# resp.cluster.version #=> String
|
328
|
+
# resp.cluster.endpoint #=> String
|
329
|
+
# resp.cluster.role_arn #=> String
|
330
|
+
# resp.cluster.resources_vpc_config.subnet_ids #=> Array
|
331
|
+
# resp.cluster.resources_vpc_config.subnet_ids[0] #=> String
|
332
|
+
# resp.cluster.resources_vpc_config.security_group_ids #=> Array
|
333
|
+
# resp.cluster.resources_vpc_config.security_group_ids[0] #=> String
|
334
|
+
# resp.cluster.resources_vpc_config.vpc_id #=> String
|
335
|
+
# resp.cluster.status #=> String, one of "CREATING", "ACTIVE", "DELETING", "FAILED"
|
336
|
+
# resp.cluster.certificate_authority.data #=> String
|
337
|
+
# resp.cluster.client_request_token #=> String
|
338
|
+
#
|
339
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DeleteCluster AWS API Documentation
|
340
|
+
#
|
341
|
+
# @overload delete_cluster(params = {})
|
342
|
+
# @param [Hash] params ({})
|
343
|
+
def delete_cluster(params = {}, options = {})
|
344
|
+
req = build_request(:delete_cluster, params)
|
345
|
+
req.send_request(options)
|
346
|
+
end
|
347
|
+
|
348
|
+
# Returns descriptive information about an Amazon EKS cluster.
|
349
|
+
#
|
350
|
+
# The API server endpoint and certificate authority data returned by
|
351
|
+
# this operation are required for `kubelet` and `kubectl` to communicate
|
352
|
+
# with your Kubernetes API server. For more information, see [Create a
|
353
|
+
# kubeconfig for Amazon EKS][1].
|
354
|
+
#
|
355
|
+
# <note markdown="1"> The API server endpoint and certificate authority data are not
|
356
|
+
# available until the cluster reaches the `ACTIVE` state.
|
357
|
+
#
|
358
|
+
# </note>
|
359
|
+
#
|
360
|
+
#
|
361
|
+
#
|
362
|
+
# [1]: http://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html
|
363
|
+
#
|
364
|
+
# @option params [required, String] :name
|
365
|
+
# The name of the cluster to describe.
|
366
|
+
#
|
367
|
+
# @return [Types::DescribeClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
368
|
+
#
|
369
|
+
# * {Types::DescribeClusterResponse#cluster #cluster} => Types::Cluster
|
370
|
+
#
|
371
|
+
#
|
372
|
+
# @example Example: To describe a cluster
|
373
|
+
#
|
374
|
+
# # This example command provides a description of the specified cluster in your default region.
|
375
|
+
#
|
376
|
+
# resp = client.describe_cluster({
|
377
|
+
# name: "devel",
|
378
|
+
# })
|
379
|
+
#
|
380
|
+
# resp.to_h outputs the following:
|
381
|
+
# {
|
382
|
+
# cluster: {
|
383
|
+
# version: "1.10",
|
384
|
+
# name: "devel",
|
385
|
+
# arn: "arn:aws:eks:us-west-2:012345678910:cluster/devel",
|
386
|
+
# certificate_authority: {
|
387
|
+
# data: "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUN5RENDQWJDZ0F3SUJBZ0lCQURBTkJna3Foa2lHOXcwQkFRc0ZBREFWTVJNd0VRWURWUVFERXdwcmRXSmwKY201bGRHVnpNQjRYRFRFNE1EVXpNVEl6TVRFek1Wb1hEVEk0TURVeU9ESXpNVEV6TVZvd0ZURVRNQkVHQTFVRQpBeE1LYTNWaVpYSnVaWFJsY3pDQ0FTSXdEUVlKS29aSWh2Y05BUUVCQlFBRGdnRVBBRENDQVFvQ2dnRUJBTTZWCjVUaG4rdFcySm9Xa2hQMzRlVUZMNitaRXJOZGIvWVdrTmtDdWNGS2RaaXl2TjlMVmdvUmV2MjlFVFZlN1ZGbSsKUTJ3ZURyRXJiQyt0dVlibkFuN1ZLYmE3ay9hb1BHekZMdmVnb0t6b0M1N2NUdGVwZzRIazRlK2tIWHNaME10MApyb3NzcjhFM1ROeExETnNJTThGL1cwdjhsTGNCbWRPcjQyV2VuTjFHZXJnaDNSZ2wzR3JIazBnNTU0SjFWenJZCm9hTi8zODFUczlOTFF2QTBXb0xIcjBFRlZpTFdSZEoyZ3lXaC9ybDVyOFNDOHZaQXg1YW1BU0hVd01aTFpWRC8KTDBpOW4wRVM0MkpVdzQyQmxHOEdpd3NhTkJWV3lUTHZKclNhRXlDSHFtVVZaUTFDZkFXUjl0L3JleVVOVXM3TApWV1FqM3BFbk9RMitMSWJrc0RzQ0F3RUFBYU1qTUNFd0RnWURWUjBQQVFIL0JBUURBZ0trTUE4R0ExVWRFd0VCCi93UUZNQU1CQWY4d0RRWUpLb1pJaHZjTkFRRUxCUUFEZ2dFQkFNZ3RsQ1dIQ2U2YzVHMXl2YlFTS0Q4K2hUalkKSm1NSG56L2EvRGt0WG9YUjFVQzIrZUgzT1BZWmVjRVZZZHVaSlZCckNNQ2VWR0ZkeWdBYlNLc1FxWDg0S2RXbAp1MU5QaERDSmEyRHliN2pVMUV6VThTQjFGZUZ5ZFE3a0hNS1E1blpBRVFQOTY4S01hSGUrSm0yQ2x1UFJWbEJVCjF4WlhTS1gzTVZ0K1Q0SU1EV2d6c3JRSjVuQkRjdEtLcUZtM3pKdVVubHo5ZEpVckdscEltMjVJWXJDckxYUFgKWkUwRUtRNWEzMHhkVWNrTHRGQkQrOEtBdFdqSS9yZUZPNzM1YnBMdVoyOTBaNm42QlF3elRrS0p4cnhVc3QvOAppNGsxcnlsaUdWMm5SSjBUYjNORkczNHgrYWdzYTRoSTFPbU90TFM0TmgvRXJxT3lIUXNDc2hEQUtKUT0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=",
|
388
|
+
# },
|
389
|
+
# created_at: Time.parse(1527807879.988),
|
390
|
+
# endpoint: "https://A0DCCD80A04F01705DD065655C30CC3D.yl4.us-west-2.eks.amazonaws.com",
|
391
|
+
# resources_vpc_config: {
|
392
|
+
# security_group_ids: [
|
393
|
+
# "sg-6979fe18",
|
394
|
+
# ],
|
395
|
+
# subnet_ids: [
|
396
|
+
# "subnet-6782e71e",
|
397
|
+
# "subnet-e7e761ac",
|
398
|
+
# ],
|
399
|
+
# vpc_id: "vpc-950809ec",
|
400
|
+
# },
|
401
|
+
# role_arn: "arn:aws:iam::012345678910:role/eks-service-role-AWSServiceRoleForAmazonEKS-J7ONKE3BQ4PI",
|
402
|
+
# status: "ACTIVE",
|
403
|
+
# },
|
404
|
+
# }
|
405
|
+
#
|
406
|
+
# @example Request syntax with placeholder values
|
407
|
+
#
|
408
|
+
# resp = client.describe_cluster({
|
409
|
+
# name: "String", # required
|
410
|
+
# })
|
411
|
+
#
|
412
|
+
# @example Response structure
|
413
|
+
#
|
414
|
+
# resp.cluster.name #=> String
|
415
|
+
# resp.cluster.arn #=> String
|
416
|
+
# resp.cluster.created_at #=> Time
|
417
|
+
# resp.cluster.version #=> String
|
418
|
+
# resp.cluster.endpoint #=> String
|
419
|
+
# resp.cluster.role_arn #=> String
|
420
|
+
# resp.cluster.resources_vpc_config.subnet_ids #=> Array
|
421
|
+
# resp.cluster.resources_vpc_config.subnet_ids[0] #=> String
|
422
|
+
# resp.cluster.resources_vpc_config.security_group_ids #=> Array
|
423
|
+
# resp.cluster.resources_vpc_config.security_group_ids[0] #=> String
|
424
|
+
# resp.cluster.resources_vpc_config.vpc_id #=> String
|
425
|
+
# resp.cluster.status #=> String, one of "CREATING", "ACTIVE", "DELETING", "FAILED"
|
426
|
+
# resp.cluster.certificate_authority.data #=> String
|
427
|
+
# resp.cluster.client_request_token #=> String
|
428
|
+
#
|
429
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DescribeCluster AWS API Documentation
|
430
|
+
#
|
431
|
+
# @overload describe_cluster(params = {})
|
432
|
+
# @param [Hash] params ({})
|
433
|
+
def describe_cluster(params = {}, options = {})
|
434
|
+
req = build_request(:describe_cluster, params)
|
435
|
+
req.send_request(options)
|
436
|
+
end
|
437
|
+
|
438
|
+
# Lists the Amazon EKS clusters in your AWS account in the specified
|
439
|
+
# region.
|
440
|
+
#
|
441
|
+
# @option params [Integer] :max_results
|
442
|
+
# The maximum number of cluster results returned by `ListClusters` in
|
443
|
+
# paginated output. When this parameter is used, `ListClusters` only
|
444
|
+
# returns `maxResults` results in a single page along with a `nextToken`
|
445
|
+
# response element. The remaining results of the initial request can be
|
446
|
+
# seen by sending another `ListClusters` request with the returned
|
447
|
+
# `nextToken` value. This value can be between 1 and 100. If this
|
448
|
+
# parameter is not used, then `ListClusters` returns up to 100 results
|
449
|
+
# and a `nextToken` value if applicable.
|
450
|
+
#
|
451
|
+
# @option params [String] :next_token
|
452
|
+
# The `nextToken` value returned from a previous paginated
|
453
|
+
# `ListClusters` request where `maxResults` was used and the results
|
454
|
+
# exceeded the value of that parameter. Pagination continues from the
|
455
|
+
# end of the previous results that returned the `nextToken` value.
|
456
|
+
#
|
457
|
+
# <note markdown="1"> This token should be treated as an opaque identifier that is only used
|
458
|
+
# to retrieve the next items in a list and not for other programmatic
|
459
|
+
# purposes.
|
460
|
+
#
|
461
|
+
# </note>
|
462
|
+
#
|
463
|
+
# @return [Types::ListClustersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
464
|
+
#
|
465
|
+
# * {Types::ListClustersResponse#clusters #clusters} => Array<String>
|
466
|
+
# * {Types::ListClustersResponse#next_token #next_token} => String
|
467
|
+
#
|
468
|
+
#
|
469
|
+
# @example Example: To list your available clusters
|
470
|
+
#
|
471
|
+
# # This example command lists all of your available clusters in your default region.
|
472
|
+
#
|
473
|
+
# resp = client.list_clusters({
|
474
|
+
# })
|
475
|
+
#
|
476
|
+
# resp.to_h outputs the following:
|
477
|
+
# {
|
478
|
+
# clusters: [
|
479
|
+
# "devel",
|
480
|
+
# "prod",
|
481
|
+
# ],
|
482
|
+
# }
|
483
|
+
#
|
484
|
+
# @example Request syntax with placeholder values
|
485
|
+
#
|
486
|
+
# resp = client.list_clusters({
|
487
|
+
# max_results: 1,
|
488
|
+
# next_token: "String",
|
489
|
+
# })
|
490
|
+
#
|
491
|
+
# @example Response structure
|
492
|
+
#
|
493
|
+
# resp.clusters #=> Array
|
494
|
+
# resp.clusters[0] #=> String
|
495
|
+
# resp.next_token #=> String
|
496
|
+
#
|
497
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/ListClusters AWS API Documentation
|
498
|
+
#
|
499
|
+
# @overload list_clusters(params = {})
|
500
|
+
# @param [Hash] params ({})
|
501
|
+
def list_clusters(params = {}, options = {})
|
502
|
+
req = build_request(:list_clusters, params)
|
503
|
+
req.send_request(options)
|
504
|
+
end
|
505
|
+
|
506
|
+
# @!endgroup
|
507
|
+
|
508
|
+
# @param params ({})
|
509
|
+
# @api private
|
510
|
+
def build_request(operation_name, params = {})
|
511
|
+
handlers = @handlers.for(operation_name)
|
512
|
+
context = Seahorse::Client::RequestContext.new(
|
513
|
+
operation_name: operation_name,
|
514
|
+
operation: config.api.operation(operation_name),
|
515
|
+
client: self,
|
516
|
+
params: params,
|
517
|
+
config: config)
|
518
|
+
context[:gem_name] = 'aws-sdk-eks'
|
519
|
+
context[:gem_version] = '1.0.0'
|
520
|
+
Seahorse::Client::Request.new(handlers, context)
|
521
|
+
end
|
522
|
+
|
523
|
+
# @api private
|
524
|
+
# @deprecated
|
525
|
+
def waiter_names
|
526
|
+
[]
|
527
|
+
end
|
528
|
+
|
529
|
+
class << self
|
530
|
+
|
531
|
+
# @api private
|
532
|
+
attr_reader :identifier
|
533
|
+
|
534
|
+
# @api private
|
535
|
+
def errors_module
|
536
|
+
Errors
|
537
|
+
end
|
538
|
+
|
539
|
+
end
|
540
|
+
end
|
541
|
+
end
|
@@ -0,0 +1,166 @@
|
|
1
|
+
# WARNING ABOUT GENERATED CODE
|
2
|
+
#
|
3
|
+
# This file is generated. See the contributing guide for more information:
|
4
|
+
# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
|
5
|
+
#
|
6
|
+
# WARNING ABOUT GENERATED CODE
|
7
|
+
|
8
|
+
module Aws::EKS
|
9
|
+
# @api private
|
10
|
+
module ClientApi
|
11
|
+
|
12
|
+
include Seahorse::Model
|
13
|
+
|
14
|
+
Certificate = Shapes::StructureShape.new(name: 'Certificate')
|
15
|
+
ClientException = Shapes::StructureShape.new(name: 'ClientException')
|
16
|
+
Cluster = Shapes::StructureShape.new(name: 'Cluster')
|
17
|
+
ClusterName = Shapes::StringShape.new(name: 'ClusterName')
|
18
|
+
ClusterStatus = Shapes::StringShape.new(name: 'ClusterStatus')
|
19
|
+
CreateClusterRequest = Shapes::StructureShape.new(name: 'CreateClusterRequest')
|
20
|
+
CreateClusterResponse = Shapes::StructureShape.new(name: 'CreateClusterResponse')
|
21
|
+
DeleteClusterRequest = Shapes::StructureShape.new(name: 'DeleteClusterRequest')
|
22
|
+
DeleteClusterResponse = Shapes::StructureShape.new(name: 'DeleteClusterResponse')
|
23
|
+
DescribeClusterRequest = Shapes::StructureShape.new(name: 'DescribeClusterRequest')
|
24
|
+
DescribeClusterResponse = Shapes::StructureShape.new(name: 'DescribeClusterResponse')
|
25
|
+
InvalidParameterException = Shapes::StructureShape.new(name: 'InvalidParameterException')
|
26
|
+
ListClustersRequest = Shapes::StructureShape.new(name: 'ListClustersRequest')
|
27
|
+
ListClustersRequestMaxResults = Shapes::IntegerShape.new(name: 'ListClustersRequestMaxResults')
|
28
|
+
ListClustersResponse = Shapes::StructureShape.new(name: 'ListClustersResponse')
|
29
|
+
ResourceInUseException = Shapes::StructureShape.new(name: 'ResourceInUseException')
|
30
|
+
ResourceLimitExceededException = Shapes::StructureShape.new(name: 'ResourceLimitExceededException')
|
31
|
+
ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
|
32
|
+
ServerException = Shapes::StructureShape.new(name: 'ServerException')
|
33
|
+
ServiceUnavailableException = Shapes::StructureShape.new(name: 'ServiceUnavailableException')
|
34
|
+
String = Shapes::StringShape.new(name: 'String')
|
35
|
+
StringList = Shapes::ListShape.new(name: 'StringList')
|
36
|
+
Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
|
37
|
+
UnsupportedAvailabilityZoneException = Shapes::StructureShape.new(name: 'UnsupportedAvailabilityZoneException')
|
38
|
+
VpcConfigRequest = Shapes::StructureShape.new(name: 'VpcConfigRequest')
|
39
|
+
VpcConfigResponse = Shapes::StructureShape.new(name: 'VpcConfigResponse')
|
40
|
+
|
41
|
+
Certificate.add_member(:data, Shapes::ShapeRef.new(shape: String, location_name: "data"))
|
42
|
+
Certificate.struct_class = Types::Certificate
|
43
|
+
|
44
|
+
Cluster.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
|
45
|
+
Cluster.add_member(:arn, Shapes::ShapeRef.new(shape: String, location_name: "arn"))
|
46
|
+
Cluster.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "createdAt"))
|
47
|
+
Cluster.add_member(:version, Shapes::ShapeRef.new(shape: String, location_name: "version"))
|
48
|
+
Cluster.add_member(:endpoint, Shapes::ShapeRef.new(shape: String, location_name: "endpoint"))
|
49
|
+
Cluster.add_member(:role_arn, Shapes::ShapeRef.new(shape: String, location_name: "roleArn"))
|
50
|
+
Cluster.add_member(:resources_vpc_config, Shapes::ShapeRef.new(shape: VpcConfigResponse, location_name: "resourcesVpcConfig"))
|
51
|
+
Cluster.add_member(:status, Shapes::ShapeRef.new(shape: ClusterStatus, location_name: "status"))
|
52
|
+
Cluster.add_member(:certificate_authority, Shapes::ShapeRef.new(shape: Certificate, location_name: "certificateAuthority"))
|
53
|
+
Cluster.add_member(:client_request_token, Shapes::ShapeRef.new(shape: String, location_name: "clientRequestToken"))
|
54
|
+
Cluster.struct_class = Types::Cluster
|
55
|
+
|
56
|
+
CreateClusterRequest.add_member(:name, Shapes::ShapeRef.new(shape: ClusterName, required: true, location_name: "name"))
|
57
|
+
CreateClusterRequest.add_member(:version, Shapes::ShapeRef.new(shape: String, location_name: "version"))
|
58
|
+
CreateClusterRequest.add_member(:role_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "roleArn"))
|
59
|
+
CreateClusterRequest.add_member(:resources_vpc_config, Shapes::ShapeRef.new(shape: VpcConfigRequest, required: true, location_name: "resourcesVpcConfig"))
|
60
|
+
CreateClusterRequest.add_member(:client_request_token, Shapes::ShapeRef.new(shape: String, location_name: "clientRequestToken", metadata: {"idempotencyToken"=>true}))
|
61
|
+
CreateClusterRequest.struct_class = Types::CreateClusterRequest
|
62
|
+
|
63
|
+
CreateClusterResponse.add_member(:cluster, Shapes::ShapeRef.new(shape: Cluster, location_name: "cluster"))
|
64
|
+
CreateClusterResponse.struct_class = Types::CreateClusterResponse
|
65
|
+
|
66
|
+
DeleteClusterRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "name"))
|
67
|
+
DeleteClusterRequest.struct_class = Types::DeleteClusterRequest
|
68
|
+
|
69
|
+
DeleteClusterResponse.add_member(:cluster, Shapes::ShapeRef.new(shape: Cluster, location_name: "cluster"))
|
70
|
+
DeleteClusterResponse.struct_class = Types::DeleteClusterResponse
|
71
|
+
|
72
|
+
DescribeClusterRequest.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location: "uri", location_name: "name"))
|
73
|
+
DescribeClusterRequest.struct_class = Types::DescribeClusterRequest
|
74
|
+
|
75
|
+
DescribeClusterResponse.add_member(:cluster, Shapes::ShapeRef.new(shape: Cluster, location_name: "cluster"))
|
76
|
+
DescribeClusterResponse.struct_class = Types::DescribeClusterResponse
|
77
|
+
|
78
|
+
ListClustersRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListClustersRequestMaxResults, location: "querystring", location_name: "maxResults"))
|
79
|
+
ListClustersRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location: "querystring", location_name: "nextToken"))
|
80
|
+
ListClustersRequest.struct_class = Types::ListClustersRequest
|
81
|
+
|
82
|
+
ListClustersResponse.add_member(:clusters, Shapes::ShapeRef.new(shape: StringList, location_name: "clusters"))
|
83
|
+
ListClustersResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
|
84
|
+
ListClustersResponse.struct_class = Types::ListClustersResponse
|
85
|
+
|
86
|
+
StringList.member = Shapes::ShapeRef.new(shape: String)
|
87
|
+
|
88
|
+
VpcConfigRequest.add_member(:subnet_ids, Shapes::ShapeRef.new(shape: StringList, required: true, location_name: "subnetIds"))
|
89
|
+
VpcConfigRequest.add_member(:security_group_ids, Shapes::ShapeRef.new(shape: StringList, location_name: "securityGroupIds"))
|
90
|
+
VpcConfigRequest.struct_class = Types::VpcConfigRequest
|
91
|
+
|
92
|
+
VpcConfigResponse.add_member(:subnet_ids, Shapes::ShapeRef.new(shape: StringList, location_name: "subnetIds"))
|
93
|
+
VpcConfigResponse.add_member(:security_group_ids, Shapes::ShapeRef.new(shape: StringList, location_name: "securityGroupIds"))
|
94
|
+
VpcConfigResponse.add_member(:vpc_id, Shapes::ShapeRef.new(shape: String, location_name: "vpcId"))
|
95
|
+
VpcConfigResponse.struct_class = Types::VpcConfigResponse
|
96
|
+
|
97
|
+
|
98
|
+
# @api private
|
99
|
+
API = Seahorse::Model::Api.new.tap do |api|
|
100
|
+
|
101
|
+
api.version = "2017-11-01"
|
102
|
+
|
103
|
+
api.metadata = {
|
104
|
+
"endpointPrefix" => "eks",
|
105
|
+
"jsonVersion" => "1.1",
|
106
|
+
"protocol" => "rest-json",
|
107
|
+
"serviceFullName" => "Amazon Elastic Container Service for Kubernetes",
|
108
|
+
"signatureVersion" => "v4",
|
109
|
+
"signingName" => "eks",
|
110
|
+
}
|
111
|
+
|
112
|
+
api.add_operation(:create_cluster, Seahorse::Model::Operation.new.tap do |o|
|
113
|
+
o.name = "CreateCluster"
|
114
|
+
o.http_method = "POST"
|
115
|
+
o.http_request_uri = "/clusters"
|
116
|
+
o.input = Shapes::ShapeRef.new(shape: CreateClusterRequest)
|
117
|
+
o.output = Shapes::ShapeRef.new(shape: CreateClusterResponse)
|
118
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
|
119
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceLimitExceededException)
|
120
|
+
o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
|
121
|
+
o.errors << Shapes::ShapeRef.new(shape: ClientException)
|
122
|
+
o.errors << Shapes::ShapeRef.new(shape: ServerException)
|
123
|
+
o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
|
124
|
+
o.errors << Shapes::ShapeRef.new(shape: UnsupportedAvailabilityZoneException)
|
125
|
+
end)
|
126
|
+
|
127
|
+
api.add_operation(:delete_cluster, Seahorse::Model::Operation.new.tap do |o|
|
128
|
+
o.name = "DeleteCluster"
|
129
|
+
o.http_method = "DELETE"
|
130
|
+
o.http_request_uri = "/clusters/{name}"
|
131
|
+
o.input = Shapes::ShapeRef.new(shape: DeleteClusterRequest)
|
132
|
+
o.output = Shapes::ShapeRef.new(shape: DeleteClusterResponse)
|
133
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
|
134
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
135
|
+
o.errors << Shapes::ShapeRef.new(shape: ClientException)
|
136
|
+
o.errors << Shapes::ShapeRef.new(shape: ServerException)
|
137
|
+
o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
|
138
|
+
end)
|
139
|
+
|
140
|
+
api.add_operation(:describe_cluster, Seahorse::Model::Operation.new.tap do |o|
|
141
|
+
o.name = "DescribeCluster"
|
142
|
+
o.http_method = "GET"
|
143
|
+
o.http_request_uri = "/clusters/{name}"
|
144
|
+
o.input = Shapes::ShapeRef.new(shape: DescribeClusterRequest)
|
145
|
+
o.output = Shapes::ShapeRef.new(shape: DescribeClusterResponse)
|
146
|
+
o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
|
147
|
+
o.errors << Shapes::ShapeRef.new(shape: ClientException)
|
148
|
+
o.errors << Shapes::ShapeRef.new(shape: ServerException)
|
149
|
+
o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
|
150
|
+
end)
|
151
|
+
|
152
|
+
api.add_operation(:list_clusters, Seahorse::Model::Operation.new.tap do |o|
|
153
|
+
o.name = "ListClusters"
|
154
|
+
o.http_method = "GET"
|
155
|
+
o.http_request_uri = "/clusters"
|
156
|
+
o.input = Shapes::ShapeRef.new(shape: ListClustersRequest)
|
157
|
+
o.output = Shapes::ShapeRef.new(shape: ListClustersResponse)
|
158
|
+
o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
|
159
|
+
o.errors << Shapes::ShapeRef.new(shape: ClientException)
|
160
|
+
o.errors << Shapes::ShapeRef.new(shape: ServerException)
|
161
|
+
o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
|
162
|
+
end)
|
163
|
+
end
|
164
|
+
|
165
|
+
end
|
166
|
+
end
|
File without changes
|
@@ -0,0 +1,14 @@
|
|
1
|
+
# WARNING ABOUT GENERATED CODE
|
2
|
+
#
|
3
|
+
# This file is generated. See the contributing guide for more information:
|
4
|
+
# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
|
5
|
+
#
|
6
|
+
# WARNING ABOUT GENERATED CODE
|
7
|
+
|
8
|
+
module Aws::EKS
|
9
|
+
module Errors
|
10
|
+
|
11
|
+
extend Aws::Errors::DynamicErrors
|
12
|
+
|
13
|
+
end
|
14
|
+
end
|
@@ -0,0 +1,23 @@
|
|
1
|
+
# WARNING ABOUT GENERATED CODE
|
2
|
+
#
|
3
|
+
# This file is generated. See the contributing guide for more information:
|
4
|
+
# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
|
5
|
+
#
|
6
|
+
# WARNING ABOUT GENERATED CODE
|
7
|
+
|
8
|
+
module Aws::EKS
|
9
|
+
class Resource
|
10
|
+
|
11
|
+
# @param options ({})
|
12
|
+
# @option options [Client] :client
|
13
|
+
def initialize(options = {})
|
14
|
+
@client = options[:client] || Client.new(options)
|
15
|
+
end
|
16
|
+
|
17
|
+
# @return [Client]
|
18
|
+
def client
|
19
|
+
@client
|
20
|
+
end
|
21
|
+
|
22
|
+
end
|
23
|
+
end
|
@@ -0,0 +1,354 @@
|
|
1
|
+
# WARNING ABOUT GENERATED CODE
|
2
|
+
#
|
3
|
+
# This file is generated. See the contributing guide for more information:
|
4
|
+
# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
|
5
|
+
#
|
6
|
+
# WARNING ABOUT GENERATED CODE
|
7
|
+
|
8
|
+
module Aws::EKS
|
9
|
+
module Types
|
10
|
+
|
11
|
+
# An object representing the `certificate-authority-data` for your
|
12
|
+
# cluster.
|
13
|
+
#
|
14
|
+
# @!attribute [rw] data
|
15
|
+
# The base64 encoded certificate data required to communicate with
|
16
|
+
# your cluster. Add this to the `certificate-authority-data` section
|
17
|
+
# of the `kubeconfig` file for your cluster.
|
18
|
+
# @return [String]
|
19
|
+
#
|
20
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/Certificate AWS API Documentation
|
21
|
+
#
|
22
|
+
class Certificate < Struct.new(
|
23
|
+
:data)
|
24
|
+
include Aws::Structure
|
25
|
+
end
|
26
|
+
|
27
|
+
# An object representing an Amazon EKS cluster.
|
28
|
+
#
|
29
|
+
# @!attribute [rw] name
|
30
|
+
# The name of the cluster.
|
31
|
+
# @return [String]
|
32
|
+
#
|
33
|
+
# @!attribute [rw] arn
|
34
|
+
# The Amazon Resource Name (ARN) of the cluster.
|
35
|
+
# @return [String]
|
36
|
+
#
|
37
|
+
# @!attribute [rw] created_at
|
38
|
+
# The Unix epoch time stamp in seconds for when the cluster was
|
39
|
+
# created.
|
40
|
+
# @return [Time]
|
41
|
+
#
|
42
|
+
# @!attribute [rw] version
|
43
|
+
# The Kubernetes server version for the cluster.
|
44
|
+
# @return [String]
|
45
|
+
#
|
46
|
+
# @!attribute [rw] endpoint
|
47
|
+
# The endpoint for your Kubernetes API server.
|
48
|
+
# @return [String]
|
49
|
+
#
|
50
|
+
# @!attribute [rw] role_arn
|
51
|
+
# The Amazon Resource Name (ARN) of the IAM role that provides
|
52
|
+
# permissions for the Kubernetes control plane to make calls to AWS
|
53
|
+
# API operations on your behalf.
|
54
|
+
# @return [String]
|
55
|
+
#
|
56
|
+
# @!attribute [rw] resources_vpc_config
|
57
|
+
# The VPC subnets and security groups used by the cluster control
|
58
|
+
# plane. Amazon EKS VPC resources have specific requirements to work
|
59
|
+
# properly with Kubernetes. For more information, see [Cluster VPC
|
60
|
+
# Considerations][1] and [Cluster Security Group Considerations][2] in
|
61
|
+
# the *Amazon EKS User Guide*.
|
62
|
+
#
|
63
|
+
#
|
64
|
+
#
|
65
|
+
# [1]: http://docs.aws.amazon.com/eks/latest/userguide/network_reqs.html
|
66
|
+
# [2]: http://docs.aws.amazon.com/eks/latest/userguide/sec-group-reqs.html
|
67
|
+
# @return [Types::VpcConfigResponse]
|
68
|
+
#
|
69
|
+
# @!attribute [rw] status
|
70
|
+
# The current status of the cluster.
|
71
|
+
# @return [String]
|
72
|
+
#
|
73
|
+
# @!attribute [rw] certificate_authority
|
74
|
+
# The `certificate-authority-data` for your cluster.
|
75
|
+
# @return [Types::Certificate]
|
76
|
+
#
|
77
|
+
# @!attribute [rw] client_request_token
|
78
|
+
# Unique, case-sensitive identifier you provide to ensure the
|
79
|
+
# idempotency of the request.
|
80
|
+
# @return [String]
|
81
|
+
#
|
82
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/Cluster AWS API Documentation
|
83
|
+
#
|
84
|
+
class Cluster < Struct.new(
|
85
|
+
:name,
|
86
|
+
:arn,
|
87
|
+
:created_at,
|
88
|
+
:version,
|
89
|
+
:endpoint,
|
90
|
+
:role_arn,
|
91
|
+
:resources_vpc_config,
|
92
|
+
:status,
|
93
|
+
:certificate_authority,
|
94
|
+
:client_request_token)
|
95
|
+
include Aws::Structure
|
96
|
+
end
|
97
|
+
|
98
|
+
# @note When making an API call, you may pass CreateClusterRequest
|
99
|
+
# data as a hash:
|
100
|
+
#
|
101
|
+
# {
|
102
|
+
# name: "ClusterName", # required
|
103
|
+
# version: "String",
|
104
|
+
# role_arn: "String", # required
|
105
|
+
# resources_vpc_config: { # required
|
106
|
+
# subnet_ids: ["String"], # required
|
107
|
+
# security_group_ids: ["String"],
|
108
|
+
# },
|
109
|
+
# client_request_token: "String",
|
110
|
+
# }
|
111
|
+
#
|
112
|
+
# @!attribute [rw] name
|
113
|
+
# The unique name to give to your cluster.
|
114
|
+
# @return [String]
|
115
|
+
#
|
116
|
+
# @!attribute [rw] version
|
117
|
+
# The desired Kubernetes version for your cluster. If you do not
|
118
|
+
# specify a value here, the latest version available in Amazon EKS is
|
119
|
+
# used.
|
120
|
+
# @return [String]
|
121
|
+
#
|
122
|
+
# @!attribute [rw] role_arn
|
123
|
+
# The Amazon Resource Name (ARN) of the IAM role that provides
|
124
|
+
# permissions for Amazon EKS to make calls to other AWS API operations
|
125
|
+
# on your behalf. For more information, see [Amazon EKS Service IAM
|
126
|
+
# Role][1] in the <i> <i>Amazon EKS User Guide</i> </i>
|
127
|
+
#
|
128
|
+
#
|
129
|
+
#
|
130
|
+
# [1]: http://docs.aws.amazon.com/eks/latest/userguide/service_IAM_role.html
|
131
|
+
# @return [String]
|
132
|
+
#
|
133
|
+
# @!attribute [rw] resources_vpc_config
|
134
|
+
# The VPC subnets and security groups used by the cluster control
|
135
|
+
# plane. Amazon EKS VPC resources have specific requirements to work
|
136
|
+
# properly with Kubernetes. For more information, see [Cluster VPC
|
137
|
+
# Considerations][1] and [Cluster Security Group Considerations][2] in
|
138
|
+
# the *Amazon EKS User Guide*.
|
139
|
+
#
|
140
|
+
#
|
141
|
+
#
|
142
|
+
# [1]: http://docs.aws.amazon.com/eks/latest/userguide/network_reqs.html
|
143
|
+
# [2]: http://docs.aws.amazon.com/eks/latest/userguide/sec-group-reqs.html
|
144
|
+
# @return [Types::VpcConfigRequest]
|
145
|
+
#
|
146
|
+
# @!attribute [rw] client_request_token
|
147
|
+
# Unique, case-sensitive identifier you provide to ensure the
|
148
|
+
# idempotency of the request.
|
149
|
+
#
|
150
|
+
# **A suitable default value is auto-generated.** You should normally
|
151
|
+
# not need to pass this option.
|
152
|
+
# @return [String]
|
153
|
+
#
|
154
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/CreateClusterRequest AWS API Documentation
|
155
|
+
#
|
156
|
+
class CreateClusterRequest < Struct.new(
|
157
|
+
:name,
|
158
|
+
:version,
|
159
|
+
:role_arn,
|
160
|
+
:resources_vpc_config,
|
161
|
+
:client_request_token)
|
162
|
+
include Aws::Structure
|
163
|
+
end
|
164
|
+
|
165
|
+
# @!attribute [rw] cluster
|
166
|
+
# The full description of your new cluster.
|
167
|
+
# @return [Types::Cluster]
|
168
|
+
#
|
169
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/CreateClusterResponse AWS API Documentation
|
170
|
+
#
|
171
|
+
class CreateClusterResponse < Struct.new(
|
172
|
+
:cluster)
|
173
|
+
include Aws::Structure
|
174
|
+
end
|
175
|
+
|
176
|
+
# @note When making an API call, you may pass DeleteClusterRequest
|
177
|
+
# data as a hash:
|
178
|
+
#
|
179
|
+
# {
|
180
|
+
# name: "String", # required
|
181
|
+
# }
|
182
|
+
#
|
183
|
+
# @!attribute [rw] name
|
184
|
+
# The name of the cluster to delete.
|
185
|
+
# @return [String]
|
186
|
+
#
|
187
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DeleteClusterRequest AWS API Documentation
|
188
|
+
#
|
189
|
+
class DeleteClusterRequest < Struct.new(
|
190
|
+
:name)
|
191
|
+
include Aws::Structure
|
192
|
+
end
|
193
|
+
|
194
|
+
# @!attribute [rw] cluster
|
195
|
+
# The full description of the cluster to delete.
|
196
|
+
# @return [Types::Cluster]
|
197
|
+
#
|
198
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DeleteClusterResponse AWS API Documentation
|
199
|
+
#
|
200
|
+
class DeleteClusterResponse < Struct.new(
|
201
|
+
:cluster)
|
202
|
+
include Aws::Structure
|
203
|
+
end
|
204
|
+
|
205
|
+
# @note When making an API call, you may pass DescribeClusterRequest
|
206
|
+
# data as a hash:
|
207
|
+
#
|
208
|
+
# {
|
209
|
+
# name: "String", # required
|
210
|
+
# }
|
211
|
+
#
|
212
|
+
# @!attribute [rw] name
|
213
|
+
# The name of the cluster to describe.
|
214
|
+
# @return [String]
|
215
|
+
#
|
216
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DescribeClusterRequest AWS API Documentation
|
217
|
+
#
|
218
|
+
class DescribeClusterRequest < Struct.new(
|
219
|
+
:name)
|
220
|
+
include Aws::Structure
|
221
|
+
end
|
222
|
+
|
223
|
+
# @!attribute [rw] cluster
|
224
|
+
# The full description of your specified cluster.
|
225
|
+
# @return [Types::Cluster]
|
226
|
+
#
|
227
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/DescribeClusterResponse AWS API Documentation
|
228
|
+
#
|
229
|
+
class DescribeClusterResponse < Struct.new(
|
230
|
+
:cluster)
|
231
|
+
include Aws::Structure
|
232
|
+
end
|
233
|
+
|
234
|
+
# @note When making an API call, you may pass ListClustersRequest
|
235
|
+
# data as a hash:
|
236
|
+
#
|
237
|
+
# {
|
238
|
+
# max_results: 1,
|
239
|
+
# next_token: "String",
|
240
|
+
# }
|
241
|
+
#
|
242
|
+
# @!attribute [rw] max_results
|
243
|
+
# The maximum number of cluster results returned by `ListClusters` in
|
244
|
+
# paginated output. When this parameter is used, `ListClusters` only
|
245
|
+
# returns `maxResults` results in a single page along with a
|
246
|
+
# `nextToken` response element. The remaining results of the initial
|
247
|
+
# request can be seen by sending another `ListClusters` request with
|
248
|
+
# the returned `nextToken` value. This value can be between 1 and 100.
|
249
|
+
# If this parameter is not used, then `ListClusters` returns up to 100
|
250
|
+
# results and a `nextToken` value if applicable.
|
251
|
+
# @return [Integer]
|
252
|
+
#
|
253
|
+
# @!attribute [rw] next_token
|
254
|
+
# The `nextToken` value returned from a previous paginated
|
255
|
+
# `ListClusters` request where `maxResults` was used and the results
|
256
|
+
# exceeded the value of that parameter. Pagination continues from the
|
257
|
+
# end of the previous results that returned the `nextToken` value.
|
258
|
+
#
|
259
|
+
# <note markdown="1"> This token should be treated as an opaque identifier that is only
|
260
|
+
# used to retrieve the next items in a list and not for other
|
261
|
+
# programmatic purposes.
|
262
|
+
#
|
263
|
+
# </note>
|
264
|
+
# @return [String]
|
265
|
+
#
|
266
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/ListClustersRequest AWS API Documentation
|
267
|
+
#
|
268
|
+
class ListClustersRequest < Struct.new(
|
269
|
+
:max_results,
|
270
|
+
:next_token)
|
271
|
+
include Aws::Structure
|
272
|
+
end
|
273
|
+
|
274
|
+
# @!attribute [rw] clusters
|
275
|
+
# A list of all of the clusters for your account in the specified
|
276
|
+
# region.
|
277
|
+
# @return [Array<String>]
|
278
|
+
#
|
279
|
+
# @!attribute [rw] next_token
|
280
|
+
# The `nextToken` value to include in a future `ListClusters` request.
|
281
|
+
# When the results of a `ListClusters` request exceed `maxResults`,
|
282
|
+
# this value can be used to retrieve the next page of results. This
|
283
|
+
# value is `null` when there are no more results to return.
|
284
|
+
# @return [String]
|
285
|
+
#
|
286
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/ListClustersResponse AWS API Documentation
|
287
|
+
#
|
288
|
+
class ListClustersResponse < Struct.new(
|
289
|
+
:clusters,
|
290
|
+
:next_token)
|
291
|
+
include Aws::Structure
|
292
|
+
end
|
293
|
+
|
294
|
+
# An object representing an Amazon EKS cluster VPC configuration
|
295
|
+
# request.
|
296
|
+
#
|
297
|
+
# @note When making an API call, you may pass VpcConfigRequest
|
298
|
+
# data as a hash:
|
299
|
+
#
|
300
|
+
# {
|
301
|
+
# subnet_ids: ["String"], # required
|
302
|
+
# security_group_ids: ["String"],
|
303
|
+
# }
|
304
|
+
#
|
305
|
+
# @!attribute [rw] subnet_ids
|
306
|
+
# Specify subnets for your Amazon EKS worker nodes. Amazon EKS creates
|
307
|
+
# cross-account elastic network interfaces in these subnets to allow
|
308
|
+
# communication between your worker nodes and the Kubernetes control
|
309
|
+
# plane.
|
310
|
+
# @return [Array<String>]
|
311
|
+
#
|
312
|
+
# @!attribute [rw] security_group_ids
|
313
|
+
# Specify one or more security groups for the cross-account elastic
|
314
|
+
# network interfaces that Amazon EKS creates to use to allow
|
315
|
+
# communication between your worker nodes and the Kubernetes control
|
316
|
+
# plane.
|
317
|
+
# @return [Array<String>]
|
318
|
+
#
|
319
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/VpcConfigRequest AWS API Documentation
|
320
|
+
#
|
321
|
+
class VpcConfigRequest < Struct.new(
|
322
|
+
:subnet_ids,
|
323
|
+
:security_group_ids)
|
324
|
+
include Aws::Structure
|
325
|
+
end
|
326
|
+
|
327
|
+
# An object representing an Amazon EKS cluster VPC configuration
|
328
|
+
# response.
|
329
|
+
#
|
330
|
+
# @!attribute [rw] subnet_ids
|
331
|
+
# The subnets associated with your cluster.
|
332
|
+
# @return [Array<String>]
|
333
|
+
#
|
334
|
+
# @!attribute [rw] security_group_ids
|
335
|
+
# The security groups associated with the cross-account elastic
|
336
|
+
# network interfaces that are used to allow communication between your
|
337
|
+
# worker nodes and the Kubernetes control plane.
|
338
|
+
# @return [Array<String>]
|
339
|
+
#
|
340
|
+
# @!attribute [rw] vpc_id
|
341
|
+
# The VPC associated with your cluster.
|
342
|
+
# @return [String]
|
343
|
+
#
|
344
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/VpcConfigResponse AWS API Documentation
|
345
|
+
#
|
346
|
+
class VpcConfigResponse < Struct.new(
|
347
|
+
:subnet_ids,
|
348
|
+
:security_group_ids,
|
349
|
+
:vpc_id)
|
350
|
+
include Aws::Structure
|
351
|
+
end
|
352
|
+
|
353
|
+
end
|
354
|
+
end
|
metadata
ADDED
@@ -0,0 +1,82 @@
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
|
+
name: aws-sdk-eks
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
version: 1.0.0
|
5
|
+
platform: ruby
|
6
|
+
authors:
|
7
|
+
- Amazon Web Services
|
8
|
+
autorequire:
|
9
|
+
bindir: bin
|
10
|
+
cert_chain: []
|
11
|
+
date: 2018-06-04 00:00:00.000000000 Z
|
12
|
+
dependencies:
|
13
|
+
- !ruby/object:Gem::Dependency
|
14
|
+
name: aws-sdk-core
|
15
|
+
requirement: !ruby/object:Gem::Requirement
|
16
|
+
requirements:
|
17
|
+
- - "~>"
|
18
|
+
- !ruby/object:Gem::Version
|
19
|
+
version: '3'
|
20
|
+
type: :runtime
|
21
|
+
prerelease: false
|
22
|
+
version_requirements: !ruby/object:Gem::Requirement
|
23
|
+
requirements:
|
24
|
+
- - "~>"
|
25
|
+
- !ruby/object:Gem::Version
|
26
|
+
version: '3'
|
27
|
+
- !ruby/object:Gem::Dependency
|
28
|
+
name: aws-sigv4
|
29
|
+
requirement: !ruby/object:Gem::Requirement
|
30
|
+
requirements:
|
31
|
+
- - "~>"
|
32
|
+
- !ruby/object:Gem::Version
|
33
|
+
version: '1.0'
|
34
|
+
type: :runtime
|
35
|
+
prerelease: false
|
36
|
+
version_requirements: !ruby/object:Gem::Requirement
|
37
|
+
requirements:
|
38
|
+
- - "~>"
|
39
|
+
- !ruby/object:Gem::Version
|
40
|
+
version: '1.0'
|
41
|
+
description: Official AWS Ruby gem for Amazon Elastic Container Service for Kubernetes
|
42
|
+
(Amazon EKS). This gem is part of the AWS SDK for Ruby.
|
43
|
+
email:
|
44
|
+
- trevrowe@amazon.com
|
45
|
+
executables: []
|
46
|
+
extensions: []
|
47
|
+
extra_rdoc_files: []
|
48
|
+
files:
|
49
|
+
- lib/aws-sdk-eks.rb
|
50
|
+
- lib/aws-sdk-eks/client.rb
|
51
|
+
- lib/aws-sdk-eks/client_api.rb
|
52
|
+
- lib/aws-sdk-eks/customizations.rb
|
53
|
+
- lib/aws-sdk-eks/errors.rb
|
54
|
+
- lib/aws-sdk-eks/resource.rb
|
55
|
+
- lib/aws-sdk-eks/types.rb
|
56
|
+
homepage: http://github.com/aws/aws-sdk-ruby
|
57
|
+
licenses:
|
58
|
+
- Apache-2.0
|
59
|
+
metadata:
|
60
|
+
source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-eks
|
61
|
+
changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-eks/CHANGELOG.md
|
62
|
+
post_install_message:
|
63
|
+
rdoc_options: []
|
64
|
+
require_paths:
|
65
|
+
- lib
|
66
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
67
|
+
requirements:
|
68
|
+
- - ">="
|
69
|
+
- !ruby/object:Gem::Version
|
70
|
+
version: '0'
|
71
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
72
|
+
requirements:
|
73
|
+
- - ">="
|
74
|
+
- !ruby/object:Gem::Version
|
75
|
+
version: '0'
|
76
|
+
requirements: []
|
77
|
+
rubyforge_project:
|
78
|
+
rubygems_version: 2.5.2.3
|
79
|
+
signing_key:
|
80
|
+
specification_version: 4
|
81
|
+
summary: AWS SDK for Ruby - Amazon EKS
|
82
|
+
test_files: []
|