Skip to content

Commit 5ec93aa

Browse files
author
AWS
committed
Amazon Elastic Kubernetes Service Update: This release lets customers add tags to an Amazon EKS cluster. These tags can be used to control access to the EKS API for managing the cluster using IAM. The Amazon EKS TagResource API allows customers to associate tags with their cluster. Customers can list tags for a cluster using the ListTagsForResource API and remove tags from a cluster with the UntagResource API. Note: tags are specific to the EKS cluster resource, they do not propagate to other AWS resources used by the cluster.
1 parent 582c21c commit 5ec93aa

File tree

2 files changed

+166
-0
lines changed

2 files changed

+166
-0
lines changed

‎.changes/next-release/feature-AmazonElasticKubernetesService-fa75cdf.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
{
2+
"type": "feature",
3+
"category": "Amazon Elastic Kubernetes Service",
4+
"description": "This release lets customers add tags to an Amazon EKS cluster. These tags can be used to control access to the EKS API for managing the cluster using IAM. The Amazon EKS TagResource API allows customers to associate tags with their cluster. Customers can list tags for a cluster using the ListTagsForResource API and remove tags from a cluster with the UntagResource API. Note: tags are specific to the EKS cluster resource, they do not propagate to other AWS resources used by the cluster."
5+
}

‎services/eks/src/main/resources/codegen-resources/service-2.json

