awscli 1.38.15__py3-none-any.whl → 1.38.16__py3-none-any.whl
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.
Potentially problematic release.
This version of awscli might be problematic. Click here for more details.
- awscli/__init__.py +1 -1
- awscli/examples/ecs/create-service.rst +149 -12
- awscli/examples/ecs/run-task.rst +127 -2
- awscli/examples/ecs/start-task.rst +128 -8
- awscli/examples/ecs/update-service.rst +517 -7
- awscli/examples/servicediscovery/create-http-namespace.rst +17 -0
- awscli/examples/servicediscovery/create-public-dns-namespace.rst +18 -0
- awscli/examples/servicediscovery/delete-service-attributes.rst +11 -0
- awscli/examples/servicediscovery/discover-instances-revision.rst +15 -0
- awscli/examples/servicediscovery/discover-instances.rst +1 -0
- awscli/examples/servicediscovery/get-instance.rst +24 -0
- awscli/examples/servicediscovery/get-instances-health-status.rst +17 -0
- awscli/examples/servicediscovery/get-namespace.rst +28 -0
- awscli/examples/servicediscovery/get-operation.rst +2 -1
- awscli/examples/servicediscovery/get-service-attributes.rst +19 -0
- awscli/examples/servicediscovery/get-service.rst +23 -0
- awscli/examples/servicediscovery/list-operations.rst +29 -0
- awscli/examples/servicediscovery/list-tags-for-resource.rst +23 -0
- awscli/examples/servicediscovery/tag-resource.rst +11 -0
- awscli/examples/servicediscovery/untag-resource.rst +11 -0
- awscli/examples/servicediscovery/update-http-namespace.rst +18 -0
- awscli/examples/servicediscovery/update-instance-custom-health-status.rst +12 -0
- awscli/examples/servicediscovery/update-private-dns-namespace.rst +18 -0
- awscli/examples/servicediscovery/update-public-dns-namespace.rst +18 -0
- awscli/examples/servicediscovery/update-service-attributes.rst +11 -0
- awscli/examples/servicediscovery/update-service.rst +17 -0
- {awscli-1.38.15.dist-info → awscli-1.38.16.dist-info}/METADATA +2 -2
- {awscli-1.38.15.dist-info → awscli-1.38.16.dist-info}/RECORD +36 -17
- {awscli-1.38.15.data → awscli-1.38.16.data}/scripts/aws +0 -0
- {awscli-1.38.15.data → awscli-1.38.16.data}/scripts/aws.cmd +0 -0
- {awscli-1.38.15.data → awscli-1.38.16.data}/scripts/aws_bash_completer +0 -0
- {awscli-1.38.15.data → awscli-1.38.16.data}/scripts/aws_completer +0 -0
- {awscli-1.38.15.data → awscli-1.38.16.data}/scripts/aws_zsh_completer.sh +0 -0
- {awscli-1.38.15.dist-info → awscli-1.38.16.dist-info}/LICENSE.txt +0 -0
- {awscli-1.38.15.dist-info → awscli-1.38.16.dist-info}/WHEEL +0 -0
- {awscli-1.38.15.dist-info → awscli-1.38.16.dist-info}/top_level.txt +0 -0
|
@@ -1,11 +1,153 @@
|
|
|
1
|
-
**Example 1: To change the
|
|
1
|
+
**Example 1: To change the task definition used in a service**
|
|
2
2
|
|
|
3
|
-
The following ``update-service`` example updates the
|
|
3
|
+
The following ``update-service`` example updates the ``my-http-service`` service to use the ``amazon-ecs-sample`` task definition. ::
|
|
4
4
|
|
|
5
5
|
aws ecs update-service \
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
6
|
+
--cluster test \
|
|
7
|
+
--service my-http-service \
|
|
8
|
+
--task-definition amazon-ecs-sample
|
|
9
|
+
|
|
10
|
+
Output::
|
|
11
|
+
|
|
12
|
+
{
|
|
13
|
+
"service": {
|
|
14
|
+
"serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/test/my-http-service",
|
|
15
|
+
"serviceName": "my-http-service",
|
|
16
|
+
"clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/test",
|
|
17
|
+
"loadBalancers": [],
|
|
18
|
+
"serviceRegistries": [],
|
|
19
|
+
"status": "ACTIVE",
|
|
20
|
+
"desiredCount": 2,
|
|
21
|
+
"runningCount": 2,
|
|
22
|
+
"pendingCount": 0,
|
|
23
|
+
"launchType": "FARGATE",
|
|
24
|
+
"platformVersion": "1.4.0",
|
|
25
|
+
"platformFamily": "Linux",
|
|
26
|
+
"taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/amazon-ecs-sample:2",
|
|
27
|
+
"deploymentConfiguration": {
|
|
28
|
+
"deploymentCircuitBreaker": {
|
|
29
|
+
"enable": true,
|
|
30
|
+
"rollback": true
|
|
31
|
+
},
|
|
32
|
+
"maximumPercent": 200,
|
|
33
|
+
"minimumHealthyPercent": 100,
|
|
34
|
+
"alarms": {
|
|
35
|
+
"alarmNames": [],
|
|
36
|
+
"rollback": false,
|
|
37
|
+
"enable": false
|
|
38
|
+
}
|
|
39
|
+
},
|
|
40
|
+
"deployments": [
|
|
41
|
+
{
|
|
42
|
+
"id": "ecs-svc/7419115625193919142",
|
|
43
|
+
"status": "PRIMARY",
|
|
44
|
+
"taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/amazon-ecs-sample:2",
|
|
45
|
+
"desiredCount": 0,
|
|
46
|
+
"pendingCount": 0,
|
|
47
|
+
"runningCount": 0,
|
|
48
|
+
"failedTasks": 0,
|
|
49
|
+
"createdAt": "2025-02-21T13:26:02.734000-06:00",
|
|
50
|
+
"updatedAt": "2025-02-21T13:26:02.734000-06:00",
|
|
51
|
+
"launchType": "FARGATE",
|
|
52
|
+
"platformVersion": "1.4.0",
|
|
53
|
+
"platformFamily": "Linux",
|
|
54
|
+
"networkConfiguration": {
|
|
55
|
+
"awsvpcConfiguration": {
|
|
56
|
+
"subnets": [
|
|
57
|
+
"subnet-12344321"
|
|
58
|
+
],
|
|
59
|
+
"securityGroups": [
|
|
60
|
+
"sg-12344321"
|
|
61
|
+
],
|
|
62
|
+
"assignPublicIp": "ENABLED"
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
"rolloutState": "IN_PROGRESS",
|
|
66
|
+
"rolloutStateReason": "ECS deployment ecs-svc/7419115625193919142 in progress."
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
"id": "ecs-svc/1709597507655421668",
|
|
70
|
+
"status": "ACTIVE",
|
|
71
|
+
"taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/old-amazon-ecs-sample:4",
|
|
72
|
+
"desiredCount": 2,
|
|
73
|
+
"pendingCount": 0,
|
|
74
|
+
"runningCount": 2,
|
|
75
|
+
"failedTasks": 0,
|
|
76
|
+
"createdAt": "2025-01-24T11:13:07.621000-06:00",
|
|
77
|
+
"updatedAt": "2025-02-02T16:11:30.838000-06:00",
|
|
78
|
+
"launchType": "FARGATE",
|
|
79
|
+
"platformVersion": "1.4.0",
|
|
80
|
+
"platformFamily": "Linux",
|
|
81
|
+
"networkConfiguration": {
|
|
82
|
+
"awsvpcConfiguration": {
|
|
83
|
+
"subnets": [
|
|
84
|
+
"subnet-12344321"
|
|
85
|
+
],
|
|
86
|
+
"securityGroups": [
|
|
87
|
+
"sg-12344321"
|
|
88
|
+
],
|
|
89
|
+
"assignPublicIp": "ENABLED"
|
|
90
|
+
}
|
|
91
|
+
},
|
|
92
|
+
"rolloutState": "COMPLETED",
|
|
93
|
+
"rolloutStateReason": "ECS deployment ecs-svc/1709597507655421668 completed."
|
|
94
|
+
}
|
|
95
|
+
],
|
|
96
|
+
"roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS",
|
|
97
|
+
"events": [
|
|
98
|
+
{
|
|
99
|
+
"id": "e40b4d1c-80d9-4834-aaf3-6a268e530e17",
|
|
100
|
+
"createdAt": "2025-02-21T10:31:26.037000-06:00",
|
|
101
|
+
"message": "(my-http-service) has reached a steady state."
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
"id": "6ac069ad-fc8b-4e49-a35d-b5574a964c8e",
|
|
105
|
+
"createdAt": "2025-02-21T04:31:22.703000-06:00",
|
|
106
|
+
"message": "(my-http-service) has reached a steady state."
|
|
107
|
+
},
|
|
108
|
+
{
|
|
109
|
+
"id": "265f7d37-dfd1-4880-a846-ec486f341919",
|
|
110
|
+
"createdAt": "2025-02-20T22:31:22.514000-06:00",
|
|
111
|
+
"message": "(my-http-service) has reached a steady state."
|
|
112
|
+
}
|
|
113
|
+
],
|
|
114
|
+
"createdAt": "2024-10-30T17:12:43.218000-05:00",
|
|
115
|
+
"placementConstraints": [],
|
|
116
|
+
"placementStrategy": [],
|
|
117
|
+
"networkConfiguration": {
|
|
118
|
+
"awsvpcConfiguration": {
|
|
119
|
+
"subnets": [
|
|
120
|
+
"subnet-12344321",
|
|
121
|
+
],
|
|
122
|
+
"securityGroups": [
|
|
123
|
+
"sg-12344321"
|
|
124
|
+
],
|
|
125
|
+
"assignPublicIp": "ENABLED"
|
|
126
|
+
}
|
|
127
|
+
},
|
|
128
|
+
"healthCheckGracePeriodSeconds": 0,
|
|
129
|
+
"schedulingStrategy": "REPLICA",
|
|
130
|
+
"deploymentController": {
|
|
131
|
+
"type": "ECS"
|
|
132
|
+
},
|
|
133
|
+
"createdBy": "arn:aws:iam::123456789012:role/AIDACKCEVSQ6C2EXAMPLE",
|
|
134
|
+
"enableECSManagedTags": true,
|
|
135
|
+
"propagateTags": "NONE",
|
|
136
|
+
"enableExecuteCommand": false,
|
|
137
|
+
"availabilityZoneRebalancing": "DISABLED"
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
For more information, see `Update an Amazon ECS service using the console <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-console-v2.html>`__ in the *Amazon ECS Developer Guide*.
|
|
142
|
+
|
|
143
|
+
**Example 2: To change the number of tasks in a service**
|
|
144
|
+
|
|
145
|
+
The following ``update-service`` example updates the desired task count of the service ``my-http-service`` from to 2. ::
|
|
146
|
+
|
|
147
|
+
aws ecs update-service \
|
|
148
|
+
--cluster MyCluster \
|
|
149
|
+
--service my-http-service \
|
|
150
|
+
--desired-count 2
|
|
9
151
|
|
|
10
152
|
Output::
|
|
11
153
|
|
|
@@ -127,7 +269,375 @@ Output::
|
|
|
127
269
|
|
|
128
270
|
For more information, see `Updating an Amazon ECS service using the console <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-console-v2.html>`__ in the *Amazon ECS Developer Guide*.
|
|
129
271
|
|
|
130
|
-
**Example
|
|
272
|
+
**Example 3: To configure Amazon EBS volumes for attachment at service update**
|
|
273
|
+
|
|
274
|
+
The following ``update-service`` example updates the service ``my-http-service`` to use Amazon EBS volumes. You must have an Amazon ECS infrastructure role configured with the ``AmazonECSInfrastructureRolePolicyForVolumes`` managed policy attached. You must also specify a task definition with the same volume name as in the ``update-service`` request and with ``configuredAtLaunch`` set to ``true``. This example uses the ``--cli-input-json`` option and a JSON input file called ``ebs.json``. ::
|
|
275
|
+
|
|
276
|
+
aws ecs update-service \
|
|
277
|
+
--cli-input-json file://ebs.json
|
|
278
|
+
|
|
279
|
+
Contents of ``ebs.json``::
|
|
280
|
+
|
|
281
|
+
{
|
|
282
|
+
"cluster": "mycluster",
|
|
283
|
+
"taskDefinition": "mytaskdef",
|
|
284
|
+
"service": "my-http-service",
|
|
285
|
+
"desiredCount": 2,
|
|
286
|
+
"volumeConfigurations": [
|
|
287
|
+
{
|
|
288
|
+
"name": "myEbsVolume",
|
|
289
|
+
"managedEBSVolume": {
|
|
290
|
+
"roleArn":"arn:aws:iam::123456789012:role/ecsInfrastructureRole",
|
|
291
|
+
"volumeType": "gp3",
|
|
292
|
+
"sizeInGiB": 100,
|
|
293
|
+
"iops": 3000,
|
|
294
|
+
"throughput": 125,
|
|
295
|
+
"filesystemType": "ext4"
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
]
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
Output::
|
|
302
|
+
|
|
303
|
+
{
|
|
304
|
+
"service": {
|
|
305
|
+
"serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/mycluster/my-http-service",
|
|
306
|
+
"serviceName": "my-http-service",
|
|
307
|
+
"clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/mycluster",
|
|
308
|
+
"loadBalancers": [],
|
|
309
|
+
"serviceRegistries": [],
|
|
310
|
+
"status": "ACTIVE",
|
|
311
|
+
"desiredCount": 2,
|
|
312
|
+
"runningCount": 2,
|
|
313
|
+
"pendingCount": 0,
|
|
314
|
+
"launchType": "FARGATE",
|
|
315
|
+
"platformVersion": "LATEST",
|
|
316
|
+
"platformFamily": "Linux",
|
|
317
|
+
"taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:1",
|
|
318
|
+
"deploymentConfiguration": {
|
|
319
|
+
"deploymentCircuitBreaker": {
|
|
320
|
+
"enable": true,
|
|
321
|
+
"rollback": true
|
|
322
|
+
},
|
|
323
|
+
"maximumPercent": 200,
|
|
324
|
+
"minimumHealthyPercent": 100,
|
|
325
|
+
"alarms": {
|
|
326
|
+
"alarmNames": [],
|
|
327
|
+
"rollback": false,
|
|
328
|
+
"enable": false
|
|
329
|
+
}
|
|
330
|
+
},
|
|
331
|
+
"deployments": [
|
|
332
|
+
{
|
|
333
|
+
"id": "ecs-svc/2420458347226626275",
|
|
334
|
+
"status": "PRIMARY",
|
|
335
|
+
"taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:1",
|
|
336
|
+
"desiredCount": 0,
|
|
337
|
+
"pendingCount": 0,
|
|
338
|
+
"runningCount": 0,
|
|
339
|
+
"failedTasks": 0,
|
|
340
|
+
"createdAt": "2025-02-21T15:07:20.519000-06:00",
|
|
341
|
+
"updatedAt": "2025-02-21T15:07:20.519000-06:00",
|
|
342
|
+
"launchType": "FARGATE",
|
|
343
|
+
"platformVersion": "1.4.0",
|
|
344
|
+
"platformFamily": "Linux",
|
|
345
|
+
"networkConfiguration": {
|
|
346
|
+
"awsvpcConfiguration": {
|
|
347
|
+
"subnets": [
|
|
348
|
+
"subnet-12344321",
|
|
349
|
+
],
|
|
350
|
+
"securityGroups": [
|
|
351
|
+
"sg-12344321"
|
|
352
|
+
],
|
|
353
|
+
"assignPublicIp": "ENABLED"
|
|
354
|
+
}
|
|
355
|
+
},
|
|
356
|
+
"rolloutState": "IN_PROGRESS",
|
|
357
|
+
"rolloutStateReason": "ECS deployment ecs-svc/2420458347226626275 in progress.",
|
|
358
|
+
"volumeConfigurations": [
|
|
359
|
+
{
|
|
360
|
+
"name": "ebs-volume",
|
|
361
|
+
"managedEBSVolume": {
|
|
362
|
+
"volumeType": "gp3",
|
|
363
|
+
"sizeInGiB": 100,
|
|
364
|
+
"iops": 3000,
|
|
365
|
+
"throughput": 125,
|
|
366
|
+
"roleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
|
|
367
|
+
"filesystemType": "ext4"
|
|
368
|
+
}
|
|
369
|
+
}
|
|
370
|
+
]
|
|
371
|
+
},
|
|
372
|
+
{
|
|
373
|
+
"id": "ecs-svc/5191625155316533644",
|
|
374
|
+
"status": "ACTIVE",
|
|
375
|
+
"taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:2",
|
|
376
|
+
"desiredCount": 2,
|
|
377
|
+
"pendingCount": 0,
|
|
378
|
+
"runningCount": 2,
|
|
379
|
+
"failedTasks": 0,
|
|
380
|
+
"createdAt": "2025-02-21T14:54:48.862000-06:00",
|
|
381
|
+
"updatedAt": "2025-02-21T14:57:22.502000-06:00",
|
|
382
|
+
"launchType": "FARGATE",
|
|
383
|
+
"platformVersion": "1.4.0",
|
|
384
|
+
"platformFamily": "Linux",
|
|
385
|
+
"networkConfiguration": {
|
|
386
|
+
"awsvpcConfiguration": {
|
|
387
|
+
"subnets": [
|
|
388
|
+
"subnet-12344321"
|
|
389
|
+
],
|
|
390
|
+
"securityGroups": [
|
|
391
|
+
"sg-12344321"
|
|
392
|
+
],
|
|
393
|
+
"assignPublicIp": "ENABLED"
|
|
394
|
+
}
|
|
395
|
+
},
|
|
396
|
+
"rolloutState": "COMPLETED",
|
|
397
|
+
"rolloutStateReason": "ECS deployment ecs-svc/5191625155316533644 completed."
|
|
398
|
+
}
|
|
399
|
+
],
|
|
400
|
+
"roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS",
|
|
401
|
+
"events": [
|
|
402
|
+
{
|
|
403
|
+
"id": "b5823113-c2c5-458e-9649-8c2ed38f23a5",
|
|
404
|
+
"createdAt": "2025-02-21T14:57:22.508000-06:00",
|
|
405
|
+
"message": "(service my-http-service) has reached a steady state."
|
|
406
|
+
},
|
|
407
|
+
{
|
|
408
|
+
"id": "b05a48e8-da35-4074-80aa-37ceb3167357",
|
|
409
|
+
"createdAt": "2025-02-21T14:57:22.507000-06:00",
|
|
410
|
+
"message": "(service my-http-service) (deployment ecs-svc/5191625155316533644) deployment completed."
|
|
411
|
+
},
|
|
412
|
+
{
|
|
413
|
+
"id": "a10cd55d-4ba6-4cea-a655-5a5d32ada8a0",
|
|
414
|
+
"createdAt": "2025-02-21T14:55:32.833000-06:00",
|
|
415
|
+
"message": "(service my-http-service) has started 1 tasks: (task fb9c8df512684aec92f3c57dc3f22361)."
|
|
416
|
+
},
|
|
417
|
+
],
|
|
418
|
+
"createdAt": "2025-02-21T14:54:48.862000-06:00",
|
|
419
|
+
"placementConstraints": [],
|
|
420
|
+
"placementStrategy": [],
|
|
421
|
+
"networkConfiguration": {
|
|
422
|
+
"awsvpcConfiguration": {
|
|
423
|
+
"subnets": [
|
|
424
|
+
"subnet-12344321"
|
|
425
|
+
],
|
|
426
|
+
"securityGroups": [
|
|
427
|
+
"sg-12344321"
|
|
428
|
+
],
|
|
429
|
+
"assignPublicIp": "ENABLED"
|
|
430
|
+
}
|
|
431
|
+
},
|
|
432
|
+
"healthCheckGracePeriodSeconds": 0,
|
|
433
|
+
"schedulingStrategy": "REPLICA",
|
|
434
|
+
"deploymentController": {
|
|
435
|
+
"type": "ECS"
|
|
436
|
+
},
|
|
437
|
+
"createdBy": "arn:aws:iam::123456789012:role/AIDACKCEVSQ6C2EXAMPLE",
|
|
438
|
+
"enableECSManagedTags": true,
|
|
439
|
+
"propagateTags": "NONE",
|
|
440
|
+
"enableExecuteCommand": false,
|
|
441
|
+
"availabilityZoneRebalancing": "ENABLED"
|
|
442
|
+
}
|
|
443
|
+
}
|
|
444
|
+
|
|
445
|
+
|
|
446
|
+
For more information, see `Use Amazon EBS volumes with Amazon ECS <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html>`__ in the *Amazon ECS Developer Guide*.
|
|
447
|
+
|
|
448
|
+
**Example 4: To update a service to no longer use Amazon EBS volumes**
|
|
449
|
+
|
|
450
|
+
The following ``update-service`` example updates the service ``my-http-service`` to no longer use Amazon EBS volumes. You must specify a task definition revision with ``configuredAtLaunch`` set to ``false``. ::
|
|
451
|
+
|
|
452
|
+
aws ecs update-service \
|
|
453
|
+
--cluster mycluster \
|
|
454
|
+
--task-definition mytaskdef \
|
|
455
|
+
--service my-http-service \
|
|
456
|
+
--desired-count 2 \
|
|
457
|
+
--volume-configurations "[]"
|
|
458
|
+
|
|
459
|
+
Output::
|
|
460
|
+
|
|
461
|
+
{
|
|
462
|
+
"service": {
|
|
463
|
+
"serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/mycluster/my-http-service",
|
|
464
|
+
"serviceName": "my-http-service",
|
|
465
|
+
"clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/mycluster",
|
|
466
|
+
"loadBalancers": [],
|
|
467
|
+
"serviceRegistries": [],
|
|
468
|
+
"status": "ACTIVE",
|
|
469
|
+
"desiredCount": 2,
|
|
470
|
+
"runningCount": 2,
|
|
471
|
+
"pendingCount": 0,
|
|
472
|
+
"launchType": "FARGATE",
|
|
473
|
+
"platformVersion": "LATEST",
|
|
474
|
+
"platformFamily": "Linux",
|
|
475
|
+
"taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:3",
|
|
476
|
+
"deploymentConfiguration": {
|
|
477
|
+
"deploymentCircuitBreaker": {
|
|
478
|
+
"enable": true,
|
|
479
|
+
"rollback": true
|
|
480
|
+
},
|
|
481
|
+
"maximumPercent": 200,
|
|
482
|
+
"minimumHealthyPercent": 100,
|
|
483
|
+
"alarms": {
|
|
484
|
+
"alarmNames": [],
|
|
485
|
+
"rollback": false,
|
|
486
|
+
"enable": false
|
|
487
|
+
}
|
|
488
|
+
},
|
|
489
|
+
"deployments": [
|
|
490
|
+
{
|
|
491
|
+
"id": "ecs-svc/7522791612543716777",
|
|
492
|
+
"status": "PRIMARY",
|
|
493
|
+
"taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/mytaskdef:3",
|
|
494
|
+
"desiredCount": 0,
|
|
495
|
+
"pendingCount": 0,
|
|
496
|
+
"runningCount": 0,
|
|
497
|
+
"failedTasks": 0,
|
|
498
|
+
"createdAt": "2025-02-21T15:25:38.598000-06:00",
|
|
499
|
+
"updatedAt": "2025-02-21T15:25:38.598000-06:00",
|
|
500
|
+
"launchType": "FARGATE",
|
|
501
|
+
"platformVersion": "1.4.0",
|
|
502
|
+
"platformFamily": "Linux",
|
|
503
|
+
"networkConfiguration": {
|
|
504
|
+
"awsvpcConfiguration": {
|
|
505
|
+
"subnets": [
|
|
506
|
+
"subnet-12344321"
|
|
507
|
+
],
|
|
508
|
+
"securityGroups": [
|
|
509
|
+
"sg-12344321"
|
|
510
|
+
],
|
|
511
|
+
"assignPublicIp": "ENABLED"
|
|
512
|
+
}
|
|
513
|
+
},
|
|
514
|
+
"rolloutState": "IN_PROGRESS",
|
|
515
|
+
"rolloutStateReason": "ECS deployment ecs-svc/7522791612543716777 in progress."
|
|
516
|
+
},
|
|
517
|
+
{
|
|
518
|
+
"id": "ecs-svc/2420458347226626275",
|
|
519
|
+
"status": "ACTIVE",
|
|
520
|
+
"taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/myoldtaskdef:1",
|
|
521
|
+
"desiredCount": 2,
|
|
522
|
+
"pendingCount": 0,
|
|
523
|
+
"runningCount": 2,
|
|
524
|
+
"failedTasks": 0,
|
|
525
|
+
"createdAt": "2025-02-21T15:07:20.519000-06:00",
|
|
526
|
+
"updatedAt": "2025-02-21T15:10:59.955000-06:00",
|
|
527
|
+
"launchType": "FARGATE",
|
|
528
|
+
"platformVersion": "1.4.0",
|
|
529
|
+
"platformFamily": "Linux",
|
|
530
|
+
"networkConfiguration": {
|
|
531
|
+
"awsvpcConfiguration": {
|
|
532
|
+
"subnets": [
|
|
533
|
+
"subnet-12344321"
|
|
534
|
+
],
|
|
535
|
+
"securityGroups": [
|
|
536
|
+
"sg-12344321"
|
|
537
|
+
],
|
|
538
|
+
"assignPublicIp": "ENABLED"
|
|
539
|
+
}
|
|
540
|
+
},
|
|
541
|
+
"rolloutState": "COMPLETED",
|
|
542
|
+
"rolloutStateReason": "ECS deployment ecs-svc/2420458347226626275 completed.",
|
|
543
|
+
"volumeConfigurations": [
|
|
544
|
+
{
|
|
545
|
+
"name": "ebs-volume",
|
|
546
|
+
"managedEBSVolume": {
|
|
547
|
+
"volumeType": "gp3",
|
|
548
|
+
"sizeInGiB": 100,
|
|
549
|
+
"iops": 3000,
|
|
550
|
+
"throughput": 125,
|
|
551
|
+
"roleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
|
|
552
|
+
"filesystemType": "ext4"
|
|
553
|
+
}
|
|
554
|
+
}
|
|
555
|
+
]
|
|
556
|
+
}
|
|
557
|
+
],
|
|
558
|
+
"roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS",
|
|
559
|
+
"events": [
|
|
560
|
+
{
|
|
561
|
+
"id": "4f2c3ca1-7800-4048-ba57-bba210ada2ad",
|
|
562
|
+
"createdAt": "2025-02-21T15:10:59.959000-06:00",
|
|
563
|
+
"message": "(service my-http-service) has reached a steady state."
|
|
564
|
+
},
|
|
565
|
+
{
|
|
566
|
+
"id": "4b36a593-2d40-4ed6-8be8-b9b699eb6198",
|
|
567
|
+
"createdAt": "2025-02-21T15:10:59.958000-06:00",
|
|
568
|
+
"message": "(service my-http-service) (deployment ecs-svc/2420458347226626275) deployment completed."
|
|
569
|
+
},
|
|
570
|
+
{
|
|
571
|
+
"id": "88380089-14e2-4ef0-8dbb-a33991683371",
|
|
572
|
+
"createdAt": "2025-02-21T15:09:39.055000-06:00",
|
|
573
|
+
"message": "(service my-http-service) has stopped 1 running tasks: (task fb9c8df512684aec92f3c57dc3f22361)."
|
|
574
|
+
},
|
|
575
|
+
{
|
|
576
|
+
"id": "97d84243-d52f-4255-89bb-9311391c61f6",
|
|
577
|
+
"createdAt": "2025-02-21T15:08:57.653000-06:00",
|
|
578
|
+
"message": "(service my-http-service) has stopped 1 running tasks: (task 33eff090ad2c40539daa837e6503a9bc)."
|
|
579
|
+
},
|
|
580
|
+
{
|
|
581
|
+
"id": "672ece6c-e2d0-4021-b5da-eefb14001687",
|
|
582
|
+
"createdAt": "2025-02-21T15:08:15.631000-06:00",
|
|
583
|
+
"message": "(service my-http-service) has started 1 tasks: (task 996c02a66ff24f3190a4a8e0c841740f)."
|
|
584
|
+
},
|
|
585
|
+
{
|
|
586
|
+
"id": "a3cf9bea-9be6-4175-ac28-4c68360986eb",
|
|
587
|
+
"createdAt": "2025-02-21T15:07:36.931000-06:00",
|
|
588
|
+
"message": "(service my-http-service) has started 1 tasks: (task d5d23c39f89e46cf9a647b9cc6572feb)."
|
|
589
|
+
},
|
|
590
|
+
{
|
|
591
|
+
"id": "b5823113-c2c5-458e-9649-8c2ed38f23a5",
|
|
592
|
+
"createdAt": "2025-02-21T14:57:22.508000-06:00",
|
|
593
|
+
"message": "(service my-http-service) has reached a steady state."
|
|
594
|
+
},
|
|
595
|
+
{
|
|
596
|
+
"id": "b05a48e8-da35-4074-80aa-37ceb3167357",
|
|
597
|
+
"createdAt": "2025-02-21T14:57:22.507000-06:00",
|
|
598
|
+
"message": "(service my-http-service) (deployment ecs-svc/5191625155316533644) deployment completed."
|
|
599
|
+
},
|
|
600
|
+
{
|
|
601
|
+
"id": "a10cd55d-4ba6-4cea-a655-5a5d32ada8a0",
|
|
602
|
+
"createdAt": "2025-02-21T14:55:32.833000-06:00",
|
|
603
|
+
"message": "(service my-http-service) has started 1 tasks: (task fb9c8df512684aec92f3c57dc3f22361)."
|
|
604
|
+
},
|
|
605
|
+
{
|
|
606
|
+
"id": "42da91fa-e26d-42ef-88c3-bb5965c56b2f",
|
|
607
|
+
"createdAt": "2025-02-21T14:55:02.703000-06:00",
|
|
608
|
+
"message": "(service my-http-service) has started 1 tasks: (task 33eff090ad2c40539daa837e6503a9bc)."
|
|
609
|
+
}
|
|
610
|
+
],
|
|
611
|
+
"createdAt": "2025-02-21T14:54:48.862000-06:00",
|
|
612
|
+
"placementConstraints": [],
|
|
613
|
+
"placementStrategy": [],
|
|
614
|
+
"networkConfiguration": {
|
|
615
|
+
"awsvpcConfiguration": {
|
|
616
|
+
"subnets": [
|
|
617
|
+
"subnet-12344321"
|
|
618
|
+
],
|
|
619
|
+
"securityGroups": [
|
|
620
|
+
"sg-12344321"
|
|
621
|
+
],
|
|
622
|
+
"assignPublicIp": "ENABLED"
|
|
623
|
+
}
|
|
624
|
+
},
|
|
625
|
+
"healthCheckGracePeriodSeconds": 0,
|
|
626
|
+
"schedulingStrategy": "REPLICA",
|
|
627
|
+
"deploymentController": {
|
|
628
|
+
"type": "ECS"
|
|
629
|
+
},
|
|
630
|
+
"createdBy": "arn:aws:iam::123456789012:role/AIDACKCEVSQ6C2EXAMPLE",
|
|
631
|
+
"enableECSManagedTags": true,
|
|
632
|
+
"propagateTags": "NONE",
|
|
633
|
+
"enableExecuteCommand": false,
|
|
634
|
+
"availabilityZoneRebalancing": "ENABLED"
|
|
635
|
+
}
|
|
636
|
+
}
|
|
637
|
+
|
|
638
|
+
For more information, see `Use Amazon EBS volumes with Amazon ECS <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ebs-volumes.html>`__ in the *Amazon ECS Developer Guide*.
|
|
639
|
+
|
|
640
|
+
**Example 5: To turn on Availability Zone rebalancing for a service**
|
|
131
641
|
|
|
132
642
|
The following ``update-service`` example turns on Availability Zone rebalancing for the service ``my-http-service``. ::
|
|
133
643
|
|
|
@@ -238,4 +748,4 @@ Output::
|
|
|
238
748
|
}
|
|
239
749
|
}
|
|
240
750
|
|
|
241
|
-
For more information, see `Updating an Amazon ECS service using the console <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-console-v2.html>`__ in the *Amazon ECS Developer Guide*.
|
|
751
|
+
For more information, see `Updating an Amazon ECS service using the console <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-console-v2.html>`__ in the *Amazon ECS Developer Guide*.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
**To create an HTTP namespace**
|
|
2
|
+
|
|
3
|
+
The following ``create-http-namespace`` example creates an HTTP namespace ``example.com``. ::
|
|
4
|
+
|
|
5
|
+
aws servicediscovery create-http-namespace \
|
|
6
|
+
--name example.com \
|
|
7
|
+
--creator-request-id example-request-id
|
|
8
|
+
|
|
9
|
+
Output::
|
|
10
|
+
|
|
11
|
+
{
|
|
12
|
+
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
To confirm that the operation succeeded, you can run ``get-operation``. For more information, see `get-operation <https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html>`__ .
|
|
16
|
+
|
|
17
|
+
For more information about creating a namespace, see `Creating an AWS Cloud Map namespace to group application services <https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
**To create an public DNS namespace**
|
|
2
|
+
|
|
3
|
+
The following ``create-public-dns-namespace`` example creates an public DNS namespace ``example.com``. ::
|
|
4
|
+
|
|
5
|
+
aws servicediscovery create-public-dns-namespace \
|
|
6
|
+
--name example-public-dns.com \
|
|
7
|
+
--creator-request-id example-public-request-id \
|
|
8
|
+
--properties DnsProperties={SOA={TTL=60}}
|
|
9
|
+
|
|
10
|
+
Output::
|
|
11
|
+
|
|
12
|
+
{
|
|
13
|
+
"OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
To confirm that the operation succeeded, you can run ``get-operation``.
|
|
17
|
+
|
|
18
|
+
For more information about creating a namespace, see `Creating an AWS Cloud Map namespace to group application services <https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
**To delete a service attribute**
|
|
2
|
+
|
|
3
|
+
The following ``delete-service-attributes`` example deletes a service attribute with the key ``Port`` that is associated with the specified service. ::
|
|
4
|
+
|
|
5
|
+
aws servicediscovery delete-service-attributes \
|
|
6
|
+
--service-id srv-e4anhexample0004 \
|
|
7
|
+
--attributes Port
|
|
8
|
+
|
|
9
|
+
This command produces no output.
|
|
10
|
+
|
|
11
|
+
For more information, see `Deleting namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
**To discover the revision of an instance**
|
|
2
|
+
|
|
3
|
+
The following ``discover-instances-revision`` example discovers the increasing revision of an instance. ::
|
|
4
|
+
|
|
5
|
+
aws servicediscovery discover-instances-revision \
|
|
6
|
+
--namespace-name example.com \
|
|
7
|
+
--service-name myservice
|
|
8
|
+
|
|
9
|
+
Output::
|
|
10
|
+
|
|
11
|
+
{
|
|
12
|
+
"InstancesRevision": 123456
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
For more information, see `AWS Cloud Map service instances <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
**To get the details of an instance**
|
|
2
|
+
|
|
3
|
+
The following ``get-instance`` example gets the attributes of a service. ::
|
|
4
|
+
|
|
5
|
+
aws servicediscovery get-instance \
|
|
6
|
+
--service-id srv-e4anhexample0004
|
|
7
|
+
--instance-id i-abcd1234
|
|
8
|
+
|
|
9
|
+
Output::
|
|
10
|
+
|
|
11
|
+
{
|
|
12
|
+
"Instances": {
|
|
13
|
+
"Id": "arn:aws:servicediscovery:us-west-2:111122223333;:service/srv-e4anhexample0004",
|
|
14
|
+
"Attributes": {
|
|
15
|
+
"AWS_INSTANCE_IPV4": "192.0.2.44",
|
|
16
|
+
"AWS_INSTANCE_PORT": "80",
|
|
17
|
+
"color": "green",
|
|
18
|
+
"region": "us-west-2",
|
|
19
|
+
"stage": "beta"
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
For more information, see `AWS Cloud Map service instances <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
**To get the health status of instances associated with a service**
|
|
2
|
+
|
|
3
|
+
The following ``get-instances-health-status`` example gets the health status of instances associated with the specified service. ::
|
|
4
|
+
|
|
5
|
+
aws servicediscovery get-instances-health-status \
|
|
6
|
+
--service-id srv-e4anhexample0004
|
|
7
|
+
|
|
8
|
+
Output::
|
|
9
|
+
|
|
10
|
+
{
|
|
11
|
+
"Status": {
|
|
12
|
+
"i-abcd1234": "HEALTHY",
|
|
13
|
+
"i-abcd1235": "UNHEALTHY"
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
For more information, see `AWS Cloud Map service instances <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
|