aws-sdk-ecs 1.105.0 → 1.107.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 +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-ecs/client.rb +338 -14
- data/lib/aws-sdk-ecs/client_api.rb +88 -0
- data/lib/aws-sdk-ecs/endpoint_parameters.rb +3 -0
- data/lib/aws-sdk-ecs/endpoint_provider.rb +76 -76
- data/lib/aws-sdk-ecs/endpoints.rb +14 -0
- data/lib/aws-sdk-ecs/errors.rb +11 -0
- data/lib/aws-sdk-ecs/plugins/endpoints.rb +2 -0
- data/lib/aws-sdk-ecs/types.rb +700 -2106
- data/lib/aws-sdk-ecs.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: bd656115569cd3894a60003c588d2781e3d2ad34c527f9d603beebe1c2012000
|
4
|
+
data.tar.gz: e6174cd7d6a3c7dc33f5187354220e6139883990f69d0c7185a71ecde59b3567
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 711348c5ef910937f8c832fd2a1eb357cadff82bca8ffbbf265b2c581967e4a46b885949c983908863d024afd1aef32bfad23bf808a03ec6505b143d6ddf5bb4
|
7
|
+
data.tar.gz: b8dca5e60ce61186106ea732889a8c6272098e97e025fecbfc61725da872264405709c3e9652f8e11b1e5b2de319ab547e1fc8d8bc1f504549fe60b18420a3a8
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,16 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.107.0 (2022-12-02)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Documentation updates for Amazon ECS
|
8
|
+
|
9
|
+
1.106.0 (2022-11-28)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - This release adds support for ECS Service Connect, a new capability that simplifies writing and operating resilient distributed applications. This release updates the TaskDefinition, Cluster, Service mutation APIs with Service connect constructs and also adds a new ListServicesByNamespace API.
|
13
|
+
|
4
14
|
1.105.0 (2022-11-10)
|
5
15
|
------------------
|
6
16
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.107.0
|
data/lib/aws-sdk-ecs/client.rb
CHANGED
@@ -577,6 +577,28 @@ module Aws::ECS
|
|
577
577
|
# when it was created, it can be defined later with the
|
578
578
|
# PutClusterCapacityProviders API operation.
|
579
579
|
#
|
580
|
+
# @option params [Types::ClusterServiceConnectDefaultsRequest] :service_connect_defaults
|
581
|
+
# Use this parameter to set a default Service Connect namespace. After
|
582
|
+
# you set a default Service Connect namespace, any new services with
|
583
|
+
# Service Connect turned on that are created in the cluster are added as
|
584
|
+
# client services in the namespace. This setting only applies to new
|
585
|
+
# services that set the `enabled` parameter to `true` in the
|
586
|
+
# `ServiceConnectConfiguration`. You can set the namespace of each
|
587
|
+
# service individually in the `ServiceConnectConfiguration` to override
|
588
|
+
# this default parameter.
|
589
|
+
#
|
590
|
+
# Tasks that run in a namespace can use short names to connect to
|
591
|
+
# services in the namespace. Tasks can connect to services across all of
|
592
|
+
# the clusters in the namespace. Tasks connect through a managed proxy
|
593
|
+
# container that collects logs and metrics for increased visibility.
|
594
|
+
# Only the tasks that Amazon ECS services create are supported with
|
595
|
+
# Service Connect. For more information, see [Service Connect][1] in the
|
596
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
597
|
+
#
|
598
|
+
#
|
599
|
+
#
|
600
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html
|
601
|
+
#
|
580
602
|
# @return [Types::CreateClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
581
603
|
#
|
582
604
|
# * {Types::CreateClusterResponse#cluster #cluster} => Types::Cluster
|
@@ -640,6 +662,9 @@ module Aws::ECS
|
|
640
662
|
# base: 1,
|
641
663
|
# },
|
642
664
|
# ],
|
665
|
+
# service_connect_defaults: {
|
666
|
+
# namespace: "String", # required
|
667
|
+
# },
|
643
668
|
# })
|
644
669
|
#
|
645
670
|
# @example Response structure
|
@@ -681,6 +706,7 @@ module Aws::ECS
|
|
681
706
|
# resp.cluster.attachments[0].details[0].name #=> String
|
682
707
|
# resp.cluster.attachments[0].details[0].value #=> String
|
683
708
|
# resp.cluster.attachments_status #=> String
|
709
|
+
# resp.cluster.service_connect_defaults.namespace #=> String
|
684
710
|
#
|
685
711
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/CreateCluster AWS API Documentation
|
686
712
|
#
|
@@ -1015,8 +1041,8 @@ module Aws::ECS
|
|
1015
1041
|
# defined and you don't specify a health check grace period value, the
|
1016
1042
|
# default value of `0` is used.
|
1017
1043
|
#
|
1018
|
-
# If you do not use an Elastic Load Balancing, we
|
1019
|
-
# the `startPeriod` in the task definition
|
1044
|
+
# If you do not use an Elastic Load Balancing, we recommend that you use
|
1045
|
+
# the `startPeriod` in the task definition health check parameters. For
|
1020
1046
|
# more information, see [Health check][1].
|
1021
1047
|
#
|
1022
1048
|
# If your service's tasks take a while to start and respond to Elastic
|
@@ -1118,6 +1144,23 @@ module Aws::ECS
|
|
1118
1144
|
# the service. If `true`, this enables execute command functionality on
|
1119
1145
|
# all containers in the service tasks.
|
1120
1146
|
#
|
1147
|
+
# @option params [Types::ServiceConnectConfiguration] :service_connect_configuration
|
1148
|
+
# The configuration for this service to discover and connect to
|
1149
|
+
# services, and be discovered by, and connected from, other services
|
1150
|
+
# within a namespace.
|
1151
|
+
#
|
1152
|
+
# Tasks that run in a namespace can use short names to connect to
|
1153
|
+
# services in the namespace. Tasks can connect to services across all of
|
1154
|
+
# the clusters in the namespace. Tasks connect through a managed proxy
|
1155
|
+
# container that collects logs and metrics for increased visibility.
|
1156
|
+
# Only the tasks that Amazon ECS services create are supported with
|
1157
|
+
# Service Connect. For more information, see [Service Connect][1] in the
|
1158
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
1159
|
+
#
|
1160
|
+
#
|
1161
|
+
#
|
1162
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html
|
1163
|
+
#
|
1121
1164
|
# @return [Types::CreateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1122
1165
|
#
|
1123
1166
|
# * {Types::CreateServiceResponse#service #service} => Types::Service
|
@@ -1315,6 +1358,35 @@ module Aws::ECS
|
|
1315
1358
|
# enable_ecs_managed_tags: false,
|
1316
1359
|
# propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION, SERVICE, NONE
|
1317
1360
|
# enable_execute_command: false,
|
1361
|
+
# service_connect_configuration: {
|
1362
|
+
# enabled: false, # required
|
1363
|
+
# namespace: "String",
|
1364
|
+
# services: [
|
1365
|
+
# {
|
1366
|
+
# port_name: "String", # required
|
1367
|
+
# discovery_name: "String",
|
1368
|
+
# client_aliases: [
|
1369
|
+
# {
|
1370
|
+
# port: 1, # required
|
1371
|
+
# dns_name: "String",
|
1372
|
+
# },
|
1373
|
+
# ],
|
1374
|
+
# ingress_port_override: 1,
|
1375
|
+
# },
|
1376
|
+
# ],
|
1377
|
+
# log_configuration: {
|
1378
|
+
# log_driver: "json-file", # required, accepts json-file, syslog, journald, gelf, fluentd, awslogs, splunk, awsfirelens
|
1379
|
+
# options: {
|
1380
|
+
# "String" => "String",
|
1381
|
+
# },
|
1382
|
+
# secret_options: [
|
1383
|
+
# {
|
1384
|
+
# name: "String", # required
|
1385
|
+
# value_from: "String", # required
|
1386
|
+
# },
|
1387
|
+
# ],
|
1388
|
+
# },
|
1389
|
+
# },
|
1318
1390
|
# })
|
1319
1391
|
#
|
1320
1392
|
# @example Response structure
|
@@ -1415,6 +1487,24 @@ module Aws::ECS
|
|
1415
1487
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
1416
1488
|
# resp.service.deployments[0].rollout_state #=> String, one of "COMPLETED", "FAILED", "IN_PROGRESS"
|
1417
1489
|
# resp.service.deployments[0].rollout_state_reason #=> String
|
1490
|
+
# resp.service.deployments[0].service_connect_configuration.enabled #=> Boolean
|
1491
|
+
# resp.service.deployments[0].service_connect_configuration.namespace #=> String
|
1492
|
+
# resp.service.deployments[0].service_connect_configuration.services #=> Array
|
1493
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].port_name #=> String
|
1494
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].discovery_name #=> String
|
1495
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].client_aliases #=> Array
|
1496
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].client_aliases[0].port #=> Integer
|
1497
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].client_aliases[0].dns_name #=> String
|
1498
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].ingress_port_override #=> Integer
|
1499
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.log_driver #=> String, one of "json-file", "syslog", "journald", "gelf", "fluentd", "awslogs", "splunk", "awsfirelens"
|
1500
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.options #=> Hash
|
1501
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.options["String"] #=> String
|
1502
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.secret_options #=> Array
|
1503
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.secret_options[0].name #=> String
|
1504
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.secret_options[0].value_from #=> String
|
1505
|
+
# resp.service.deployments[0].service_connect_resources #=> Array
|
1506
|
+
# resp.service.deployments[0].service_connect_resources[0].discovery_name #=> String
|
1507
|
+
# resp.service.deployments[0].service_connect_resources[0].discovery_arn #=> String
|
1418
1508
|
# resp.service.role_arn #=> String
|
1419
1509
|
# resp.service.events #=> Array
|
1420
1510
|
# resp.service.events[0].id #=> String
|
@@ -1968,6 +2058,7 @@ module Aws::ECS
|
|
1968
2058
|
# resp.cluster.attachments[0].details[0].name #=> String
|
1969
2059
|
# resp.cluster.attachments[0].details[0].value #=> String
|
1970
2060
|
# resp.cluster.attachments_status #=> String
|
2061
|
+
# resp.cluster.service_connect_defaults.namespace #=> String
|
1971
2062
|
#
|
1972
2063
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeleteCluster AWS API Documentation
|
1973
2064
|
#
|
@@ -2138,6 +2229,24 @@ module Aws::ECS
|
|
2138
2229
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
2139
2230
|
# resp.service.deployments[0].rollout_state #=> String, one of "COMPLETED", "FAILED", "IN_PROGRESS"
|
2140
2231
|
# resp.service.deployments[0].rollout_state_reason #=> String
|
2232
|
+
# resp.service.deployments[0].service_connect_configuration.enabled #=> Boolean
|
2233
|
+
# resp.service.deployments[0].service_connect_configuration.namespace #=> String
|
2234
|
+
# resp.service.deployments[0].service_connect_configuration.services #=> Array
|
2235
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].port_name #=> String
|
2236
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].discovery_name #=> String
|
2237
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].client_aliases #=> Array
|
2238
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].client_aliases[0].port #=> Integer
|
2239
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].client_aliases[0].dns_name #=> String
|
2240
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].ingress_port_override #=> Integer
|
2241
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.log_driver #=> String, one of "json-file", "syslog", "journald", "gelf", "fluentd", "awslogs", "splunk", "awsfirelens"
|
2242
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.options #=> Hash
|
2243
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.options["String"] #=> String
|
2244
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.secret_options #=> Array
|
2245
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.secret_options[0].name #=> String
|
2246
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.secret_options[0].value_from #=> String
|
2247
|
+
# resp.service.deployments[0].service_connect_resources #=> Array
|
2248
|
+
# resp.service.deployments[0].service_connect_resources[0].discovery_name #=> String
|
2249
|
+
# resp.service.deployments[0].service_connect_resources[0].discovery_arn #=> String
|
2141
2250
|
# resp.service.role_arn #=> String
|
2142
2251
|
# resp.service.events #=> Array
|
2143
2252
|
# resp.service.events[0].id #=> String
|
@@ -2459,6 +2568,8 @@ module Aws::ECS
|
|
2459
2568
|
# resp.task_definition.container_definitions[0].port_mappings[0].container_port #=> Integer
|
2460
2569
|
# resp.task_definition.container_definitions[0].port_mappings[0].host_port #=> Integer
|
2461
2570
|
# resp.task_definition.container_definitions[0].port_mappings[0].protocol #=> String, one of "tcp", "udp"
|
2571
|
+
# resp.task_definition.container_definitions[0].port_mappings[0].name #=> String
|
2572
|
+
# resp.task_definition.container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
|
2462
2573
|
# resp.task_definition.container_definitions[0].essential #=> Boolean
|
2463
2574
|
# resp.task_definition.container_definitions[0].entry_point #=> Array
|
2464
2575
|
# resp.task_definition.container_definitions[0].entry_point[0] #=> String
|
@@ -2711,7 +2822,8 @@ module Aws::ECS
|
|
2711
2822
|
# isn't included.
|
2712
2823
|
#
|
2713
2824
|
# If `ATTACHMENTS` is specified, the attachments for the container
|
2714
|
-
# instances or tasks within the cluster are included
|
2825
|
+
# instances or tasks within the cluster are included, for example the
|
2826
|
+
# capacity providers.
|
2715
2827
|
#
|
2716
2828
|
# If `SETTINGS` is specified, the settings for the cluster are included.
|
2717
2829
|
#
|
@@ -2800,6 +2912,7 @@ module Aws::ECS
|
|
2800
2912
|
# resp.clusters[0].attachments[0].details[0].name #=> String
|
2801
2913
|
# resp.clusters[0].attachments[0].details[0].value #=> String
|
2802
2914
|
# resp.clusters[0].attachments_status #=> String
|
2915
|
+
# resp.clusters[0].service_connect_defaults.namespace #=> String
|
2803
2916
|
# resp.failures #=> Array
|
2804
2917
|
# resp.failures[0].arn #=> String
|
2805
2918
|
# resp.failures[0].reason #=> String
|
@@ -3190,6 +3303,24 @@ module Aws::ECS
|
|
3190
3303
|
# resp.services[0].deployments[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
3191
3304
|
# resp.services[0].deployments[0].rollout_state #=> String, one of "COMPLETED", "FAILED", "IN_PROGRESS"
|
3192
3305
|
# resp.services[0].deployments[0].rollout_state_reason #=> String
|
3306
|
+
# resp.services[0].deployments[0].service_connect_configuration.enabled #=> Boolean
|
3307
|
+
# resp.services[0].deployments[0].service_connect_configuration.namespace #=> String
|
3308
|
+
# resp.services[0].deployments[0].service_connect_configuration.services #=> Array
|
3309
|
+
# resp.services[0].deployments[0].service_connect_configuration.services[0].port_name #=> String
|
3310
|
+
# resp.services[0].deployments[0].service_connect_configuration.services[0].discovery_name #=> String
|
3311
|
+
# resp.services[0].deployments[0].service_connect_configuration.services[0].client_aliases #=> Array
|
3312
|
+
# resp.services[0].deployments[0].service_connect_configuration.services[0].client_aliases[0].port #=> Integer
|
3313
|
+
# resp.services[0].deployments[0].service_connect_configuration.services[0].client_aliases[0].dns_name #=> String
|
3314
|
+
# resp.services[0].deployments[0].service_connect_configuration.services[0].ingress_port_override #=> Integer
|
3315
|
+
# resp.services[0].deployments[0].service_connect_configuration.log_configuration.log_driver #=> String, one of "json-file", "syslog", "journald", "gelf", "fluentd", "awslogs", "splunk", "awsfirelens"
|
3316
|
+
# resp.services[0].deployments[0].service_connect_configuration.log_configuration.options #=> Hash
|
3317
|
+
# resp.services[0].deployments[0].service_connect_configuration.log_configuration.options["String"] #=> String
|
3318
|
+
# resp.services[0].deployments[0].service_connect_configuration.log_configuration.secret_options #=> Array
|
3319
|
+
# resp.services[0].deployments[0].service_connect_configuration.log_configuration.secret_options[0].name #=> String
|
3320
|
+
# resp.services[0].deployments[0].service_connect_configuration.log_configuration.secret_options[0].value_from #=> String
|
3321
|
+
# resp.services[0].deployments[0].service_connect_resources #=> Array
|
3322
|
+
# resp.services[0].deployments[0].service_connect_resources[0].discovery_name #=> String
|
3323
|
+
# resp.services[0].deployments[0].service_connect_resources[0].discovery_arn #=> String
|
3193
3324
|
# resp.services[0].role_arn #=> String
|
3194
3325
|
# resp.services[0].events #=> Array
|
3195
3326
|
# resp.services[0].events[0].id #=> String
|
@@ -3348,6 +3479,8 @@ module Aws::ECS
|
|
3348
3479
|
# resp.task_definition.container_definitions[0].port_mappings[0].container_port #=> Integer
|
3349
3480
|
# resp.task_definition.container_definitions[0].port_mappings[0].host_port #=> Integer
|
3350
3481
|
# resp.task_definition.container_definitions[0].port_mappings[0].protocol #=> String, one of "tcp", "udp"
|
3482
|
+
# resp.task_definition.container_definitions[0].port_mappings[0].name #=> String
|
3483
|
+
# resp.task_definition.container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
|
3351
3484
|
# resp.task_definition.container_definitions[0].essential #=> Boolean
|
3352
3485
|
# resp.task_definition.container_definitions[0].entry_point #=> Array
|
3353
3486
|
# resp.task_definition.container_definitions[0].entry_point[0] #=> String
|
@@ -3780,7 +3913,7 @@ module Aws::ECS
|
|
3780
3913
|
# resp.tasks[0].pull_stopped_at #=> Time
|
3781
3914
|
# resp.tasks[0].started_at #=> Time
|
3782
3915
|
# resp.tasks[0].started_by #=> String
|
3783
|
-
# resp.tasks[0].stop_code #=> String, one of "TaskFailedToStart", "EssentialContainerExited", "UserInitiated"
|
3916
|
+
# resp.tasks[0].stop_code #=> String, one of "TaskFailedToStart", "EssentialContainerExited", "UserInitiated", "ServiceSchedulerInitiated", "SpotInterruption", "TerminationNotice"
|
3784
3917
|
# resp.tasks[0].stopped_at #=> Time
|
3785
3918
|
# resp.tasks[0].stopped_reason #=> String
|
3786
3919
|
# resp.tasks[0].stopping_at #=> Time
|
@@ -3835,6 +3968,7 @@ module Aws::ECS
|
|
3835
3968
|
#
|
3836
3969
|
# * {Types::DiscoverPollEndpointResponse#endpoint #endpoint} => String
|
3837
3970
|
# * {Types::DiscoverPollEndpointResponse#telemetry_endpoint #telemetry_endpoint} => String
|
3971
|
+
# * {Types::DiscoverPollEndpointResponse#service_connect_endpoint #service_connect_endpoint} => String
|
3838
3972
|
#
|
3839
3973
|
# @example Request syntax with placeholder values
|
3840
3974
|
#
|
@@ -3847,6 +3981,7 @@ module Aws::ECS
|
|
3847
3981
|
#
|
3848
3982
|
# resp.endpoint #=> String
|
3849
3983
|
# resp.telemetry_endpoint #=> String
|
3984
|
+
# resp.service_connect_endpoint #=> String
|
3850
3985
|
#
|
3851
3986
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DiscoverPollEndpoint AWS API Documentation
|
3852
3987
|
#
|
@@ -3861,7 +3996,7 @@ module Aws::ECS
|
|
3861
3996
|
#
|
3862
3997
|
# If you use a condition key in your IAM policy to refine the conditions
|
3863
3998
|
# for the policy statement, for example limit the actions to a specific
|
3864
|
-
# cluster, you
|
3999
|
+
# cluster, you receive an `AccessDeniedException` when there is a
|
3865
4000
|
# mismatch between the condition key value and the corresponding
|
3866
4001
|
# parameter value.
|
3867
4002
|
#
|
@@ -4472,6 +4607,82 @@ module Aws::ECS
|
|
4472
4607
|
req.send_request(options)
|
4473
4608
|
end
|
4474
4609
|
|
4610
|
+
# This operation lists all of the services that are associated with a
|
4611
|
+
# Cloud Map namespace. This list might include services in different
|
4612
|
+
# clusters. In contrast, `ListServices` can only list services in one
|
4613
|
+
# cluster at a time. If you need to filter the list of services in a
|
4614
|
+
# single cluster by various parameters, use `ListServices`. For more
|
4615
|
+
# information, see [Service Connect][1] in the *Amazon Elastic Container
|
4616
|
+
# Service Developer Guide*.
|
4617
|
+
#
|
4618
|
+
#
|
4619
|
+
#
|
4620
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html
|
4621
|
+
#
|
4622
|
+
# @option params [required, String] :namespace
|
4623
|
+
# The namespace name or full Amazon Resource Name (ARN) of the Cloud Map
|
4624
|
+
# namespace to list the services in.
|
4625
|
+
#
|
4626
|
+
# Tasks that run in a namespace can use short names to connect to
|
4627
|
+
# services in the namespace. Tasks can connect to services across all of
|
4628
|
+
# the clusters in the namespace. Tasks connect through a managed proxy
|
4629
|
+
# container that collects logs and metrics for increased visibility.
|
4630
|
+
# Only the tasks that Amazon ECS services create are supported with
|
4631
|
+
# Service Connect. For more information, see [Service Connect][1] in the
|
4632
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
4633
|
+
#
|
4634
|
+
#
|
4635
|
+
#
|
4636
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html
|
4637
|
+
#
|
4638
|
+
# @option params [String] :next_token
|
4639
|
+
# The `nextToken` value that's returned from a
|
4640
|
+
# `ListServicesByNamespace` request. It indicates that more results are
|
4641
|
+
# available to fulfill the request and further calls are needed. If
|
4642
|
+
# `maxResults` is returned, it is possible the number of results is less
|
4643
|
+
# than `maxResults`.
|
4644
|
+
#
|
4645
|
+
# @option params [Integer] :max_results
|
4646
|
+
# The maximum number of service results that `ListServicesByNamespace`
|
4647
|
+
# returns in paginated output. When this parameter is used,
|
4648
|
+
# `ListServicesByNamespace` only returns `maxResults` results in a
|
4649
|
+
# single page along with a `nextToken` response element. The remaining
|
4650
|
+
# results of the initial request can be seen by sending another
|
4651
|
+
# `ListServicesByNamespace` request with the returned `nextToken` value.
|
4652
|
+
# This value can be between 1 and 100. If this parameter isn't used,
|
4653
|
+
# then `ListServicesByNamespace` returns up to 10 results and a
|
4654
|
+
# `nextToken` value if applicable.
|
4655
|
+
#
|
4656
|
+
# @return [Types::ListServicesByNamespaceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4657
|
+
#
|
4658
|
+
# * {Types::ListServicesByNamespaceResponse#service_arns #service_arns} => Array<String>
|
4659
|
+
# * {Types::ListServicesByNamespaceResponse#next_token #next_token} => String
|
4660
|
+
#
|
4661
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
4662
|
+
#
|
4663
|
+
# @example Request syntax with placeholder values
|
4664
|
+
#
|
4665
|
+
# resp = client.list_services_by_namespace({
|
4666
|
+
# namespace: "String", # required
|
4667
|
+
# next_token: "String",
|
4668
|
+
# max_results: 1,
|
4669
|
+
# })
|
4670
|
+
#
|
4671
|
+
# @example Response structure
|
4672
|
+
#
|
4673
|
+
# resp.service_arns #=> Array
|
4674
|
+
# resp.service_arns[0] #=> String
|
4675
|
+
# resp.next_token #=> String
|
4676
|
+
#
|
4677
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ListServicesByNamespace AWS API Documentation
|
4678
|
+
#
|
4679
|
+
# @overload list_services_by_namespace(params = {})
|
4680
|
+
# @param [Hash] params ({})
|
4681
|
+
def list_services_by_namespace(params = {}, options = {})
|
4682
|
+
req = build_request(:list_services_by_namespace, params)
|
4683
|
+
req.send_request(options)
|
4684
|
+
end
|
4685
|
+
|
4475
4686
|
# List the tags for an Amazon ECS resource.
|
4476
4687
|
#
|
4477
4688
|
# @option params [required, String] :resource_arn
|
@@ -4808,6 +5019,9 @@ module Aws::ECS
|
|
4808
5019
|
# `startedBy` value limits the results to tasks that were started with
|
4809
5020
|
# that value.
|
4810
5021
|
#
|
5022
|
+
# When you specify `startedBy` as the filter, it must be the only filter
|
5023
|
+
# that you use.
|
5024
|
+
#
|
4811
5025
|
# @option params [String] :service_name
|
4812
5026
|
# The name of the service to use when filtering the `ListTasks` results.
|
4813
5027
|
# Specifying a `serviceName` limits the results to tasks that belong to
|
@@ -5289,6 +5503,7 @@ module Aws::ECS
|
|
5289
5503
|
# resp.cluster.attachments[0].details[0].name #=> String
|
5290
5504
|
# resp.cluster.attachments[0].details[0].value #=> String
|
5291
5505
|
# resp.cluster.attachments_status #=> String
|
5506
|
+
# resp.cluster.service_connect_defaults.namespace #=> String
|
5292
5507
|
#
|
5293
5508
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/PutClusterCapacityProviders AWS API Documentation
|
5294
5509
|
#
|
@@ -5930,6 +6145,8 @@ module Aws::ECS
|
|
5930
6145
|
# container_port: 1,
|
5931
6146
|
# host_port: 1,
|
5932
6147
|
# protocol: "tcp", # accepts tcp, udp
|
6148
|
+
# name: "String",
|
6149
|
+
# app_protocol: "http", # accepts http, http2, grpc
|
5933
6150
|
# },
|
5934
6151
|
# ],
|
5935
6152
|
# essential: false,
|
@@ -6159,6 +6376,8 @@ module Aws::ECS
|
|
6159
6376
|
# resp.task_definition.container_definitions[0].port_mappings[0].container_port #=> Integer
|
6160
6377
|
# resp.task_definition.container_definitions[0].port_mappings[0].host_port #=> Integer
|
6161
6378
|
# resp.task_definition.container_definitions[0].port_mappings[0].protocol #=> String, one of "tcp", "udp"
|
6379
|
+
# resp.task_definition.container_definitions[0].port_mappings[0].name #=> String
|
6380
|
+
# resp.task_definition.container_definitions[0].port_mappings[0].app_protocol #=> String, one of "http", "http2", "grpc"
|
6162
6381
|
# resp.task_definition.container_definitions[0].essential #=> Boolean
|
6163
6382
|
# resp.task_definition.container_definitions[0].entry_point #=> Array
|
6164
6383
|
# resp.task_definition.container_definitions[0].entry_point[0] #=> String
|
@@ -6789,7 +7008,7 @@ module Aws::ECS
|
|
6789
7008
|
# resp.tasks[0].pull_stopped_at #=> Time
|
6790
7009
|
# resp.tasks[0].started_at #=> Time
|
6791
7010
|
# resp.tasks[0].started_by #=> String
|
6792
|
-
# resp.tasks[0].stop_code #=> String, one of "TaskFailedToStart", "EssentialContainerExited", "UserInitiated"
|
7011
|
+
# resp.tasks[0].stop_code #=> String, one of "TaskFailedToStart", "EssentialContainerExited", "UserInitiated", "ServiceSchedulerInitiated", "SpotInterruption", "TerminationNotice"
|
6793
7012
|
# resp.tasks[0].stopped_at #=> Time
|
6794
7013
|
# resp.tasks[0].stopped_reason #=> String
|
6795
7014
|
# resp.tasks[0].stopping_at #=> Time
|
@@ -7097,7 +7316,7 @@ module Aws::ECS
|
|
7097
7316
|
# resp.tasks[0].pull_stopped_at #=> Time
|
7098
7317
|
# resp.tasks[0].started_at #=> Time
|
7099
7318
|
# resp.tasks[0].started_by #=> String
|
7100
|
-
# resp.tasks[0].stop_code #=> String, one of "TaskFailedToStart", "EssentialContainerExited", "UserInitiated"
|
7319
|
+
# resp.tasks[0].stop_code #=> String, one of "TaskFailedToStart", "EssentialContainerExited", "UserInitiated", "ServiceSchedulerInitiated", "SpotInterruption", "TerminationNotice"
|
7101
7320
|
# resp.tasks[0].stopped_at #=> Time
|
7102
7321
|
# resp.tasks[0].stopped_reason #=> String
|
7103
7322
|
# resp.tasks[0].stopping_at #=> Time
|
@@ -7263,7 +7482,7 @@ module Aws::ECS
|
|
7263
7482
|
# resp.task.pull_stopped_at #=> Time
|
7264
7483
|
# resp.task.started_at #=> Time
|
7265
7484
|
# resp.task.started_by #=> String
|
7266
|
-
# resp.task.stop_code #=> String, one of "TaskFailedToStart", "EssentialContainerExited", "UserInitiated"
|
7485
|
+
# resp.task.stop_code #=> String, one of "TaskFailedToStart", "EssentialContainerExited", "UserInitiated", "ServiceSchedulerInitiated", "SpotInterruption", "TerminationNotice"
|
7267
7486
|
# resp.task.stopped_at #=> Time
|
7268
7487
|
# resp.task.stopped_reason #=> String
|
7269
7488
|
# resp.task.stopping_at #=> Time
|
@@ -7687,6 +7906,28 @@ module Aws::ECS
|
|
7687
7906
|
# @option params [Types::ClusterConfiguration] :configuration
|
7688
7907
|
# The execute command configuration for the cluster.
|
7689
7908
|
#
|
7909
|
+
# @option params [Types::ClusterServiceConnectDefaultsRequest] :service_connect_defaults
|
7910
|
+
# Use this parameter to set a default Service Connect namespace. After
|
7911
|
+
# you set a default Service Connect namespace, any new services with
|
7912
|
+
# Service Connect turned on that are created in the cluster are added as
|
7913
|
+
# client services in the namespace. This setting only applies to new
|
7914
|
+
# services that set the `enabled` parameter to `true` in the
|
7915
|
+
# `ServiceConnectConfiguration`. You can set the namespace of each
|
7916
|
+
# service individually in the `ServiceConnectConfiguration` to override
|
7917
|
+
# this default parameter.
|
7918
|
+
#
|
7919
|
+
# Tasks that run in a namespace can use short names to connect to
|
7920
|
+
# services in the namespace. Tasks can connect to services across all of
|
7921
|
+
# the clusters in the namespace. Tasks connect through a managed proxy
|
7922
|
+
# container that collects logs and metrics for increased visibility.
|
7923
|
+
# Only the tasks that Amazon ECS services create are supported with
|
7924
|
+
# Service Connect. For more information, see [Service Connect][1] in the
|
7925
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
7926
|
+
#
|
7927
|
+
#
|
7928
|
+
#
|
7929
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html
|
7930
|
+
#
|
7690
7931
|
# @return [Types::UpdateClusterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
7691
7932
|
#
|
7692
7933
|
# * {Types::UpdateClusterResponse#cluster #cluster} => Types::Cluster
|
@@ -7714,6 +7955,9 @@ module Aws::ECS
|
|
7714
7955
|
# },
|
7715
7956
|
# },
|
7716
7957
|
# },
|
7958
|
+
# service_connect_defaults: {
|
7959
|
+
# namespace: "String", # required
|
7960
|
+
# },
|
7717
7961
|
# })
|
7718
7962
|
#
|
7719
7963
|
# @example Response structure
|
@@ -7755,6 +7999,7 @@ module Aws::ECS
|
|
7755
7999
|
# resp.cluster.attachments[0].details[0].name #=> String
|
7756
8000
|
# resp.cluster.attachments[0].details[0].value #=> String
|
7757
8001
|
# resp.cluster.attachments_status #=> String
|
8002
|
+
# resp.cluster.service_connect_defaults.namespace #=> String
|
7758
8003
|
#
|
7759
8004
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateCluster AWS API Documentation
|
7760
8005
|
#
|
@@ -7776,6 +8021,13 @@ module Aws::ECS
|
|
7776
8021
|
# specified, it overrides the `containerInsights` value set with
|
7777
8022
|
# PutAccountSetting or PutAccountSettingDefault.
|
7778
8023
|
#
|
8024
|
+
# Currently, if you delete an existing cluster that does not have
|
8025
|
+
# Container Insights turned on, and then create a new cluster with the
|
8026
|
+
# same name with Container Insights tuned on, Container Insights will
|
8027
|
+
# not actually be turned on. If you want to preserve the same name for
|
8028
|
+
# your existing cluster and turn on Container Insights, you must wait 7
|
8029
|
+
# days before you can re-create it.
|
8030
|
+
#
|
7779
8031
|
# @return [Types::UpdateClusterSettingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
7780
8032
|
#
|
7781
8033
|
# * {Types::UpdateClusterSettingsResponse#cluster #cluster} => Types::Cluster
|
@@ -7831,6 +8083,7 @@ module Aws::ECS
|
|
7831
8083
|
# resp.cluster.attachments[0].details[0].name #=> String
|
7832
8084
|
# resp.cluster.attachments[0].details[0].value #=> String
|
7833
8085
|
# resp.cluster.attachments_status #=> String
|
8086
|
+
# resp.cluster.service_connect_defaults.namespace #=> String
|
7834
8087
|
#
|
7835
8088
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/UpdateClusterSettings AWS API Documentation
|
7836
8089
|
#
|
@@ -7857,6 +8110,13 @@ module Aws::ECS
|
|
7857
8110
|
#
|
7858
8111
|
# </note>
|
7859
8112
|
#
|
8113
|
+
# <note markdown="1"> Agent updates with the `UpdateContainerAgent` API operation do not
|
8114
|
+
# apply to Windows container instances. We recommend that you launch new
|
8115
|
+
# container instances to update the agent version in your Windows
|
8116
|
+
# clusters.
|
8117
|
+
#
|
8118
|
+
# </note>
|
8119
|
+
#
|
7860
8120
|
# The `UpdateContainerAgent` API requires an Amazon ECS-optimized AMI or
|
7861
8121
|
# Amazon Linux AMI with the `ecs-init` service installed and running.
|
7862
8122
|
# For help updating the Amazon ECS container agent on other operating
|
@@ -8425,6 +8685,23 @@ module Aws::ECS
|
|
8425
8685
|
#
|
8426
8686
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html
|
8427
8687
|
#
|
8688
|
+
# @option params [Types::ServiceConnectConfiguration] :service_connect_configuration
|
8689
|
+
# The configuration for this service to discover and connect to
|
8690
|
+
# services, and be discovered by, and connected from, other services
|
8691
|
+
# within a namespace.
|
8692
|
+
#
|
8693
|
+
# Tasks that run in a namespace can use short names to connect to
|
8694
|
+
# services in the namespace. Tasks can connect to services across all of
|
8695
|
+
# the clusters in the namespace. Tasks connect through a managed proxy
|
8696
|
+
# container that collects logs and metrics for increased visibility.
|
8697
|
+
# Only the tasks that Amazon ECS services create are supported with
|
8698
|
+
# Service Connect. For more information, see [Service Connect][1] in the
|
8699
|
+
# *Amazon Elastic Container Service Developer Guide*.
|
8700
|
+
#
|
8701
|
+
#
|
8702
|
+
#
|
8703
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html
|
8704
|
+
#
|
8428
8705
|
# @return [Types::UpdateServiceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
8429
8706
|
#
|
8430
8707
|
# * {Types::UpdateServiceResponse#service #service} => Types::Service
|
@@ -8519,6 +8796,35 @@ module Aws::ECS
|
|
8519
8796
|
# container_port: 1,
|
8520
8797
|
# },
|
8521
8798
|
# ],
|
8799
|
+
# service_connect_configuration: {
|
8800
|
+
# enabled: false, # required
|
8801
|
+
# namespace: "String",
|
8802
|
+
# services: [
|
8803
|
+
# {
|
8804
|
+
# port_name: "String", # required
|
8805
|
+
# discovery_name: "String",
|
8806
|
+
# client_aliases: [
|
8807
|
+
# {
|
8808
|
+
# port: 1, # required
|
8809
|
+
# dns_name: "String",
|
8810
|
+
# },
|
8811
|
+
# ],
|
8812
|
+
# ingress_port_override: 1,
|
8813
|
+
# },
|
8814
|
+
# ],
|
8815
|
+
# log_configuration: {
|
8816
|
+
# log_driver: "json-file", # required, accepts json-file, syslog, journald, gelf, fluentd, awslogs, splunk, awsfirelens
|
8817
|
+
# options: {
|
8818
|
+
# "String" => "String",
|
8819
|
+
# },
|
8820
|
+
# secret_options: [
|
8821
|
+
# {
|
8822
|
+
# name: "String", # required
|
8823
|
+
# value_from: "String", # required
|
8824
|
+
# },
|
8825
|
+
# ],
|
8826
|
+
# },
|
8827
|
+
# },
|
8522
8828
|
# })
|
8523
8829
|
#
|
8524
8830
|
# @example Response structure
|
@@ -8619,6 +8925,24 @@ module Aws::ECS
|
|
8619
8925
|
# resp.service.deployments[0].network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
|
8620
8926
|
# resp.service.deployments[0].rollout_state #=> String, one of "COMPLETED", "FAILED", "IN_PROGRESS"
|
8621
8927
|
# resp.service.deployments[0].rollout_state_reason #=> String
|
8928
|
+
# resp.service.deployments[0].service_connect_configuration.enabled #=> Boolean
|
8929
|
+
# resp.service.deployments[0].service_connect_configuration.namespace #=> String
|
8930
|
+
# resp.service.deployments[0].service_connect_configuration.services #=> Array
|
8931
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].port_name #=> String
|
8932
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].discovery_name #=> String
|
8933
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].client_aliases #=> Array
|
8934
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].client_aliases[0].port #=> Integer
|
8935
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].client_aliases[0].dns_name #=> String
|
8936
|
+
# resp.service.deployments[0].service_connect_configuration.services[0].ingress_port_override #=> Integer
|
8937
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.log_driver #=> String, one of "json-file", "syslog", "journald", "gelf", "fluentd", "awslogs", "splunk", "awsfirelens"
|
8938
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.options #=> Hash
|
8939
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.options["String"] #=> String
|
8940
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.secret_options #=> Array
|
8941
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.secret_options[0].name #=> String
|
8942
|
+
# resp.service.deployments[0].service_connect_configuration.log_configuration.secret_options[0].value_from #=> String
|
8943
|
+
# resp.service.deployments[0].service_connect_resources #=> Array
|
8944
|
+
# resp.service.deployments[0].service_connect_resources[0].discovery_name #=> String
|
8945
|
+
# resp.service.deployments[0].service_connect_resources[0].discovery_arn #=> String
|
8622
8946
|
# resp.service.role_arn #=> String
|
8623
8947
|
# resp.service.events #=> Array
|
8624
8948
|
# resp.service.events[0].id #=> String
|
@@ -8763,8 +9087,8 @@ module Aws::ECS
|
|
8763
9087
|
# task by invoking this operation repeatedly.
|
8764
9088
|
#
|
8765
9089
|
# To learn more about Amazon ECS task protection, see [Task scale-in
|
8766
|
-
# protection][3] in the
|
8767
|
-
# Guide
|
9090
|
+
# protection][3] in the <i> <i>Amazon Elastic Container Service
|
9091
|
+
# Developer Guide</i> </i>.
|
8768
9092
|
#
|
8769
9093
|
# <note markdown="1"> This operation is only supported for tasks belonging to an Amazon ECS
|
8770
9094
|
# service. Invoking this operation for a standalone task will result in
|
@@ -8774,15 +9098,15 @@ module Aws::ECS
|
|
8774
9098
|
# </note>
|
8775
9099
|
#
|
8776
9100
|
# If you prefer to set task protection from within the container, we
|
8777
|
-
# recommend using the [
|
9101
|
+
# recommend using the [Task scale-in protection endpoint][5].
|
8778
9102
|
#
|
8779
9103
|
#
|
8780
9104
|
#
|
8781
9105
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-auto-scaling.html
|
8782
9106
|
# [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html
|
8783
9107
|
# [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-scale-in-protection.html
|
8784
|
-
# [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/api_failures_messages.html
|
8785
|
-
# [5]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/
|
9108
|
+
# [4]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/api_failures_messages.html
|
9109
|
+
# [5]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-scale-in-protection-endpoint.html
|
8786
9110
|
#
|
8787
9111
|
# @option params [required, String] :cluster
|
8788
9112
|
# The short name or full Amazon Resource Name (ARN) of the cluster that
|
@@ -9025,7 +9349,7 @@ module Aws::ECS
|
|
9025
9349
|
params: params,
|
9026
9350
|
config: config)
|
9027
9351
|
context[:gem_name] = 'aws-sdk-ecs'
|
9028
|
-
context[:gem_version] = '1.
|
9352
|
+
context[:gem_version] = '1.107.0'
|
9029
9353
|
Seahorse::Client::Request.new(handlers, context)
|
9030
9354
|
end
|
9031
9355
|
|