Lines changed: 161 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,20 @@
9797
],
9898
"documentation":"<p>Lists the Amazon EKS clusters in your AWS account in the specified Region.</p>"
9999
},
100+
"ListTagsForResource":{
101+
"name":"ListTagsForResource",
102+
"http":{
103+
"method":"GET",
104+
"requestUri":"/tags/{resourceArn}"
105+
},
106+
"input":{"shape":"ListTagsForResourceRequest"},
107+
"output":{"shape":"ListTagsForResourceResponse"},
108+
"errors":[
109+
{"shape":"BadRequestException"},
110+
{"shape":"NotFoundException"}
111+
],
112+
"documentation":"<p>List the tags for an Amazon EKS resource.</p>"
113+
},
100114
"ListUpdates":{
101115
"name":"ListUpdates",
102116
"http":{
@@ -113,6 +127,34 @@
113127
],
114128
"documentation":"<p>Lists the updates associated with an Amazon EKS cluster in your AWS account, in the specified Region.</p>"
115129
},
130+
"TagResource":{
131+
"name":"TagResource",
132+
"http":{
133+
"method":"POST",
134+
"requestUri":"/tags/{resourceArn}"
135+
},
136+
"input":{"shape":"TagResourceRequest"},
137+
"output":{"shape":"TagResourceResponse"},
138+
"errors":[
139+
{"shape":"BadRequestException"},
140+
{"shape":"NotFoundException"}
141+
],
142+
"documentation":"<p>Associates the specified tags to a resource with the specified <code>resourceArn</code>. If existing tags on a resource are not specified in the request parameters, they are not changed. When a resource is deleted, the tags associated with that resource are deleted as well.</p>"
143+
},
144+
"UntagResource":{
145+
"name":"UntagResource",
146+
"http":{
147+
"method":"DELETE",
148+
"requestUri":"/tags/{resourceArn}"
149+
},
150+
"input":{"shape":"UntagResourceRequest"},
151+
"output":{"shape":"UntagResourceResponse"},
152+
"errors":[
153+
{"shape":"BadRequestException"},
154+
{"shape":"NotFoundException"}
155+
],
156+
"documentation":"<p>Deletes specified tags from a resource.</p>"
157+
},
116158
"UpdateClusterConfig":{
117159
"name":"UpdateClusterConfig",
118160
"http":{
@@ -151,6 +193,15 @@
151193
}
152194
},
153195
"shapes":{
196+
"BadRequestException":{
197+
"type":"structure",
198+
"members":{
199+
"message":{"shape":"String"}
200+
},
201+
"documentation":"<p>This exception is thrown if the request contains a semantic error. The precise meaning will depend on the API, and will be documented in the error message.</p>",
202+
"error":{"httpStatusCode":400},
203+
"exception":true
204+
},
154205
"Boolean":{"type":"boolean"},
155206
"BoxedBoolean":{
156207
"type":"boolean",
@@ -233,6 +284,10 @@
233284
"platformVersion":{
234285
"shape":"String",
235286
"documentation":"<p>The platform version of your Amazon EKS cluster. For more information, see <a href=\"https://docs.aws.amazon.com/eks/latest/userguide/platform-versions.html\">Platform Versions</a> in the <i> <i>Amazon EKS User Guide</i> </i>.</p>"
287+
},
288+
"tags":{
289+
"shape":"TagMap",
290+
"documentation":"<p>The metadata that you apply to the cluster to assist with categorization and organization. Each tag consists of a key and an optional value, both of which you define.</p>"
236291
}
237292
},
238293
"documentation":"<p>An object representing an Amazon EKS cluster.</p>"
@@ -284,6 +339,10 @@
284339
"shape":"String",
285340
"documentation":"<p>Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.</p>",
286341
"idempotencyToken":true
342+
},
343+
"tags":{
344+
"shape":"TagMap",
345+
"documentation":"<p>The metadata to apply to the cluster to assist with categorization and organization. Each tag consists of a key and an optional value, both of which you define.</p>"
287346
}
288347
}
289348
},
@@ -475,6 +534,27 @@
475534
}
476535
}
477536
},
537+
"ListTagsForResourceRequest":{
538+
"type":"structure",
539+
"required":["resourceArn"],
540+
"members":{
541+
"resourceArn":{
542+
"shape":"String",
543+
"documentation":"<p>The Amazon Resource Name (ARN) that identifies the resource for which to list the tags. Currently, the supported resources are Amazon EKS clusters.</p>",
544+
"location":"uri",
545+
"locationName":"resourceArn"
546+
}
547+
}
548+
},
549+
"ListTagsForResourceResponse":{
550+
"type":"structure",
551+
"members":{
552+
"tags":{
553+
"shape":"TagMap",
554+
"documentation":"<p>The tags for the resource.</p>"
555+
}
556+
}
557+
},
478558
"ListUpdatesRequest":{
479559
"type":"structure",
480560
"required":["name"],
@@ -560,6 +640,15 @@
560640
},
561641
"documentation":"<p>An object representing the logging configuration for resources in your cluster.</p>"
562642
},
643+
"NotFoundException":{
644+
"type":"structure",
645+
"members":{
646+
"message":{"shape":"String"}
647+
},
648+
"documentation":"<p>A service resource associated with the request could not be found. Clients should not retry such requests.</p>",
649+
"error":{"httpStatusCode":404},
650+
"exception":true
651+
},
563652
"OIDC":{
564653
"type":"structure",
565654
"members":{
@@ -638,6 +727,52 @@
638727
"type":"list",
639728
"member":{"shape":"String"}
640729
},
730+
"TagKey":{
731+
"type":"string",
732+
"max":128,
733+
"min":1
734+
},
735+
"TagKeyList":{
736+
"type":"list",
737+
"member":{"shape":"TagKey"},
738+
"max":50,
739+
"min":1
740+
},
741+
"TagMap":{
742+
"type":"map",
743+
"key":{"shape":"TagKey"},
744+
"value":{"shape":"TagValue"},
745+
"max":50,
746+
"min":1
747+
},
748+
"TagResourceRequest":{
749+
"type":"structure",
750+
"required":[
751+
"resourceArn",
752+
"tags"
753+
],
754+
"members":{
755+
"resourceArn":{
756+
"shape":"String",
757+
"documentation":"<p>The Amazon Resource Name (ARN) of the resource to which to add tags. Currently, the supported resources are Amazon EKS clusters.</p>",
758+
"location":"uri",
759+
"locationName":"resourceArn"
760+
},
761+
"tags":{
762+
"shape":"TagMap",
763+
"documentation":"<p>The tags to add to the resource. A tag is an array of key-value pairs.</p>"
764+
}
765+
}
766+
},
767+
"TagResourceResponse":{
768+
"type":"structure",
769+
"members":{
770+
}
771+
},
772+
"TagValue":{
773+
"type":"string",
774+
"max":256
775+
},
641776
"Timestamp":{"type":"timestamp"},
642777
"UnsupportedAvailabilityZoneException":{
643778
"type":"structure",
@@ -656,6 +791,32 @@
656791
"error":{"httpStatusCode":400},
657792
"exception":true
658793
},
794+
"UntagResourceRequest":{
795+
"type":"structure",
796+
"required":[
797+
"resourceArn",
798+
"tagKeys"
799+
],
800+
"members":{
801+
"resourceArn":{
802+
"shape":"String",
803+
"documentation":"<p>The Amazon Resource Name (ARN) of the resource from which to delete tags. Currently, the supported resources are Amazon EKS clusters.</p>",
804+
"location":"uri",
805+
"locationName":"resourceArn"
806+
},
807+
"tagKeys":{
808+
"shape":"TagKeyList",
809+
"documentation":"<p>The keys of the tags to be removed.</p>",
810+
"location":"querystring",
811+
"locationName":"tagKeys"
812+
}
813+
}
814+
},
815+
"UntagResourceResponse":{
816+
"type":"structure",
817+
"members":{
818+
}
819+
},
659820
"Update":{
660821
"type":"structure",
661822
"members":{

0 commit comments

Comments
 (0)