From 63c4fc73071e684900820632caf5e629983350a5 Mon Sep 17 00:00:00 2001 From: Anuj Singh Date: Thu, 26 Oct 2023 02:30:30 +0000 Subject: [PATCH] revert the following commits to exclude from release v1.78.1: 1. Revert "Load Managed Daemon images in background (#3984)" This reverts commit 75db5cbd1a9d6734aeb965c98aa740cedc358ae8. 2. Revert "update daemon log path host root in container (#3982)" This reverts commit 6166b6ea1a68e1e12413e6908a5cad844e847b91. 3. Revert "Fix loading CSI driver container from state if it exists" This reverts commit 139150203f433dea0e244dd635aabff93676d5b2. 4. Revert "Latest FE model files (#3974)" This reverts commit b589a08c9fe19b5365d7c7511fd0a5431653fb67. 5. Revert "Move utils function Uint16SliceToStringSlice to shared lib" This reverts commit 882bcb24f8c2452b1be4ed524f4bb537953fabd6. 6. Revert "Move remaining credentials module to shared library" This reverts commit f58f228e83624d801e3308d2f889d813c6117c54. 7. Revert "fix merge import failure (#3976)" This reverts commit 46e21e68a46a08f05b29be2e2f19e40e0e00a3a3. 8. Revert "Fixing task volumes from payload for EBS-backed tasks" This reverts commit fc97633971cad096cc8e8463693225f28454511f. 9. Revert "Create Generic Attachment to decouple from ENI and save attachment state. (#3969)" This reverts commit 12e23ed1389070ef45955ae2b74ad698e99ce523. 10. Revert "Add support for finding EBS devices on Xen instances (#3971)" This reverts commit 3500ac2cd7b6b63612090d8f233e7fe1c88ad8cf. 11. Revert "Add network builder and platform APIs (#3939)" This reverts commit b8d2a7f0a61be3315f8d62243c299ff7433a608a. 12. Revert "Minor refactor of TTL cache (allow nil TTL + get TTL)" This reverts commit 4b33664b9d2aacf232b9d845a97ded85d64aaa92. 13. Revert "Move httpclient to ecs-agent/ and minor refactor" This reverts commit 041ca3f6bff364caa9b23fb0cb09a1b9ab3bf233. 14. Revert "Add missing EBSTaskAttach changes from feature branch" This reverts commit 7a0d1165a74a68ee75bede1542b912c6d750d21b. --- agent/acs/session/attach_eni_common.go | 2 +- agent/acs/session/attach_eni_common_test.go | 10 +- .../attach_instance_eni_responder_test.go | 4 +- .../session/attach_task_eni_responder_test.go | 4 +- agent/acs/session/payload_responder.go | 36 +- agent/acs/session/payload_responder_test.go | 14 +- agent/acs/updater/updater.go | 5 +- agent/acs/updater/updater_test.go | 7 +- agent/api/container/container.go | 13 - agent/api/container/container_test.go | 42 +- agent/api/container/containertype.go | 1 - agent/api/ecsclient/client.go | 30 +- agent/api/ecsclient/client_test.go | 14 +- agent/api/statechange.go | 6 +- agent/api/task/task.go | 70 +- agent/api/task/task_attachment_handler.go | 14 +- .../api/task/task_attachment_handler_test.go | 8 +- agent/api/task/task_test.go | 151 +- agent/api/task/taskvolume.go | 6 +- agent/api/task/taskvolume_test.go | 2 +- agent/app/agent.go | 53 +- agent/app/agent_capability.go | 14 +- agent/app/agent_test.go | 47 - agent/app/agent_unix.go | 9 +- agent/app/agent_windows.go | 8 +- agent/app/data_test.go | 4 +- agent/asm/factory/factory.go | 6 +- .../instancecreds/instancecreds.go | 0 .../instancecreds/instancecreds_linux.go | 11 +- .../instancecreds/instancecreds_test.go | 0 .../instancecreds_unsupported.go | 0 .../instancecreds/instancecreds_windows.go | 11 +- .../providers/credentials_filename_linux.go | 0 .../credentials_filename_unsupported.go | 0 .../providers/credentials_filename_windows.go | 0 .../rotating_shared_credentials_provider.go | 9 +- ...tating_shared_credentials_provider_test.go | 0 agent/data/client.go | 13 +- agent/data/eniattachment_client.go | 2 +- ...t_test.go => eniattachment_client_test.go} | 62 +- agent/data/noop_client.go | 13 - agent/data/resattachment_client.go | 58 - agent/ebs/watcher.go | 283 +- agent/ebs/watcher_test.go | 471 +- agent/ec2/ec2_client.go | 2 +- agent/ec2/ec2_metadata_client.go | 2 +- agent/ecr/factory.go | 8 +- agent/engine/daemonmanager/daemon_manager.go | 3 - .../daemonmanager/daemon_manager_linux.go | 7 +- .../daemonmanager/daemon_manager_windows.go | 4 - agent/engine/daemonmanager/mock/manager.go | 15 - agent/engine/data.go | 23 +- agent/engine/data_test.go | 98 +- agent/engine/docker_image_manager.go | 2 - agent/engine/docker_task_engine_linux_test.go | 7 +- agent/engine/docker_task_engine_test.go | 11 +- .../dockerstate/docker_task_engine_state.go | 6 +- agent/engine/dockerstate/dockerstate_test.go | 63 +- .../dockerstate/mocks/dockerstate_mocks.go | 2 +- agent/engine/host_resource_manager_test.go | 7 +- agent/eni/watcher/watcher.go | 7 +- agent/eni/watcher/watcher_linux_test.go | 14 +- agent/eni/watcher/watcher_test.go | 25 +- agent/eni/watcher/watcher_windows_test.go | 16 +- agent/eventhandler/attachment_handler.go | 27 +- agent/eventhandler/attachment_handler_test.go | 110 +- agent/eventhandler/handler_test.go | 4 +- agent/eventhandler/task_handler_test.go | 4 +- agent/eventhandler/task_handler_types_test.go | 10 +- agent/fsx/factory/factory.go | 6 +- .../agentapi/taskprotection/factory.go | 7 +- {ecs-agent => agent}/httpclient/httpclient.go | 38 +- .../httpclient/httpclient_test.go | 9 +- .../httpclient/mock/gomock_helpers.go | 0 .../httpclient/mock/httpclient.go | 0 agent/s3/factory/factory.go | 8 +- agent/sighandlers/termination_handler_test.go | 4 +- agent/ssm/factory/factory.go | 6 +- agent/stats/engine_unix_test.go | 2 +- agent/taskresource/volume/dockervolume_ebs.go | 2 +- .../volume/dockervolume_ebs_test.go | 2 +- agent/utils/utils.go | 38 +- agent/utils/utils_test.go | 23 +- .../session/attach_instance_eni_responder.go | 7 +- .../acs/session/attach_resource_responder.go | 9 +- .../acs/session/attach_task_eni_responder.go | 7 +- .../ecs-agent/api/attachment/attachment.go | 29 - .../api/attachmentinfo}/attachment_info.go | 6 +- .../ecs-agent/api}/eni/eni.go | 0 .../ecs-agent/api}/eni/eniattachment.go | 44 +- .../ecs-agent/api}/resource/ebs_discovery.go | 24 +- .../resource/ebs_discovery_linux.go | 55 +- .../resource/ebs_discovery_windows.go | 0 .../resource/generate_mocks.go | 2 +- .../{attachment => }/resource/interfaces.go | 0 .../resource/mocks/ebs_mocks.go | 2 +- .../resource/resource_attachment.go | 56 +- .../resource/resource_type.go | 0 .../resource/resource_validation.go | 0 .../attachment_status.go | 2 +- .../ecs-agent/async/mocks/async_mocks.go | 17 +- .../ecs-agent/async/ttl_cache.go | 78 +- .../instancecreds/instancecreds_windows.go | 72 - .../ecs-agent/httpclient/httpclient.go | 101 - .../ecs-agent/logger/field/constants.go | 3 - .../model/networkinterface/eniattachment.go | 43 +- .../networkinterface/networkinterface.go | 68 +- .../networkinterface_status.go | 42 + .../netlib/model/status/network_status.go | 42 - .../amazon-ecs-agent/ecs-agent/utils/utils.go | 16 +- agent/vendor/modules.txt | 13 +- .../session/attach_instance_eni_responder.go | 7 +- .../acs/session/attach_resource_responder.go | 9 +- .../session/attach_resource_responder_test.go | 2 +- .../acs/session/attach_task_eni_responder.go | 7 +- ecs-agent/acs/session/mocks/session_mock.go | 2 +- ecs-agent/api/attachment/attachment.go | 29 - .../resource/ebs_discovery_linux_test.go | 201 - .../api/attachmentinfo}/attachment_info.go | 6 +- .../api/ecs/statechange/statechange_test.go | 9 +- ecs-agent/api/eni/eni.go | 386 + .../api/{attachment => }/eni/eni_test.go | 0 ecs-agent/api/eni/eniattachment.go | 166 + .../eni/eniattachment_test.go | 31 +- .../api}/resource/ebs_discovery.go | 24 +- .../resource/ebs_discovery_linux.go | 55 +- .../api/resource/ebs_discovery_linux_test.go | 64 + .../resource/ebs_discovery_windows.go | 0 .../resource/ebs_discovery_windows_test.go | 0 .../resource/generate_mocks.go | 2 +- .../{attachment => }/resource/interfaces.go | 0 .../resource/mocks/ebs_mocks.go | 2 +- .../resource/resource_attachment.go | 56 +- .../resource/resource_attachment_test.go | 27 +- .../resource/resource_type.go | 0 .../resource/resource_validation.go | 0 .../resource/resource_validation_test.go | 0 .../attachment_status.go | 2 +- .../attachment_status_test.go | 2 +- ecs-agent/async/mocks/async_mocks.go | 17 +- ecs-agent/async/ttl_cache.go | 78 +- ecs-agent/async/ttl_cache_test.go | 20 +- .../instancecreds/instancecreds.go | 25 - .../instancecreds/instancecreds_linux.go | 55 - .../instancecreds_unsupported.go | 32 - .../providers/credentials_filename_linux.go | 22 - .../credentials_filename_unsupported.go | 23 - .../providers/credentials_filename_windows.go | 20 - .../rotating_shared_credentials_provider.go | 83 - ecs-agent/ecs/model/api/api-2.json | 7881 ----- ecs-agent/ecs/model/api/docs-2.json | 4150 --- ecs-agent/ecs/model/api/paginators-1.json | 40 - ecs-agent/ecs/model/api/waiters-2.json | 93 - ecs-agent/ecs/model/ecs/api.go | 26130 ---------------- ecs-agent/ecs/model/ecs/errors.go | 246 - ecs-agent/ecs/model/ecs/service.go | 122 - ecs-agent/ecs/model/generate.go | 17 - ecs-agent/httpclient/mock/gomock_helpers.go | 90 - ecs-agent/httpclient/mock/httpclient.go | 64 - ecs-agent/logger/field/constants.go | 3 - ecs-agent/netlib/common_test.go | 23 - .../model/networkinterface/eniattachment.go | 43 +- .../networkinterface/eniattachment_test.go | 31 +- .../networkinterface/networkinterface.go | 68 +- .../networkinterface_status.go | 42 + .../networkinterface/networkinterface_test.go | 373 + .../model/tasknetworkconfig/common_test.go | 11 +- .../tasknetworkconfig/network_namespace.go | 34 +- .../network_namespace_test.go | 32 +- .../tasknetworkconfig/task_network_config.go | 21 +- .../task_network_config_test.go | 40 - ecs-agent/netlib/network_builder.go | 46 - .../netlib/network_builder_linux_test.go | 279 - ecs-agent/netlib/platform/api.go | 33 - ecs-agent/netlib/platform/common_linux.go | 207 - .../netlib/platform/common_linux_test.go | 18 - ecs-agent/netlib/platform/containerd_linux.go | 31 - .../netlib/platform/containerd_windows.go | 42 - ecs-agent/utils/utils.go | 16 +- ecs-agent/utils/utils_test.go | 30 - .../aws-sdk-go/aws/corehandlers/handlers.go | 232 - .../aws/corehandlers/param_validator.go | 17 - .../aws-sdk-go/aws/corehandlers/user_agent.go | 37 - .../ec2rolecreds/ec2_role_provider.go | 188 - .../aws/credentials/endpointcreds/provider.go | 210 - .../aws/aws-sdk-go/aws/defaults/defaults.go | 207 - .../aws-sdk-go/aws/defaults/shared_config.go | 27 - .../aws/aws-sdk-go/aws/ec2metadata/api.go | 250 - .../aws/aws-sdk-go/aws/ec2metadata/service.go | 245 - .../aws/ec2metadata/token_provider.go | 93 - .../aws/aws-sdk-go/internal/sdkuri/path.go | 23 - ecs-agent/vendor/modules.txt | 6 - 192 files changed, 1819 insertions(+), 44309 deletions(-) rename agent/{vendor/github.com/aws/amazon-ecs-agent/ecs-agent => }/credentials/instancecreds/instancecreds.go (100%) rename agent/{vendor/github.com/aws/amazon-ecs-agent/ecs-agent => }/credentials/instancecreds/instancecreds_linux.go (86%) rename {ecs-agent => agent}/credentials/instancecreds/instancecreds_test.go (100%) rename agent/{vendor/github.com/aws/amazon-ecs-agent/ecs-agent => }/credentials/instancecreds/instancecreds_unsupported.go (100%) rename {ecs-agent => agent}/credentials/instancecreds/instancecreds_windows.go (89%) rename agent/{vendor/github.com/aws/amazon-ecs-agent/ecs-agent => }/credentials/providers/credentials_filename_linux.go (100%) rename agent/{vendor/github.com/aws/amazon-ecs-agent/ecs-agent => }/credentials/providers/credentials_filename_unsupported.go (100%) rename agent/{vendor/github.com/aws/amazon-ecs-agent/ecs-agent => }/credentials/providers/credentials_filename_windows.go (100%) rename agent/{vendor/github.com/aws/amazon-ecs-agent/ecs-agent => }/credentials/providers/rotating_shared_credentials_provider.go (89%) rename {ecs-agent => agent}/credentials/providers/rotating_shared_credentials_provider_test.go (100%) rename agent/data/{attachment_client_test.go => eniattachment_client_test.go} (53%) delete mode 100644 agent/data/resattachment_client.go rename {ecs-agent => agent}/httpclient/httpclient.go (72%) rename {ecs-agent => agent}/httpclient/httpclient_test.go (86%) rename agent/{vendor/github.com/aws/amazon-ecs-agent/ecs-agent => }/httpclient/mock/gomock_helpers.go (100%) rename agent/{vendor/github.com/aws/amazon-ecs-agent/ecs-agent => }/httpclient/mock/httpclient.go (100%) delete mode 100644 agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/attachment.go rename {ecs-agent/api/attachment => agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo}/attachment_info.go (92%) rename {ecs-agent/api/attachment => agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api}/eni/eni.go (100%) rename {ecs-agent/api/attachment => agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api}/eni/eniattachment.go (83%) rename {ecs-agent/api/attachment => agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api}/resource/ebs_discovery.go (77%) rename agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/{attachment => }/resource/ebs_discovery_linux.go (62%) rename agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/{attachment => }/resource/ebs_discovery_windows.go (100%) rename agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/{attachment => }/resource/generate_mocks.go (84%) rename agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/{attachment => }/resource/interfaces.go (100%) rename agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/{attachment => }/resource/mocks/ebs_mocks.go (95%) rename agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/{attachment => }/resource/resource_attachment.go (87%) rename agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/{attachment => }/resource/resource_type.go (100%) rename agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/{attachment => }/resource/resource_validation.go (100%) rename agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/{attachment => status}/attachment_status.go (98%) delete mode 100644 agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds_windows.go delete mode 100644 agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/httpclient/httpclient.go create mode 100644 agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/networkinterface_status.go delete mode 100644 agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/status/network_status.go delete mode 100644 ecs-agent/api/attachment/attachment.go delete mode 100644 ecs-agent/api/attachment/resource/ebs_discovery_linux_test.go rename {agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment => ecs-agent/api/attachmentinfo}/attachment_info.go (92%) create mode 100644 ecs-agent/api/eni/eni.go rename ecs-agent/api/{attachment => }/eni/eni_test.go (100%) create mode 100644 ecs-agent/api/eni/eniattachment.go rename ecs-agent/api/{attachment => }/eni/eniattachment_test.go (87%) rename {agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment => ecs-agent/api}/resource/ebs_discovery.go (77%) rename ecs-agent/api/{attachment => }/resource/ebs_discovery_linux.go (62%) create mode 100644 ecs-agent/api/resource/ebs_discovery_linux_test.go rename ecs-agent/api/{attachment => }/resource/ebs_discovery_windows.go (100%) rename ecs-agent/api/{attachment => }/resource/ebs_discovery_windows_test.go (100%) rename ecs-agent/api/{attachment => }/resource/generate_mocks.go (84%) rename ecs-agent/api/{attachment => }/resource/interfaces.go (100%) rename ecs-agent/api/{attachment => }/resource/mocks/ebs_mocks.go (95%) rename ecs-agent/api/{attachment => }/resource/resource_attachment.go (87%) rename ecs-agent/api/{attachment => }/resource/resource_attachment_test.go (89%) rename ecs-agent/api/{attachment => }/resource/resource_type.go (100%) rename ecs-agent/api/{attachment => }/resource/resource_validation.go (100%) rename ecs-agent/api/{attachment => }/resource/resource_validation_test.go (100%) rename ecs-agent/api/{attachment => status}/attachment_status.go (98%) rename ecs-agent/api/{attachment => status}/attachment_status_test.go (98%) delete mode 100644 ecs-agent/credentials/instancecreds/instancecreds.go delete mode 100644 ecs-agent/credentials/instancecreds/instancecreds_linux.go delete mode 100644 ecs-agent/credentials/instancecreds/instancecreds_unsupported.go delete mode 100644 ecs-agent/credentials/providers/credentials_filename_linux.go delete mode 100644 ecs-agent/credentials/providers/credentials_filename_unsupported.go delete mode 100644 ecs-agent/credentials/providers/credentials_filename_windows.go delete mode 100644 ecs-agent/credentials/providers/rotating_shared_credentials_provider.go delete mode 100644 ecs-agent/ecs/model/api/api-2.json delete mode 100644 ecs-agent/ecs/model/api/docs-2.json delete mode 100644 ecs-agent/ecs/model/api/paginators-1.json delete mode 100644 ecs-agent/ecs/model/api/waiters-2.json delete mode 100644 ecs-agent/ecs/model/ecs/api.go delete mode 100644 ecs-agent/ecs/model/ecs/errors.go delete mode 100644 ecs-agent/ecs/model/ecs/service.go delete mode 100644 ecs-agent/ecs/model/generate.go delete mode 100644 ecs-agent/httpclient/mock/gomock_helpers.go delete mode 100644 ecs-agent/httpclient/mock/httpclient.go delete mode 100644 ecs-agent/netlib/common_test.go create mode 100644 ecs-agent/netlib/model/networkinterface/networkinterface_status.go create mode 100644 ecs-agent/netlib/model/networkinterface/networkinterface_test.go delete mode 100644 ecs-agent/netlib/network_builder.go delete mode 100644 ecs-agent/netlib/network_builder_linux_test.go delete mode 100644 ecs-agent/netlib/platform/api.go delete mode 100644 ecs-agent/netlib/platform/common_linux.go delete mode 100644 ecs-agent/netlib/platform/common_linux_test.go delete mode 100644 ecs-agent/netlib/platform/containerd_linux.go delete mode 100644 ecs-agent/netlib/platform/containerd_windows.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/param_validator.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/user_agent.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/credentials/ec2rolecreds/ec2_role_provider.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/credentials/endpointcreds/provider.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/defaults/defaults.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/defaults/shared_config.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/api.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/service.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/token_provider.go delete mode 100644 ecs-agent/vendor/github.com/aws/aws-sdk-go/internal/sdkuri/path.go diff --git a/agent/acs/session/attach_eni_common.go b/agent/acs/session/attach_eni_common.go index f4f4ba432be..3f05c429f45 100644 --- a/agent/acs/session/attach_eni_common.go +++ b/agent/acs/session/attach_eni_common.go @@ -127,7 +127,7 @@ func (eniHandler *eniHandler) removeENIAttachmentData(mac string) { seelog.Errorf("Unable to retrieve ENI Attachment for mac address %s: ", mac) return } - attachmentId, err := utils.GetAttachmentId(attachmentToRemove.AttachmentARN) + attachmentId, err := utils.GetENIAttachmentId(attachmentToRemove.AttachmentARN) if err != nil { seelog.Errorf("Failed to get attachment id for %s: %v", attachmentToRemove.AttachmentARN, err) } else { diff --git a/agent/acs/session/attach_eni_common_test.go b/agent/acs/session/attach_eni_common_test.go index 2c813bd3385..5a93729ef0d 100644 --- a/agent/acs/session/attach_eni_common_test.go +++ b/agent/acs/session/attach_eni_common_test.go @@ -26,7 +26,7 @@ import ( "github.com/aws/amazon-ecs-agent/agent/data" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/testconst" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" ) @@ -53,7 +53,7 @@ func testENIAckTimeout(t *testing.T, attachmentType string) { expiresAt := time.Now().Add(time.Millisecond * testconst.WaitTimeoutMillis) eniAttachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: testconst.TaskARN, AttachmentARN: attachmentArn, ExpiresAt: expiresAt, @@ -99,7 +99,7 @@ func testENIAckWithinTimeout(t *testing.T, attachmentType string) { dataClient := data.NewNoopClient() expiresAt := time.Now().Add(time.Millisecond * testconst.WaitTimeoutMillis) eniAttachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: testconst.TaskARN, AttachmentARN: attachmentArn, ExpiresAt: expiresAt, @@ -141,7 +141,7 @@ func testHandleENIAttachment(t *testing.T, attachmentType, taskArn string) { taskEngineState := dockerstate.NewTaskEngineState() expiresAt := time.Now().Add(time.Millisecond * testconst.WaitTimeoutMillis) eniAttachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskArn, AttachmentARN: attachmentArn, ExpiresAt: expiresAt, @@ -188,7 +188,7 @@ func testHandleExpiredENIAttachment(t *testing.T, attachmentType, taskArn string dataClient := data.NewNoopClient() eniAttachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskArn, AttachmentARN: attachmentArn, ExpiresAt: expiresAt, diff --git a/agent/acs/session/attach_instance_eni_responder_test.go b/agent/acs/session/attach_instance_eni_responder_test.go index d4abec66a4e..974f22a3c28 100644 --- a/agent/acs/session/attach_instance_eni_responder_test.go +++ b/agent/acs/session/attach_instance_eni_responder_test.go @@ -31,7 +31,7 @@ import ( "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" acssession "github.com/aws/amazon-ecs-agent/ecs-agent/acs/session" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/testconst" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" ) @@ -113,7 +113,7 @@ func TestInstanceENIAckSingleMessageWithDuplicateENIAttachment(t *testing.T) { mockState.EXPECT(). ENIByMac(testconst.RandomMAC). Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: expiresAt, }, }, true). diff --git a/agent/acs/session/attach_task_eni_responder_test.go b/agent/acs/session/attach_task_eni_responder_test.go index 94f3e4cf8b0..ba04db1804f 100644 --- a/agent/acs/session/attach_task_eni_responder_test.go +++ b/agent/acs/session/attach_task_eni_responder_test.go @@ -31,7 +31,7 @@ import ( "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" acssession "github.com/aws/amazon-ecs-agent/ecs-agent/acs/session" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/testconst" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" ) @@ -113,7 +113,7 @@ func TestTaskENIAckSingleMessageWithDuplicateENIAttachment(t *testing.T) { mockState.EXPECT(). ENIByMac(testconst.RandomMAC). Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: expiresAt, }, }, true). diff --git a/agent/acs/session/payload_responder.go b/agent/acs/session/payload_responder.go index 4bb85f2be1e..770de32667c 100644 --- a/agent/acs/session/payload_responder.go +++ b/agent/acs/session/payload_responder.go @@ -22,7 +22,6 @@ import ( "github.com/aws/amazon-ecs-agent/agent/engine" "github.com/aws/amazon-ecs-agent/agent/eventhandler" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" @@ -107,16 +106,6 @@ func (pmHandler *payloadMessageHandler) addPayloadTasks(payload *ecsacs.PayloadM allTasksOK = false continue } - - // Note: If we receive an EBS-backed task, we'll also received an incomplete volume configuration in the list of Volumes - // To accomodate this, we'll first check if the task IS EBS-backed then we'll mark the corresponding Volume object to be - // of type "attachment". This volume object will be replaced by the newly created EBS volume configuration when we parse - // through the task attachments. - volName, ok := hasEBSAttachment(task) - if ok { - initializeAttachmentTypeVolume(task, volName) - } - apiTask, err := apitask.TaskFromACS(task, payload) if err != nil { pmHandler.handleInvalidTask(task, err, payload) @@ -151,7 +140,7 @@ func (pmHandler *payloadMessageHandler) addPayloadTasks(payload *ecsacs.PayloadM // Add ENI information to the task struct. for _, acsENI := range task.ElasticNetworkInterfaces { - eni, err := ni.InterfaceFromACS(acsENI) + eni, err := ni.ENIFromACS(acsENI) if err != nil { pmHandler.handleInvalidTask(task, err, payload) allTasksOK = false @@ -317,26 +306,3 @@ func isTaskStatusStopped(status apitaskstatus.TaskStatus) bool { func isTaskStatusNotStopped(status apitaskstatus.TaskStatus) bool { return status != apitaskstatus.TaskStopped } - -func hasEBSAttachment(acsTask *ecsacs.Task) (string, bool) { - // TODO: This will only work if there's one EBS volume per task. If we there is a case where we have multi-attach for a task, this needs to be modified - for _, attachment := range acsTask.Attachments { - if *attachment.AttachmentType == apiresource.EBSTaskAttach { - for _, property := range attachment.AttachmentProperties { - if *property.Name == apiresource.VolumeNameKey { - return *property.Value, true - } - } - } - } - return "", false -} - -func initializeAttachmentTypeVolume(acsTask *ecsacs.Task, volName string) { - for _, volume := range acsTask.Volumes { - if *volume.Name == volName && volume.Type == nil { - newType := "attachment" - volume.Type = &newType - } - } -} diff --git a/agent/acs/session/payload_responder_test.go b/agent/acs/session/payload_responder_test.go index 8a4eb6d7bf8..5e9b149315f 100644 --- a/agent/acs/session/payload_responder_test.go +++ b/agent/acs/session/payload_responder_test.go @@ -34,10 +34,10 @@ import ( "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" acssession "github.com/aws/amazon-ecs-agent/ecs-agent/acs/session" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/testconst" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/eni" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" - ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" "github.com/aws/amazon-ecs-agent/ecs-agent/wsclient" "github.com/aws/aws-sdk-go/aws" "github.com/golang/mock/gomock" @@ -725,12 +725,6 @@ func TestHandlePayloadMessageAddedEBSToTask(t *testing.T) { AttachmentType: aws.String(apiresource.EBSTaskAttach), }, }, - Volumes: []*ecsacs.Volume{ - { - Name: aws.String(taskresourcevolume.TestVolumeName), - Type: aws.String(apitask.AttachmentType), - }, - }, }, } @@ -864,7 +858,7 @@ func TestHandlePayloadMessageAddedENITrunkToTask(t *testing.T) { Arn: aws.String(testconst.TaskARN), ElasticNetworkInterfaces: []*ecsacs.ElasticNetworkInterface{ { - InterfaceAssociationProtocol: aws.String(ni.VLANInterfaceAssociationProtocol), + InterfaceAssociationProtocol: aws.String(eni.VLANInterfaceAssociationProtocol), AttachmentArn: aws.String(attachmentARN), Ec2Id: aws.String(ec2ID), Ipv4Addresses: []*ecsacs.IPv4AddressAssignment{ @@ -896,7 +890,7 @@ func TestHandlePayloadMessageAddedENITrunkToTask(t *testing.T) { // Validate the added task has the ENI trunk information as expected. taskeni := addedTask.GetPrimaryENI() - assert.Equal(t, ni.VLANInterfaceAssociationProtocol, taskeni.InterfaceAssociationProtocol) + assert.Equal(t, eni.VLANInterfaceAssociationProtocol, taskeni.InterfaceAssociationProtocol) assert.Equal(t, testconst.RandomMAC, taskeni.InterfaceVlanProperties.TrunkInterfaceMacAddress) assert.Equal(t, vlanID, taskeni.InterfaceVlanProperties.VlanID) } diff --git a/agent/acs/updater/updater.go b/agent/acs/updater/updater.go index f632647cc7d..4b7d00811a5 100644 --- a/agent/acs/updater/updater.go +++ b/agent/acs/updater/updater.go @@ -29,12 +29,11 @@ import ( "github.com/aws/amazon-ecs-agent/agent/data" "github.com/aws/amazon-ecs-agent/agent/engine" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" + "github.com/aws/amazon-ecs-agent/agent/httpclient" "github.com/aws/amazon-ecs-agent/agent/sighandlers" "github.com/aws/amazon-ecs-agent/agent/sighandlers/exitcodes" "github.com/aws/amazon-ecs-agent/agent/utils" - agentversion "github.com/aws/amazon-ecs-agent/agent/version" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/httpclient" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/ttime" "github.com/aws/amazon-ecs-agent/ecs-agent/wsclient" @@ -80,7 +79,7 @@ func NewUpdater(cfg *config.Config, state dockerstate.TaskEngineState, dataClien taskEngine engine.TaskEngine) *updater { return &updater{ config: cfg, - httpclient: httpclient.New(updateDownloadTimeout, false, agentversion.String(), config.OSType), + httpclient: httpclient.New(updateDownloadTimeout, false), state: state, dataClient: dataClient, taskEngine: taskEngine, diff --git a/agent/acs/updater/updater_test.go b/agent/acs/updater/updater_test.go index aa90ef3ce31..4dba30c81b4 100644 --- a/agent/acs/updater/updater_test.go +++ b/agent/acs/updater/updater_test.go @@ -31,10 +31,9 @@ import ( "github.com/aws/amazon-ecs-agent/agent/data" "github.com/aws/amazon-ecs-agent/agent/engine" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" - agentversion "github.com/aws/amazon-ecs-agent/agent/version" + "github.com/aws/amazon-ecs-agent/agent/httpclient" + mock_http "github.com/aws/amazon-ecs-agent/agent/httpclient/mock" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/httpclient" - mock_http "github.com/aws/amazon-ecs-agent/ecs-agent/httpclient/mock" mock_client "github.com/aws/amazon-ecs-agent/ecs-agent/wsclient/mock" "github.com/golang/mock/gomock" @@ -59,7 +58,7 @@ func mocks(t *testing.T, cfg *config.Config) (*updater, *gomock.Controller, *moc mockacs := mock_client.NewMockClientServer(ctrl) mockhttp := mock_http.NewMockRoundTripper(ctrl) - httpClient := httpclient.New(updateDownloadTimeout, false, agentversion.String(), config.OSType) + httpClient := httpclient.New(updateDownloadTimeout, false) httpClient.Transport.(httpclient.OverridableTransport).SetTransport(mockhttp) u := NewUpdater(cfg, dockerstate.NewTaskEngineState(), data.NewNoopClient(), diff --git a/agent/api/container/container.go b/agent/api/container/container.go index c77dab614e7..8c7af30d4ec 100644 --- a/agent/api/container/container.go +++ b/agent/api/container/container.go @@ -1508,16 +1508,3 @@ func (c *Container) GetContainerPortRangeMap() map[string]string { defer c.lock.RUnlock() return c.ContainerPortRangeMap } - -func (c *Container) IsManagedDaemonContainer() bool { - c.lock.RLock() - defer c.lock.RUnlock() - return c.Type == ContainerManagedDaemon -} - -func (c *Container) GetImageName() string { - c.lock.RLock() - defer c.lock.RUnlock() - containerImage := strings.Split(c.Image, ":")[0] - return containerImage -} diff --git a/agent/api/container/container_test.go b/agent/api/container/container_test.go index 1fd96d6a6ff..db34d75ed41 100644 --- a/agent/api/container/container_test.go +++ b/agent/api/container/container_test.go @@ -130,53 +130,13 @@ func TestIsInternal(t *testing.T) { } for _, tc := range testCases { - t.Run(fmt.Sprintf("IsInternal should return %t for %s", tc.internal, tc.container.String()), + t.Run(fmt.Sprintf("IsInternal shoukd return %t for %s", tc.internal, tc.container.String()), func(t *testing.T) { assert.Equal(t, tc.internal, tc.container.IsInternal()) }) } } -func TestIsManagedDaemonContainer(t *testing.T) { - testCases := []struct { - container *Container - internal bool - isManagedDaemon bool - }{ - {&Container{}, false, false}, - {&Container{Type: ContainerNormal, Image: "someImage:latest"}, false, false}, - {&Container{Type: ContainerManagedDaemon, Image: "someImage:latest"}, true, true}, - } - - for _, tc := range testCases { - t.Run(fmt.Sprintf("IsManagedDaemonContainer should return %t for %s", tc.isManagedDaemon, tc.container.String()), - func(t *testing.T) { - assert.Equal(t, tc.internal, tc.container.IsInternal()) - ok := tc.container.IsManagedDaemonContainer() - assert.Equal(t, tc.isManagedDaemon, ok) - }) - } -} - -func TestGetImageName(t *testing.T) { - testCases := []struct { - container *Container - imageName string - }{ - {&Container{}, ""}, - {&Container{Image: "someImage:latest"}, "someImage"}, - {&Container{Image: "someImage"}, "someImage"}, - } - - for _, tc := range testCases { - t.Run(fmt.Sprintf("GetImageName should return %s for %s", tc.imageName, tc.container.String()), - func(t *testing.T) { - imageName := tc.container.GetImageName() - assert.Equal(t, tc.imageName, imageName) - }) - } -} - // TestSetupExecutionRoleFlag tests whether or not the container appropriately // sets the flag for using execution roles func TestSetupExecutionRoleFlag(t *testing.T) { diff --git a/agent/api/container/containertype.go b/agent/api/container/containertype.go index 165692e35f8..740f504229e 100644 --- a/agent/api/container/containertype.go +++ b/agent/api/container/containertype.go @@ -53,7 +53,6 @@ var stringToContainerType = map[string]ContainerType{ "EMPTY_HOST_VOLUME": ContainerEmptyHostVolume, "CNI_PAUSE": ContainerCNIPause, "NAMESPACE_PAUSE": ContainerNamespacePause, - "MANAGED_DAEMON": ContainerManagedDaemon, } // String converts the container type enum to a string diff --git a/agent/api/ecsclient/client.go b/agent/api/ecsclient/client.go index 19b02d504af..99e8998477e 100644 --- a/agent/api/ecsclient/client.go +++ b/agent/api/ecsclient/client.go @@ -23,17 +23,15 @@ import ( "github.com/aws/amazon-ecs-agent/agent/api" "github.com/aws/amazon-ecs-agent/agent/config" + "github.com/aws/amazon-ecs-agent/agent/credentials/instancecreds" "github.com/aws/amazon-ecs-agent/agent/ec2" + "github.com/aws/amazon-ecs-agent/agent/httpclient" "github.com/aws/amazon-ecs-agent/agent/utils" - agentversion "github.com/aws/amazon-ecs-agent/agent/version" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" apierrors "github.com/aws/amazon-ecs-agent/ecs-agent/api/errors" "github.com/aws/amazon-ecs-agent/ecs-agent/async" - "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds" "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" - "github.com/aws/amazon-ecs-agent/ecs-agent/httpclient" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" - commonutils "github.com/aws/amazon-ecs-agent/ecs-agent/utils" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/retry" "github.com/aws/aws-sdk-go/aws" @@ -79,25 +77,25 @@ type APIECSClient struct { // NewECSClient creates a new ECSClient interface object func NewECSClient( credentialProvider *credentials.Credentials, - cfg *config.Config, + config *config.Config, ec2MetadataClient ec2.EC2MetadataClient) api.ECSClient { var ecsConfig aws.Config ecsConfig.Credentials = credentialProvider - ecsConfig.Region = &cfg.AWSRegion - ecsConfig.HTTPClient = httpclient.New(RoundtripTimeout, cfg.AcceptInsecureCert, agentversion.String(), config.OSType) - if cfg.APIEndpoint != "" { - ecsConfig.Endpoint = &cfg.APIEndpoint + ecsConfig.Region = &config.AWSRegion + ecsConfig.HTTPClient = httpclient.New(RoundtripTimeout, config.AcceptInsecureCert) + if config.APIEndpoint != "" { + ecsConfig.Endpoint = &config.APIEndpoint } standardClient := ecs.New(session.New(&ecsConfig)) submitStateChangeClient := newSubmitStateChangeClient(&ecsConfig) return &APIECSClient{ credentialProvider: credentialProvider, - config: cfg, + config: config, standardClient: standardClient, submitStateChangeClient: submitStateChangeClient, ec2metadata: ec2MetadataClient, - pollEndpointCache: async.NewTTLCache(&async.TTL{Duration: pollEndpointCacheTTL}), + pollEndpointCache: async.NewTTLCache(pollEndpointCacheTTL), } } @@ -323,12 +321,12 @@ func (client *APIECSClient) getResources() ([]*ecs.Resource, error) { portResource := ecs.Resource{ Name: utils.Strptr("PORTS"), Type: utils.Strptr("STRINGSET"), - StringSetValue: commonutils.Uint16SliceToStringSlice(client.config.ReservedPorts), + StringSetValue: utils.Uint16SliceToStringSlice(client.config.ReservedPorts), } udpPortResource := ecs.Resource{ Name: utils.Strptr("PORTS_UDP"), Type: utils.Strptr("STRINGSET"), - StringSetValue: commonutils.Uint16SliceToStringSlice(client.config.ReservedPortsUDP), + StringSetValue: utils.Uint16SliceToStringSlice(client.config.ReservedPortsUDP), } return []*ecs.Resource{&cpuResource, &memResource, &portResource, &udpPortResource}, nil @@ -658,14 +656,14 @@ func (client *APIECSClient) SubmitContainerStateChange(change api.ContainerState } func (client *APIECSClient) SubmitAttachmentStateChange(change api.AttachmentStateChange) error { - attachmentStatus := change.Attachment.GetAttachmentStatus() + attachmentStatus := change.Attachment.Status.String() req := ecs.SubmitAttachmentStateChangesInput{ Cluster: &client.config.Cluster, Attachments: []*ecs.AttachmentStateChange{ { - AttachmentArn: aws.String(change.Attachment.GetAttachmentARN()), - Status: aws.String(attachmentStatus.String()), + AttachmentArn: aws.String(change.Attachment.AttachmentARN), + Status: aws.String(attachmentStatus), }, }, } diff --git a/agent/api/ecsclient/client_test.go b/agent/api/ecsclient/client_test.go index 663d9ac07e4..ac25498b458 100644 --- a/agent/api/ecsclient/client_test.go +++ b/agent/api/ecsclient/client_test.go @@ -24,6 +24,9 @@ import ( "testing" "time" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" + "github.com/golang/mock/gomock" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" @@ -34,7 +37,6 @@ import ( "github.com/aws/amazon-ecs-agent/agent/config" "github.com/aws/amazon-ecs-agent/agent/ec2" mock_ec2 "github.com/aws/amazon-ecs-agent/agent/ec2/mocks" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/aws/amazon-ecs-agent/ecs-agent/async" @@ -1027,7 +1029,7 @@ func TestDiscoverTelemetryEndpointAfterPollEndpointCacheHit(t *testing.T) { defer mockCtrl.Finish() mockSDK := mock_api.NewMockECSSDK(mockCtrl) - pollEndpointCache := async.NewTTLCache(&async.TTL{Duration: 10 * time.Minute}) + pollEndpointCache := async.NewTTLCache(10 * time.Minute) client := &APIECSClient{ credentialProvider: credentials.AnonymousCredentials, config: &config.Config{ @@ -1061,9 +1063,9 @@ func TestDiscoverTelemetryEndpointAfterPollEndpointCacheHit(t *testing.T) { } } -// TestSubmitTaskStateChangeWithENIAttachments tests the SubmitTaskStateChange API +// TestSubmitTaskStateChangeWithAttachments tests the SubmitTaskStateChange API // also send the Attachment Status -func TestSubmitTaskStateChangeWithENIAttachments(t *testing.T) { +func TestSubmitTaskStateChangeWithAttachments(t *testing.T) { mockCtrl := gomock.NewController(t) defer mockCtrl.Finish() @@ -1084,9 +1086,9 @@ func TestSubmitTaskStateChangeWithENIAttachments(t *testing.T) { err := client.SubmitTaskStateChange(api.TaskStateChange{ TaskARN: "task_arn", Attachment: &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: "eni_arn", - Status: attachment.AttachmentAttached, + Status: status.AttachmentAttached, }, }, }) diff --git a/agent/api/statechange.go b/agent/api/statechange.go index 8651df6386e..75243ae72e2 100644 --- a/agent/api/statechange.go +++ b/agent/api/statechange.go @@ -21,7 +21,6 @@ import ( apicontainer "github.com/aws/amazon-ecs-agent/agent/api/container" apitask "github.com/aws/amazon-ecs-agent/agent/api/task" "github.com/aws/amazon-ecs-agent/agent/statechange" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" @@ -99,7 +98,8 @@ type TaskStateChange struct { // AttachmentStateChange represents a state change that needs to be sent to the // SubmitAttachmentStateChanges API type AttachmentStateChange struct { - Attachment attachment.Attachment + // Attachment is the eni attachment object to send + Attachment *ni.ENIAttachment } type ErrShouldNotSendEvent struct { @@ -352,7 +352,7 @@ func (change *TaskStateChange) String() string { // String returns a human readable string representation of this object func (change *AttachmentStateChange) String() string { if change.Attachment != nil { - return fmt.Sprintf("%s -> %v, %s", change.Attachment.GetAttachmentARN(), change.Attachment.GetAttachmentStatus(), + return fmt.Sprintf("%s -> %s, %s", change.Attachment.AttachmentARN, change.Attachment.Status.String(), change.Attachment.String()) } diff --git a/agent/api/task/task.go b/agent/api/task/task.go index c5f1507b181..689f1c20282 100644 --- a/agent/api/task/task.go +++ b/agent/api/task/task.go @@ -43,6 +43,7 @@ import ( "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" apierrors "github.com/aws/amazon-ecs-agent/ecs-agent/api/errors" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" @@ -50,7 +51,6 @@ import ( "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" nlappmesh "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/appmesh" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" - commonutils "github.com/aws/amazon-ecs-agent/ecs-agent/utils" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/arn" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/ttime" @@ -332,6 +332,7 @@ func TaskFromACS(acsTask *ecsacs.Task, envelope *ecsacs.PayloadMessage) (*Task, return task, nil } +// TODO: Add unit test func (task *Task) RemoveVolume(index int) { task.lock.Lock() defer task.lock.Unlock() @@ -342,6 +343,7 @@ func (task *Task) removeVolumeUnsafe(index int) { if index < 0 || index >= len(task.Volumes) { return } + // temp := task.Volumes[:1] out := make([]TaskVolume, 0) out = append(out, task.Volumes[:index]...) out = append(out, task.Volumes[index+1:]...) @@ -350,6 +352,17 @@ func (task *Task) removeVolumeUnsafe(index int) { func (task *Task) initializeVolumes(cfg *config.Config, dockerClient dockerapi.DockerClient, ctx context.Context) error { // TODO: Have EBS volumes use the DockerVolumeConfig to create the mountpoint + if task.IsEBSTaskAttachEnabled() { + ebsVolumes := task.GetEBSVolumeNames() + for index, tv := range task.Volumes { + volumeName := tv.Name + volumeType := tv.Type + if ebsVolumes[volumeName] && volumeType != apiresource.EBSTaskAttach { + task.RemoveVolume(index) + } + } + } + err := task.initializeDockerLocalVolumes(dockerClient, ctx) if err != nil { return apierrors.NewResourceInitError(task.Arn, err) @@ -3472,6 +3485,28 @@ func (task *Task) isEBSTaskAttachEnabledUnsafe() bool { return false } +// TODO: Add unit tests +func (task *Task) GetEBSVolumeNames() map[string]bool { + task.lock.RLock() + defer task.lock.RUnlock() + return task.getEBSVolumeNamesUnsafe() +} + +func (task *Task) getEBSVolumeNamesUnsafe() map[string]bool { + volNames := map[string]bool{} + for _, tv := range task.Volumes { + switch tv.Volume.(type) { + case *taskresourcevolume.EBSTaskVolumeConfig: + logger.Debug("found ebs volume config") + ebsCfg := tv.Volume.(*taskresourcevolume.EBSTaskVolumeConfig) + volNames[ebsCfg.VolumeName] = true + default: + continue + } + } + return volNames +} + func (task *Task) IsServiceConnectBridgeModeApplicationContainer(container *apicontainer.Container) bool { return container.GetNetworkModeFromHostConfig() == "container" && task.IsServiceConnectEnabled() } @@ -3650,12 +3685,12 @@ func (task *Task) ToHostResources() map[string]*ecs.Resource { resources["PORTS_TCP"] = &ecs.Resource{ Name: utils.Strptr("PORTS_TCP"), Type: utils.Strptr("STRINGSET"), - StringSetValue: commonutils.Uint16SliceToStringSlice(tcpPortSet), + StringSetValue: utils.Uint16SliceToStringSlice(tcpPortSet), } resources["PORTS_UDP"] = &ecs.Resource{ Name: utils.Strptr("PORTS_UDP"), Type: utils.Strptr("STRINGSET"), - StringSetValue: commonutils.Uint16SliceToStringSlice(udpPortSet), + StringSetValue: utils.Uint16SliceToStringSlice(udpPortSet), } // GPU @@ -3688,32 +3723,3 @@ func (task *Task) HasActiveContainers() bool { } return false } - -// IsManagedDaemonTask will check if a task is a non-stopped managed daemon task -// TODO: Somehow track this on a task level (i.e. obtain the managed daemon image name from task arn and then find the corresponding container with the image name) -func (task *Task) IsManagedDaemonTask() (string, bool) { - task.lock.RLock() - defer task.lock.RUnlock() - - // We'll want to obtain the last known non-stopped managed daemon task to be saved into our task engine. - // There can be an edge case where the task hasn't been progressed to RUNNING yet. - if !task.IsInternal || task.KnownStatusUnsafe.Terminal() { - return "", false - } - - for _, c := range task.Containers { - if c.IsManagedDaemonContainer() { - imageName := c.GetImageName() - return imageName, true - } - } - return "", false -} - -func (task *Task) IsRunning() bool { - task.lock.RLock() - defer task.lock.RUnlock() - taskStatus := task.KnownStatusUnsafe - - return taskStatus == apitaskstatus.TaskRunning -} diff --git a/agent/api/task/task_attachment_handler.go b/agent/api/task/task_attachment_handler.go index de237427717..bcaef0bfbeb 100644 --- a/agent/api/task/task_attachment_handler.go +++ b/agent/api/task/task_attachment_handler.go @@ -19,12 +19,12 @@ import ( "github.com/aws/amazon-ecs-agent/agent/api/serviceconnect" taskresourcevolume "github.com/aws/amazon-ecs-agent/agent/taskresource/volume" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/aws-sdk-go/aws" ) -// AttachmentHandler defines an interface to handle attachment received from ACS. +// AttachmentHandler defines an interface to handel attachment received from ACS. type AttachmentHandler interface { parseAttachment(acsAttachment *ecsacs.Attachment) error validateAttachment(acsTask *ecsacs.Task, task *Task) error @@ -110,7 +110,6 @@ func handleTaskAttachments(acsTask *ecsacs.Task, task *Task) error { task.ServiceConnectConfig = scHandler.(*ServiceConnectAttachmentHandler).scConfig } if len(ebsVolumeAttachments) > 0 { - ebsVolumes := make(map[string]bool) for _, attachment := range ebsVolumeAttachments { ebs, err := taskresourcevolume.ParseEBSTaskVolumeAttachment(attachment) if err != nil { @@ -121,17 +120,8 @@ func handleTaskAttachments(acsTask *ecsacs.Task, task *Task) error { Type: apiresource.EBSTaskAttach, Volume: ebs, } - ebsVolumes[ebs.VolumeName] = true task.Volumes = append(task.Volumes, taskVolume) } - // We're removing all incorrect volume configuration that were intially passed over from ACS - for index, tv := range task.Volumes { - volumeName := tv.Name - volumeType := tv.Type - if ebsVolumes[volumeName] && volumeType != apiresource.EBSTaskAttach { - task.RemoveVolume(index) - } - } } } return nil diff --git a/agent/api/task/task_attachment_handler_test.go b/agent/api/task/task_attachment_handler_test.go index 3f2cf5b3ab8..98e007ad267 100644 --- a/agent/api/task/task_attachment_handler_test.go +++ b/agent/api/task/task_attachment_handler_test.go @@ -25,7 +25,7 @@ import ( "github.com/aws/amazon-ecs-agent/agent/api/serviceconnect" taskresourcevolume "github.com/aws/amazon-ecs-agent/agent/taskresource/volume" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" "github.com/aws/aws-sdk-go/aws" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" @@ -274,12 +274,6 @@ func TestHandleTaskAttachmentWithEBSVolumeAttachment(t *testing.T) { AttachmentType: stringToPointer(apiresource.EBSTaskAttach), }, }, - Volumes: []*ecsacs.Volume{ - { - Name: strptr("test-volume"), - Type: strptr(AttachmentType), - }, - }, } testTask := &Task{} err := handleTaskAttachments(testAcsTask, testTask) diff --git a/agent/api/task/task_test.go b/agent/api/task/task_test.go index 2d25dd34983..7bddfb78e31 100644 --- a/agent/api/task/task_test.go +++ b/agent/api/task/task_test.go @@ -48,14 +48,13 @@ import ( taskresourcevolume "github.com/aws/amazon-ecs-agent/agent/taskresource/volume" "github.com/aws/amazon-ecs-agent/agent/utils" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" mock_credentials "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/mocks" "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" - commonutils "github.com/aws/amazon-ecs-agent/ecs-agent/utils" "github.com/aws/aws-sdk-go/service/secretsmanager" "github.com/aws/amazon-ecs-agent/agent/taskresource/asmsecret" @@ -4692,15 +4691,6 @@ func TestTaskWithEBSVolumeAttachment(t *testing.T) { AttachmentType: strptr(apiresource.EBSTaskAttach), }, }, - Volumes: []*ecsacs.Volume{ - { - Name: strptr("test-volume"), - Type: strptr(AttachmentType), - Host: &ecsacs.HostVolumeProperties{ - SourcePath: strptr("/host/path"), - }, - }, - }, } testExpectedEBSCfg := &taskresourcevolume.EBSTaskVolumeConfig{ @@ -5179,7 +5169,7 @@ func TestToHostResources(t *testing.T) { }, { task: testTask4, - expectedResources: getTestTaskResourceMap(int64(1024), int64(512), commonutils.Uint16SliceToStringSlice(portsTCP), commonutils.Uint16SliceToStringSlice(portsUDP), []*string{}), + expectedResources: getTestTaskResourceMap(int64(1024), int64(512), utils.Uint16SliceToStringSlice(portsTCP), utils.Uint16SliceToStringSlice(portsUDP), []*string{}), }, { task: testTask5, @@ -5244,140 +5234,3 @@ func TestToHostResources(t *testing.T) { assert.Equal(t, len(tc.expectedResources["PORTS_UDP"].StringSetValue), len(calcResources["PORTS_UDP"].StringSetValue), "Error converting task UDP port resources") } } - -func TestRemoveVolumes(t *testing.T) { - task := &Task{ - Volumes: []TaskVolume{ - { - Name: "volName", - Type: "host", - Volume: &taskresourcevolume.FSHostVolume{ - FSSourcePath: "/host/path", - }, - }, - }, - } - task.RemoveVolume(0) - assert.Equal(t, len(task.Volumes), 0) -} - -func TestRemoveVolumeIndexOutOfBounds(t *testing.T) { - task := &Task{ - Volumes: []TaskVolume{ - { - Name: "volName", - Type: "host", - Volume: &taskresourcevolume.FSHostVolume{ - FSSourcePath: "/host/path", - }, - }, - }, - } - task.RemoveVolume(1) - assert.Equal(t, len(task.Volumes), 1) - - task.RemoveVolume(-1) - assert.Equal(t, len(task.Volumes), 1) -} - -func TestIsManagedDaemonTask(t *testing.T) { - - testTask1 := &Task{ - Containers: []*apicontainer.Container{ - { - Type: apicontainer.ContainerManagedDaemon, - Image: "someImage:latest", - }, - }, - IsInternal: true, - KnownStatusUnsafe: apitaskstatus.TaskRunning, - } - - testTask2 := &Task{ - Containers: []*apicontainer.Container{ - { - Type: apicontainer.ContainerNormal, - Image: "someImage", - }, - { - Type: apicontainer.ContainerNormal, - Image: "someImage:latest", - }, - }, - IsInternal: false, - KnownStatusUnsafe: apitaskstatus.TaskRunning, - } - - testTask3 := &Task{ - Containers: []*apicontainer.Container{ - { - Type: apicontainer.ContainerManagedDaemon, - Image: "someImage:latest", - }, - }, - IsInternal: true, - KnownStatusUnsafe: apitaskstatus.TaskStopped, - } - - testTask4 := &Task{ - Containers: []*apicontainer.Container{ - { - Type: apicontainer.ContainerManagedDaemon, - Image: "someImage:latest", - }, - }, - IsInternal: true, - KnownStatusUnsafe: apitaskstatus.TaskCreated, - } - - testTask5 := &Task{ - Containers: []*apicontainer.Container{ - { - Type: apicontainer.ContainerNormal, - Image: "someImage", - }, - }, - IsInternal: true, - KnownStatusUnsafe: apitaskstatus.TaskStopped, - } - - testCases := []struct { - task *Task - internal bool - isManagedDaemon bool - }{ - { - task: testTask1, - internal: true, - isManagedDaemon: true, - }, - { - task: testTask2, - internal: false, - isManagedDaemon: false, - }, - { - task: testTask3, - internal: true, - isManagedDaemon: false, - }, - { - task: testTask4, - internal: true, - isManagedDaemon: true, - }, - { - task: testTask5, - internal: true, - isManagedDaemon: false, - }, - } - - for _, tc := range testCases { - t.Run(fmt.Sprintf("IsManagedDaemonTask should return %t for %s", tc.isManagedDaemon, tc.task.String()), - func(t *testing.T) { - _, ok := tc.task.IsManagedDaemonTask() - assert.Equal(t, tc.isManagedDaemon, ok) - }) - } -} diff --git a/agent/api/task/taskvolume.go b/agent/api/task/taskvolume.go index b48bd67dc48..e230fe1d96f 100644 --- a/agent/api/task/taskvolume.go +++ b/agent/api/task/taskvolume.go @@ -21,7 +21,7 @@ import ( "github.com/aws/amazon-ecs-agent/agent/taskresource/fsxwindowsfileserver" taskresourcetypes "github.com/aws/amazon-ecs-agent/agent/taskresource/types" taskresourcevolume "github.com/aws/amazon-ecs-agent/agent/taskresource/volume" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" "github.com/cihub/seelog" "github.com/pkg/errors" @@ -32,7 +32,6 @@ const ( DockerVolumeType = "docker" EFSVolumeType = "efs" FSxWindowsFileServerVolumeType = "fsxWindowsFileServer" - AttachmentType = "attachment" ) // TaskVolume is a definition of all the volumes available for containers to @@ -79,9 +78,6 @@ func (tv *TaskVolume) UnmarshalJSON(b []byte) error { return tv.unmarshalFSxWindowsFileServerVolume(intermediate["fsxWindowsFileServerVolumeConfiguration"]) case apiresource.EBSTaskAttach: return tv.unmarshalEBSVolume(intermediate["ebsVolumeConfiguration"]) - case AttachmentType: - seelog.Warn("Obtaining the volume configuration from task attachments.") - return nil default: return errors.Errorf("unrecognized volume type: %q", tv.Type) } diff --git a/agent/api/task/taskvolume_test.go b/agent/api/task/taskvolume_test.go index 56f6ccbbdde..9c16a53775e 100644 --- a/agent/api/task/taskvolume_test.go +++ b/agent/api/task/taskvolume_test.go @@ -28,8 +28,8 @@ import ( mock_dockerapi "github.com/aws/amazon-ecs-agent/agent/dockerclient/dockerapi/mocks" "github.com/aws/amazon-ecs-agent/agent/taskresource" taskresourcevolume "github.com/aws/amazon-ecs-agent/agent/taskresource/volume" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" "github.com/docker/docker/api/types/volume" "github.com/golang/mock/gomock" diff --git a/agent/app/agent.go b/agent/app/agent.go index e3365b726fe..a232fc7088d 100644 --- a/agent/app/agent.go +++ b/agent/app/agent.go @@ -27,6 +27,7 @@ import ( "github.com/aws/amazon-ecs-agent/agent/app/factory" "github.com/aws/amazon-ecs-agent/agent/config" "github.com/aws/amazon-ecs-agent/agent/containermetadata" + "github.com/aws/amazon-ecs-agent/agent/credentials/instancecreds" "github.com/aws/amazon-ecs-agent/agent/data" "github.com/aws/amazon-ecs-agent/agent/dockerclient" "github.com/aws/amazon-ecs-agent/agent/dockerclient/dockerapi" @@ -59,7 +60,6 @@ import ( "github.com/aws/amazon-ecs-agent/ecs-agent/acs/session" apierrors "github.com/aws/amazon-ecs-agent/ecs-agent/api/errors" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" - "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds" "github.com/aws/amazon-ecs-agent/ecs-agent/doctor" "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" "github.com/aws/amazon-ecs-agent/ecs-agent/eventstream" @@ -433,15 +433,19 @@ func (agent *ecsAgent) doStart(containerChangeEventStream *eventstream.EventStre return exitcodes.ExitTerminal } - // Load Managed Daemon images asynchronously - agent.loadManagedDaemonImagesAsync(imageManager) - scManager := agent.serviceconnectManager scManager.SetECSClient(client, agent.containerInstanceARN) if loaded, _ := scManager.IsLoaded(agent.dockerClient); loaded { imageManager.AddImageToCleanUpExclusionList(agent.serviceconnectManager.GetLoadedImageName()) } + // exclude all daemon images from cleanup + for _, csiDM := range agent.daemonManagers { + if loaded, _ := csiDM.IsLoaded(agent.dockerClient); loaded { + imageManager.AddImageToCleanUpExclusionList(csiDM.GetManagedDaemon().GetLoadedDaemonImageRef()) + } + } + // Add container instance ARN to metadata manager if agent.cfg.ContainerMetadataEnabled.Enabled() { agent.metadataManager.SetContainerInstanceARN(agent.containerInstanceARN) @@ -481,7 +485,7 @@ func (agent *ecsAgent) doStart(containerChangeEventStream *eventstream.EventStre agent.startAsyncRoutines(containerChangeEventStream, credentialsManager, imageManager, taskEngine, deregisterInstanceEventStream, client, taskHandler, attachmentEventHandler, state, doctor) // TODO add EBS watcher to async routines - agent.startEBSWatcher(state, taskEngine, agent.dockerClient) + agent.startEBSWatcher(state, taskEngine) // Start the acs session, which should block doStart return agent.startACSSession(credentialsManager, taskEngine, deregisterInstanceEventStream, client, state, taskHandler, doctor) @@ -747,38 +751,6 @@ func (agent *ecsAgent) constructVPCSubnetAttributes() []*ecs.Attribute { } } -// Loads Managed Daemon images for all Managed Daemons registered on the Agent. -// The images are loaded in the background. Successfully loaded images are added to -// imageManager's cleanup exclusion list. -func (agent *ecsAgent) loadManagedDaemonImagesAsync(imageManager engine.ImageManager) { - daemonManagers := agent.getDaemonManagers() - logger.Debug(fmt.Sprintf("Will load images for %d Managed Daemons", len(daemonManagers))) - for _, daemonManager := range daemonManagers { - go agent.loadManagedDaemonImage(daemonManager, imageManager) - } -} - -// Loads Managed Daemon image and adds it to image cleanup exclusion list upon success. -func (agent *ecsAgent) loadManagedDaemonImage(dm dm.DaemonManager, imageManager engine.ImageManager) { - imageRef := dm.GetManagedDaemon().GetImageRef() - logger.Info("Starting to load Managed Daemon image", logger.Fields{ - field.ImageRef: imageRef, - }) - image, err := dm.LoadImage(agent.ctx, agent.dockerClient) - if err != nil { - logger.Error("Failed to load Managed Daemon image", logger.Fields{ - field.ImageRef: imageRef, - field.Error: err, - }) - return - } - logger.Info("Successfully loaded Managed Daemon image", logger.Fields{ - field.ImageRef: imageRef, - field.ImageID: image.ID, - }) - imageManager.AddImageToCleanUpExclusionList(imageRef) -} - // registerContainerInstance registers the container instance ID for the ECS Agent func (agent *ecsAgent) registerContainerInstance( client api.ECSClient, @@ -1069,7 +1041,7 @@ func (agent *ecsAgent) startACSSession( taskComparer, sequenceNumberAccessor, taskStopper, - agent.ebsWatcher, + nil, updater.NewUpdater(agent.cfg, state, agent.dataClient, taskEngine).AddAgentUpdateHandlers, ) logger.Info("Beginning Polling for updates") @@ -1168,11 +1140,6 @@ func (agent *ecsAgent) setDaemonManager(key string, val dm.DaemonManager) { agent.daemonManagers[key] = val } -// Returns daemon managers map. Not designed to be thread-safe. -func (agent *ecsAgent) getDaemonManagers() map[string]dm.DaemonManager { - return agent.daemonManagers -} - // setVPCSubnet sets the vpc and subnet ids for the agent by querying the // instance metadata service func (agent *ecsAgent) setVPCSubnet() (error, bool) { diff --git a/agent/app/agent_capability.go b/agent/app/agent_capability.go index 6742960941b..0c812ba41e0 100644 --- a/agent/app/agent_capability.go +++ b/agent/app/agent_capability.go @@ -522,16 +522,12 @@ func (agent *ecsAgent) appendEBSTaskAttachCapabilities(capabilities []*ecs.Attri if daemonDef.GetImageName() == md.EbsCsiDriver { csiDaemonManager := dm.NewDaemonManager(daemonDef) agent.setDaemonManager(md.EbsCsiDriver, csiDaemonManager) - imageExists, err := csiDaemonManager.ImageExists() - if !imageExists { - logger.Error( - "Either EBS Daemon image does not exist or failed to check its existence."+ - " This container instance will not advertise EBS Task Attach capability.", + if _, err := csiDaemonManager.LoadImage(agent.ctx, agent.dockerClient); err != nil { + logger.Error("Failed to load the EBS CSI Driver. This container instance will not be able to support EBS Task Attach", logger.Fields{ - field.ImageName: csiDaemonManager.GetManagedDaemon().GetImageName(), - field.ImageTARPath: csiDaemonManager.GetManagedDaemon().GetImageTarPath(), - field.Error: err, - }) + field.Error: err, + }, + ) return capabilities } } diff --git a/agent/app/agent_test.go b/agent/app/agent_test.go index e3346b27f69..5a3f9328ad7 100644 --- a/agent/app/agent_test.go +++ b/agent/app/agent_test.go @@ -59,7 +59,6 @@ import ( "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" aws_credentials "github.com/aws/aws-sdk-go/aws/credentials" - "github.com/docker/docker/api/types" "github.com/golang/mock/gomock" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" @@ -1860,49 +1859,3 @@ func TestWaitUntilInstanceInServicePolling(t *testing.T) { }) } } - -func TestLoadManagedDaemonImage(t *testing.T) { - tcs := []struct { - name string - setDaemonManagerExpectations func(*mock_daemonmanager.MockDaemonManager) - setImageManagerExpectations func(*mock_engine.MockImageManager) - }{ - { - name: "no exclusion list update if image load fails", - setDaemonManagerExpectations: func(mdm *mock_daemonmanager.MockDaemonManager) { - mdm.EXPECT().GetManagedDaemon().Return(md.NewManagedDaemon("name", "tag")).Times(2) - mdm.EXPECT().LoadImage(gomock.Any(), gomock.Any()).Return(nil, errors.New("error")) - }, - }, - { - name: "exclusion list is updated if image load succeeds", - setDaemonManagerExpectations: func(mdm *mock_daemonmanager.MockDaemonManager) { - mdm.EXPECT().GetManagedDaemon().Return(md.NewManagedDaemon("name", "tag")).Times(3) - mdm.EXPECT(). - LoadImage(gomock.Any(), gomock.Any()). - Return(&types.ImageInspect{ID: "image-id"}, nil) - }, - setImageManagerExpectations: func(mim *mock_engine.MockImageManager) { - mim.EXPECT().AddImageToCleanUpExclusionList("name:tag") - }, - }, - } - for _, tc := range tcs { - t.Run(tc.name, func(t *testing.T) { - ctrl := gomock.NewController(t) - ctrl.Finish() - - dockerClient := mock_dockerapi.NewMockDockerClient(ctrl) - daemonManager := mock_daemonmanager.NewMockDaemonManager(ctrl) - imageManager := mock_engine.NewMockImageManager(ctrl) - - tc.setDaemonManagerExpectations(daemonManager) - if tc.setImageManagerExpectations != nil { - tc.setImageManagerExpectations(imageManager) - } - - agent := &ecsAgent{ctx: context.Background(), dockerClient: dockerClient} - agent.loadManagedDaemonImage(daemonManager, imageManager) - }) - } -} diff --git a/agent/app/agent_unix.go b/agent/app/agent_unix.go index a653eb98369..b3c1429289f 100644 --- a/agent/app/agent_unix.go +++ b/agent/app/agent_unix.go @@ -21,7 +21,6 @@ import ( asmfactory "github.com/aws/amazon-ecs-agent/agent/asm/factory" "github.com/aws/amazon-ecs-agent/agent/config" - "github.com/aws/amazon-ecs-agent/agent/dockerclient/dockerapi" ebs "github.com/aws/amazon-ecs-agent/agent/ebs" "github.com/aws/amazon-ecs-agent/agent/ecscni" "github.com/aws/amazon-ecs-agent/agent/engine" @@ -152,14 +151,10 @@ func (agent *ecsAgent) startENIWatcher(state dockerstate.TaskEngineState, stateC return nil } -func (agent *ecsAgent) startEBSWatcher( - state dockerstate.TaskEngineState, - taskEngine engine.TaskEngine, - dockerClient dockerapi.DockerClient, -) { +func (agent *ecsAgent) startEBSWatcher(state dockerstate.TaskEngineState, taskEngine engine.TaskEngine) { if agent.ebsWatcher == nil { seelog.Debug("Creating new EBS watcher...") - agent.ebsWatcher = ebs.NewWatcher(agent.ctx, state, taskEngine, dockerClient) + agent.ebsWatcher = ebs.NewWatcher(agent.ctx, state, taskEngine) go agent.ebsWatcher.Start() } } diff --git a/agent/app/agent_windows.go b/agent/app/agent_windows.go index 8e263bfbf17..a7a87f8195e 100644 --- a/agent/app/agent_windows.go +++ b/agent/app/agent_windows.go @@ -24,7 +24,6 @@ import ( asmfactory "github.com/aws/amazon-ecs-agent/agent/asm/factory" "github.com/aws/amazon-ecs-agent/agent/data" - "github.com/aws/amazon-ecs-agent/agent/dockerclient/dockerapi" "github.com/aws/amazon-ecs-agent/agent/ecscni" "github.com/aws/amazon-ecs-agent/agent/engine" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" @@ -100,12 +99,9 @@ func (agent *ecsAgent) startWindowsService() int { return 0 } -func (agent *ecsAgent) startEBSWatcher( - state dockerstate.TaskEngineState, - taskEngine engine.TaskEngine, - dockerClient dockerapi.DockerClient, -) { +func (agent *ecsAgent) startEBSWatcher(state dockerstate.TaskEngineState, taskEngine engine.TaskEngine) error { seelog.Debug("Windows EBS Watcher not implemented: No Op") + return nil } // handler implements https://godoc.org/golang.org/x/sys/windows/svc#Handler diff --git a/agent/app/data_test.go b/agent/app/data_test.go index aefea6d07fb..99bacc33fac 100644 --- a/agent/app/data_test.go +++ b/agent/app/data_test.go @@ -29,7 +29,7 @@ import ( "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" "github.com/aws/amazon-ecs-agent/agent/engine/image" "github.com/aws/amazon-ecs-agent/agent/statemanager" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" "github.com/aws/amazon-ecs-agent/ecs-agent/eventstream" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" "github.com/golang/mock/gomock" @@ -76,7 +76,7 @@ var ( } testENIAttachment = &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: testAttachmentArn, AttachStatusSent: false, }, diff --git a/agent/asm/factory/factory.go b/agent/asm/factory/factory.go index b703ada5405..aeb6ffaa652 100644 --- a/agent/asm/factory/factory.go +++ b/agent/asm/factory/factory.go @@ -16,10 +16,8 @@ package factory import ( "time" - "github.com/aws/amazon-ecs-agent/agent/config" - agentversion "github.com/aws/amazon-ecs-agent/agent/version" + "github.com/aws/amazon-ecs-agent/agent/httpclient" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" - "github.com/aws/amazon-ecs-agent/ecs-agent/httpclient" "github.com/aws/aws-sdk-go/aws" awscreds "github.com/aws/aws-sdk-go/aws/credentials" "github.com/aws/aws-sdk-go/aws/session" @@ -44,7 +42,7 @@ type asmClientCreator struct{} func (*asmClientCreator) NewASMClient(region string, creds credentials.IAMRoleCredentials) secretsmanageriface.SecretsManagerAPI { cfg := aws.NewConfig(). - WithHTTPClient(httpclient.New(roundtripTimeout, false, agentversion.String(), config.OSType)). + WithHTTPClient(httpclient.New(roundtripTimeout, false)). WithRegion(region). WithCredentials( awscreds.NewStaticCredentials(creds.AccessKeyID, creds.SecretAccessKey, diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds.go b/agent/credentials/instancecreds/instancecreds.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds.go rename to agent/credentials/instancecreds/instancecreds.go diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds_linux.go b/agent/credentials/instancecreds/instancecreds_linux.go similarity index 86% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds_linux.go rename to agent/credentials/instancecreds/instancecreds_linux.go index 88ac75ee454..b94452635ad 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds_linux.go +++ b/agent/credentials/instancecreds/instancecreds_linux.go @@ -16,13 +16,10 @@ package instancecreds import ( - "fmt" - - "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers" - "github.com/aws/amazon-ecs-agent/ecs-agent/logger" - + "github.com/aws/amazon-ecs-agent/agent/credentials/providers" "github.com/aws/aws-sdk-go/aws/credentials" "github.com/aws/aws-sdk-go/aws/defaults" + "github.com/cihub/seelog" ) // GetCredentials returns the instance credentials chain. This is the default chain @@ -47,9 +44,9 @@ func GetCredentials(isExternal bool) *credentials.Credentials { // credentials.Credentials is concurrency-safe, so lock not needed here v, err := credentialChain.Get() if err != nil { - logger.Error(fmt.Sprintf("Error getting ECS instance credentials from default chain: %s", err)) + seelog.Errorf("Error getting ECS instance credentials from default chain: %s", err) } else { - logger.Info(fmt.Sprintf("Successfully got ECS instance credentials from provider: %s", v.ProviderName)) + seelog.Infof("Successfully got ECS instance credentials from provider: %s", v.ProviderName) } return credentialChain } diff --git a/ecs-agent/credentials/instancecreds/instancecreds_test.go b/agent/credentials/instancecreds/instancecreds_test.go similarity index 100% rename from ecs-agent/credentials/instancecreds/instancecreds_test.go rename to agent/credentials/instancecreds/instancecreds_test.go diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds_unsupported.go b/agent/credentials/instancecreds/instancecreds_unsupported.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds_unsupported.go rename to agent/credentials/instancecreds/instancecreds_unsupported.go diff --git a/ecs-agent/credentials/instancecreds/instancecreds_windows.go b/agent/credentials/instancecreds/instancecreds_windows.go similarity index 89% rename from ecs-agent/credentials/instancecreds/instancecreds_windows.go rename to agent/credentials/instancecreds/instancecreds_windows.go index 22dcbcf9d63..efcd1f9aa74 100644 --- a/ecs-agent/credentials/instancecreds/instancecreds_windows.go +++ b/agent/credentials/instancecreds/instancecreds_windows.go @@ -16,13 +16,10 @@ package instancecreds import ( - "fmt" - - "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers" - "github.com/aws/amazon-ecs-agent/ecs-agent/logger" - + "github.com/aws/amazon-ecs-agent/agent/credentials/providers" "github.com/aws/aws-sdk-go/aws/credentials" "github.com/aws/aws-sdk-go/aws/defaults" + "github.com/cihub/seelog" ) // GetCredentials returns the instance credentials chain. This is the default chain @@ -64,9 +61,9 @@ func GetCredentials(isExternal bool) *credentials.Credentials { // credentials.Credentials is concurrency-safe, so lock not needed here v, err := credentialChain.Get() if err != nil { - logger.Error(fmt.Sprintf("Error getting ECS instance credentials from default chain: %s", err)) + seelog.Errorf("Error getting ECS instance credentials from default chain: %s", err) } else { - logger.Info(fmt.Sprintf("Successfully got ECS instance credentials from provider: %s", v.ProviderName)) + seelog.Infof("Successfully got ECS instance credentials from provider: %s", v.ProviderName) } return credentialChain } diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers/credentials_filename_linux.go b/agent/credentials/providers/credentials_filename_linux.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers/credentials_filename_linux.go rename to agent/credentials/providers/credentials_filename_linux.go diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers/credentials_filename_unsupported.go b/agent/credentials/providers/credentials_filename_unsupported.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers/credentials_filename_unsupported.go rename to agent/credentials/providers/credentials_filename_unsupported.go diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers/credentials_filename_windows.go b/agent/credentials/providers/credentials_filename_windows.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers/credentials_filename_windows.go rename to agent/credentials/providers/credentials_filename_windows.go diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers/rotating_shared_credentials_provider.go b/agent/credentials/providers/rotating_shared_credentials_provider.go similarity index 89% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers/rotating_shared_credentials_provider.go rename to agent/credentials/providers/rotating_shared_credentials_provider.go index 9102f59673d..93f52b78754 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers/rotating_shared_credentials_provider.go +++ b/agent/credentials/providers/rotating_shared_credentials_provider.go @@ -18,9 +18,8 @@ import ( "os" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/logger" - "github.com/aws/aws-sdk-go/aws/credentials" + "github.com/cihub/seelog" ) const ( @@ -47,7 +46,7 @@ type RotatingSharedCredentialsProvider struct { func NewRotatingSharedCredentialsProvider() *RotatingSharedCredentialsProvider { var credentialProfile = DEFAULT_CREDENTIAL_PROFILE if alternateCredentialProfile := os.Getenv(ALTERNATE_CREDENTIAL_PROFILE_ENV_VAR); alternateCredentialProfile != "" { - logger.Info(fmt.Sprintf("Overriding %s credential profile; using: %s.", DEFAULT_CREDENTIAL_PROFILE, alternateCredentialProfile)) + seelog.Infof("Overriding %s credential profile; using: %s.", DEFAULT_CREDENTIAL_PROFILE, alternateCredentialProfile) credentialProfile = alternateCredentialProfile } @@ -68,8 +67,8 @@ func (p *RotatingSharedCredentialsProvider) Retrieve() (credentials.Value, error return v, err } p.SetExpiration(time.Now().Add(p.RotationInterval), 0) - logger.Info(fmt.Sprintf("Successfully got instance credentials from file %s. %s", - p.sharedCredentialsProvider.Filename, credValueToString(v))) + seelog.Infof("Successfully got instance credentials from file %s. %s", + p.sharedCredentialsProvider.Filename, credValueToString(v)) return v, err } diff --git a/ecs-agent/credentials/providers/rotating_shared_credentials_provider_test.go b/agent/credentials/providers/rotating_shared_credentials_provider_test.go similarity index 100% rename from ecs-agent/credentials/providers/rotating_shared_credentials_provider_test.go rename to agent/credentials/providers/rotating_shared_credentials_provider_test.go diff --git a/agent/data/client.go b/agent/data/client.go index a5058c03bb2..c756f7ff977 100644 --- a/agent/data/client.go +++ b/agent/data/client.go @@ -21,7 +21,6 @@ import ( "github.com/aws/amazon-ecs-agent/agent/api/task" "github.com/aws/amazon-ecs-agent/agent/data/transformationfunctions" "github.com/aws/amazon-ecs-agent/agent/engine/image" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" generaldata "github.com/aws/amazon-ecs-agent/ecs-agent/data" "github.com/aws/amazon-ecs-agent/ecs-agent/modeltransformer" "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" @@ -36,7 +35,6 @@ const ( tasksBucketName = "tasks" imagesBucketName = "images" eniAttachmentsBucketName = "eniattachments" - resAttachmentsBucketName = "resattachments" metadataBucketName = "metadata" emptyAgentVersionMsg = "No version info available in boltDB. Either this is a fresh instance, or we were using state file to persist data. Transformer not applicable." ) @@ -50,7 +48,6 @@ var ( containersBucketName, tasksBucketName, eniAttachmentsBucketName, - resAttachmentsBucketName, metadataBucketName, } ) @@ -87,17 +84,9 @@ type Client interface { SaveENIAttachment(*networkinterface.ENIAttachment) error // DeleteENIAttachment deletes the data of an ENI atttachment. DeleteENIAttachment(string) error - // GetENIAttachments gets the data of all the ENI attachments. + // GetENIAttachments gets the data of all the ENI attachment. GetENIAttachments() ([]*networkinterface.ENIAttachment, error) - // SaveResourceAttachment saves the data of a resource attachment. - // This includes the EBS Attachment type - SaveResourceAttachment(*resource.ResourceAttachment) error - // DeleteResourceAttachment deletes the data of a resource atttachment. - DeleteResourceAttachment(string) error - // GetResourceAttachments gets the data of all the resouce attachments. - GetResourceAttachments() ([]*resource.ResourceAttachment, error) - // SaveMetadata saves a key value pair of metadata. SaveMetadata(string, string) error // GetMetadata gets the value of a certain kind of metadata. diff --git a/agent/data/eniattachment_client.go b/agent/data/eniattachment_client.go index d52c2d5778e..d002e3b36b8 100644 --- a/agent/data/eniattachment_client.go +++ b/agent/data/eniattachment_client.go @@ -24,7 +24,7 @@ import ( ) func (c *client) SaveENIAttachment(eni *ni.ENIAttachment) error { - id, err := utils.GetAttachmentId(eni.AttachmentARN) + id, err := utils.GetENIAttachmentId(eni.AttachmentARN) if err != nil { return errors.Wrap(err, "failed to generate database id") } diff --git a/agent/data/attachment_client_test.go b/agent/data/eniattachment_client_test.go similarity index 53% rename from agent/data/attachment_client_test.go rename to agent/data/eniattachment_client_test.go index 248cc3dff18..e876b56ec72 100644 --- a/agent/data/attachment_client_test.go +++ b/agent/data/eniattachment_client_test.go @@ -19,8 +19,7 @@ package data import ( "testing" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" "github.com/stretchr/testify/assert" ) @@ -28,15 +27,13 @@ import ( const ( testAttachmentArn = "arn:aws:ecs:us-west-2:167933679560:attachment/test-arn" testAttachmentArn2 = "arn:aws:ecs:us-west-2:167933679560:attachment/test-arn2" - testAttachmentArn3 = "arn:aws:ecs:us-west-2:123456789012:volume/test-arn3" - testAttachmentArn4 = "arn:aws:ecs:us-west-2:123456789012:volume/test-arn4" ) func TestManageENIAttachments(t *testing.T) { testClient := newTestClient(t) testEniAttachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: testAttachmentArn, AttachStatusSent: false, }, @@ -52,7 +49,7 @@ func TestManageENIAttachments(t *testing.T) { assert.Equal(t, testAttachmentArn, res[0].AttachmentARN) testEniAttachment2 := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: testAttachmentArn2, AttachStatusSent: true, }, @@ -70,49 +67,11 @@ func TestManageENIAttachments(t *testing.T) { assert.Len(t, res, 0) } -func TestManageResourceAttachments(t *testing.T) { - testClient := newTestClient(t) - - testResAttachment := &resource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ - AttachmentARN: testAttachmentArn3, - AttachStatusSent: false, - }, - } - - assert.NoError(t, testClient.SaveResourceAttachment(testResAttachment)) - testResAttachment.SetSentStatus() - assert.NoError(t, testClient.SaveResourceAttachment(testResAttachment)) - res, err := testClient.GetResourceAttachments() - assert.NoError(t, err) - assert.Len(t, res, 1) - assert.Equal(t, true, res[0].AttachStatusSent) - assert.Equal(t, testAttachmentArn3, res[0].AttachmentARN) - - testResAttachment2 := &resource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ - AttachmentARN: testAttachmentArn4, - AttachStatusSent: true, - }, - } - - assert.NoError(t, testClient.SaveResourceAttachment(testResAttachment2)) - res, err = testClient.GetResourceAttachments() - assert.NoError(t, err) - assert.Len(t, res, 2) - - assert.NoError(t, testClient.DeleteResourceAttachment("test-arn3")) - assert.NoError(t, testClient.DeleteResourceAttachment("test-arn4")) - res, err = testClient.GetResourceAttachments() - assert.NoError(t, err) - assert.Len(t, res, 0) -} - func TestSaveENIAttachmentInvalidID(t *testing.T) { testClient := newTestClient(t) testEniAttachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: "invalid-arn", AttachStatusSent: false, }, @@ -120,16 +79,3 @@ func TestSaveENIAttachmentInvalidID(t *testing.T) { assert.Error(t, testClient.SaveENIAttachment(testEniAttachment)) } - -func TestSaveResAttachmentInvalidID(t *testing.T) { - testClient := newTestClient(t) - - testResAttachment := &resource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ - AttachmentARN: "invalid-arn", - AttachStatusSent: false, - }, - } - - assert.Error(t, testClient.SaveResourceAttachment(testResAttachment)) -} diff --git a/agent/data/noop_client.go b/agent/data/noop_client.go index 3c38ee436be..cbad81bc2a4 100644 --- a/agent/data/noop_client.go +++ b/agent/data/noop_client.go @@ -17,7 +17,6 @@ import ( "github.com/aws/amazon-ecs-agent/agent/api/container" "github.com/aws/amazon-ecs-agent/agent/api/task" "github.com/aws/amazon-ecs-agent/agent/engine/image" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" ) @@ -81,18 +80,6 @@ func (c *noopClient) GetENIAttachments() ([]*networkinterface.ENIAttachment, err return nil, nil } -func (c *noopClient) SaveResourceAttachment(*resource.ResourceAttachment) error { - return nil -} - -func (c *noopClient) DeleteResourceAttachment(string) error { - return nil -} - -func (c *noopClient) GetResourceAttachments() ([]*resource.ResourceAttachment, error) { - return nil, nil -} - func (c *noopClient) SaveMetadata(string, string) error { return nil } diff --git a/agent/data/resattachment_client.go b/agent/data/resattachment_client.go deleted file mode 100644 index c93e0450b13..00000000000 --- a/agent/data/resattachment_client.go +++ /dev/null @@ -1,58 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package data - -import ( - "encoding/json" - - "github.com/aws/amazon-ecs-agent/agent/utils" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" - - "github.com/pkg/errors" - bolt "go.etcd.io/bbolt" -) - -func (c *client) SaveResourceAttachment(res *resource.ResourceAttachment) error { - id, err := utils.GetAttachmentId(res.AttachmentARN) - if err != nil { - return errors.Wrap(err, "failed to generate database id") - } - return c.DB.Batch(func(tx *bolt.Tx) error { - b := tx.Bucket([]byte(resAttachmentsBucketName)) - return c.Accessor.PutObject(b, id, res) - }) -} - -func (c *client) DeleteResourceAttachment(id string) error { - return c.DB.Batch(func(tx *bolt.Tx) error { - b := tx.Bucket([]byte(resAttachmentsBucketName)) - return b.Delete([]byte(id)) - }) -} - -func (c *client) GetResourceAttachments() ([]*resource.ResourceAttachment, error) { - var resAttachments []*resource.ResourceAttachment - err := c.DB.View(func(tx *bolt.Tx) error { - bucket := tx.Bucket([]byte(resAttachmentsBucketName)) - return c.Accessor.Walk(bucket, func(id string, data []byte) error { - resAttachment := resource.ResourceAttachment{} - if err := json.Unmarshal(data, &resAttachment); err != nil { - return err - } - resAttachments = append(resAttachments, &resAttachment) - return nil - }) - }) - return resAttachments, err -} diff --git a/agent/ebs/watcher.go b/agent/ebs/watcher.go index 5fe069910ee..8fd2a0d9caf 100644 --- a/agent/ebs/watcher.go +++ b/agent/ebs/watcher.go @@ -17,20 +17,18 @@ import ( "context" "errors" "fmt" - "path/filepath" "strconv" "time" ecsapi "github.com/aws/amazon-ecs-agent/agent/api" - "github.com/aws/amazon-ecs-agent/agent/dockerclient/dockerapi" ecsengine "github.com/aws/amazon-ecs-agent/agent/engine" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" - apiebs "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" + attachmentinfo "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + apiebs "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" + apiattachmentstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" csi "github.com/aws/amazon-ecs-agent/ecs-agent/csiclient" - "github.com/aws/amazon-ecs-agent/ecs-agent/logger" - "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" md "github.com/aws/amazon-ecs-agent/ecs-agent/manageddaemon" + apieni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" log "github.com/cihub/seelog" v1 "k8s.io/api/core/v1" @@ -38,7 +36,6 @@ import ( const ( nodeStageTimeout = 2 * time.Second - hostMountDir = "/mnt/ecs/ebs" ) type EBSWatcher struct { @@ -51,15 +48,13 @@ type EBSWatcher struct { csiClient csi.CSIClient scanTicker *time.Ticker // TODO: The dockerTaskEngine.stateChangeEvent will be used to send over the state change event for EBS attachments once it's been found and mounted/resize/format. - taskEngine ecsengine.TaskEngine - dockerClient dockerapi.DockerClient + taskEngine ecsengine.TaskEngine } // NewWatcher is used to return a new instance of the EBSWatcher struct func NewWatcher(ctx context.Context, state dockerstate.TaskEngineState, - taskEngine ecsengine.TaskEngine, - dockerClient dockerapi.DockerClient) *EBSWatcher { + taskEngine ecsengine.TaskEngine) *EBSWatcher { derivedContext, cancel := context.WithCancel(ctx) discoveryClient := apiebs.NewDiscoveryClient(derivedContext) // TODO pull this socket out into config @@ -71,7 +66,6 @@ func NewWatcher(ctx context.Context, discoveryClient: discoveryClient, csiClient: &csiClient, taskEngine: taskEngine, - dockerClient: dockerClient, } } @@ -84,7 +78,17 @@ func (w *EBSWatcher) Start() { for { select { case <-w.scanTicker.C: - w.tick() + pendingEBS := w.agentState.GetAllPendingEBSAttachmentsWithKey() + if len(pendingEBS) > 0 { + foundVolumes := apiebs.ScanEBSVolumes(pendingEBS, w.discoveryClient) + w.overrideDeviceName(foundVolumes) + if err := w.StageAll(foundVolumes); err != nil { + log.Errorf("stage error: %s", err) + continue + } + // TODO only notify attached for volumes that are successfully staged + w.NotifyAttached(foundVolumes) + } case <-w.ctx.Done(): w.scanTicker.Stop() log.Info("EBS Watcher Stopped due to agent stop") @@ -93,93 +97,6 @@ func (w *EBSWatcher) Start() { } } -// Method to handle watcher's tick. -// If there are no pending EBS volume attachments in agent state, then this method is a no-op. -// If there are pending EBS volume attachments in agent state then this method will ensure -// that EBS Managed Daemon is running and then scan the host for the EBS volumes and process -// the ones that are found. -func (w *EBSWatcher) tick() { - pendingEBS := w.agentState.GetAllPendingEBSAttachmentsWithKey() - if len(pendingEBS) <= 0 { - return - } - if !w.daemonRunning() { - log.Info("EBS Managed Daemon is not currently running. Skipping EBS Watcher tick.") - return - } - foundVolumes := apiebs.ScanEBSVolumes(pendingEBS, w.discoveryClient) - w.overrideDeviceName(foundVolumes) - w.StageAll(foundVolumes) - w.NotifyAttached(foundVolumes) -} - -// Checks if EBS Daemon Task is running and starts a new one it if it's not. -func (w *EBSWatcher) daemonRunning() bool { - csiTask := w.taskEngine.GetDaemonTask(md.EbsCsiDriver) - - // Check if task is running or about to run - if csiTask != nil && csiTask.GetKnownStatus() == status.TaskRunning { - logger.Debug("EBS Managed Daemon is running", logger.Fields{field.TaskID: csiTask.GetID()}) - return true - } - if csiTask != nil && csiTask.GetKnownStatus() < status.TaskRunning { - logger.Debug("EBS Managed Daemon task is pending transitioning to running", logger.Fields{ - field.TaskID: csiTask.GetID(), - field.KnownStatus: csiTask.GetKnownStatus(), - }) - return false - } - - // Task is neither running nor about to run. We need to start a new one. - - if csiTask == nil { - logger.Info("EBS Managed Daemon task has not been initialized. Will start a new one.") - } else { - logger.Info("EBS Managed Daemon task is beyond running state. Will start a new one.", logger.Fields{ - field.TaskID: csiTask.GetID(), - field.KnownStatus: csiTask.GetKnownStatus(), - }) - } - - ebsCsiDaemonManager, ok := w.taskEngine.GetDaemonManagers()[md.EbsCsiDriver] - if !ok { - log.Errorf("EBS Daemon Manager is not Initialized. EBS Task Attach is not supported.") - return false - } - - // Check if Managed Daemon image has been loaded. - imageLoaded, err := ebsCsiDaemonManager.IsLoaded(w.dockerClient) - if !imageLoaded { - logger.Info("Image is not loaded yet so can't start a Managed Daemon task.", logger.Fields{ - "ImageRef": ebsCsiDaemonManager.GetManagedDaemon().GetImageRef(), - field.Error: err, - }) - return false - } - logger.Debug("Managed Daemon image has been loaded", logger.Fields{ - "ImageRef": ebsCsiDaemonManager.GetManagedDaemon().GetImageRef(), - }) - - // Create a new Managed Daemon task. - csiTask, err = ebsCsiDaemonManager.CreateDaemonTask() - if err != nil { - // Failed to create the task. There is nothing that the watcher can do at this time - // so swallow the error and try again later. - logger.Error("Failed to create EBS Managed Daemon task.", logger.Fields{field.Error: err}) - return false - } - - // Add the new task to task engine. - w.taskEngine.SetDaemonTask(md.EbsCsiDriver, csiTask) - w.taskEngine.AddTask(csiTask) - logger.Info("Added EBS Managed Daemon task to task engine", logger.Fields{ - field.TaskID: csiTask.GetID(), - }) - - // Task is not confirmed to be running yet, so return false. - return false -} - // Stop will stop the EBS watcher func (w *EBSWatcher) Stop() { log.Info("Stopping EBS watcher.") @@ -195,7 +112,8 @@ func (w *EBSWatcher) HandleResourceAttachment(ebs *apiebs.ResourceAttachment) { // HandleResourceAttachment processes the resource attachment message. It will: // 1. Check whether we already have this attachment in state and if so it's a noop. -// 2. Otherwise add the attachment to state, start its ack timer, and save to the agent state. +// 2. Start the EBS CSI driver if it's not already running +// 3. Otherwise add the attachment to state, start its ack timer, and save to the agent state. func (w *EBSWatcher) HandleEBSResourceAttachment(ebs *apiebs.ResourceAttachment) error { attachmentType := ebs.GetAttachmentType() if attachmentType != apiebs.EBSTaskAttach { @@ -212,6 +130,28 @@ func (w *EBSWatcher) HandleEBSResourceAttachment(ebs *apiebs.ResourceAttachment) }) } + // start EBS CSI Driver Managed Daemon + if runningCsiTask := w.taskEngine.GetDaemonTask(md.EbsCsiDriver); runningCsiTask != nil { + log.Debugf("engine ebs CSI driver is running with taskID: %v", runningCsiTask.GetID()) + } else { + if ebsCsiDaemonManager, ok := w.taskEngine.GetDaemonManagers()[md.EbsCsiDriver]; ok { + if csiTask, err := ebsCsiDaemonManager.CreateDaemonTask(); err != nil { + // fail attachment and return + log.Errorf("Unable to start ebsCsiDaemon in the engine: error: %s", err) + if csiTask != nil { + log.Errorf("CSI task Error task ID: %s", csiTask.GetID()) + } + return err + } else { + w.taskEngine.SetDaemonTask(md.EbsCsiDriver, csiTask) + w.taskEngine.AddTask(csiTask) + log.Infof("task_engine: Added EBS CSI task to engine") + } + } else { + log.Errorf("CSI Driver is not Initialized") + } + } + if err := w.addEBSAttachmentToState(ebs); err != nil { return fmt.Errorf("%w; attach %v message handler: unable to add ebs attachment to engine state: %v", err, attachmentType, ebs.EBSToString()) @@ -234,86 +174,95 @@ func (w *EBSWatcher) overrideDeviceName(foundVolumes map[string]string) { } // assumes CSI Driver Managed Daemon is running else call will timeout -func (w *EBSWatcher) StageAll(foundVolumes map[string]string) []error { - errors := make([]error, 0) - for volumeId, deviceName := range foundVolumes { - if err := w.stageVolumeEBS(volumeId, deviceName); err != nil { - log.Error(err) - errors = append(errors, err) +func (w *EBSWatcher) StageAll(foundVolumes map[string]string) error { + for volID, deviceName := range foundVolumes { + // get volume details from attachment + ebsAttachment, ok := w.agentState.GetEBSByVolumeId(volID) + if !ok { + continue } + if ebsAttachment.IsSent() { + log.Debugf("State change event has already been emitted for EBS volume: %v.", ebsAttachment.EBSToString()) + continue + } + if ebsAttachment.HasExpired() { + log.Debugf("EBS status expired, no longer tracking EBS volume: %v.", ebsAttachment.EBSToString()) + continue + } + if ebsAttachment.IsAttached() { + log.Debugf("EBS status is already attached, skipping: %v.", ebsAttachment.EBSToString()) + continue + } + hostPath := ebsAttachment.GetAttachmentProperties(apiebs.SourceVolumeHostPathKey) + filesystemType := ebsAttachment.GetAttachmentProperties(apiebs.FileSystemTypeName) + + // CSI NodeStage stub required fields + stubSecrets := make(map[string]string) + stubVolumeContext := make(map[string]string) + stubMountOptions := []string{} + // note that the numbers '123456', '10' and '8' here are dummy data + // we don't use the fsGroup for now + stubFsGroup, _ := strconv.ParseInt("123456", 10, 8) + publishContext := map[string]string{"devicePath": deviceName} + // call CSI NodeStage + timeoutCtx, cancelFunc := context.WithTimeout(w.ctx, nodeStageTimeout) + defer cancelFunc() + err := w.csiClient.NodeStageVolume(timeoutCtx, + volID, + publishContext, + hostPath, + filesystemType, + v1.ReadWriteMany, + stubSecrets, + stubVolumeContext, + stubMountOptions, + &stubFsGroup) + + if err != nil { + log.Errorf("Failed to initialize EBS volume: error: %s", err) + continue + } + // set attached status + log.Infof("We've set attached status for %v", ebsAttachment.EBSToString()) + ebsAttachment.SetAttachedStatus() } - return errors -} - -func (w *EBSWatcher) stageVolumeEBS(volID, deviceName string) error { - // get volume details from attachment - ebsAttachment, ok := w.agentState.GetEBSByVolumeId(volID) - if !ok { - return fmt.Errorf("Unable to find EBS volume with volume ID: %v within agent state.", volID) - } - if !ebsAttachment.ShouldAttach() { - return nil - } - attachmentMountPath := ebsAttachment.GetAttachmentProperties(apiebs.SourceVolumeHostPathKey) - hostPath := filepath.Join(hostMountDir, attachmentMountPath) - filesystemType := ebsAttachment.GetAttachmentProperties(apiebs.FileSystemKey) - // CSI NodeStage stub required fields - stubSecrets := make(map[string]string) - stubVolumeContext := make(map[string]string) - stubMountOptions := []string{} - // note that the numbers '123456', '10' and '8' here are dummy data - // we don't use the fsGroup for now - stubFsGroup, _ := strconv.ParseInt("123456", 10, 8) - publishContext := map[string]string{"devicePath": deviceName} - // call CSI NodeStage - timeoutCtx, cancelFunc := context.WithTimeout(w.ctx, nodeStageTimeout) - defer cancelFunc() - err := w.csiClient.NodeStageVolume(timeoutCtx, - volID, - publishContext, - hostPath, - filesystemType, - v1.ReadWriteMany, - stubSecrets, - stubVolumeContext, - stubMountOptions, - &stubFsGroup) - if err != nil { - return fmt.Errorf("Failed to initialize EBS volume ID: %v: error: %w", ebsAttachment.EBSToString(), err) - } - ebsAttachment.SetAttachedStatus() - log.Debugf("We've set attached status for %v", ebsAttachment.EBSToString()) return nil } // NotifyAttached will go through the list of found EBS volumes from the scanning process and mark them as found. -func (w *EBSWatcher) NotifyAttached(foundVolumes map[string]string) []error { - errors := make([]error, 0) +func (w *EBSWatcher) NotifyAttached(foundVolumes map[string]string) { for volID := range foundVolumes { - if err := w.notifyAttachedEBS(volID); err != nil { - log.Error(err) - errors = append(errors, err) - } + w.notifyAttachedEBS(volID) } - return errors } // notifyAttachedEBS will mark it as found within the agent state -func (w *EBSWatcher) notifyAttachedEBS(volumeId string) error { +func (w *EBSWatcher) notifyAttachedEBS(volumeId string) { // TODO: Add the EBS volume to data client ebs, ok := w.agentState.GetEBSByVolumeId(volumeId) if !ok { - return fmt.Errorf("Unable to find EBS volume with volume ID: %v within agent state.", volumeId) + log.Errorf("Unable to find EBS volume with volume ID: %v within agent state.", volumeId) + return } - if !ebs.ShouldNotify() { - return nil + + if ebs.HasExpired() { + log.Debugf("EBS status expired, no longer tracking EBS volume: %v.", ebs.EBSToString()) + return + } + + if ebs.IsSent() { + log.Debugf("State change event has already been emitted for EBS volume: %v.", ebs.EBSToString()) + return } + // We found an EBS volume which has the expiration time set in future and + // needs to be acknowledged as having been 'attached' to the Instance if err := w.sendEBSStateChange(ebs); err != nil { - return fmt.Errorf("Unable to send state EBS change, %s", err) + log.Warnf("Unable to send state EBS change, %s", err) + return } - ebs.StopAckTimer() + ebs.SetSentStatus() log.Infof("We've set sent status for %v", ebs.EBSToString()) - return nil + ebs.StopAckTimer() } // removeEBSAttachment removes a EBS volume with a specific volume ID @@ -358,9 +307,17 @@ func (w *EBSWatcher) sendEBSStateChange(ebsvol *apiebs.ResourceAttachment) error } func (w *EBSWatcher) emitEBSAttachedEvent(ebsvol *apiebs.ResourceAttachment) { + attachmentInfo := attachmentinfo.AttachmentInfo{ + AttachmentARN: ebsvol.GetAttachmentARN(), + Status: apiattachmentstatus.AttachmentAttached, + ExpiresAt: ebsvol.GetExpiresAt(), + ClusterARN: ebsvol.GetClusterARN(), + ContainerInstanceARN: ebsvol.GetContainerInstanceARN(), + } attachmentChange := ecsapi.AttachmentStateChange{ - Attachment: ebsvol, + Attachment: &apieni.ENIAttachment{AttachmentInfo: attachmentInfo}, } + log.Debugf("Emitting EBS volume attached event for: %v", ebsvol) w.taskEngine.StateChangeEvents() <- attachmentChange } diff --git a/agent/ebs/watcher_test.go b/agent/ebs/watcher_test.go index 765ec002c28..6fc6ef2fc27 100644 --- a/agent/ebs/watcher_test.go +++ b/agent/ebs/watcher_test.go @@ -18,30 +18,20 @@ package ebs import ( "context" - "errors" "fmt" - "path/filepath" "sync" "testing" "time" - "github.com/aws/amazon-ecs-agent/agent/api/task" - mock_dockerapi "github.com/aws/amazon-ecs-agent/agent/dockerclient/dockerapi/mocks" "github.com/aws/amazon-ecs-agent/agent/engine" - "github.com/aws/amazon-ecs-agent/agent/engine/daemonmanager" - mock_daemonmanager "github.com/aws/amazon-ecs-agent/agent/engine/daemonmanager/mock" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" - mock_dockerstate "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate/mocks" mock_engine "github.com/aws/amazon-ecs-agent/agent/engine/mocks" - statechange "github.com/aws/amazon-ecs-agent/agent/statechange" taskresourcevolume "github.com/aws/amazon-ecs-agent/agent/taskresource/volume" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/testconst" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" - apiebs "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" - mock_ebs_discovery "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/mocks" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" - csi "github.com/aws/amazon-ecs-agent/ecs-agent/csiclient" - mock_csiclient "github.com/aws/amazon-ecs-agent/ecs-agent/csiclient/mocks" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + apiebs "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" + mock_ebs_discovery "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/mocks" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" md "github.com/aws/amazon-ecs-agent/ecs-agent/manageddaemon" "github.com/golang/mock/gomock" @@ -58,7 +48,7 @@ const ( // newTestEBSWatcher creates a new EBSWatcher object for testing func newTestEBSWatcher(ctx context.Context, agentState dockerstate.TaskEngineState, - discoveryClient apiebs.EBSDiscovery, taskEngine engine.TaskEngine, csiClient csi.CSIClient) *EBSWatcher { + discoveryClient apiebs.EBSDiscovery, taskEngine engine.TaskEngine) *EBSWatcher { derivedContext, cancel := context.WithCancel(ctx) return &EBSWatcher{ ctx: derivedContext, @@ -66,7 +56,6 @@ func newTestEBSWatcher(ctx context.Context, agentState dockerstate.TaskEngineSta agentState: agentState, discoveryClient: discoveryClient, taskEngine: taskEngine, - csiClient: csiClient, } } @@ -84,18 +73,6 @@ func TestHandleEBSAttachmentHappyCase(t *testing.T) { mockTaskEngine.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(nil).AnyTimes() mockTaskEngine.EXPECT().GetDaemonManagers().Return(nil).AnyTimes() - mockCsiClient := mock_csiclient.NewMockCSIClient(mockCtrl) - mockCsiClient.EXPECT().NodeStageVolume(gomock.Any(), - taskresourcevolume.TestVolumeId, - gomock.Any(), - filepath.Join(hostMountDir, taskresourcevolume.TestSourceVolumeHostPath), - taskresourcevolume.TestFileSystem, - gomock.Any(), - gomock.Any(), - gomock.Any(), - gomock.Any(), - gomock.Any()).Return(nil).AnyTimes() - testAttachmentProperties := map[string]string{ apiebs.DeviceNameKey: taskresourcevolume.TestDeviceName, apiebs.VolumeIdKey: taskresourcevolume.TestVolumeId, @@ -107,18 +84,18 @@ func TestHandleEBSAttachmentHappyCase(t *testing.T) { expiresAt := time.Now().Add(time.Millisecond * testconst.WaitTimeoutMillis) ebsAttachment := &apiebs.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, TaskClusterARN: taskClusterARN, ContainerInstanceARN: containerInstanceARN, ExpiresAt: expiresAt, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, AttachmentARN: resourceAttachmentARN, }, AttachmentProperties: testAttachmentProperties, AttachmentType: apiebs.EBSTaskAttach, } - watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine, mockCsiClient) + watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine) var wg sync.WaitGroup wg.Add(1) mockDiscoveryClient.EXPECT().ConfirmEBSVolumeIsAttached(taskresourcevolume.TestDeviceName, taskresourcevolume.TestVolumeId). @@ -154,6 +131,7 @@ func TestHandleEBSAttachmentHappyCase(t *testing.T) { // TestHandleExpiredEBSAttachment tests acknowledging an expired resource attachment of type Elastic Block Stores // The resource attachment object should not be saved to the agent state since the expiration date is in the past. func TestHandleExpiredEBSAttachment(t *testing.T) { + t.Skip() mockCtrl := gomock.NewController(t) defer mockCtrl.Finish() @@ -161,7 +139,8 @@ func TestHandleExpiredEBSAttachment(t *testing.T) { taskEngineState := dockerstate.NewTaskEngineState() mockDiscoveryClient := mock_ebs_discovery.NewMockEBSDiscovery(mockCtrl) mockTaskEngine := mock_engine.NewMockTaskEngine(mockCtrl) - mockCsiClient := mock_csiclient.NewMockCSIClient(mockCtrl) + mockTaskEngine.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(nil).AnyTimes() + mockTaskEngine.EXPECT().GetDaemonManagers().Return(nil).AnyTimes() testAttachmentProperties := map[string]string{ apiebs.DeviceNameKey: taskresourcevolume.TestDeviceName, @@ -174,18 +153,18 @@ func TestHandleExpiredEBSAttachment(t *testing.T) { expiresAt := time.Now().Add(-1 * time.Millisecond) ebsAttachment := &apiebs.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, TaskClusterARN: taskClusterARN, ContainerInstanceARN: containerInstanceARN, ExpiresAt: expiresAt, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, AttachmentARN: resourceAttachmentARN, }, AttachmentProperties: testAttachmentProperties, AttachmentType: apiebs.EBSTaskAttach, } - watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine, mockCsiClient) + watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine) err := watcher.HandleEBSResourceAttachment(ebsAttachment) assert.Error(t, err) @@ -208,18 +187,6 @@ func TestHandleDuplicateEBSAttachment(t *testing.T) { mockTaskEngine.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(nil).AnyTimes() mockTaskEngine.EXPECT().GetDaemonManagers().Return(nil).AnyTimes() - mockCsiClient := mock_csiclient.NewMockCSIClient(mockCtrl) - mockCsiClient.EXPECT().NodeStageVolume(gomock.Any(), - taskresourcevolume.TestVolumeId, - gomock.Any(), - filepath.Join(hostMountDir, taskresourcevolume.TestSourceVolumeHostPath), - taskresourcevolume.TestFileSystem, - gomock.Any(), - gomock.Any(), - gomock.Any(), - gomock.Any(), - gomock.Any()).Return(nil).AnyTimes() - expiresAt := time.Now().Add(time.Millisecond * testconst.WaitTimeoutMillis) testAttachmentProperties1 := map[string]string{ @@ -232,12 +199,12 @@ func TestHandleDuplicateEBSAttachment(t *testing.T) { } ebsAttachment1 := &apiebs.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, TaskClusterARN: taskClusterARN, ContainerInstanceARN: containerInstanceARN, ExpiresAt: expiresAt, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, AttachmentARN: resourceAttachmentARN, }, AttachmentProperties: testAttachmentProperties1, @@ -254,19 +221,19 @@ func TestHandleDuplicateEBSAttachment(t *testing.T) { } ebsAttachment2 := &apiebs.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, TaskClusterARN: taskClusterARN, ContainerInstanceARN: containerInstanceARN, ExpiresAt: expiresAt, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, AttachmentARN: resourceAttachmentARN, }, AttachmentProperties: testAttachmentProperties2, AttachmentType: apiebs.EBSTaskAttach, } - watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine, mockCsiClient) + watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine) var wg sync.WaitGroup wg.Add(1) mockDiscoveryClient.EXPECT().ConfirmEBSVolumeIsAttached(taskresourcevolume.TestDeviceName, taskresourcevolume.TestVolumeId). @@ -309,7 +276,8 @@ func TestHandleInvalidTypeEBSAttachment(t *testing.T) { taskEngineState := dockerstate.NewTaskEngineState() mockDiscoveryClient := mock_ebs_discovery.NewMockEBSDiscovery(mockCtrl) mockTaskEngine := mock_engine.NewMockTaskEngine(mockCtrl) - mockCsiClient := mock_csiclient.NewMockCSIClient(mockCtrl) + mockTaskEngine.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(nil).AnyTimes() + mockTaskEngine.EXPECT().GetDaemonManagers().Return(nil).AnyTimes() testAttachmentProperties := map[string]string{ apiebs.DeviceNameKey: taskresourcevolume.TestDeviceName, @@ -322,18 +290,18 @@ func TestHandleInvalidTypeEBSAttachment(t *testing.T) { expiresAt := time.Now().Add(time.Millisecond * testconst.WaitTimeoutMillis) ebsAttachment := &apiebs.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, TaskClusterARN: taskClusterARN, ContainerInstanceARN: containerInstanceARN, ExpiresAt: expiresAt, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, AttachmentARN: resourceAttachmentARN, }, AttachmentProperties: testAttachmentProperties, AttachmentType: "InvalidResourceType", } - watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine, mockCsiClient) + watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine) watcher.HandleResourceAttachment(ebsAttachment) @@ -354,7 +322,8 @@ func TestHandleEBSAckTimeout(t *testing.T) { taskEngineState := dockerstate.NewTaskEngineState() mockDiscoveryClient := mock_ebs_discovery.NewMockEBSDiscovery(mockCtrl) mockTaskEngine := mock_engine.NewMockTaskEngine(mockCtrl) - mockCsiClient := mock_csiclient.NewMockCSIClient(mockCtrl) + mockTaskEngine.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(nil).AnyTimes() + mockTaskEngine.EXPECT().GetDaemonManagers().Return(nil).AnyTimes() testAttachmentProperties := map[string]string{ apiebs.DeviceNameKey: taskresourcevolume.TestDeviceName, @@ -367,17 +336,17 @@ func TestHandleEBSAckTimeout(t *testing.T) { expiresAt := time.Now().Add(time.Millisecond * testconst.WaitTimeoutMillis) ebsAttachment := &apiebs.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, TaskClusterARN: taskClusterARN, ContainerInstanceARN: containerInstanceARN, ExpiresAt: expiresAt, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, AttachmentARN: resourceAttachmentARN, }, AttachmentProperties: testAttachmentProperties, } - watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine, mockCsiClient) + watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine) watcher.HandleResourceAttachment(ebsAttachment) time.Sleep(time.Millisecond * testconst.WaitTimeoutMillis * 2) @@ -389,6 +358,7 @@ func TestHandleEBSAckTimeout(t *testing.T) { // TestHandleMismatchEBSAttachment tests handling an EBS attachment but found a different volume attached // onto the host during the scanning process. func TestHandleMismatchEBSAttachment(t *testing.T) { + t.Skip() mockCtrl := gomock.NewController(t) defer mockCtrl.Finish() @@ -396,9 +366,10 @@ func TestHandleMismatchEBSAttachment(t *testing.T) { taskEngineState := dockerstate.NewTaskEngineState() mockDiscoveryClient := mock_ebs_discovery.NewMockEBSDiscovery(mockCtrl) mockTaskEngine := mock_engine.NewMockTaskEngine(mockCtrl) - mockCsiClient := mock_csiclient.NewMockCSIClient(mockCtrl) + mockTaskEngine.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(nil).AnyTimes() + mockTaskEngine.EXPECT().GetDaemonManagers().Return(nil).AnyTimes() - watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine, mockCsiClient) + watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine) testAttachmentProperties := map[string]string{ apiebs.DeviceNameKey: taskresourcevolume.TestDeviceName, @@ -411,12 +382,12 @@ func TestHandleMismatchEBSAttachment(t *testing.T) { expiresAt := time.Now().Add(time.Millisecond * testconst.WaitTimeoutMillis) ebsAttachment := &apiebs.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, TaskClusterARN: taskClusterARN, ContainerInstanceARN: containerInstanceARN, ExpiresAt: expiresAt, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, AttachmentARN: resourceAttachmentARN, }, AttachmentProperties: testAttachmentProperties, @@ -444,376 +415,4 @@ func TestHandleMismatchEBSAttachment(t *testing.T) { assert.ErrorIs(t, ebsAttachment.GetError(), apiebs.ErrInvalidVolumeID) } -// TestHandleEBSAttachmentWithExistingCSIDriverTask tests handling an EBS attachment when there's already a known running CSI driver daemon -// task. There should be no calls to GetDaemonManagers nor CreateDaemonTask. -func TestHandleEBSAttachmentWithExistingCSIDriverTask(t *testing.T) { - mockCtrl := gomock.NewController(t) - defer mockCtrl.Finish() - - ctx := context.Background() - taskEngineState := dockerstate.NewTaskEngineState() - mockDiscoveryClient := mock_ebs_discovery.NewMockEBSDiscovery(mockCtrl) - mockTaskEngine := mock_engine.NewMockTaskEngine(mockCtrl) - mockTaskEngine.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(&task.Task{ - Arn: "arn:aws:ecs:us-east-1:012345678910:task/some-task-id", - KnownStatusUnsafe: status.TaskRunning, - }).AnyTimes() - mockTaskEngine.EXPECT().StateChangeEvents().Return(make(chan statechange.Event)).AnyTimes() - - mockCsiClient := mock_csiclient.NewMockCSIClient(mockCtrl) - mockCsiClient.EXPECT().NodeStageVolume(gomock.Any(), - taskresourcevolume.TestVolumeId, - gomock.Any(), - filepath.Join(hostMountDir, taskresourcevolume.TestSourceVolumeHostPath), - taskresourcevolume.TestFileSystem, - gomock.Any(), - gomock.Any(), - gomock.Any(), - gomock.Any(), - gomock.Any()).Return(nil).AnyTimes() - - testAttachmentProperties := map[string]string{ - apiebs.DeviceNameKey: taskresourcevolume.TestDeviceName, - apiebs.VolumeIdKey: taskresourcevolume.TestVolumeId, - apiebs.VolumeNameKey: taskresourcevolume.TestVolumeName, - apiebs.SourceVolumeHostPathKey: taskresourcevolume.TestSourceVolumeHostPath, - apiebs.FileSystemKey: taskresourcevolume.TestFileSystem, - apiebs.VolumeSizeGibKey: taskresourcevolume.TestVolumeSizeGib, - } - - expiresAt := time.Now().Add(time.Millisecond * testconst.WaitTimeoutMillis) - ebsAttachment := &apiebs.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ - TaskARN: taskARN, - TaskClusterARN: taskClusterARN, - ContainerInstanceARN: containerInstanceARN, - ExpiresAt: expiresAt, - Status: attachment.AttachmentNone, - AttachmentARN: resourceAttachmentARN, - }, - AttachmentProperties: testAttachmentProperties, - AttachmentType: apiebs.EBSTaskAttach, - } - watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine, mockCsiClient) - var wg sync.WaitGroup - wg.Add(1) - mockDiscoveryClient.EXPECT().ConfirmEBSVolumeIsAttached(taskresourcevolume.TestDeviceName, taskresourcevolume.TestVolumeId). - Do(func(deviceName, volumeID string) { - wg.Done() - }). - Return(taskresourcevolume.TestDeviceName, nil). - MinTimes(1) - - err := watcher.HandleEBSResourceAttachment(ebsAttachment) - assert.NoError(t, err) - - // Instead of starting the EBS watcher, we'll be mocking a tick of the EBS watcher's scan ticker. - // Otherwise, the watcher will continue to run forever and the test will panic. - wg.Add(1) - go func() { - defer wg.Done() - pendingEBS := watcher.agentState.GetAllPendingEBSAttachmentsWithKey() - if len(pendingEBS) > 0 { - foundVolumes := apiebs.ScanEBSVolumes(pendingEBS, watcher.discoveryClient) - watcher.StageAll(foundVolumes) - watcher.NotifyAttached(foundVolumes) - } - }() - - wg.Wait() - - assert.Len(t, taskEngineState.(*dockerstate.DockerTaskEngineState).GetAllEBSAttachments(), 1) - ebsAttachment, ok := taskEngineState.(*dockerstate.DockerTaskEngineState).GetEBSByVolumeId(taskresourcevolume.TestVolumeId) - require.True(t, ok) - assert.True(t, ebsAttachment.IsAttached()) -} - -// TestHandleEBSAttachmentWithStoppedCSIDriverTask tests handling an EBS attachment when there's an existing CSI driver daemon task -// saved to the task engine but is STOPPED. There should be a call to CreateDaemonTask which is suppose to create a new CSI driver task -// and will then be set and added to the task engine. -func TestHandleEBSAttachmentWithStoppedCSIDriverTask(t *testing.T) { - mockCtrl := gomock.NewController(t) - defer mockCtrl.Finish() - - ctx := context.Background() - taskEngineState := dockerstate.NewTaskEngineState() - mockDiscoveryClient := mock_ebs_discovery.NewMockEBSDiscovery(mockCtrl) - mockTaskEngine := mock_engine.NewMockTaskEngine(mockCtrl) - mockTaskEngine.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(&task.Task{ - Arn: "arn:aws:ecs:us-east-1:012345678910:task/some-task-id", - KnownStatusUnsafe: status.TaskStopped, - }).AnyTimes() - mockDaemonManager := mock_daemonmanager.NewMockDaemonManager(mockCtrl) - mockDaemonManager.EXPECT().CreateDaemonTask().Return(&task.Task{ - Arn: "arn:aws:ecs:us-east-1:012345678910:task/some-task-id", - KnownStatusUnsafe: status.TaskCreated, - }, nil).AnyTimes() - - daemonManagers := map[string]daemonmanager.DaemonManager{ - md.EbsCsiDriver: mockDaemonManager, - } - - mockTaskEngine.EXPECT().GetDaemonManagers().Return(daemonManagers).AnyTimes() - mockTaskEngine.EXPECT().StateChangeEvents().Return(make(chan statechange.Event)).AnyTimes() - mockTaskEngine.EXPECT().SetDaemonTask(md.EbsCsiDriver, gomock.Any()).Return().AnyTimes() - mockTaskEngine.EXPECT().AddTask(gomock.Any()).Return().AnyTimes() - - mockCsiClient := mock_csiclient.NewMockCSIClient(mockCtrl) - mockCsiClient.EXPECT().NodeStageVolume(gomock.Any(), - taskresourcevolume.TestVolumeId, - gomock.Any(), - filepath.Join(hostMountDir, taskresourcevolume.TestSourceVolumeHostPath), - taskresourcevolume.TestFileSystem, - gomock.Any(), - gomock.Any(), - gomock.Any(), - gomock.Any(), - gomock.Any()).Return(nil).AnyTimes() - - testAttachmentProperties := map[string]string{ - apiebs.DeviceNameKey: taskresourcevolume.TestDeviceName, - apiebs.VolumeIdKey: taskresourcevolume.TestVolumeId, - apiebs.VolumeNameKey: taskresourcevolume.TestVolumeName, - apiebs.SourceVolumeHostPathKey: taskresourcevolume.TestSourceVolumeHostPath, - apiebs.FileSystemKey: taskresourcevolume.TestFileSystem, - apiebs.VolumeSizeGibKey: taskresourcevolume.TestVolumeSizeGib, - } - - expiresAt := time.Now().Add(time.Millisecond * testconst.WaitTimeoutMillis) - ebsAttachment := &apiebs.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ - TaskARN: taskARN, - TaskClusterARN: taskClusterARN, - ContainerInstanceARN: containerInstanceARN, - ExpiresAt: expiresAt, - Status: attachment.AttachmentNone, - AttachmentARN: resourceAttachmentARN, - }, - AttachmentProperties: testAttachmentProperties, - AttachmentType: apiebs.EBSTaskAttach, - } - watcher := newTestEBSWatcher(ctx, taskEngineState, mockDiscoveryClient, mockTaskEngine, mockCsiClient) - var wg sync.WaitGroup - wg.Add(1) - mockDiscoveryClient.EXPECT().ConfirmEBSVolumeIsAttached(taskresourcevolume.TestDeviceName, taskresourcevolume.TestVolumeId). - Do(func(deviceName, volumeID string) { - wg.Done() - }). - Return(taskresourcevolume.TestDeviceName, nil). - MinTimes(1) - - err := watcher.HandleEBSResourceAttachment(ebsAttachment) - assert.NoError(t, err) - - // Instead of starting the EBS watcher, we'll be mocking a tick of the EBS watcher's scan ticker. - // Otherwise, the watcher will continue to run forever and the test will panic. - wg.Add(1) - go func() { - defer wg.Done() - pendingEBS := watcher.agentState.GetAllPendingEBSAttachmentsWithKey() - if len(pendingEBS) > 0 { - foundVolumes := apiebs.ScanEBSVolumes(pendingEBS, watcher.discoveryClient) - watcher.StageAll(foundVolumes) - watcher.NotifyAttached(foundVolumes) - } - }() - - wg.Wait() - - assert.Len(t, taskEngineState.(*dockerstate.DockerTaskEngineState).GetAllEBSAttachments(), 1) - ebsAttachment, ok := taskEngineState.(*dockerstate.DockerTaskEngineState).GetEBSByVolumeId(taskresourcevolume.TestVolumeId) - require.True(t, ok) - assert.True(t, ebsAttachment.IsAttached()) -} - // TODO add StageAll test - -func TestDaemonRunning(t *testing.T) { - tcs := []struct { - name string - setTaskEngineMocks func(*gomock.Controller, *mock_engine.MockTaskEngine) - expected bool - }{ - { - name: "task is running", - setTaskEngineMocks: func(ctrl *gomock.Controller, mte *mock_engine.MockTaskEngine) { - task := &task.Task{ - KnownStatusUnsafe: status.TaskRunning, - Arn: "arn:aws:ecs:us-west-2:1234:task/test/sometaskid", - } - mte.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(task) - }, - expected: true, - }, - { - name: "task is created", - setTaskEngineMocks: func(ctrl *gomock.Controller, mte *mock_engine.MockTaskEngine) { - task := &task.Task{ - KnownStatusUnsafe: status.TaskCreated, - Arn: "arn:aws:ecs:us-west-2:1234:task/test/sometaskid", - } - mte.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(task) - }, - expected: false, - }, - { - name: "task is not created, daemon manager not found", - setTaskEngineMocks: func(ctrl *gomock.Controller, mte *mock_engine.MockTaskEngine) { - mte.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(nil) - mte.EXPECT().GetDaemonManagers().Return(map[string]daemonmanager.DaemonManager{}) - }, - expected: false, - }, - { - name: "image not loaded yet", - setTaskEngineMocks: func(ctrl *gomock.Controller, mte *mock_engine.MockTaskEngine) { - mte.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(nil) - daemonManager := mock_daemonmanager.NewMockDaemonManager(ctrl) - daemonManager.EXPECT().IsLoaded(gomock.Any()).Return(false, nil) - daemonManager.EXPECT().GetManagedDaemon().Return(md.NewManagedDaemon("name", "tag")) - dms := map[string]daemonmanager.DaemonManager{md.EbsCsiDriver: daemonManager} - mte.EXPECT().GetDaemonManagers().Return(dms) - }, - expected: false, - }, - { - name: "daemon task create failed", - setTaskEngineMocks: func(ctrl *gomock.Controller, mte *mock_engine.MockTaskEngine) { - mte.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(nil) - daemonManager := mock_daemonmanager.NewMockDaemonManager(ctrl) - daemonManager.EXPECT().IsLoaded(gomock.Any()).Return(true, nil) - daemonManager.EXPECT().GetManagedDaemon().Return(md.NewManagedDaemon("name", "tag")) - dms := map[string]daemonmanager.DaemonManager{md.EbsCsiDriver: daemonManager} - mte.EXPECT().GetDaemonManagers().Return(dms) - daemonManager.EXPECT().CreateDaemonTask().Return(nil, errors.New("error")) - }, - expected: false, - }, - { - name: "new daemon task created successfully", - setTaskEngineMocks: func(ctrl *gomock.Controller, mte *mock_engine.MockTaskEngine) { - mte.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(nil) - daemonManager := mock_daemonmanager.NewMockDaemonManager(ctrl) - daemonManager.EXPECT().IsLoaded(gomock.Any()).Return(true, nil) - daemonManager.EXPECT().GetManagedDaemon().Return(md.NewManagedDaemon("name", "tag")) - dms := map[string]daemonmanager.DaemonManager{md.EbsCsiDriver: daemonManager} - mte.EXPECT().GetDaemonManagers().Return(dms) - csiTask := &task.Task{Arn: "arn:aws:ecs:us-west-2:1234:task/test/sometaskid"} - daemonManager.EXPECT().CreateDaemonTask().Return(csiTask, nil) - mte.EXPECT().SetDaemonTask(md.EbsCsiDriver, csiTask).Return() - mte.EXPECT().AddTask(csiTask).Return() - }, - expected: false, - }, - } - - for _, tc := range tcs { - t.Run(tc.name, func(t *testing.T) { - ctrl := gomock.NewController(t) - defer ctrl.Finish() - - taskEngine := mock_engine.NewMockTaskEngine(ctrl) - tc.setTaskEngineMocks(ctrl, taskEngine) - - watcher := &EBSWatcher{taskEngine: taskEngine} - assert.Equal(t, tc.expected, watcher.daemonRunning()) - }) - } -} - -func TestTick(t *testing.T) { - type testCase struct { - name string - pendingAttachments map[string]*apiebs.ResourceAttachment - setTaskEngineStateExpectations func(*mock_dockerstate.MockTaskEngineState) - setTaskEngineExpectations func(*mock_engine.MockTaskEngine) - setDiscoveryClientExpectations func(*mock_ebs_discovery.MockEBSDiscovery) - assertEBSAttachmentsState func(t *testing.T, atts map[string]*apiebs.ResourceAttachment) - } - - attachmentAlreadySentCase := func() testCase { - attachment := &apiebs.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ - Status: attachment.AttachmentAttached, - AttachStatusSent: true, - }, - AttachmentProperties: map[string]string{apiebs.DeviceNameKey: "device-name"}, - } - return testCase{ - name: "daemon running and volume already attached and sent", - pendingAttachments: map[string]*apiebs.ResourceAttachment{"ebs-volume:id": attachment}, - setTaskEngineStateExpectations: func(mtes *mock_dockerstate.MockTaskEngineState) { - mtes.EXPECT().GetEBSByVolumeId("id").Return(attachment, true).Times(3) - }, - setTaskEngineExpectations: func(mte *mock_engine.MockTaskEngine) { - task := &task.Task{KnownStatusUnsafe: status.TaskRunning} - mte.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(task) - }, - setDiscoveryClientExpectations: func(me *mock_ebs_discovery.MockEBSDiscovery) { - me.EXPECT().ConfirmEBSVolumeIsAttached("device-name", "id").Return("actual-name", nil) - }, - assertEBSAttachmentsState: func(t *testing.T, atts map[string]*apiebs.ResourceAttachment) { - attachment, ok := atts["ebs-volume:id"] - require.True(t, ok, "attachment not found") - assert.NoError(t, attachment.GetError()) - assert.True(t, attachment.IsAttached()) - assert.True(t, attachment.IsSent()) - }, - } - } - - tcs := []testCase{ - { - name: "no-op when there are no pending attachments", - pendingAttachments: map[string]*apiebs.ResourceAttachment{}, - }, - { - name: "no-op when daemon has been initialized but pending to run", - pendingAttachments: map[string]*apiebs.ResourceAttachment{"id": &apiebs.ResourceAttachment{}}, - setTaskEngineExpectations: func(mte *mock_engine.MockTaskEngine) { - task := &task.Task{KnownStatusUnsafe: status.TaskCreated} - mte.EXPECT().GetDaemonTask(md.EbsCsiDriver).Return(task) - }, - assertEBSAttachmentsState: func(t *testing.T, atts map[string]*apiebs.ResourceAttachment) { - attachment, ok := atts["id"] - require.True(t, ok, "attachment not found") - assert.NoError(t, attachment.GetError()) - assert.False(t, attachment.IsAttached()) - assert.False(t, attachment.IsSent()) - }, - }, - attachmentAlreadySentCase(), - } - - for _, tc := range tcs { - t.Run(tc.name, func(t *testing.T) { - ctrl := gomock.NewController(t) - defer ctrl.Finish() - - taskEngineState := mock_dockerstate.NewMockTaskEngineState(ctrl) - taskEngine := mock_engine.NewMockTaskEngine(ctrl) - dockerClient := mock_dockerapi.NewMockDockerClient(ctrl) - discoveryClient := mock_ebs_discovery.NewMockEBSDiscovery(ctrl) - - attachments := tc.pendingAttachments - taskEngineState.EXPECT().GetAllPendingEBSAttachmentsWithKey().Return(attachments) - if tc.setTaskEngineStateExpectations != nil { - tc.setTaskEngineStateExpectations(taskEngineState) - } - if tc.setTaskEngineExpectations != nil { - tc.setTaskEngineExpectations(taskEngine) - } - if tc.setDiscoveryClientExpectations != nil { - tc.setDiscoveryClientExpectations(discoveryClient) - } - - watcher := NewWatcher(context.Background(), taskEngineState, taskEngine, dockerClient) - watcher.discoveryClient = discoveryClient - watcher.tick() - - if tc.assertEBSAttachmentsState != nil { - tc.assertEBSAttachmentsState(t, attachments) - } - }) - } -} diff --git a/agent/ec2/ec2_client.go b/agent/ec2/ec2_client.go index e01cac87fdb..e883ad7dba7 100644 --- a/agent/ec2/ec2_client.go +++ b/agent/ec2/ec2_client.go @@ -16,7 +16,7 @@ package ec2 import ( "strings" - "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds" + "github.com/aws/amazon-ecs-agent/agent/credentials/instancecreds" "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" diff --git a/agent/ec2/ec2_metadata_client.go b/agent/ec2/ec2_metadata_client.go index 8d433a85f38..90afa0fb2f5 100644 --- a/agent/ec2/ec2_metadata_client.go +++ b/agent/ec2/ec2_metadata_client.go @@ -20,7 +20,7 @@ import ( "strings" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds" + "github.com/aws/amazon-ecs-agent/agent/credentials/instancecreds" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/ec2metadata" "github.com/aws/aws-sdk-go/aws/session" diff --git a/agent/ecr/factory.go b/agent/ecr/factory.go index ffb78c90419..48b3d66936d 100644 --- a/agent/ecr/factory.go +++ b/agent/ecr/factory.go @@ -20,12 +20,10 @@ import ( "time" apicontainer "github.com/aws/amazon-ecs-agent/agent/api/container" - "github.com/aws/amazon-ecs-agent/agent/config" + "github.com/aws/amazon-ecs-agent/agent/credentials/instancecreds" ecrapi "github.com/aws/amazon-ecs-agent/agent/ecr/model/ecr" - agentversion "github.com/aws/amazon-ecs-agent/agent/version" + "github.com/aws/amazon-ecs-agent/agent/httpclient" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" - "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds" - "github.com/aws/amazon-ecs-agent/ecs-agent/httpclient" "github.com/aws/aws-sdk-go/aws" awscreds "github.com/aws/aws-sdk-go/aws/credentials" "github.com/aws/aws-sdk-go/aws/session" @@ -47,7 +45,7 @@ const ( // NewECRFactory returns an ECRFactory capable of producing ECRSDK clients func NewECRFactory(acceptInsecureCert bool) ECRFactory { return &ecrFactory{ - httpClient: httpclient.New(roundtripTimeout, acceptInsecureCert, agentversion.String(), config.OSType), + httpClient: httpclient.New(roundtripTimeout, acceptInsecureCert), } } diff --git a/agent/engine/daemonmanager/daemon_manager.go b/agent/engine/daemonmanager/daemon_manager.go index ad3ffaf4961..a1c98b48a27 100644 --- a/agent/engine/daemonmanager/daemon_manager.go +++ b/agent/engine/daemonmanager/daemon_manager.go @@ -25,9 +25,6 @@ import ( type DaemonManager interface { GetManagedDaemon() *md.ManagedDaemon CreateDaemonTask() (*apitask.Task, error) - // Returns true if the Daemon image is found on this host, false otherwise. - // Error is returned when something goes wrong when looking for the image. - ImageExists() (bool, error) LoadImage(ctx context.Context, dockerClient dockerapi.DockerClient) (*types.ImageInspect, error) IsLoaded(dockerClient dockerapi.DockerClient) (bool, error) } diff --git a/agent/engine/daemonmanager/daemon_manager_linux.go b/agent/engine/daemonmanager/daemon_manager_linux.go index 86df0277ba3..ca70c98c9b5 100644 --- a/agent/engine/daemonmanager/daemon_manager_linux.go +++ b/agent/engine/daemonmanager/daemon_manager_linux.go @@ -49,7 +49,7 @@ const ( ecsAgentLogFileENV = "ECS_LOGFILE" defaultECSAgentLogPathContainer = "/log" socketPathHostRoot = "/var/run/ecs" - logPathHostRoot = "/log/daemons" + logPathHostRoot = "/log/ecs/daemons" ) var mkdirAllAndChown = utils.MkdirAllAndChown @@ -171,11 +171,6 @@ func (dm *daemonManager) initDaemonDirectoryMounts(imageName string) error { return nil } -// Returns true if the Daemon image is found on this host, false otherwise. -func (dm *daemonManager) ImageExists() (bool, error) { - return utils.FileExists(dm.managedDaemon.GetImageTarPath()) -} - // LoadImage loads the daemon's latest image func (dm *daemonManager) LoadImage(ctx context.Context, dockerClient dockerapi.DockerClient) (*types.ImageInspect, error) { var loadErr error diff --git a/agent/engine/daemonmanager/daemon_manager_windows.go b/agent/engine/daemonmanager/daemon_manager_windows.go index 0f027be61d7..4524b8206c5 100644 --- a/agent/engine/daemonmanager/daemon_manager_windows.go +++ b/agent/engine/daemonmanager/daemon_manager_windows.go @@ -37,7 +37,3 @@ func (dm *daemonManager) LoadImage(ctx context.Context, dockerClient dockerapi.D func (dm *daemonManager) IsLoaded(dockerClient dockerapi.DockerClient) (bool, error) { return false, errors.New("daemonmanager.IsLoaded not implemented for Windows") } - -func (dm *daemonManager) ImageExists() (bool, error) { - return false, errors.New("daemonmanager.ImageExists not implemented for Windows") -} diff --git a/agent/engine/daemonmanager/mock/manager.go b/agent/engine/daemonmanager/mock/manager.go index 4dc7efc59cc..64660aaca75 100644 --- a/agent/engine/daemonmanager/mock/manager.go +++ b/agent/engine/daemonmanager/mock/manager.go @@ -81,21 +81,6 @@ func (mr *MockDaemonManagerMockRecorder) GetManagedDaemon() *gomock.Call { return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "GetManagedDaemon", reflect.TypeOf((*MockDaemonManager)(nil).GetManagedDaemon)) } -// ImageExists mocks base method. -func (m *MockDaemonManager) ImageExists() (bool, error) { - m.ctrl.T.Helper() - ret := m.ctrl.Call(m, "ImageExists") - ret0, _ := ret[0].(bool) - ret1, _ := ret[1].(error) - return ret0, ret1 -} - -// ImageExists indicates an expected call of ImageExists. -func (mr *MockDaemonManagerMockRecorder) ImageExists() *gomock.Call { - mr.mock.ctrl.T.Helper() - return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "ImageExists", reflect.TypeOf((*MockDaemonManager)(nil).ImageExists)) -} - // IsLoaded mocks base method. func (m *MockDaemonManager) IsLoaded(arg0 dockerapi.DockerClient) (bool, error) { m.ctrl.T.Helper() diff --git a/agent/engine/data.go b/agent/engine/data.go index c994ea219c4..eae131792e6 100644 --- a/agent/engine/data.go +++ b/agent/engine/data.go @@ -40,10 +40,6 @@ func (engine *DockerTaskEngine) LoadState() error { return err } - if err := engine.loadResourceAttachments(); err != nil { - return err - } - return engine.loadENIAttachments() } @@ -56,12 +52,6 @@ func (engine *DockerTaskEngine) loadTasks() error { for _, task := range tasks { engine.state.AddTask(task) - // TODO: Will need to clean up all of the STOPPED managed daemon tasks - md, ok := task.IsManagedDaemonTask() - if ok { - engine.SetDaemonTask(md, task) - } - // Populate ip <-> task mapping if task has a local ip. This mapping is needed for serving v2 task metadata. if ip := task.GetLocalIPAddress(); ip != "" { engine.state.AddTaskIPAddress(ip, task.Arn) @@ -129,17 +119,6 @@ func (engine *DockerTaskEngine) loadImageStates() error { return nil } -func (engine *DockerTaskEngine) loadResourceAttachments() error { - resAttachments, err := engine.dataClient.GetResourceAttachments() - if err != nil { - return err - } - for _, resAttachment := range resAttachments { - engine.state.AddEBSAttachment(resAttachment) - } - return nil -} - func (engine *DockerTaskEngine) loadENIAttachments() error { eniAttachments, err := engine.dataClient.GetENIAttachments() if err != nil { @@ -257,7 +236,7 @@ func (engine *DockerTaskEngine) removeENIAttachmentData(mac string) { seelog.Warnf("Unable to retrieve ENI Attachment for mac address %s: ", mac) return } - attachmentId, err := utils.GetAttachmentId(attachmentToRemove.AttachmentARN) + attachmentId, err := utils.GetENIAttachmentId(attachmentToRemove.AttachmentARN) if err != nil { seelog.Errorf("Failed to get attachment id for %s: %v", attachmentToRemove.AttachmentARN, err) } else { diff --git a/agent/engine/data_test.go b/agent/engine/data_test.go index 064cd405f71..c58329eeb07 100644 --- a/agent/engine/data_test.go +++ b/agent/engine/data_test.go @@ -26,9 +26,8 @@ import ( "github.com/aws/amazon-ecs-agent/agent/data" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" "github.com/aws/amazon-ecs-agent/agent/engine/image" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" - apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/stretchr/testify/assert" "github.com/stretchr/testify/require" ) @@ -52,13 +51,6 @@ var ( TaskARNUnsafe: testTaskARN, KnownStatusUnsafe: apicontainerstatus.ContainerPulled, } - testManagedDaemonContainer = &apicontainer.Container{ - Name: "ecs-managed-" + testContainerName, - Image: "ebs-csi-driver", - TaskARNUnsafe: testTaskARN, - Type: apicontainer.ContainerManagedDaemon, - KnownStatusUnsafe: apicontainerstatus.ContainerRunning, - } testDockerContainer = &apicontainer.DockerContainer{ DockerID: testDockerID, Container: testContainer, @@ -67,10 +59,6 @@ var ( DockerID: testDockerID, Container: testPulledContainer, } - testManagedDaemonDockerContainer = &apicontainer.DockerContainer{ - DockerID: testDockerID, - Container: testManagedDaemonContainer, - } testTask = &apitask.Task{ Arn: testTaskARN, Containers: []*apicontainer.Container{testContainer}, @@ -81,20 +69,6 @@ var ( Containers: []*apicontainer.Container{testContainer, testPulledContainer}, LocalIPAddressUnsafe: testTaskIP, } - testTaskWithManagedDaemonContainer = &apitask.Task{ - Arn: testTaskARN, - Containers: []*apicontainer.Container{testManagedDaemonContainer}, - LocalIPAddressUnsafe: testTaskIP, - IsInternal: true, - KnownStatusUnsafe: apitaskstatus.TaskRunning, - } - testStoppedTaskWithManagedDaemonContainer = &apitask.Task{ - Arn: testTaskARN, - Containers: []*apicontainer.Container{testManagedDaemonContainer}, - LocalIPAddressUnsafe: testTaskIP, - IsInternal: true, - KnownStatusUnsafe: apitaskstatus.TaskStopped, - } testImageState = &image.ImageState{ Image: testImage, PullSucceeded: false, @@ -104,7 +78,7 @@ var ( } testENIAttachment = &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: testAttachmentArn, AttachStatusSent: false, }, @@ -161,74 +135,6 @@ func TestLoadState(t *testing.T) { assert.Equal(t, testTaskARN, arn) } -func TestLoadStateWithManagedDaemon(t *testing.T) { - dataClient := newTestDataClient(t) - - engine := &DockerTaskEngine{ - state: dockerstate.NewTaskEngineState(), - dataClient: dataClient, - daemonTasks: make(map[string]*apitask.Task), - } - - require.NoError(t, dataClient.SaveTask(testTaskWithManagedDaemonContainer)) - require.NoError(t, dataClient.SaveDockerContainer(testManagedDaemonDockerContainer)) - require.NoError(t, dataClient.SaveENIAttachment(testENIAttachment)) - require.NoError(t, dataClient.SaveImageState(testImageState)) - - require.NoError(t, engine.LoadState()) - task, ok := engine.state.TaskByArn(testTaskARN) - assert.True(t, ok) - assert.Equal(t, apicontainerstatus.ContainerRunning, task.Containers[0].GetKnownStatus()) - _, ok = engine.state.ContainerByID(testDockerID) - assert.True(t, ok) - assert.Len(t, engine.state.AllImageStates(), 1) - assert.Len(t, engine.state.AllENIAttachments(), 1) - - // Check ip <-> task arn mapping is loaded in state. - ip, ok := engine.state.GetIPAddressByTaskARN(testTaskARN) - require.True(t, ok) - assert.Equal(t, testTaskIP, ip) - arn, ok := engine.state.GetTaskByIPAddress(testTaskIP) - require.True(t, ok) - assert.Equal(t, testTaskARN, arn) - - assert.NotNil(t, engine.GetDaemonTask("ebs-csi-driver")) -} - -func TestLoadStateWithStoppedManagedDaemon(t *testing.T) { - dataClient := newTestDataClient(t) - - engine := &DockerTaskEngine{ - state: dockerstate.NewTaskEngineState(), - dataClient: dataClient, - daemonTasks: make(map[string]*apitask.Task), - } - - require.NoError(t, dataClient.SaveTask(testStoppedTaskWithManagedDaemonContainer)) - require.NoError(t, dataClient.SaveDockerContainer(testManagedDaemonDockerContainer)) - require.NoError(t, dataClient.SaveENIAttachment(testENIAttachment)) - require.NoError(t, dataClient.SaveImageState(testImageState)) - - require.NoError(t, engine.LoadState()) - task, ok := engine.state.TaskByArn(testTaskARN) - assert.True(t, ok) - assert.Equal(t, apicontainerstatus.ContainerRunning, task.Containers[0].GetKnownStatus()) - _, ok = engine.state.ContainerByID(testDockerID) - assert.True(t, ok) - assert.Len(t, engine.state.AllImageStates(), 1) - assert.Len(t, engine.state.AllENIAttachments(), 1) - - // Check ip <-> task arn mapping is loaded in state. - ip, ok := engine.state.GetIPAddressByTaskARN(testTaskARN) - require.True(t, ok) - assert.Equal(t, testTaskIP, ip) - arn, ok := engine.state.GetTaskByIPAddress(testTaskIP) - require.True(t, ok) - assert.Equal(t, testTaskARN, arn) - - assert.Nil(t, engine.GetDaemonTask("ebs-csi-driver")) -} - func TestSaveState(t *testing.T) { dataClient := newTestDataClient(t) diff --git a/agent/engine/docker_image_manager.go b/agent/engine/docker_image_manager.go index a6841ce797b..31b981f791d 100644 --- a/agent/engine/docker_image_manager.go +++ b/agent/engine/docker_image_manager.go @@ -113,8 +113,6 @@ func buildImageCleanupExclusionList(cfg *config.Config) []string { } func (imageManager *dockerImageManager) AddImageToCleanUpExclusionList(image string) { - imageManager.updateLock.Lock() - defer imageManager.updateLock.Unlock() imageManager.imageCleanupExclusionList = append(imageManager.imageCleanupExclusionList, image) logger.Info("Image excluded from cleanup", logger.Fields{ field.Image: image, diff --git a/agent/engine/docker_task_engine_linux_test.go b/agent/engine/docker_task_engine_linux_test.go index 627b53770db..378e70c3ffb 100644 --- a/agent/engine/docker_task_engine_linux_test.go +++ b/agent/engine/docker_task_engine_linux_test.go @@ -51,8 +51,9 @@ import ( resourcestatus "github.com/aws/amazon-ecs-agent/agent/taskresource/status" mock_ioutilwrapper "github.com/aws/amazon-ecs-agent/agent/utils/ioutilwrapper/mocks" mock_appnet "github.com/aws/amazon-ecs-agent/ecs-agent/api/appnet/mocks" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/appmesh" @@ -224,10 +225,10 @@ func TestDeleteTask(t *testing.T) { } attachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: "TaskARN", AttachmentARN: testAttachmentArn, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, AttachStatusSent: true, }, MACAddress: "MACAddress", diff --git a/agent/engine/docker_task_engine_test.go b/agent/engine/docker_task_engine_test.go index dc4f3793199..7fc3e486929 100644 --- a/agent/engine/docker_task_engine_test.go +++ b/agent/engine/docker_task_engine_test.go @@ -57,9 +57,10 @@ import ( mock_taskresource "github.com/aws/amazon-ecs-agent/agent/taskresource/mocks" "github.com/aws/amazon-ecs-agent/agent/taskresource/ssmsecret" taskresourcevolume "github.com/aws/amazon-ecs-agent/agent/taskresource/volume" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" apierrors "github.com/aws/amazon-ecs-agent/ecs-agent/api/errors" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" mock_credentials "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/mocks" @@ -2424,10 +2425,10 @@ func TestSynchronizeENIAttachment(t *testing.T) { testTask := testdata.LoadTask("sleep5") expiresAt := time.Now().Unix() + 1 attachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: "TaskARN", AttachmentARN: "AttachmentARN", - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, MACAddress: "MACAddress", @@ -2460,10 +2461,10 @@ func TestSynchronizeENIAttachmentRemoveData(t *testing.T) { dockerTaskEngine := taskEngine.(*DockerTaskEngine) attachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: "TaskARN", AttachmentARN: testAttachmentArn, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, AttachStatusSent: false, }, MACAddress: "MACAddress", diff --git a/agent/engine/dockerstate/docker_task_engine_state.go b/agent/engine/dockerstate/docker_task_engine_state.go index 40fadd2615c..c64f090707b 100644 --- a/agent/engine/dockerstate/docker_task_engine_state.go +++ b/agent/engine/dockerstate/docker_task_engine_state.go @@ -21,7 +21,7 @@ import ( apicontainer "github.com/aws/amazon-ecs-agent/agent/api/container" apitask "github.com/aws/amazon-ecs-agent/agent/api/task" "github.com/aws/amazon-ecs-agent/agent/engine/image" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" "github.com/cihub/seelog" ) @@ -300,7 +300,7 @@ func (state *DockerTaskEngineState) GetAllPendingEBSAttachments() []*apiresource func (state *DockerTaskEngineState) allPendingEBSAttachmentsUnsafe() []*apiresource.ResourceAttachment { var pendingEBSAttachments []*apiresource.ResourceAttachment for _, v := range state.ebsAttachments { - if !v.IsAttached() || !v.IsSent() { + if !v.IsAttached() && !v.IsSent() { pendingEBSAttachments = append(pendingEBSAttachments, v) } } @@ -319,7 +319,7 @@ func (state *DockerTaskEngineState) GetAllPendingEBSAttachmentsWithKey() map[str func (state *DockerTaskEngineState) allPendingEBSAttachmentsWithKeyUnsafe() map[string]*apiresource.ResourceAttachment { pendingEBSAttachments := make(map[string]*apiresource.ResourceAttachment) for k, v := range state.ebsAttachments { - if !v.IsAttached() || !v.IsSent() { + if !v.IsAttached() && !v.IsSent() { pendingEBSAttachments[k] = v } } diff --git a/agent/engine/dockerstate/dockerstate_test.go b/agent/engine/dockerstate/dockerstate_test.go index 2e17cdc2d31..c70c67312b3 100644 --- a/agent/engine/dockerstate/dockerstate_test.go +++ b/agent/engine/dockerstate/dockerstate_test.go @@ -22,8 +22,9 @@ import ( apicontainer "github.com/aws/amazon-ecs-agent/agent/api/container" apitask "github.com/aws/amazon-ecs-agent/agent/api/task" "github.com/aws/amazon-ecs-agent/agent/engine/image" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" "github.com/stretchr/testify/assert" ) @@ -103,7 +104,7 @@ func TestAddRemoveENIAttachment(t *testing.T) { state := NewTaskEngineState() attachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: "taskarn", AttachmentARN: "eni1", }, @@ -132,7 +133,7 @@ func TestAddRemoveEBSAttachment(t *testing.T) { state := NewTaskEngineState() attachment := &apiresource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: "taskarn", AttachmentARN: "ebs1", }, @@ -161,11 +162,11 @@ func TestAddPendingEBSAttachment(t *testing.T) { state := NewTaskEngineState() pendingAttachment := &apiresource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: "taskarn1", AttachmentARN: "ebs1", AttachStatusSent: false, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, }, AttachmentProperties: testAttachmentProperties, AttachmentType: apiresource.EBSTaskAttach, @@ -181,11 +182,11 @@ func TestAddPendingEBSAttachment(t *testing.T) { } foundAttachment := &apiresource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: "taskarn2", AttachmentARN: "ebs2", AttachStatusSent: true, - Status: attachment.AttachmentAttached, + Status: status.AttachmentAttached, }, AttachmentProperties: testSentAttachmentProperties, AttachmentType: apiresource.EBSTaskAttach, @@ -202,52 +203,6 @@ func TestAddPendingEBSAttachment(t *testing.T) { } -func TestAddPendingEBSAttachmentExclusion(t *testing.T) { - state := NewTaskEngineState() - - testSentAttachmentProperties := map[string]string{ - apiresource.VolumeNameKey: "myCoolVolume", - apiresource.SourceVolumeHostPathKey: "/testpath2", - apiresource.VolumeSizeGibKey: "7", - apiresource.DeviceNameKey: "/dev/nvme1n0", - apiresource.VolumeIdKey: "vol-456", - apiresource.FileSystemKey: "testXFS", - } - - // not attached but sent should be included (||) - sentAttachment := &apiresource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ - TaskARN: "taskarn1", - AttachmentARN: "ebs1", - AttachStatusSent: true, - Status: attachment.AttachmentNone, - }, - AttachmentProperties: testAttachmentProperties, - AttachmentType: apiresource.EBSTaskAttach, - } - - // attached and sent attachment should be excluded (&&) - foundAttachment := &apiresource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ - TaskARN: "taskarn2", - AttachmentARN: "ebs2", - AttachStatusSent: true, - Status: attachment.AttachmentAttached, - }, - AttachmentProperties: testSentAttachmentProperties, - AttachmentType: apiresource.EBSTaskAttach, - } - - state.AddEBSAttachment(foundAttachment) - state.AddEBSAttachment(sentAttachment) - assert.Len(t, state.(*DockerTaskEngineState).GetAllPendingEBSAttachments(), 1) - assert.Len(t, state.(*DockerTaskEngineState).GetAllPendingEBSAttachmentsWithKey(), 1) - assert.Len(t, state.(*DockerTaskEngineState).GetAllEBSAttachments(), 2) - - _, ok := state.(*DockerTaskEngineState).GetAllPendingEBSAttachmentsWithKey()["vol-123"] - assert.True(t, ok) -} - func TestTwophaseAddContainer(t *testing.T) { state := NewTaskEngineState() testTask := &apitask.Task{Arn: "test", Containers: []*apicontainer.Container{{ diff --git a/agent/engine/dockerstate/mocks/dockerstate_mocks.go b/agent/engine/dockerstate/mocks/dockerstate_mocks.go index be114a322bd..73a577dc1a8 100644 --- a/agent/engine/dockerstate/mocks/dockerstate_mocks.go +++ b/agent/engine/dockerstate/mocks/dockerstate_mocks.go @@ -24,7 +24,7 @@ import ( container "github.com/aws/amazon-ecs-agent/agent/api/container" task "github.com/aws/amazon-ecs-agent/agent/api/task" image "github.com/aws/amazon-ecs-agent/agent/engine/image" - resource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + resource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" networkinterface "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" gomock "github.com/golang/mock/gomock" ) diff --git a/agent/engine/host_resource_manager_test.go b/agent/engine/host_resource_manager_test.go index e2d331496f1..447eb6d8af3 100644 --- a/agent/engine/host_resource_manager_test.go +++ b/agent/engine/host_resource_manager_test.go @@ -21,7 +21,6 @@ import ( "github.com/aws/amazon-ecs-agent/agent/utils" "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" - commonutils "github.com/aws/amazon-ecs-agent/ecs-agent/utils" "github.com/aws/aws-sdk-go/aws" "github.com/stretchr/testify/assert" ) @@ -232,7 +231,7 @@ func TestConsumable(t *testing.T) { } for _, tc := range testCases { - resources := getTestTaskResourceMap(tc.cpu, tc.mem, commonutils.Uint16SliceToStringSlice(tc.ports), commonutils.Uint16SliceToStringSlice(tc.portsUdp), aws.StringSlice(tc.gpus)) + resources := getTestTaskResourceMap(tc.cpu, tc.mem, utils.Uint16SliceToStringSlice(tc.ports), utils.Uint16SliceToStringSlice(tc.portsUdp), aws.StringSlice(tc.gpus)) canBeConsumed, err := h.consumable(resources) assert.Equal(t, canBeConsumed, tc.canBeConsumed, "Error in checking if resources can be successfully consumed") assert.Equal(t, err, nil, "Error in checking if resources can be successfully consumed, error returned from consumable") @@ -245,7 +244,7 @@ func TestResourceHealthTrue(t *testing.T) { gpuIDs := []string{"gpu1", "gpu2", "gpu3", "gpu4"} h := getTestHostResourceManager(int64(2048), int64(2048), []*string{&hostResourcePort1}, []*string{&hostResourcePort2}, aws.StringSlice(gpuIDs)) - resources := getTestTaskResourceMap(1024, 1024, commonutils.Uint16SliceToStringSlice([]uint16{22}), commonutils.Uint16SliceToStringSlice([]uint16{1000}), aws.StringSlice([]string{"gpu1", "gpu2"})) + resources := getTestTaskResourceMap(1024, 1024, utils.Uint16SliceToStringSlice([]uint16{22}), utils.Uint16SliceToStringSlice([]uint16{1000}), aws.StringSlice([]string{"gpu1", "gpu2"})) err := h.checkResourcesHealth(resources) assert.NoError(t, err, "Error in checking healthy resource map status") } @@ -257,7 +256,7 @@ func TestResourceHealthGPUFalse(t *testing.T) { gpuIDs := []string{"gpu1", "gpu2", "gpu3", "gpu4"} h := getTestHostResourceManager(int64(2048), int64(2048), []*string{&hostResourcePort1}, []*string{&hostResourcePort2}, aws.StringSlice(gpuIDs)) - resources := getTestTaskResourceMap(1024, 1024, commonutils.Uint16SliceToStringSlice([]uint16{22}), commonutils.Uint16SliceToStringSlice([]uint16{1000}), aws.StringSlice([]string{"gpu1", "gpu5"})) + resources := getTestTaskResourceMap(1024, 1024, utils.Uint16SliceToStringSlice([]uint16{22}), utils.Uint16SliceToStringSlice([]uint16{1000}), aws.StringSlice([]string{"gpu1", "gpu5"})) err := h.checkResourcesHealth(resources) assert.Error(t, err, "Error in checking unhealthy resource map status") } diff --git a/agent/eni/watcher/watcher.go b/agent/eni/watcher/watcher.go index 2f3d4136a15..7101236a364 100644 --- a/agent/eni/watcher/watcher.go +++ b/agent/eni/watcher/watcher.go @@ -18,6 +18,8 @@ import ( "fmt" "time" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" + "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" "github.com/aws/amazon-ecs-agent/agent/statechange" @@ -25,7 +27,6 @@ import ( "github.com/pkg/errors" "github.com/aws/amazon-ecs-agent/agent/api" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" apierrors "github.com/aws/amazon-ecs-agent/ecs-agent/api/errors" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/retry" @@ -152,7 +153,7 @@ func (eniWatcher *ENIWatcher) sendENIStateChange(mac string) error { // emitTaskENIChangeEvent sends a state change event for a task ENI attachment to the event channel with eni status as // attached func (eniWatcher *ENIWatcher) emitTaskENIAttachedEvent(eni *ni.ENIAttachment) { - eni.Status = attachment.AttachmentAttached + eni.Status = status.AttachmentAttached log.Infof("Emitting task ENI attached event for: %s", eni.String()) eniWatcher.eniChangeEvent <- api.TaskStateChange{ TaskARN: eni.TaskARN, @@ -163,7 +164,7 @@ func (eniWatcher *ENIWatcher) emitTaskENIAttachedEvent(eni *ni.ENIAttachment) { // emitInstanceENIChangeEvent sends a state change event for an instance ENI attachment to the event channel with eni // status as attached func (eniWatcher *ENIWatcher) emitInstanceENIAttachedEvent(eni *ni.ENIAttachment) { - eni.Status = attachment.AttachmentAttached + eni.Status = status.AttachmentAttached log.Infof("Emitting instance ENI attached event for: %s", eni.String()) eniWatcher.eniChangeEvent <- api.NewAttachmentStateChangeEvent(eni) } diff --git a/agent/eni/watcher/watcher_linux_test.go b/agent/eni/watcher/watcher_linux_test.go index b073afcec84..c353b895724 100644 --- a/agent/eni/watcher/watcher_linux_test.go +++ b/agent/eni/watcher/watcher_linux_test.go @@ -24,6 +24,8 @@ import ( "testing" "time" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" + "github.com/deniswernert/udev" "github.com/golang/mock/gomock" "github.com/stretchr/testify/assert" @@ -33,7 +35,7 @@ import ( "github.com/aws/amazon-ecs-agent/agent/api" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" "github.com/aws/amazon-ecs-agent/agent/statechange" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" mock_dockerstate "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate/mocks" @@ -85,7 +87,7 @@ func TestWatcherInit(t *testing.T) { taskEngineState := dockerstate.NewTaskEngineState() taskEngineState.AddENIAttachment(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachStatusSent: false, ExpiresAt: time.Unix(time.Now().Unix()+10, 0), }, @@ -199,6 +201,7 @@ func TestReconcileENIs(t *testing.T) { require.NoError(t, watcher.reconcileOnce(false)) <-done + assert.NotNil(t, event.(api.TaskStateChange).Attachment) assert.Equal(t, randomMAC, event.(api.TaskStateChange).Attachment.MACAddress) select { @@ -235,6 +238,7 @@ func TestReconcileENIsWithRetry(t *testing.T) { require.NoError(t, watcher.reconcileOnce(true)) <-done + require.NotNil(t, event.(api.TaskStateChange).Attachment) assert.Equal(t, randomMAC, event.(api.TaskStateChange).Attachment.MACAddress) select { @@ -246,7 +250,7 @@ func TestReconcileENIsWithRetry(t *testing.T) { func getMockAttachment() *ni.ENIAttachment { return &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachStatusSent: false, ExpiresAt: time.Unix(time.Now().Unix()+10, 0), }, @@ -367,7 +371,7 @@ func TestUdevAddEvent(t *testing.T) { }, }, nil), mockStateManager.EXPECT().ENIByMac(randomMAC).Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: time.Unix(time.Now().Unix()+10, 0), }, }, true), @@ -382,7 +386,7 @@ func TestUdevAddEvent(t *testing.T) { eniChangeEvent := <-eventChannel taskStateChange, ok := eniChangeEvent.(api.TaskStateChange) require.True(t, ok) - assert.Equal(t, attachment.AttachmentAttached, taskStateChange.Attachment.Status) + assert.Equal(t, status.AttachmentAttached, taskStateChange.Attachment.Status) var waitForClose sync.WaitGroup waitForClose.Add(2) diff --git a/agent/eni/watcher/watcher_test.go b/agent/eni/watcher/watcher_test.go index 715f9a5e765..553a2b91808 100644 --- a/agent/eni/watcher/watcher_test.go +++ b/agent/eni/watcher/watcher_test.go @@ -21,7 +21,8 @@ import ( "testing" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/aws/amazon-ecs-agent/agent/api" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" @@ -65,7 +66,7 @@ func TestSendENIStateChange(t *testing.T) { gomock.InOrder( mockStateManager.EXPECT().ENIByMac(randomMAC).Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: time.Now().Add(expirationTimeAddition), }, }, true), @@ -78,7 +79,7 @@ func TestSendENIStateChange(t *testing.T) { eniChangeEvent := <-eventChannel taskStateChange, ok := eniChangeEvent.(api.TaskStateChange) require.True(t, ok) - assert.Equal(t, attachment.AttachmentAttached, taskStateChange.Attachment.Status) + assert.Equal(t, status.AttachmentAttached, taskStateChange.Attachment.Status) } // Test for SendENIStateChange. We call the method for an Unmanaged ENI. Therefore we get an error. @@ -111,7 +112,7 @@ func TestSendENIStateChangeAlreadySent(t *testing.T) { gomock.InOrder( mockStateManager.EXPECT().ENIByMac(randomMAC).Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachStatusSent: true, ExpiresAt: time.Now().Add(expirationTimeAddition), }, @@ -136,7 +137,7 @@ func TestSendENIStateChangeExpired(t *testing.T) { gomock.InOrder( mockStateManager.EXPECT().ENIByMac(randomMAC).Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachStatusSent: false, ExpiresAt: time.Now().Add(expirationTimeSubtraction), }, @@ -162,7 +163,7 @@ func TestSendENIStateChangeWithRetries(t *testing.T) { gomock.InOrder( mockStateManager.EXPECT().ENIByMac(randomMAC).Return(nil, false), mockStateManager.EXPECT().ENIByMac(randomMAC).Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: time.Now().Add(expirationTimeAddition), }, MACAddress: randomMAC, @@ -176,7 +177,7 @@ func TestSendENIStateChangeWithRetries(t *testing.T) { eniChangeEvent := <-eventChannel taskStateChange, ok := eniChangeEvent.(api.TaskStateChange) require.True(t, ok) - assert.Equal(t, attachment.AttachmentAttached, taskStateChange.Attachment.Status) + assert.Equal(t, status.AttachmentAttached, taskStateChange.Attachment.Status) } // Test for SendENIStateChangeWithRetries. We call this method for an expired ENI. @@ -193,7 +194,7 @@ func TestSendENIStateChangeWithRetriesDoesNotRetryExpiredENI(t *testing.T) { // mean that it doesn't get retried. mockStateManager.EXPECT().ENIByMac(randomMAC).Return( &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachStatusSent: false, ExpiresAt: time.Now().Add(expirationTimeSubtraction), }, @@ -220,7 +221,7 @@ func TestSendENIStateChangeWithAttachmentTypeInstanceENI(t *testing.T) { gomock.InOrder( mockStateManager.EXPECT().ENIByMac(randomMAC).Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: time.Now().Add(expirationTimeAddition), }, AttachmentType: ni.ENIAttachmentTypeInstanceENI, @@ -234,7 +235,7 @@ func TestSendENIStateChangeWithAttachmentTypeInstanceENI(t *testing.T) { eniChangeEvent := <-eventChannel attachmentStateChange, ok := eniChangeEvent.(api.AttachmentStateChange) require.True(t, ok) - assert.Equal(t, attachment.AttachmentAttached, attachmentStateChange.Attachment.GetAttachmentStatus()) + assert.Equal(t, status.AttachmentAttached, attachmentStateChange.Attachment.Status) } // TestSendENIStateChangeWithAttachmentTypeTaskENI tests that we send the attachment state change @@ -249,7 +250,7 @@ func TestSendENIStateChangeWithAttachmentTypeTaskENI(t *testing.T) { gomock.InOrder( mockStateManager.EXPECT().ENIByMac(randomMAC).Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: time.Now().Add(expirationTimeAddition), }, AttachmentType: ni.ENIAttachmentTypeTaskENI, @@ -263,5 +264,5 @@ func TestSendENIStateChangeWithAttachmentTypeTaskENI(t *testing.T) { eniChangeEvent := <-eventChannel taskStateChange, ok := eniChangeEvent.(api.TaskStateChange) require.True(t, ok) - assert.Equal(t, attachment.AttachmentAttached, taskStateChange.Attachment.Status) + assert.Equal(t, status.AttachmentAttached, taskStateChange.Attachment.Status) } diff --git a/agent/eni/watcher/watcher_windows_test.go b/agent/eni/watcher/watcher_windows_test.go index 014c538a8bb..5de513257e7 100644 --- a/agent/eni/watcher/watcher_windows_test.go +++ b/agent/eni/watcher/watcher_windows_test.go @@ -23,6 +23,8 @@ import ( "testing" "time" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" + "github.com/aws/amazon-ecs-agent/agent/api" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" mock_dockerstate "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate/mocks" @@ -30,7 +32,7 @@ import ( mock_iphelperwrapper "github.com/aws/amazon-ecs-agent/agent/eni/iphelperwrapper/mocks" mock_networkutils "github.com/aws/amazon-ecs-agent/agent/eni/networkutils/mocks" "github.com/aws/amazon-ecs-agent/agent/statechange" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" "github.com/golang/mock/gomock" @@ -149,7 +151,7 @@ func TestReconcileOnce(t *testing.T) { mockStateManager := mock_dockerstate.NewMockTaskEngineState(mockCtrl) mockStateManager.EXPECT().ENIByMac(macAddress1). Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachStatusSent: false, ExpiresAt: time.Now().Add(expirationTimeAddition), }, @@ -160,7 +162,7 @@ func TestReconcileOnce(t *testing.T) { waitForEvents.Done() }). Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachStatusSent: true, }, MACAddress: macAddress2, @@ -257,7 +259,7 @@ func TestEventHandlerSuccess(t *testing.T) { mockNetworkUtils.EXPECT().GetInterfaceMACByIndex(interfaceIndex1, gomock.Any(), sendENIStateChangeRetryTimeout).Return(macAddress1, nil), mockStateManager.EXPECT().ENIByMac(macAddress1). Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: time.Now().Add(expirationTimeAddition), }, MACAddress: macAddress1, @@ -279,7 +281,7 @@ func TestEventHandlerSuccess(t *testing.T) { taskStateChange, ok := event.(api.TaskStateChange) assert.True(t, ok) - assert.Equal(t, attachment.AttachmentAttached, taskStateChange.Attachment.Status) + assert.Equal(t, status.AttachmentAttached, taskStateChange.Attachment.Status) var wait sync.WaitGroup wait.Add(1) @@ -347,7 +349,7 @@ func TestEventHandlerENIStatusAlreadySent(t *testing.T) { mockNetworkUtils.EXPECT().GetInterfaceMACByIndex(interfaceIndex1, gomock.Any(), sendENIStateChangeRetryTimeout).Return(macAddress1, nil), mockStateManager.EXPECT().ENIByMac(macAddress1). Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachStatusSent: true, }, MACAddress: macAddress1, @@ -430,7 +432,7 @@ func TestEventHandlerExpiredENI(t *testing.T) { mockNetworkUtils.EXPECT().GetInterfaceMACByIndex(interfaceIndex1, gomock.Any(), sendENIStateChangeRetryTimeout).Return(macAddress1, nil), mockStateManager.EXPECT().ENIByMac(macAddress1). Return(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: time.Now().Add(expirationTimeSubtraction), }, MACAddress: macAddress1, diff --git a/agent/eventhandler/attachment_handler.go b/agent/eventhandler/attachment_handler.go index 63f1407c241..e9947e0269c 100644 --- a/agent/eventhandler/attachment_handler.go +++ b/agent/eventhandler/attachment_handler.go @@ -22,8 +22,6 @@ import ( "github.com/aws/amazon-ecs-agent/agent/api" "github.com/aws/amazon-ecs-agent/agent/data" "github.com/aws/amazon-ecs-agent/agent/statechange" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" - ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/retry" "github.com/cihub/seelog" ) @@ -94,7 +92,7 @@ func (eventHandler *AttachmentEventHandler) AddStateChangeEvent(change statechan return fmt.Errorf("eventhandler: received malformed attachment state change event: %v", event) } - attachmentARN := event.Attachment.GetAttachmentARN() + attachmentARN := event.Attachment.AttachmentARN eventHandler.lock.Lock() if _, ok := eventHandler.attachmentARNToHandler[attachmentARN]; !ok { eventHandler.attachmentARNToHandler[attachmentARN] = &attachmentHandler{ @@ -129,7 +127,7 @@ func (handler *attachmentHandler) submitAttachmentEvent(attachmentChange *api.At } func (handler *attachmentHandler) submitAttachmentEventOnce(attachmentChange *api.AttachmentStateChange) error { - if !attachmentChange.Attachment.ShouldNotify() { + if !attachmentChangeShouldBeSent(attachmentChange) { seelog.Debugf("AttachmentHandler: not sending attachment state change [%s] as it should not be sent", attachmentChange.String()) // if the attachment state change should not be sent, we don't need to retry anymore so return nil here return nil @@ -145,19 +143,14 @@ func (handler *attachmentHandler) submitAttachmentEventOnce(attachmentChange *ap attachmentChange.Attachment.SetSentStatus() attachmentChange.Attachment.StopAckTimer() - switch typedAttachment := attachmentChange.Attachment.(type) { - case *ni.ENIAttachment: - err := handler.dataClient.SaveENIAttachment(typedAttachment) - if err != nil { - seelog.Errorf("AttachmentHandler: error saving ENI state after submitted attachment state change [%s]: %v", attachmentChange.String(), err) - } - case *resource.ResourceAttachment: - err := handler.dataClient.SaveResourceAttachment(typedAttachment) - if err != nil { - seelog.Errorf("AttachmentHandler: error saving Resource state after submitted attachment state change [%s]: %v", attachmentChange.String(), err) - } - default: - seelog.Errorf("Unable to save attachment state after submitted attachment state change [%s]: unknown attachment type", attachmentChange.String()) + err := handler.dataClient.SaveENIAttachment(attachmentChange.Attachment) + if err != nil { + seelog.Errorf("AttachmentHandler: error saving state after submitted attachment state change [%s]: %v", attachmentChange.String(), err) } return nil } + +// attachmentChangeShouldBeSent checks whether an attachment state change should be sent to backend +func attachmentChangeShouldBeSent(attachmentChange *api.AttachmentStateChange) bool { + return !attachmentChange.Attachment.HasExpired() && !attachmentChange.Attachment.IsSent() +} diff --git a/agent/eventhandler/attachment_handler_test.go b/agent/eventhandler/attachment_handler_test.go index d12cdcfbef4..d50c2c7f81e 100644 --- a/agent/eventhandler/attachment_handler_test.go +++ b/agent/eventhandler/attachment_handler_test.go @@ -25,8 +25,7 @@ import ( "github.com/aws/amazon-ecs-agent/agent/api" mock_api "github.com/aws/amazon-ecs-agent/agent/api/mocks" "github.com/aws/amazon-ecs-agent/agent/data" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" apierrors "github.com/aws/amazon-ecs-agent/ecs-agent/api/errors" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/retry" @@ -46,12 +45,12 @@ const ( attachmentARN = "arn:aws:ecs:us-west-2:1234567890:attachment/abc" ) -func TestSendENIAttachmentEvent(t *testing.T) { +func TestSendAttachmentEvent(t *testing.T) { ctrl := gomock.NewController(t) defer ctrl.Finish() client := mock_api.NewMockECSClient(ctrl) - attachmentEvent := eniAttachmentEvent(attachmentARN) + attachmentEvent := attachmentEvent(attachmentARN) timeoutFunc := func() { t.Error("Timeout sending ENI attach status") @@ -67,37 +66,7 @@ func TestSendENIAttachmentEvent(t *testing.T) { client.EXPECT().SubmitAttachmentStateChange(gomock.Any()).Return(nil).Do(func(change api.AttachmentStateChange) { assert.NotNil(t, change.Attachment) - assert.Equal(t, attachmentARN, change.Attachment.GetAttachmentARN()) - wg.Done() - }) - - require.NoError(t, handler.AddStateChangeEvent(attachmentEvent)) - - wg.Wait() -} - -func TestSendResAttachmentEvent(t *testing.T) { - ctrl := gomock.NewController(t) - defer ctrl.Finish() - client := mock_api.NewMockECSClient(ctrl) - - attachmentEvent := resAttachmentEvent(attachmentARN) - - timeoutFunc := func() { - t.Error("Timeout sending ENI attach status") - } - assert.NoError(t, attachmentEvent.Attachment.StartTimer(timeoutFunc)) - - ctx, cancel := context.WithCancel(context.Background()) - handler := NewAttachmentEventHandler(ctx, data.NewNoopClient(), client) - defer cancel() - - var wg sync.WaitGroup - wg.Add(1) - - client.EXPECT().SubmitAttachmentStateChange(gomock.Any()).Return(nil).Do(func(change api.AttachmentStateChange) { - assert.NotNil(t, change.Attachment) - assert.Equal(t, attachmentARN, change.Attachment.GetAttachmentARN()) + assert.Equal(t, attachmentARN, change.Attachment.AttachmentARN) wg.Done() }) @@ -111,7 +80,7 @@ func TestSendAttachmentEventRetries(t *testing.T) { defer ctrl.Finish() client := mock_api.NewMockECSClient(ctrl) - attachmentEvent := eniAttachmentEvent(attachmentARN) + attachmentEvent := attachmentEvent(attachmentARN) timeoutFunc := func() { t.Error("Timeout sending ENI attach status") @@ -135,7 +104,7 @@ func TestSendAttachmentEventRetries(t *testing.T) { client.EXPECT().SubmitAttachmentStateChange(gomock.Any()).Return(retriable).Do(func(interface{}) { wg.Done() }), client.EXPECT().SubmitAttachmentStateChange(gomock.Any()).Return(nil).Do(func(change api.AttachmentStateChange) { assert.NotNil(t, change.Attachment) - assert.Equal(t, attachmentARN, change.Attachment.GetAttachmentARN()) + assert.Equal(t, attachmentARN, change.Attachment.AttachmentARN) wg.Done() }), ) @@ -145,14 +114,14 @@ func TestSendAttachmentEventRetries(t *testing.T) { wg.Wait() } -func TestSendMutipleAttachmentEventsMixedAttachments(t *testing.T) { +func TestSendMultipleAttachmentEventsDifferentAttachments(t *testing.T) { ctrl := gomock.NewController(t) defer ctrl.Finish() client := mock_api.NewMockECSClient(ctrl) - attachmentEvent1 := eniAttachmentEvent("attachmentARN1") - attachmentEvent2 := resAttachmentEvent("attachmentARN2") - attachmentEvent3 := resAttachmentEvent("attachmentARN3") + attachmentEvent1 := attachmentEvent("attachmentARN1") + attachmentEvent2 := attachmentEvent("attachmentARN2") + attachmentEvent3 := attachmentEvent("attachmentARN3") timeoutFunc := func() { t.Error("Timeout sending ENI attach status") @@ -174,7 +143,7 @@ func TestSendMutipleAttachmentEventsMixedAttachments(t *testing.T) { mapLock.Lock() defer mapLock.Unlock() - submittedAttachments[change.Attachment.GetAttachmentARN()] = true + submittedAttachments[change.Attachment.AttachmentARN] = true wg.Done() }) @@ -196,7 +165,7 @@ func TestSubmitAttachmentEventSucceeds(t *testing.T) { dataClient := newTestDataClient(t) - attachmentEvent := eniAttachmentEvent(attachmentARN) + attachmentEvent := attachmentEvent(attachmentARN) timeoutFunc := func() { t.Error("Timeout sending ENI attach status") @@ -213,12 +182,12 @@ func TestSubmitAttachmentEventSucceeds(t *testing.T) { client.EXPECT().SubmitAttachmentStateChange(gomock.Any()).Return(nil).Do(func(change api.AttachmentStateChange) { assert.NotNil(t, change.Attachment) - assert.Equal(t, attachmentARN, change.Attachment.GetAttachmentARN()) + assert.Equal(t, attachmentARN, change.Attachment.AttachmentARN) }) handler.submitAttachmentEvent(&attachmentEvent) - assert.True(t, attachmentEvent.Attachment.IsSent()) + assert.True(t, attachmentEvent.Attachment.AttachStatusSent) res, err := dataClient.GetENIAttachments() assert.NoError(t, err) assert.Len(t, res, 1) @@ -229,7 +198,8 @@ func TestSubmitAttachmentEventAttachmentExpired(t *testing.T) { defer ctrl.Finish() client := mock_api.NewMockECSClient(ctrl) - attachmentEvent := eniAttachmentEventWithExpiry(attachmentARN, 100*time.Millisecond) + attachmentEvent := attachmentEvent(attachmentARN) + attachmentEvent.Attachment.ExpiresAt = time.Now().Add(100 * time.Millisecond) // wait until eni attachment expires time.Sleep(200 * time.Millisecond) @@ -244,7 +214,7 @@ func TestSubmitAttachmentEventAttachmentExpired(t *testing.T) { handler.submitAttachmentEvent(&attachmentEvent) // no SubmitAttachmentStateChange should happen and attach status should not be sent - assert.False(t, attachmentEvent.Attachment.IsSent()) + assert.False(t, attachmentEvent.Attachment.AttachStatusSent) } func TestSubmitAttachmentEventAttachmentIsSent(t *testing.T) { @@ -252,7 +222,7 @@ func TestSubmitAttachmentEventAttachmentIsSent(t *testing.T) { defer ctrl.Finish() client := mock_api.NewMockECSClient(ctrl) - attachmentEvent := resAttachmentEvent(attachmentARN) + attachmentEvent := attachmentEvent(attachmentARN) attachmentEvent.Attachment.SetSentStatus() timeoutFunc := func() { @@ -273,40 +243,32 @@ func TestSubmitAttachmentEventAttachmentIsSent(t *testing.T) { attachmentEvent.Attachment.StopAckTimer() } -func eniAttachmentEvent(attachmentARN string) api.AttachmentStateChange { - return api.AttachmentStateChange{ - Attachment: &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ - AttachmentARN: attachmentARN, - AttachStatusSent: false, - ExpiresAt: time.Now().Add(time.Second), - }, - AttachmentType: ni.ENIAttachmentTypeInstanceENI, - }, - } +func TestAttachmentChangeShouldBeSent(t *testing.T) { + attachmentEvent := attachmentEvent(attachmentARN) + assert.True(t, attachmentChangeShouldBeSent(&attachmentEvent)) } -func resAttachmentEvent(attachmentARN string) api.AttachmentStateChange { - return api.AttachmentStateChange{ - Attachment: &resource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ - AttachmentARN: attachmentARN, - Status: attachment.AttachmentAttached, - AttachStatusSent: false, - ExpiresAt: time.Now().Add(time.Second), - }, - AttachmentType: resource.EBSTaskAttach, - }, - } +func TestAttachmentChangeShouldBeSentAttachmentExpired(t *testing.T) { + attachmentEvent := attachmentEvent(attachmentARN) + attachmentEvent.Attachment.ExpiresAt = time.Now() + time.Sleep(10 * time.Millisecond) + + assert.False(t, attachmentChangeShouldBeSent(&attachmentEvent)) +} + +func TestAttachmentChangeShouldBeSentAttachmentIsSent(t *testing.T) { + attachmentEvent := attachmentEvent(attachmentARN) + attachmentEvent.Attachment.SetSentStatus() + assert.False(t, attachmentChangeShouldBeSent(&attachmentEvent)) } -func eniAttachmentEventWithExpiry(attachmentARN string, expiresAfter time.Duration) api.AttachmentStateChange { +func attachmentEvent(attachmentARN string) api.AttachmentStateChange { return api.AttachmentStateChange{ Attachment: &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: attachmentARN, AttachStatusSent: false, - ExpiresAt: time.Now().Add(expiresAfter), + ExpiresAt: time.Now().Add(time.Second), }, AttachmentType: ni.ENIAttachmentTypeInstanceENI, }, diff --git a/agent/eventhandler/handler_test.go b/agent/eventhandler/handler_test.go index cdc8636027c..1d85fa99e0e 100644 --- a/agent/eventhandler/handler_test.go +++ b/agent/eventhandler/handler_test.go @@ -46,7 +46,7 @@ func TestHandleEngineEvent(t *testing.T) { contEvent1 := containerEvent(taskARN) contEvent2 := containerEvent(taskARN) taskEvent := taskEvent(taskARN) - attachmentEvent := eniAttachmentEvent("attachmentARN") + attachmentEvent := attachmentEvent("attachmentARN") timeoutFunc := func() { t.Error("Timeout sending ENI attach status") @@ -62,7 +62,7 @@ func TestHandleEngineEvent(t *testing.T) { client.EXPECT().SubmitAttachmentStateChange(gomock.Any()).Do(func(change api.AttachmentStateChange) { assert.NotNil(t, change.Attachment) - assert.Equal(t, "attachmentARN", change.Attachment.GetAttachmentARN()) + assert.Equal(t, "attachmentARN", change.Attachment.AttachmentARN) wg.Done() }) diff --git a/agent/eventhandler/task_handler_test.go b/agent/eventhandler/task_handler_test.go index 325a6ce5e66..159f878a24e 100644 --- a/agent/eventhandler/task_handler_test.go +++ b/agent/eventhandler/task_handler_test.go @@ -33,7 +33,7 @@ import ( mock_dockerstate "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate/mocks" "github.com/aws/amazon-ecs-agent/agent/statechange" "github.com/aws/amazon-ecs-agent/agent/utils" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" apierrors "github.com/aws/amazon-ecs-agent/ecs-agent/api/errors" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" @@ -377,7 +377,7 @@ func TestENISentStatusChange(t *testing.T) { } eniAttachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachStatusSent: false, ExpiresAt: time.Now().Add(time.Second), diff --git a/agent/eventhandler/task_handler_types_test.go b/agent/eventhandler/task_handler_types_test.go index d5b3478169e..8ad35b761ea 100644 --- a/agent/eventhandler/task_handler_types_test.go +++ b/agent/eventhandler/task_handler_types_test.go @@ -25,7 +25,7 @@ import ( apicontainer "github.com/aws/amazon-ecs-agent/agent/api/container" apitask "github.com/aws/amazon-ecs-agent/agent/api/task" "github.com/aws/amazon-ecs-agent/agent/data" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" @@ -307,7 +307,7 @@ func TestShouldTaskAttachmentEventBeSent(t *testing.T) { event: newSendableTaskEvent(api.TaskStateChange{ Status: apitaskstatus.TaskStatusNone, Attachment: &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: time.Unix(time.Now().Unix()-1, 0), AttachStatusSent: false, }, @@ -324,7 +324,7 @@ func TestShouldTaskAttachmentEventBeSent(t *testing.T) { event: newSendableTaskEvent(api.TaskStateChange{ Status: apitaskstatus.TaskStatusNone, Attachment: &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: time.Unix(time.Now().Unix()+10, 0), AttachStatusSent: true, }, @@ -338,7 +338,7 @@ func TestShouldTaskAttachmentEventBeSent(t *testing.T) { event: newSendableTaskEvent(api.TaskStateChange{ Status: apitaskstatus.TaskStatusNone, Attachment: &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ ExpiresAt: time.Unix(time.Now().Unix()+10, 0), AttachStatusSent: false, }, @@ -470,7 +470,7 @@ func TestSetAttachmentSentStatus(t *testing.T) { dataClient := newTestDataClient(t) testAttachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachStatusSent: true, ExpiresAt: time.Unix(time.Now().Unix()+100, 0), AttachmentARN: testAttachmentARN, diff --git a/agent/fsx/factory/factory.go b/agent/fsx/factory/factory.go index 4e356c7548e..5def1c59a5b 100644 --- a/agent/fsx/factory/factory.go +++ b/agent/fsx/factory/factory.go @@ -16,11 +16,9 @@ package factory import ( "time" - "github.com/aws/amazon-ecs-agent/agent/config" fsxclient "github.com/aws/amazon-ecs-agent/agent/fsx" - agentversion "github.com/aws/amazon-ecs-agent/agent/version" + "github.com/aws/amazon-ecs-agent/agent/httpclient" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" - "github.com/aws/amazon-ecs-agent/ecs-agent/httpclient" "github.com/aws/aws-sdk-go/aws" awscreds "github.com/aws/aws-sdk-go/aws/credentials" "github.com/aws/aws-sdk-go/aws/session" @@ -44,7 +42,7 @@ type fsxClientCreator struct{} func (*fsxClientCreator) NewFSxClient(region string, creds credentials.IAMRoleCredentials) fsxclient.FSxClient { cfg := aws.NewConfig(). - WithHTTPClient(httpclient.New(roundtripTimeout, false, agentversion.String(), config.OSType)). + WithHTTPClient(httpclient.New(roundtripTimeout, false)). WithRegion(region). WithCredentials( awscreds.NewStaticCredentials(creds.AccessKeyID, creds.SecretAccessKey, diff --git a/agent/handlers/agentapi/taskprotection/factory.go b/agent/handlers/agentapi/taskprotection/factory.go index c9d8089e45f..89b2bdfb2fc 100644 --- a/agent/handlers/agentapi/taskprotection/factory.go +++ b/agent/handlers/agentapi/taskprotection/factory.go @@ -14,9 +14,7 @@ package taskprotection import ( "github.com/aws/amazon-ecs-agent/agent/api/ecsclient" - "github.com/aws/amazon-ecs-agent/agent/config" - "github.com/aws/amazon-ecs-agent/agent/version" - "github.com/aws/amazon-ecs-agent/ecs-agent/httpclient" + "github.com/aws/amazon-ecs-agent/agent/httpclient" "github.com/aws/amazon-ecs-agent/ecs-agent/api" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" @@ -44,8 +42,7 @@ func (factory TaskProtectionClientFactory) NewTaskProtectionClient( taskCredential.SecretAccessKey, taskCredential.SessionToken)). WithRegion(factory.Region). - WithHTTPClient(httpclient.New(ecsclient.RoundtripTimeout, factory.AcceptInsecureCert, version.String(), - config.OSType)). + WithHTTPClient(httpclient.New(ecsclient.RoundtripTimeout, factory.AcceptInsecureCert)). WithEndpoint(factory.Endpoint) ecsClient := ecs.New(session.Must(session.NewSession()), cfg) diff --git a/ecs-agent/httpclient/httpclient.go b/agent/httpclient/httpclient.go similarity index 72% rename from ecs-agent/httpclient/httpclient.go rename to agent/httpclient/httpclient.go index 08b33e63ef5..097bd69e371 100644 --- a/ecs-agent/httpclient/httpclient.go +++ b/agent/httpclient/httpclient.go @@ -22,33 +22,29 @@ import ( "net/http" "time" + "github.com/aws/amazon-ecs-agent/agent/config" + "github.com/aws/amazon-ecs-agent/agent/version" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/cipher" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/httpproxy" ) -// Below constants taken from the default http.Client behavior. -// Ref: https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/custom-http.html -const ( - defaultDialTimeout = 30 * time.Second - defaultDialKeepalive = 30 * time.Second - defaultTLSHandshakeTimeout = 10 * time.Second -) +// Taken from the default http.Client behavior +const defaultDialTimeout = 30 * time.Second +const defaultDialKeepalive = 30 * time.Second //go:generate mockgen -destination=mock/$GOFILE -copyright_file=../../scripts/copyright_file net/http RoundTripper type ecsRoundTripper struct { insecureSkipVerify bool - agentVersion string - osType string transport http.RoundTripper } -func (client *ecsRoundTripper) userAgent() string { - return fmt.Sprintf("%s (%s) (+http://aws.amazon.com/ecs/)", client.agentVersion, client.osType) +func userAgent() string { + return fmt.Sprintf("%s (%s) (+http://aws.amazon.com/ecs/)", version.String(), config.OSType) } func (client *ecsRoundTripper) RoundTrip(req *http.Request) (*http.Response, error) { - req.Header.Set("User-Agent", client.userAgent()) + req.Header.Set("User-Agent", userAgent()) return client.transport.RoundTrip(req) } @@ -59,30 +55,26 @@ func (client *ecsRoundTripper) CancelRequest(req *http.Request) { } // New returns an ECS httpClient with a roundtrip timeout of the given duration -func New(timeout time.Duration, insecureSkipVerify bool, agentVersion string, osType string) *http.Client { +func New(timeout time.Duration, insecureSkipVerify bool) *http.Client { // Transport is the transport requests will be made over // Note, these defaults are taken from the golang http library. We do not // explicitly do not use theirs to avoid changing their behavior. transport := &http.Transport{ Proxy: httpproxy.Proxy, - DialContext: (&net.Dialer{ + Dial: (&net.Dialer{ Timeout: defaultDialTimeout, KeepAlive: defaultDialKeepalive, - }).DialContext, - TLSHandshakeTimeout: defaultTLSHandshakeTimeout, + }).Dial, + TLSHandshakeTimeout: 10 * time.Second, } + transport.TLSClientConfig = &tls.Config{} cipher.WithSupportedCipherSuites(transport.TLSClientConfig) transport.TLSClientConfig.InsecureSkipVerify = insecureSkipVerify client := &http.Client{ - Transport: &ecsRoundTripper{ - insecureSkipVerify: insecureSkipVerify, - agentVersion: agentVersion, - osType: osType, - transport: transport, - }, - Timeout: timeout, + Transport: &ecsRoundTripper{insecureSkipVerify, transport}, + Timeout: timeout, } return client diff --git a/ecs-agent/httpclient/httpclient_test.go b/agent/httpclient/httpclient_test.go similarity index 86% rename from ecs-agent/httpclient/httpclient_test.go rename to agent/httpclient/httpclient_test.go index 5e12859e434..d9fca05d44b 100644 --- a/ecs-agent/httpclient/httpclient_test.go +++ b/agent/httpclient/httpclient_test.go @@ -27,13 +27,8 @@ import ( "github.com/stretchr/testify/assert" ) -const ( - agentVersionStr = "Amazon ECS Agent - v0.0.0 (fffffff)" - osType = "linux" -) - func TestNewHttpClient(t *testing.T) { - expectedResult := New(time.Duration(10), true, agentVersionStr, osType) + expectedResult := New(time.Duration(10), true) transport := expectedResult.Transport.(*ecsRoundTripper) assert.Equal(t, cipher.SupportedCipherSuites, transport.transport.(*http.Transport).TLSClientConfig.CipherSuites) assert.Equal(t, true, transport.transport.(*http.Transport).TLSClientConfig.InsecureSkipVerify) @@ -45,7 +40,7 @@ func TestNewHttpClientProxy(t *testing.T) { os.Setenv("HTTP_PROXY", proxy_url) defer os.Unsetenv("HTTP_PROXY") - client := New(time.Duration(10*time.Second), true, agentVersionStr, osType) + client := New(time.Duration(10*time.Second), true) _, err := client.Get("http://www.amazon.com") // Client won't be able to connect because we have given a arbitrary proxy assert.Error(t, err) diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/httpclient/mock/gomock_helpers.go b/agent/httpclient/mock/gomock_helpers.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/httpclient/mock/gomock_helpers.go rename to agent/httpclient/mock/gomock_helpers.go diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/httpclient/mock/httpclient.go b/agent/httpclient/mock/httpclient.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/httpclient/mock/httpclient.go rename to agent/httpclient/mock/httpclient.go diff --git a/agent/s3/factory/factory.go b/agent/s3/factory/factory.go index 0704ca19ac3..716c61ee215 100644 --- a/agent/s3/factory/factory.go +++ b/agent/s3/factory/factory.go @@ -16,11 +16,9 @@ package factory import ( "time" - "github.com/aws/amazon-ecs-agent/agent/config" + "github.com/aws/amazon-ecs-agent/agent/httpclient" s3client "github.com/aws/amazon-ecs-agent/agent/s3" - agentversion "github.com/aws/amazon-ecs-agent/agent/version" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" - "github.com/aws/amazon-ecs-agent/ecs-agent/httpclient" "github.com/aws/aws-sdk-go/aws" awscreds "github.com/aws/aws-sdk-go/aws/credentials" @@ -52,7 +50,7 @@ type s3ClientCreator struct{} func (*s3ClientCreator) NewS3ManagerClient(bucket, region string, creds credentials.IAMRoleCredentials) (s3client.S3ManagerClient, error) { cfg := aws.NewConfig(). - WithHTTPClient(httpclient.New(roundtripTimeout, false, agentversion.String(), config.OSType)). + WithHTTPClient(httpclient.New(roundtripTimeout, false)). WithCredentials( awscreds.NewStaticCredentials(creds.AccessKeyID, creds.SecretAccessKey, creds.SessionToken)).WithRegion(region) @@ -70,7 +68,7 @@ func (*s3ClientCreator) NewS3ManagerClient(bucket, region string, func (*s3ClientCreator) NewS3Client(bucket, region string, creds credentials.IAMRoleCredentials) (s3client.S3Client, error) { cfg := aws.NewConfig(). - WithHTTPClient(httpclient.New(roundtripTimeout, false, agentversion.String(), config.OSType)). + WithHTTPClient(httpclient.New(roundtripTimeout, false)). WithCredentials( awscreds.NewStaticCredentials(creds.AccessKeyID, creds.SecretAccessKey, creds.SessionToken)).WithRegion(region) diff --git a/agent/sighandlers/termination_handler_test.go b/agent/sighandlers/termination_handler_test.go index e6d8d183c31..54325b78869 100644 --- a/agent/sighandlers/termination_handler_test.go +++ b/agent/sighandlers/termination_handler_test.go @@ -26,7 +26,7 @@ import ( "github.com/aws/amazon-ecs-agent/agent/engine" "github.com/aws/amazon-ecs-agent/agent/engine/dockerstate" "github.com/aws/amazon-ecs-agent/agent/engine/image" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" "github.com/stretchr/testify/assert" @@ -62,7 +62,7 @@ func TestFinalSave(t *testing.T) { } eniAttachment := &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: eniAttachmentArn, AttachStatusSent: false, diff --git a/agent/ssm/factory/factory.go b/agent/ssm/factory/factory.go index 3a27412403f..6fe32db9569 100644 --- a/agent/ssm/factory/factory.go +++ b/agent/ssm/factory/factory.go @@ -16,11 +16,9 @@ package factory import ( "time" - "github.com/aws/amazon-ecs-agent/agent/config" + "github.com/aws/amazon-ecs-agent/agent/httpclient" ssmclient "github.com/aws/amazon-ecs-agent/agent/ssm" - agentversion "github.com/aws/amazon-ecs-agent/agent/version" "github.com/aws/amazon-ecs-agent/ecs-agent/credentials" - "github.com/aws/amazon-ecs-agent/ecs-agent/httpclient" "github.com/aws/aws-sdk-go/aws" awscreds "github.com/aws/aws-sdk-go/aws/credentials" "github.com/aws/aws-sdk-go/aws/session" @@ -45,7 +43,7 @@ type ssmClientCreator struct{} func (*ssmClientCreator) NewSSMClient(region string, creds credentials.IAMRoleCredentials) ssmclient.SSMClient { cfg := aws.NewConfig(). - WithHTTPClient(httpclient.New(roundtripTimeout, false, agentversion.String(), config.OSType)). + WithHTTPClient(httpclient.New(roundtripTimeout, false)). WithRegion(region). WithCredentials( awscreds.NewStaticCredentials(creds.AccessKeyID, creds.SecretAccessKey, diff --git a/agent/stats/engine_unix_test.go b/agent/stats/engine_unix_test.go index c79efe14876..5bfbb5dea91 100644 --- a/agent/stats/engine_unix_test.go +++ b/agent/stats/engine_unix_test.go @@ -27,7 +27,7 @@ import ( mock_dockerapi "github.com/aws/amazon-ecs-agent/agent/dockerclient/dockerapi/mocks" mock_resolver "github.com/aws/amazon-ecs-agent/agent/stats/resolver/mock" taskresourcevolume "github.com/aws/amazon-ecs-agent/agent/taskresource/volume" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/aws/amazon-ecs-agent/ecs-agent/csiclient" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" diff --git a/agent/taskresource/volume/dockervolume_ebs.go b/agent/taskresource/volume/dockervolume_ebs.go index 3835e9b8bd9..4ef1bbdf5aa 100644 --- a/agent/taskresource/volume/dockervolume_ebs.go +++ b/agent/taskresource/volume/dockervolume_ebs.go @@ -17,7 +17,7 @@ import ( "fmt" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/aws-sdk-go/aws" ) diff --git a/agent/taskresource/volume/dockervolume_ebs_test.go b/agent/taskresource/volume/dockervolume_ebs_test.go index ede690cadef..5d4f9af626c 100644 --- a/agent/taskresource/volume/dockervolume_ebs_test.go +++ b/agent/taskresource/volume/dockervolume_ebs_test.go @@ -19,7 +19,7 @@ import ( "testing" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + apiresource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" "github.com/aws/aws-sdk-go/aws" "github.com/stretchr/testify/assert" ) diff --git a/agent/utils/utils.go b/agent/utils/utils.go index fab02eecce0..b3e73a05f29 100644 --- a/agent/utils/utils.go +++ b/agent/utils/utils.go @@ -18,11 +18,9 @@ import ( "encoding/binary" "encoding/hex" "fmt" - "io/fs" "io/ioutil" "math" "math/big" - "os" "path/filepath" "reflect" "strconv" @@ -100,6 +98,17 @@ func BoolPtr(b bool) *bool { return &b } +// Uint16SliceToStringSlice converts a slice of type uint16 to a slice of type +// *string. It uses strconv.Itoa on each element +func Uint16SliceToStringSlice(slice []uint16) []*string { + stringSlice := make([]*string, len(slice)) + for i, el := range slice { + str := strconv.Itoa(int(el)) + stringSlice[i] = &str + } + return stringSlice +} + func StrSliceEqual(s1, s2 []string) bool { if len(s1) != len(s2) { return false @@ -219,28 +228,15 @@ func GetTaskID(taskARN string) (string, error) { return fields[len(fields)-1], nil } -// GetAttachmentId retrieves the ID from an attachment's ARN. -// asssumes arn structure: arn:[partition]:ec2:[region]:[account-id]:[attachment-type]/[resource-id] -func GetAttachmentId(attachmentArn string) (string, error) { - _, err := arn.Parse(attachmentArn) +// GetENIAttachmentId retrieves the attachment ID from eni attachment ARN. +func GetENIAttachmentId(eniAttachmentArn string) (string, error) { + _, err := arn.Parse(eniAttachmentArn) if err != nil { - return "", errors.Errorf("failed to get resource attachment id: resource attachment arn format invalid: %s", attachmentArn) + return "", errors.Errorf("failed to get eni attachment id: eni attachment arn format invalid: %s", eniAttachmentArn) } - fields := strings.Split(attachmentArn, "/") + fields := strings.Split(eniAttachmentArn, "/") if len(fields) < 2 { - return "", errors.Errorf("failed to get resource attachment id: resource attachment arn invalid: %s", attachmentArn) + return "", errors.Errorf("failed to get eni attachment id: eni attachment arn invalid: %s", eniAttachmentArn) } return fields[len(fields)-1], nil } - -// Checks if a file exists on the provided file path. -func FileExists(filePath string) (bool, error) { - _, err := os.Stat(filePath) - if err != nil { - if errors.Is(err, fs.ErrNotExist) { - return false, nil - } - return false, err - } - return true, nil -} diff --git a/agent/utils/utils_test.go b/agent/utils/utils_test.go index 0f3d6b77d9d..3923acb2eb7 100644 --- a/agent/utils/utils_test.go +++ b/agent/utils/utils_test.go @@ -18,11 +18,8 @@ package utils import ( "errors" - "fmt" - "os" "sort" "testing" - "time" "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" "github.com/aws/aws-sdk-go/aws" @@ -189,26 +186,12 @@ func TestGetTaskID(t *testing.T) { assert.Error(t, err) } -func TestGetAttachmentId(t *testing.T) { +func TestGetENIAttachmentId(t *testing.T) { attachmentArn := "arn:aws:ecs:us-west-2:1234567890:attachment/abc" - id, err := GetAttachmentId(attachmentArn) + id, err := GetENIAttachmentId(attachmentArn) require.NoError(t, err) assert.Equal(t, "abc", id) - _, err = GetAttachmentId("invalid") + _, err = GetENIAttachmentId("invalid") assert.Error(t, err) } - -func TestFileExists(t *testing.T) { - t.Run("file is found", func(t *testing.T) { - file, err := os.CreateTemp("", "file_exists_test") - res, err := FileExists(file.Name()) - assert.NoError(t, err) - assert.True(t, res) - }) - t.Run("file is not found", func(t *testing.T) { - res, err := FileExists(fmt.Sprintf("test_file_exists_%d", time.Now().Unix())) - assert.NoError(t, err) - assert.False(t, res) - }) -} diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_instance_eni_responder.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_instance_eni_responder.go index fbbc3730d79..e23fb144092 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_instance_eni_responder.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_instance_eni_responder.go @@ -21,7 +21,8 @@ import ( "github.com/pkg/errors" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" @@ -98,9 +99,9 @@ func (r *attachInstanceENIResponder) handleInstanceENIFromMessage(eni *ecsacs.El messageID, clusterARN, containerInstanceARN string, receivedAt time.Time, waitTimeoutMs int64) { expiresAt := receivedAt.Add(time.Duration(waitTimeoutMs) * time.Millisecond) err := r.eniHandler.HandleENIAttachment(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: aws.StringValue(eni.AttachmentArn), - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: expiresAt, AttachStatusSent: false, ClusterARN: clusterARN, diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_resource_responder.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_resource_responder.go index 29b3c8a3c5b..2045de56d7a 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_resource_responder.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_resource_responder.go @@ -18,8 +18,9 @@ import ( "time" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" "github.com/aws/amazon-ecs-agent/ecs-agent/metrics" @@ -91,14 +92,14 @@ func (r *attachResourceResponder) handleAttachMessage(message *ecsacs.ConfirmAtt }) expiresAt := receivedAt.Add(time.Duration(waitTimeoutMs) * time.Millisecond) go r.resourceHandler.HandleResourceAttachment(&resource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: aws.StringValue(message.TaskArn), TaskClusterARN: aws.StringValue(message.TaskClusterArn), ClusterARN: aws.StringValue(message.ClusterArn), ContainerInstanceARN: aws.StringValue(message.ContainerInstanceArn), ExpiresAt: expiresAt, AttachmentARN: aws.StringValue(message.Attachment.AttachmentArn), - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, }, AttachmentProperties: attachmentProperties, AttachmentType: aws.StringValue(message.Attachment.AttachmentType), diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_task_eni_responder.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_task_eni_responder.go index 389d6f72fa5..ba226aea08d 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_task_eni_responder.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/attach_task_eni_responder.go @@ -21,7 +21,8 @@ import ( "github.com/pkg/errors" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" @@ -99,10 +100,10 @@ func (r *attachTaskENIResponder) handleTaskENIFromMessage(eni *ecsacs.ElasticNet messageID, taskARN, clusterARN, containerInstanceARN string, receivedAt time.Time, waitTimeoutMs int64) { expiresAt := receivedAt.Add(time.Duration(waitTimeoutMs) * time.Millisecond) err := r.eniHandler.HandleENIAttachment(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: aws.StringValue(eni.AttachmentArn), - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: expiresAt, AttachStatusSent: false, ClusterARN: clusterARN, diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/attachment.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/attachment.go deleted file mode 100644 index 54384b7dfe8..00000000000 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/attachment.go +++ /dev/null @@ -1,29 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package attachment - -type Attachment interface { - GetAttachmentARN() string - GetAttachmentStatus() AttachmentStatus - GetAttachmentType() string - HasExpired() bool - IsSent() bool - SetAttachedStatus() - SetSentStatus() - ShouldAttach() bool - ShouldNotify() bool - StartTimer(func()) error - StopAckTimer() - String() string -} diff --git a/ecs-agent/api/attachment/attachment_info.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo/attachment_info.go similarity index 92% rename from ecs-agent/api/attachment/attachment_info.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo/attachment_info.go index 8b2d1e956ec..6f929c246e8 100644 --- a/ecs-agent/api/attachment/attachment_info.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo/attachment_info.go @@ -11,10 +11,12 @@ // express or implied. See the License for the specific language governing // permissions and limitations under the License. -package attachment +package attachmentinfo import ( "time" + + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" ) type AttachmentInfo struct { @@ -23,7 +25,7 @@ type AttachmentInfo struct { // AttachmentARN is the identifier for the attachment AttachmentARN string `json:"attachmentArn"` // Status is the status of the attachment: none/attached/detached - Status AttachmentStatus `json:"status"` + Status status.AttachmentStatus `json:"status"` // ExpiresAt is the timestamp past which the attachment is considered // unsuccessful. The SubmitTaskStateChange API, with the attachment information // should be invoked before this timestamp. diff --git a/ecs-agent/api/attachment/eni/eni.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/eni/eni.go similarity index 100% rename from ecs-agent/api/attachment/eni/eni.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/eni/eni.go diff --git a/ecs-agent/api/attachment/eni/eniattachment.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/eni/eniattachment.go similarity index 83% rename from ecs-agent/api/attachment/eni/eniattachment.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/eni/eniattachment.go index 292b5b9dddf..8b45d2f75cd 100644 --- a/ecs-agent/api/attachment/eni/eniattachment.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/eni/eniattachment.go @@ -18,7 +18,8 @@ import ( "sync" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/arn" @@ -36,7 +37,7 @@ const ( // ENIAttachment contains the information of the eni attachment type ENIAttachment struct { - attachment.AttachmentInfo + attachmentinfo.AttachmentInfo // AttachmentType is the type of the eni attachment, can either be "task-eni" or "instance-eni" AttachmentType string `json:"attachmentType"` // MACAddress is the mac address of eni @@ -117,13 +118,6 @@ func (eni *ENIAttachment) IsSent() bool { return eni.AttachStatusSent } -// SetAttachedStatus marks the eni status as attached -func (eni *ENIAttachment) SetAttachedStatus() { - eni.guard.Lock() - defer eni.guard.Unlock() - eni.Status = attachment.AttachmentAttached -} - // SetSentStatus marks the eni attached status has been sent func (eni *ENIAttachment) SetSentStatus() { eni.guard.Lock() @@ -157,18 +151,6 @@ func (eni *ENIAttachment) String() string { return eni.stringUnsafe() } -func (eni *ENIAttachment) GetAttachmentARN() string { - eni.guard.RLock() - defer eni.guard.RUnlock() - return eni.AttachmentARN -} - -func (eni *ENIAttachment) GetAttachmentStatus() attachment.AttachmentStatus { - eni.guard.RLock() - defer eni.guard.RUnlock() - return eni.Status -} - // stringUnsafe returns a string representation of the ENI Attachment func (eni *ENIAttachment) stringUnsafe() string { // skip TaskArn field for instance level eni attachment since it won't have a task arn @@ -182,23 +164,3 @@ func (eni *ENIAttachment) stringUnsafe() string { "ENI Attachment: task=%s attachment=%s attachmentType=%s attachmentSent=%t mac=%s status=%s expiresAt=%s", eni.TaskARN, eni.AttachmentARN, eni.AttachmentType, eni.AttachStatusSent, eni.MACAddress, eni.Status.String(), eni.ExpiresAt.Format(time.RFC3339)) } - -func (eni *ENIAttachment) GetAttachmentType() string { - eni.guard.RLock() - defer eni.guard.RUnlock() - - return eni.AttachmentType -} - -func (eni *ENIAttachment) ShouldAttach() bool { - eni.guard.RLock() - defer eni.guard.RUnlock() - return !(eni.Status == attachment.AttachmentAttached) && !eni.AttachStatusSent && !(time.Now().After(eni.ExpiresAt)) -} - -// should notify not sent/not expired -func (eni *ENIAttachment) ShouldNotify() bool { - eni.guard.RLock() - defer eni.guard.RUnlock() - return !eni.AttachStatusSent && !(time.Now().After(eni.ExpiresAt)) -} diff --git a/ecs-agent/api/attachment/resource/ebs_discovery.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/ebs_discovery.go similarity index 77% rename from ecs-agent/api/attachment/resource/ebs_discovery.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/ebs_discovery.go index 4076c24169d..95c442d9264 100644 --- a/ecs-agent/api/attachment/resource/ebs_discovery.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/ebs_discovery.go @@ -35,31 +35,13 @@ var ( ) type EBSDiscoveryClient struct { - ctx context.Context - hasXenSupport bool + ctx context.Context } -type EBSDiscoveryClientOption func(*EBSDiscoveryClient) - -// Enable Xen instances support for EBS Discovery Client -func WithXenSupport() EBSDiscoveryClientOption { - return func(ec *EBSDiscoveryClient) { - ec.hasXenSupport = true - } -} - -func NewDiscoveryClient(ctx context.Context, opts ...EBSDiscoveryClientOption) *EBSDiscoveryClient { - client := &EBSDiscoveryClient{ +func NewDiscoveryClient(ctx context.Context) *EBSDiscoveryClient { + return &EBSDiscoveryClient{ ctx: ctx, } - for _, opt := range opts { - opt(client) - } - return client -} - -func (client *EBSDiscoveryClient) HasXenSupport() bool { - return client.hasXenSupport } // ScanEBSVolumes will iterate through the entire list of provided EBS volume attachments within the agent state and checks if it's attached on the host. diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/ebs_discovery_linux.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/ebs_discovery_linux.go similarity index 62% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/ebs_discovery_linux.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/ebs_discovery_linux.go index 3f8dbeeb446..21b6510fe81 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/ebs_discovery_linux.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/ebs_discovery_linux.go @@ -25,11 +25,6 @@ import ( "strings" ) -const ( - sdPrefix = "sd" - xvdPrefix = "xvd" -) - // LsblkOutput is used to manage and track the output of `lsblk` type LsblkOutput struct { BlockDevices []BlockDevice `json:"blockdevices"` @@ -61,7 +56,7 @@ func (api *EBSDiscoveryClient) ConfirmEBSVolumeIsAttached(deviceName, volumeID s } expectedVolumeId := strings.ReplaceAll(volumeID, "-", "") - actualDeviceName, err := parseLsblkOutput(&lsblkOut, deviceName, expectedVolumeId, api.HasXenSupport()) + actualDeviceName, err := parseLsblkOutput(&lsblkOut, deviceName, expectedVolumeId) if err != nil { return "", err } @@ -83,57 +78,13 @@ func (api *EBSDiscoveryClient) ConfirmEBSVolumeIsAttached(deviceName, volumeID s // } // ] // } -// -// If hasXenSupport is true then, in addition to matching a device by its serial, this function -// matches devices by their names disregarding "sd" or "xvd" prefix if it exists in -// device name in parseLsblkOutput and deviceName both. -// This is because on Xen instances the device name received from upstream with "sd" or "xvd" -// prefix might appear on the instance with the prefix interchanged, that is "xvd" instead of "sd" -// and vice-versa. -func parseLsblkOutput( - output *LsblkOutput, - deviceName, volumeId string, - hasXenSupport bool, -) (string, error) { +func parseLsblkOutput(output *LsblkOutput, deviceName string, volumeId string) (string, error) { actualDeviceName := deviceName[strings.LastIndex(deviceName, "/")+1:] for _, block := range output.BlockDevices { + //TODO: Add edge case for Xen-based instances if block.Serial == volumeId { return block.Name, nil } - if hasXenSupport { - if foundDeviceName, found := matchXenBlockDevice(block, actualDeviceName); found { - return foundDeviceName, nil - } - } } return "", fmt.Errorf("cannot find EBS volume with device name: %v and volume ID: %v", actualDeviceName, volumeId) } - -// Matches a block device against a device name by matching the block device's name and -// the device name after stripping "sd" or "xvd" prefixes (whichever is present) from both names -// if it is present in both names. -func matchXenBlockDevice(block BlockDevice, deviceName string) (string, bool) { - if hasXenPrefix(block.Name) && hasXenPrefix(deviceName) { - if trimXenPrefix(block.Name) == trimXenPrefix(deviceName) { - return block.Name, true - } - } else if block.Name == deviceName { - return block.Name, true - } - return "", false -} - -// Checks if the device name has sd or xvd prefix. -func hasXenPrefix(name string) bool { - return strings.HasPrefix(name, sdPrefix) || strings.HasPrefix(name, xvdPrefix) -} - -// Trims "sd" or "xvd" prefix (whichever is present) from the given name. -func trimXenPrefix(name string) string { - if strings.HasPrefix(name, sdPrefix) { - return strings.TrimPrefix(name, sdPrefix) - } else if strings.HasPrefix(name, xvdPrefix) { - return strings.TrimPrefix(name, xvdPrefix) - } - return name -} diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/ebs_discovery_windows.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/ebs_discovery_windows.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/ebs_discovery_windows.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/ebs_discovery_windows.go diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/generate_mocks.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/generate_mocks.go similarity index 84% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/generate_mocks.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/generate_mocks.go index 6c86d8825ee..a66369fc121 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/generate_mocks.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/generate_mocks.go @@ -11,6 +11,6 @@ // express or implied. See the License for the specific language governing // permissions and limitations under the License. -//go:generate mockgen -destination=mocks/ebs_mocks.go -copyright_file=../../../../scripts/copyright_file github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource EBSDiscovery +//go:generate mockgen -destination=mocks/ebs_mocks.go -copyright_file=../../../scripts/copyright_file github.com/aws/amazon-ecs-agent/ecs-agent/api/resource EBSDiscovery package resource diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/interfaces.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/interfaces.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/interfaces.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/interfaces.go diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/mocks/ebs_mocks.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/mocks/ebs_mocks.go similarity index 95% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/mocks/ebs_mocks.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/mocks/ebs_mocks.go index 2c0abac5d48..9edfb8c25a6 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/mocks/ebs_mocks.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/mocks/ebs_mocks.go @@ -13,7 +13,7 @@ // // Code generated by MockGen. DO NOT EDIT. -// Source: github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource (interfaces: EBSDiscovery) +// Source: github.com/aws/amazon-ecs-agent/ecs-agent/api/resource (interfaces: EBSDiscovery) // Package mock_resource is a generated GoMock package. package mock_resource diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/resource_attachment.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/resource_attachment.go similarity index 87% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/resource_attachment.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/resource_attachment.go index f4666867cef..bd8c27cd7c8 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/resource_attachment.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/resource_attachment.go @@ -19,13 +19,14 @@ import ( "sync" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/ttime" ) type ResourceAttachment struct { - attachment.AttachmentInfo + attachmentinfo.AttachmentInfo // AttachmentType is the type of the resource attachment which can be "amazonebs" for EBS attach tasks. AttachmentType string `json:"AttachmentType,omitempty"` // AttachmentProperties is a map storing (name, value) representation of attachment properties. @@ -214,7 +215,7 @@ func (ra *ResourceAttachment) IsAttached() bool { ra.guard.RLock() defer ra.guard.RUnlock() - return ra.Status == attachment.AttachmentAttached + return ra.Status == status.AttachmentAttached } // SetAttachedStatus marks the resouce attachment as attached once it's been found on the host @@ -222,7 +223,7 @@ func (ra *ResourceAttachment) SetAttachedStatus() { ra.guard.Lock() defer ra.guard.Unlock() - ra.Status = attachment.AttachmentAttached + ra.Status = status.AttachmentAttached } // StopAckTimer stops the ack timer set on the resource attachment @@ -253,6 +254,7 @@ func (ra *ResourceAttachment) SetError(err error) { func (ra *ResourceAttachment) GetError() error { ra.guard.RLock() defer ra.guard.RUnlock() + return ra.err } @@ -260,6 +262,7 @@ func (ra *ResourceAttachment) GetError() error { func (ra *ResourceAttachment) EBSToString() string { ra.guard.RLock() defer ra.guard.RUnlock() + return ra.ebsToStringUnsafe() } @@ -284,74 +287,41 @@ func (ra *ResourceAttachment) GetAttachmentProperties(key string) string { func (ra *ResourceAttachment) GetAttachmentType() string { ra.guard.RLock() defer ra.guard.RUnlock() + return ra.AttachmentType } func (ra *ResourceAttachment) SetDeviceName(deviceName string) { ra.guard.Lock() defer ra.guard.Unlock() + ra.AttachmentProperties[DeviceNameKey] = deviceName } func (ra *ResourceAttachment) GetAttachmentARN() string { ra.guard.RLock() defer ra.guard.RUnlock() - return ra.AttachmentARN -} -func (ra *ResourceAttachment) GetStatus() attachment.AttachmentStatus { - ra.guard.RLock() - defer ra.guard.RUnlock() - return ra.Status + return ra.AttachmentARN } func (ra *ResourceAttachment) GetExpiresAt() time.Time { ra.guard.RLock() defer ra.guard.RUnlock() + return ra.ExpiresAt } func (ra *ResourceAttachment) GetClusterARN() string { ra.guard.RLock() defer ra.guard.RUnlock() + return ra.ClusterARN } func (ra *ResourceAttachment) GetContainerInstanceARN() string { ra.guard.RLock() defer ra.guard.RUnlock() - return ra.ContainerInstanceARN -} -// should attach when not attached, and not sent/not expired -func (ra *ResourceAttachment) ShouldAttach() bool { - ra.guard.RLock() - defer ra.guard.RUnlock() - return !(ra.Status == attachment.AttachmentAttached) && !ra.AttachStatusSent && !(time.Now().After(ra.ExpiresAt)) -} - -// should notify when attached, and not sent/not expired -func (ra *ResourceAttachment) ShouldNotify() bool { - ra.guard.RLock() - defer ra.guard.RUnlock() - return (ra.Status == attachment.AttachmentAttached) && !ra.AttachStatusSent && !(time.Now().After(ra.ExpiresAt)) -} - -func (ra *ResourceAttachment) String() string { - ra.guard.RLock() - defer ra.guard.RUnlock() - return ra.stringUnsafe() -} - -func (ra *ResourceAttachment) GetAttachmentStatus() attachment.AttachmentStatus { - ra.guard.RLock() - defer ra.guard.RUnlock() - return ra.Status -} - -// stringUnsafe returns a string representation of the ENI Attachment -func (ra *ResourceAttachment) stringUnsafe() string { - return fmt.Sprintf( - "Resource Attachment: attachment=%s attachmentType=%s attachmentSent=%t status=%s expiresAt=%s", - ra.AttachmentARN, ra.AttachmentType, ra.AttachStatusSent, ra.Status.String(), ra.ExpiresAt.Format(time.RFC3339)) + return ra.ContainerInstanceARN } diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/resource_type.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/resource_type.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/resource_type.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/resource_type.go diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/resource_validation.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/resource_validation.go similarity index 100% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/resource_validation.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/resource_validation.go diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/attachment_status.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/status/attachment_status.go similarity index 98% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/attachment_status.go rename to agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/status/attachment_status.go index 93f0ba49ea7..be8d9646d9d 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/attachment_status.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/status/attachment_status.go @@ -11,7 +11,7 @@ // express or implied. See the License for the specific language governing // permissions and limitations under the License. -package attachment +package status const ( // AttachmentNone is zero state of a task when received attach message from acs diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/async/mocks/async_mocks.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/async/mocks/async_mocks.go index b797e422e0d..b96d4cc2fde 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/async/mocks/async_mocks.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/async/mocks/async_mocks.go @@ -20,6 +20,7 @@ package mock_async import ( reflect "reflect" + time "time" async "github.com/aws/amazon-ecs-agent/ecs-agent/async" gomock "github.com/golang/mock/gomock" @@ -138,20 +139,6 @@ func (mr *MockTTLCacheMockRecorder) Get(arg0 interface{}) *gomock.Call { return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Get", reflect.TypeOf((*MockTTLCache)(nil).Get), arg0) } -// GetTTL mocks base method. -func (m *MockTTLCache) GetTTL() *async.TTL { - m.ctrl.T.Helper() - ret := m.ctrl.Call(m, "GetTTL") - ret0, _ := ret[0].(*async.TTL) - return ret0 -} - -// GetTTL indicates an expected call of GetTTL. -func (mr *MockTTLCacheMockRecorder) GetTTL() *gomock.Call { - mr.mock.ctrl.T.Helper() - return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "GetTTL", reflect.TypeOf((*MockTTLCache)(nil).GetTTL)) -} - // Set mocks base method. func (m *MockTTLCache) Set(arg0 string, arg1 interface{}) { m.ctrl.T.Helper() @@ -165,7 +152,7 @@ func (mr *MockTTLCacheMockRecorder) Set(arg0, arg1 interface{}) *gomock.Call { } // SetTTL mocks base method. -func (m *MockTTLCache) SetTTL(arg0 *async.TTL) { +func (m *MockTTLCache) SetTTL(arg0 time.Duration) { m.ctrl.T.Helper() m.ctrl.Call(m, "SetTTL", arg0) } diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/async/ttl_cache.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/async/ttl_cache.go index 7351fa6a987..ba10fcb8f82 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/async/ttl_cache.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/async/ttl_cache.go @@ -19,32 +19,22 @@ import ( ) type TTLCache interface { - // Get fetches a value from cache, returns nil, false on miss. + // Get fetches a value from cache, returns nil, false on miss Get(key string) (value interface{}, expired bool, ok bool) - // Set sets a value in cache. This overwrites any existing value. + // Set sets a value in cache. overrites any existing value Set(key string, value interface{}) - // Delete deletes the value from the cache. + // Delete deletes the value from the cache Delete(key string) - // GetTTL gets the time-to-live of the cache. - GetTTL() *TTL - // SetTTL sets the time-to-live of the cache. - SetTTL(ttl *TTL) + // SetTTL sets the time-to-live of the cache + SetTTL(ttl time.Duration) } -// NewTTLCache creates a TTL cache with optional TTL for items. -func NewTTLCache(ttl *TTL) TTLCache { - ttlCache := &ttlCache{ +// Creates a TTL cache with ttl for items. +func NewTTLCache(ttl time.Duration) TTLCache { + return &ttlCache{ + ttl: ttl, cache: make(map[string]*ttlCacheEntry), } - // Only set TTL if it is not nil. - if ttl != nil { - ttlCache.ttl = ttl - } - return ttlCache -} - -type TTL struct { - Duration time.Duration } type ttlCacheEntry struct { @@ -55,7 +45,7 @@ type ttlCacheEntry struct { type ttlCache struct { mu sync.RWMutex cache map[string]*ttlCacheEntry - ttl *TTL + ttl time.Duration } // Get returns the value associated with the key. @@ -70,60 +60,34 @@ func (t *ttlCache) Get(key string) (value interface{}, expired bool, ok bool) { return nil, false, false } entry := t.cache[key] - // Entries can only be expired if the cache has a TTL set. - if t.ttl != nil { - expired = time.Now().After(entry.expiry) - } + expired = time.Now().After(entry.expiry) return entry.value, expired, true } -// Set sets the key-value pair in the cache. +// Set sets the key-value pair in the cache func (t *ttlCache) Set(key string, value interface{}) { t.mu.Lock() defer t.mu.Unlock() t.cache[key] = &ttlCacheEntry{ - value: value, - } - // Entries can only have expiry set if the cache has a TTL set. - if t.ttl != nil { - t.cache[key].expiry = time.Now().Add(t.ttl.Duration) + value: value, + expiry: time.Now().Add(t.ttl), } } -// Delete removes the entry associated with the key from cache. +// Delete removes the entry associated with the key from cache func (t *ttlCache) Delete(key string) { t.mu.Lock() defer t.mu.Unlock() delete(t.cache, key) } -// GetTTL gets the time-to-live of the cache. -func (t *ttlCache) GetTTL() *TTL { - t.mu.Lock() - defer t.mu.Unlock() - if t.ttl == nil { - return nil - } - return &TTL{Duration: t.ttl.Duration} -} - -// SetTTL sets the time-to-live of the cache. -func (t *ttlCache) SetTTL(newTTL *TTL) { +// SetTTL sets the time-to-live of the cache +func (t *ttlCache) SetTTL(ttl time.Duration) { t.mu.Lock() defer t.mu.Unlock() - - // Update expiry of all entries in the cache. - if t.ttl != nil { - oldTTLDuration := t.ttl.Duration - for _, val := range t.cache { - val.expiry = val.expiry.Add(newTTL.Duration - oldTTLDuration) - } - } else { - now := time.Now() - for _, val := range t.cache { - val.expiry = now.Add(newTTL.Duration) - } + oldTTL := t.ttl + t.ttl = ttl + for _, val := range t.cache { + val.expiry = val.expiry.Add(ttl - oldTTL) } - - t.ttl = &TTL{Duration: newTTL.Duration} } diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds_windows.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds_windows.go deleted file mode 100644 index 22dcbcf9d63..00000000000 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds/instancecreds_windows.go +++ /dev/null @@ -1,72 +0,0 @@ -//go:build windows - -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package instancecreds - -import ( - "fmt" - - "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers" - "github.com/aws/amazon-ecs-agent/ecs-agent/logger" - - "github.com/aws/aws-sdk-go/aws/credentials" - "github.com/aws/aws-sdk-go/aws/defaults" -) - -// GetCredentials returns the instance credentials chain. This is the default chain -// credentials plus the "rotating shared credentials provider", so credentials will -// be checked in this order: -// -// 1. Env vars (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). -// -// 2. Shared credentials file (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/create-shared-credentials-file.html) (file at ~/.aws/credentials containing access key id and secret access key). -// -// 3. EC2 role credentials. This is an IAM role that the user specifies when they launch their EC2 container instance (ie ecsInstanceRole (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/instance_IAM_role.html)). -// -// 4. Rotating shared credentials file located at /rotatingcreds/credentials -// -// The default credential chain provided by the SDK includes: -// * EnvProvider -// * SharedCredentialsProvider -// * RemoteCredProvider (EC2RoleProvider) -// -// In the case of ECS-A on Windows, the `SharedCredentialsProvider` takes -// precedence over the `RotatingSharedCredentialsProvider` and this results -// in the credentials not being refreshed. To mitigate this issue, we will -// reorder the credential chain and ensure that `RotatingSharedCredentialsProvider` -// takes precedence over the `SharedCredentialsProvider` for ECS-A. -func GetCredentials(isExternal bool) *credentials.Credentials { - mu.Lock() - credProviders := defaults.CredProviders(defaults.Config(), defaults.Handlers()) - if isExternal { - credProviders = append(credProviders[:1], append([]credentials.Provider{providers.NewRotatingSharedCredentialsProvider()}, credProviders[1:]...)...) - } else { - credProviders = append(credProviders, providers.NewRotatingSharedCredentialsProvider()) - } - credentialChain = credentials.NewCredentials(&credentials.ChainProvider{ - VerboseErrors: false, - Providers: credProviders, - }) - mu.Unlock() - - // credentials.Credentials is concurrency-safe, so lock not needed here - v, err := credentialChain.Get() - if err != nil { - logger.Error(fmt.Sprintf("Error getting ECS instance credentials from default chain: %s", err)) - } else { - logger.Info(fmt.Sprintf("Successfully got ECS instance credentials from provider: %s", v.ProviderName)) - } - return credentialChain -} diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/httpclient/httpclient.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/httpclient/httpclient.go deleted file mode 100644 index 08b33e63ef5..00000000000 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/httpclient/httpclient.go +++ /dev/null @@ -1,101 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -// Package httpclient provides a thin, but testable, wrapper around http.Client. -// It adds an ECS header to requests and provides an interface -package httpclient - -import ( - "crypto/tls" - "fmt" - "net" - "net/http" - "time" - - "github.com/aws/amazon-ecs-agent/ecs-agent/utils/cipher" - "github.com/aws/amazon-ecs-agent/ecs-agent/utils/httpproxy" -) - -// Below constants taken from the default http.Client behavior. -// Ref: https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/custom-http.html -const ( - defaultDialTimeout = 30 * time.Second - defaultDialKeepalive = 30 * time.Second - defaultTLSHandshakeTimeout = 10 * time.Second -) - -//go:generate mockgen -destination=mock/$GOFILE -copyright_file=../../scripts/copyright_file net/http RoundTripper - -type ecsRoundTripper struct { - insecureSkipVerify bool - agentVersion string - osType string - transport http.RoundTripper -} - -func (client *ecsRoundTripper) userAgent() string { - return fmt.Sprintf("%s (%s) (+http://aws.amazon.com/ecs/)", client.agentVersion, client.osType) -} - -func (client *ecsRoundTripper) RoundTrip(req *http.Request) (*http.Response, error) { - req.Header.Set("User-Agent", client.userAgent()) - return client.transport.RoundTrip(req) -} - -func (client *ecsRoundTripper) CancelRequest(req *http.Request) { - if def, ok := client.transport.(*http.Transport); ok { - def.CancelRequest(req) - } -} - -// New returns an ECS httpClient with a roundtrip timeout of the given duration -func New(timeout time.Duration, insecureSkipVerify bool, agentVersion string, osType string) *http.Client { - // Transport is the transport requests will be made over - // Note, these defaults are taken from the golang http library. We do not - // explicitly do not use theirs to avoid changing their behavior. - transport := &http.Transport{ - Proxy: httpproxy.Proxy, - DialContext: (&net.Dialer{ - Timeout: defaultDialTimeout, - KeepAlive: defaultDialKeepalive, - }).DialContext, - TLSHandshakeTimeout: defaultTLSHandshakeTimeout, - } - transport.TLSClientConfig = &tls.Config{} - cipher.WithSupportedCipherSuites(transport.TLSClientConfig) - transport.TLSClientConfig.InsecureSkipVerify = insecureSkipVerify - - client := &http.Client{ - Transport: &ecsRoundTripper{ - insecureSkipVerify: insecureSkipVerify, - agentVersion: agentVersion, - osType: osType, - transport: transport, - }, - Timeout: timeout, - } - - return client -} - -// OverridableTransport is a transport that provides an override for testing purposes. -type OverridableTransport interface { - SetTransport(http.RoundTripper) -} - -// SetTransport allows you to set the transport. It is exposed so tests may -// override it. It fulfills an interface to allow calling this function via -// assertion to the exported interface -func (client *ecsRoundTripper) SetTransport(transport http.RoundTripper) { - client.transport = transport -} diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/logger/field/constants.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/logger/field/constants.go index ed3f732fc4f..b3ae496ac64 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/logger/field/constants.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/logger/field/constants.go @@ -40,9 +40,6 @@ const ( ServiceName = "ServiceName" TaskProtection = "TaskProtection" ImageID = "imageID" - ImageName = "imageName" - ImageRef = "imageRef" - ImageTARPath = "imageTARPath" ImageNames = "imageNames" ImageSizeBytes = "imageSizeBytes" ImagePulledAt = "imagePulledAt" diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/eniattachment.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/eniattachment.go index 3ff374e4e7a..347f0714968 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/eniattachment.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/eniattachment.go @@ -18,7 +18,7 @@ import ( "sync" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/arn" @@ -36,7 +36,7 @@ const ( // ENIAttachment contains the information of the eni attachment type ENIAttachment struct { - attachment.AttachmentInfo + attachmentinfo.AttachmentInfo // AttachmentType is the type of the eni attachment, can either be "task-eni" or "instance-eni" AttachmentType string `json:"attachmentType"` // MACAddress is the mac address of eni @@ -117,13 +117,6 @@ func (eni *ENIAttachment) IsSent() bool { return eni.AttachStatusSent } -// SetAttachedStatus marks the eni status as attached -func (eni *ENIAttachment) SetAttachedStatus() { - eni.guard.Lock() - defer eni.guard.Unlock() - eni.Status = attachment.AttachmentAttached -} - // SetSentStatus marks the eni attached status has been sent func (eni *ENIAttachment) SetSentStatus() { eni.guard.Lock() @@ -157,18 +150,6 @@ func (eni *ENIAttachment) String() string { return eni.stringUnsafe() } -func (eni *ENIAttachment) GetAttachmentARN() string { - eni.guard.RLock() - defer eni.guard.RUnlock() - return eni.AttachmentARN -} - -func (eni *ENIAttachment) GetAttachmentStatus() attachment.AttachmentStatus { - eni.guard.RLock() - defer eni.guard.RUnlock() - return eni.Status -} - // stringUnsafe returns a string representation of the ENI Attachment func (eni *ENIAttachment) stringUnsafe() string { // skip TaskArn field for instance level eni attachment since it won't have a task arn @@ -182,23 +163,3 @@ func (eni *ENIAttachment) stringUnsafe() string { "ENI Attachment: task=%s attachment=%s attachmentType=%s attachmentSent=%t mac=%s status=%s expiresAt=%s", eni.TaskARN, eni.AttachmentARN, eni.AttachmentType, eni.AttachStatusSent, eni.MACAddress, eni.Status.String(), eni.ExpiresAt.Format(time.RFC3339)) } - -func (eni *ENIAttachment) GetAttachmentType() string { - eni.guard.RLock() - defer eni.guard.RUnlock() - - return eni.AttachmentType -} - -func (eni *ENIAttachment) ShouldAttach() bool { - eni.guard.RLock() - defer eni.guard.RUnlock() - return !(eni.Status == attachment.AttachmentAttached) && !eni.AttachStatusSent && !(time.Now().After(eni.ExpiresAt)) -} - -// should notify when attached, and not sent/not expired -func (eni *ENIAttachment) ShouldNotify() bool { - eni.guard.RLock() - defer eni.guard.RUnlock() - return !eni.AttachStatusSent && !(time.Now().After(eni.ExpiresAt)) -} diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/networkinterface.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/networkinterface.go index 3ed4a1da313..72667e7d03b 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/networkinterface.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/networkinterface.go @@ -24,8 +24,6 @@ import ( "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" loggerfield "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/status" - "github.com/aws/aws-sdk-go/aws" "github.com/pkg/errors" ) @@ -55,13 +53,15 @@ type NetworkInterface struct { // InterfaceAssociationProtocol is the type of NetworkInterface, valid value: "default", "vlan" InterfaceAssociationProtocol string `json:",omitempty"` - Index int64 `json:"Index,omitempty"` - UserID uint32 `json:"UserID,omitempty"` - Name string `json:"Name,omitempty"` - DeviceName string `json:"DeviceName,omitempty"` - GuestNetNSName string `json:"GuestNetNSName,omitempty"` - KnownStatus status.NetworkStatus `json:"KnownStatus,omitempty"` - DesiredStatus status.NetworkStatus `json:"DesiredStatus,omitempty"` + Index int64 `json:"Index,omitempty"` + UserID uint32 `json:"UserID,omitempty"` + Name string `json:"Name,omitempty"` + NetNSName string `json:"NetNSName,omitempty"` + NetNSPath string `json:"NetNSPath,omitempty"` + DeviceName string `json:"DeviceName,omitempty"` + GuestNetNSName string `json:"GuestNetNSName,omitempty"` + KnownStatus Status `json:"KnownStatus,omitempty"` + DesiredStatus Status `json:"DesiredStatus,omitempty"` // InterfaceVlanProperties contains information for an interface // that is supposed to be used as a VLAN device @@ -84,10 +84,6 @@ type NetworkInterface struct { ipv4SubnetCIDRBlock string ipv6SubnetCIDRBlock string - // Default denotes whether the interface is responsible - // for handling default route within the netns it resides in. - Default bool - // guard protects access to fields of this struct. guard sync.RWMutex } @@ -372,8 +368,8 @@ type IPV6Address struct { Address string } -// InterfaceFromACS validates the given ACS NetworkInterface information and creates an NetworkInterface object from it. -func InterfaceFromACS(acsENI *ecsacs.ElasticNetworkInterface) (*NetworkInterface, error) { +// ENIFromACS validates the given ACS NetworkInterface information and creates an NetworkInterface object from it. +func ENIFromACS(acsENI *ecsacs.ElasticNetworkInterface) (*NetworkInterface, error) { err := ValidateENI(acsENI) if err != nil { return nil, err @@ -397,6 +393,14 @@ func InterfaceFromACS(acsENI *ecsacs.ElasticNetworkInterface) (*NetworkInterface }) } + // Read NetworkInterface association properties. + var interfaceVlanProperties InterfaceVlanProperties + + if aws.StringValue(acsENI.InterfaceAssociationProtocol) == VLANInterfaceAssociationProtocol { + interfaceVlanProperties.TrunkInterfaceMacAddress = aws.StringValue(acsENI.InterfaceVlanProperties.TrunkInterfaceMacAddress) + interfaceVlanProperties.VlanID = aws.StringValue(acsENI.InterfaceVlanProperties.VlanId) + } + ni := &NetworkInterface{ ID: aws.StringValue(acsENI.Ec2Id), MacAddress: aws.StringValue(acsENI.MacAddress), @@ -405,14 +409,7 @@ func InterfaceFromACS(acsENI *ecsacs.ElasticNetworkInterface) (*NetworkInterface SubnetGatewayIPV4Address: aws.StringValue(acsENI.SubnetGatewayIpv4Address), PrivateDNSName: aws.StringValue(acsENI.PrivateDnsName), InterfaceAssociationProtocol: aws.StringValue(acsENI.InterfaceAssociationProtocol), - } - - // Read NetworkInterface association properties. - if aws.StringValue(acsENI.InterfaceAssociationProtocol) == VLANInterfaceAssociationProtocol { - var interfaceVlanProperties InterfaceVlanProperties - interfaceVlanProperties.TrunkInterfaceMacAddress = aws.StringValue(acsENI.InterfaceVlanProperties.TrunkInterfaceMacAddress) - interfaceVlanProperties.VlanID = aws.StringValue(acsENI.InterfaceVlanProperties.VlanId) - ni.InterfaceVlanProperties = &interfaceVlanProperties + InterfaceVlanProperties: &interfaceVlanProperties, } for _, nameserverIP := range acsENI.DomainNameServers { @@ -473,6 +470,8 @@ func ValidateENI(acsENI *ecsacs.ElasticNetworkInterface) error { // New creates a new NetworkInterface model. func New( acsENI *ecsacs.ElasticNetworkInterface, + netNSName string, + netNSPath string, guestNetNSName string, peerInterface *ecsacs.ElasticNetworkInterface, ) (*NetworkInterface, error) { @@ -502,9 +501,9 @@ func New( // by the common NetworkInterface handler. default: // Acquire the NetworkInterface information from the payload. - networkInterface, err = InterfaceFromACS(acsENI) + networkInterface, err = ENIFromACS(acsENI) if err != nil { - return nil, errors.Wrap(err, "failed to unmarshal interface model") + return nil, errors.Wrap(err, "failed to unmarshal eni") } // Historically, if there is no interface association protocol in the NetworkInterface payload, we assume @@ -515,9 +514,11 @@ func New( } networkInterface.Index = aws.Int64Value(acsENI.Index) - networkInterface.Name = GetInterfaceName(acsENI) - networkInterface.KnownStatus = status.NetworkNone - networkInterface.DesiredStatus = status.NetworkReadyPull + networkInterface.Name = GetENIName(acsENI) + networkInterface.KnownStatus = StatusNone + networkInterface.DesiredStatus = StatusReadyPull + networkInterface.NetNSName = netNSName + networkInterface.NetNSPath = netNSPath networkInterface.GuestNetNSName = guestNetNSName return networkInterface, nil @@ -568,11 +569,11 @@ func (ni *NetworkInterface) IsPrimary() bool { // it was decided that for firecracker platform the files had to be generated for secondary ENIs as well. // Hence the NetworkInterface IsPrimary check was moved from here to warmpool specific APIs. func (ni *NetworkInterface) ShouldGenerateNetworkConfigFiles() bool { - return ni.DesiredStatus == status.NetworkReadyPull + return ni.DesiredStatus == StatusReadyPull } -// GetInterfaceName creates the NetworkInterface name from the NetworkInterface mac address in case it is empty in the ACS payload. -func GetInterfaceName(acsENI *ecsacs.ElasticNetworkInterface) string { +// GetENIName creates the NetworkInterface name from the NetworkInterface mac address in case it is empty in the ACS payload. +func GetENIName(acsENI *ecsacs.ElasticNetworkInterface) string { if acsENI.Name != nil { return aws.StringValue(acsENI.Name) } @@ -644,8 +645,3 @@ func vethPairFromACS( }, nil } - -// NetNSName returns the netns name that the specified network interface will be attached to in a desired task. -func NetNSName(taskID, eniName string) string { - return fmt.Sprintf("%s-%s", taskID, eniName) -} diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/networkinterface_status.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/networkinterface_status.go new file mode 100644 index 00000000000..6b10dde38e5 --- /dev/null +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface/networkinterface_status.go @@ -0,0 +1,42 @@ +package networkinterface + +// Status represents the status of an ENI resource. +type Status string + +const ( + // StatusNone is the initial staus of the ENI. + StatusNone Status = "NONE" + // StatusReadyPull indicates that the ENI is ready for downloading resources associated with + // the execution role. This includes container images, task secrets and configs. + StatusReadyPull Status = "READY_PULL" + // StatusReady indicates that the ENI is ready for use by containers in the task. + StatusReady Status = "READY" + // StatusDeleted indicates that the ENI is deleted. + StatusDeleted Status = "DELETED" +) + +var ( + eniStatusOrder = map[Status]int{ + StatusNone: 0, + StatusReadyPull: 1, + StatusReady: 2, + StatusDeleted: 3, + } +) + +func (es Status) String() string { + return string(es) +} + +func (es Status) StatusBackwards(es2 Status) bool { + return eniStatusOrder[es] < eniStatusOrder[es2] +} + +func GetAllStatuses() []Status { + return []Status{ + StatusNone, + StatusReadyPull, + StatusReady, + StatusDeleted, + } +} diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/status/network_status.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/status/network_status.go deleted file mode 100644 index b6fdb9d2d84..00000000000 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/status/network_status.go +++ /dev/null @@ -1,42 +0,0 @@ -package status - -// NetworkStatus represents the status of a network resource. -type NetworkStatus string - -const ( - // NetworkNone is the initial status of the ENI. - NetworkNone NetworkStatus = "NONE" - // NetworkReadyPull indicates that the ENI is ready for downloading resources associated with - // the execution role. This includes container images, task secrets and configs. - NetworkReadyPull NetworkStatus = "READY_PULL" - // NetworkReady indicates that the ENI is ready for use by containers in the task. - NetworkReady NetworkStatus = "READY" - // NetworkDeleted indicates that the ENI is deleted. - NetworkDeleted NetworkStatus = "DELETED" -) - -var ( - eniStatusOrder = map[NetworkStatus]int{ - NetworkNone: 0, - NetworkReadyPull: 1, - NetworkReady: 2, - NetworkDeleted: 3, - } -) - -func (es NetworkStatus) String() string { - return string(es) -} - -func (es NetworkStatus) ENIStatusBackwards(es2 NetworkStatus) bool { - return eniStatusOrder[es] < eniStatusOrder[es2] -} - -func GetAllENIStatuses() []NetworkStatus { - return []NetworkStatus{ - NetworkNone, - NetworkReadyPull, - NetworkReady, - NetworkDeleted, - } -} diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/utils/utils.go b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/utils/utils.go index fa4581a5d30..7ac89d29750 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/utils/utils.go +++ b/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/utils/utils.go @@ -12,10 +12,7 @@ // permissions and limitations under the License. package utils -import ( - "reflect" - "strconv" -) +import "reflect" func ZeroOrNil(obj interface{}) bool { value := reflect.ValueOf(obj) @@ -38,14 +35,3 @@ func ZeroOrNil(obj interface{}) bool { } return false } - -// Uint16SliceToStringSlice converts a slice of type uint16 to a slice of type -// *string. It uses strconv.Itoa on each element -func Uint16SliceToStringSlice(slice []uint16) []*string { - stringSlice := make([]*string, len(slice)) - for i, el := range slice { - str := strconv.Itoa(int(el)) - stringSlice[i] = &str - } - return stringSlice -} diff --git a/agent/vendor/modules.txt b/agent/vendor/modules.txt index 2c33830c005..a8b513d8fd6 100644 --- a/agent/vendor/modules.txt +++ b/agent/vendor/modules.txt @@ -12,28 +12,26 @@ github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/testconst github.com/aws/amazon-ecs-agent/ecs-agent/api github.com/aws/amazon-ecs-agent/ecs-agent/api/appnet github.com/aws/amazon-ecs-agent/ecs-agent/api/appnet/mocks -github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment -github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource -github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/mocks +github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status +github.com/aws/amazon-ecs-agent/ecs-agent/api/eni github.com/aws/amazon-ecs-agent/ecs-agent/api/errors github.com/aws/amazon-ecs-agent/ecs-agent/api/mocks +github.com/aws/amazon-ecs-agent/ecs-agent/api/resource +github.com/aws/amazon-ecs-agent/ecs-agent/api/resource/mocks +github.com/aws/amazon-ecs-agent/ecs-agent/api/status github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status github.com/aws/amazon-ecs-agent/ecs-agent/async github.com/aws/amazon-ecs-agent/ecs-agent/async/mocks github.com/aws/amazon-ecs-agent/ecs-agent/config github.com/aws/amazon-ecs-agent/ecs-agent/credentials -github.com/aws/amazon-ecs-agent/ecs-agent/credentials/instancecreds github.com/aws/amazon-ecs-agent/ecs-agent/credentials/mocks -github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers github.com/aws/amazon-ecs-agent/ecs-agent/csiclient github.com/aws/amazon-ecs-agent/ecs-agent/csiclient/mocks github.com/aws/amazon-ecs-agent/ecs-agent/data github.com/aws/amazon-ecs-agent/ecs-agent/doctor github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs github.com/aws/amazon-ecs-agent/ecs-agent/eventstream -github.com/aws/amazon-ecs-agent/ecs-agent/httpclient -github.com/aws/amazon-ecs-agent/ecs-agent/httpclient/mock github.com/aws/amazon-ecs-agent/ecs-agent/logger github.com/aws/amazon-ecs-agent/ecs-agent/logger/audit github.com/aws/amazon-ecs-agent/ecs-agent/logger/audit/mocks @@ -44,7 +42,6 @@ github.com/aws/amazon-ecs-agent/ecs-agent/metrics github.com/aws/amazon-ecs-agent/ecs-agent/modeltransformer github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/appmesh github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface -github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/status github.com/aws/amazon-ecs-agent/ecs-agent/stats github.com/aws/amazon-ecs-agent/ecs-agent/tcs/client github.com/aws/amazon-ecs-agent/ecs-agent/tcs/handler diff --git a/ecs-agent/acs/session/attach_instance_eni_responder.go b/ecs-agent/acs/session/attach_instance_eni_responder.go index fbbc3730d79..e23fb144092 100644 --- a/ecs-agent/acs/session/attach_instance_eni_responder.go +++ b/ecs-agent/acs/session/attach_instance_eni_responder.go @@ -21,7 +21,8 @@ import ( "github.com/pkg/errors" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" @@ -98,9 +99,9 @@ func (r *attachInstanceENIResponder) handleInstanceENIFromMessage(eni *ecsacs.El messageID, clusterARN, containerInstanceARN string, receivedAt time.Time, waitTimeoutMs int64) { expiresAt := receivedAt.Add(time.Duration(waitTimeoutMs) * time.Millisecond) err := r.eniHandler.HandleENIAttachment(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: aws.StringValue(eni.AttachmentArn), - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: expiresAt, AttachStatusSent: false, ClusterARN: clusterARN, diff --git a/ecs-agent/acs/session/attach_resource_responder.go b/ecs-agent/acs/session/attach_resource_responder.go index 29b3c8a3c5b..2045de56d7a 100644 --- a/ecs-agent/acs/session/attach_resource_responder.go +++ b/ecs-agent/acs/session/attach_resource_responder.go @@ -18,8 +18,9 @@ import ( "time" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" "github.com/aws/amazon-ecs-agent/ecs-agent/metrics" @@ -91,14 +92,14 @@ func (r *attachResourceResponder) handleAttachMessage(message *ecsacs.ConfirmAtt }) expiresAt := receivedAt.Add(time.Duration(waitTimeoutMs) * time.Millisecond) go r.resourceHandler.HandleResourceAttachment(&resource.ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: aws.StringValue(message.TaskArn), TaskClusterARN: aws.StringValue(message.TaskClusterArn), ClusterARN: aws.StringValue(message.ClusterArn), ContainerInstanceARN: aws.StringValue(message.ContainerInstanceArn), ExpiresAt: expiresAt, AttachmentARN: aws.StringValue(message.Attachment.AttachmentArn), - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, }, AttachmentProperties: attachmentProperties, AttachmentType: aws.StringValue(message.Attachment.AttachmentType), diff --git a/ecs-agent/acs/session/attach_resource_responder_test.go b/ecs-agent/acs/session/attach_resource_responder_test.go index 4a7fff2972a..5fe331581c4 100644 --- a/ecs-agent/acs/session/attach_resource_responder_test.go +++ b/ecs-agent/acs/session/attach_resource_responder_test.go @@ -29,7 +29,7 @@ import ( "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/session/testconst" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" ) const ( diff --git a/ecs-agent/acs/session/attach_task_eni_responder.go b/ecs-agent/acs/session/attach_task_eni_responder.go index 389d6f72fa5..ba226aea08d 100644 --- a/ecs-agent/acs/session/attach_task_eni_responder.go +++ b/ecs-agent/acs/session/attach_task_eni_responder.go @@ -21,7 +21,8 @@ import ( "github.com/pkg/errors" "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" @@ -99,10 +100,10 @@ func (r *attachTaskENIResponder) handleTaskENIFromMessage(eni *ecsacs.ElasticNet messageID, taskARN, clusterARN, containerInstanceARN string, receivedAt time.Time, waitTimeoutMs int64) { expiresAt := receivedAt.Add(time.Duration(waitTimeoutMs) * time.Millisecond) err := r.eniHandler.HandleENIAttachment(&ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: aws.StringValue(eni.AttachmentArn), - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: expiresAt, AttachStatusSent: false, ClusterARN: clusterARN, diff --git a/ecs-agent/acs/session/mocks/session_mock.go b/ecs-agent/acs/session/mocks/session_mock.go index 0b2a7756a9b..54bd2104409 100644 --- a/ecs-agent/acs/session/mocks/session_mock.go +++ b/ecs-agent/acs/session/mocks/session_mock.go @@ -22,7 +22,7 @@ import ( reflect "reflect" ecsacs "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - resource "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource" + resource "github.com/aws/amazon-ecs-agent/ecs-agent/api/resource" networkinterface "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" gomock "github.com/golang/mock/gomock" ) diff --git a/ecs-agent/api/attachment/attachment.go b/ecs-agent/api/attachment/attachment.go deleted file mode 100644 index 54384b7dfe8..00000000000 --- a/ecs-agent/api/attachment/attachment.go +++ /dev/null @@ -1,29 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package attachment - -type Attachment interface { - GetAttachmentARN() string - GetAttachmentStatus() AttachmentStatus - GetAttachmentType() string - HasExpired() bool - IsSent() bool - SetAttachedStatus() - SetSentStatus() - ShouldAttach() bool - ShouldNotify() bool - StartTimer(func()) error - StopAckTimer() - String() string -} diff --git a/ecs-agent/api/attachment/resource/ebs_discovery_linux_test.go b/ecs-agent/api/attachment/resource/ebs_discovery_linux_test.go deleted file mode 100644 index 14e1f00aef1..00000000000 --- a/ecs-agent/api/attachment/resource/ebs_discovery_linux_test.go +++ /dev/null @@ -1,201 +0,0 @@ -//go:build linux && unit -// +build linux,unit - -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package resource - -import ( - "context" - "fmt" - "testing" - - "github.com/stretchr/testify/assert" -) - -func TestParseLsblkOutput(t *testing.T) { - mkError := func(deviceName string, volumeId string) string { - return fmt.Sprintf("cannot find EBS volume with device name: %v and volume ID: %v", - deviceName, volumeId) - } - - tcs := []struct { - name string - lsblkOutput LsblkOutput - deviceName string - volumeId string - hasXenSupport bool - expectedActualDeviceName string - expectedError string - }{ - { - name: "nitro device found with the same name", - lsblkOutput: LsblkOutput{[]BlockDevice{ - {Name: "mydevice", Serial: "myvolumeid"}, - }}, - deviceName: "/dev/mydevice", - volumeId: "myvolumeid", - expectedActualDeviceName: "mydevice", - }, - { - name: "nitro device found with another name", - lsblkOutput: LsblkOutput{[]BlockDevice{ - {Name: "mydevice", Serial: "myvolumeid"}, - }}, - deviceName: "/dev/otherdevice", - volumeId: "myvolumeid", - expectedActualDeviceName: "mydevice", - }, - { - name: "nitro device found with another name multiple devices", - lsblkOutput: LsblkOutput{[]BlockDevice{ - {Name: "mydevice2", Serial: "myvolumeid2"}, - {Name: "mydevice", Serial: "myvolumeid"}, - }}, - deviceName: "/dev/otherdevice", - volumeId: "myvolumeid", - expectedActualDeviceName: "mydevice", - }, - { - name: "nitro device not found", - lsblkOutput: LsblkOutput{[]BlockDevice{ - {Name: "mydevice", Serial: "myvolumeid"}, - }}, - deviceName: "/dev/mydevice", - volumeId: "othervolumeid", - expectedError: mkError("mydevice", "othervolumeid"), - }, - { - name: "xen received sd found sd", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "sddevice"}}}, - deviceName: "/dev/sddevice", - volumeId: "volumeid", - hasXenSupport: true, - expectedActualDeviceName: "sddevice", - }, - { - name: "xen received xvd found xvd", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "xvddevice"}}}, - deviceName: "/dev/xvddevice", - volumeId: "volumeid", - hasXenSupport: true, - expectedActualDeviceName: "xvddevice", - }, - { - name: "xen received sd found xvd", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "xvddevice"}}}, - deviceName: "/dev/sddevice", - volumeId: "volumeid", - hasXenSupport: true, - expectedActualDeviceName: "xvddevice", - }, - { - name: "xen received xvd found sd", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "sddevice"}}}, - deviceName: "/dev/xvddevice", - volumeId: "volumeid", - hasXenSupport: true, - expectedActualDeviceName: "sddevice", - }, - { - name: "xen device not found", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "sda"}}}, - deviceName: "/dev/xvdb", - volumeId: "volumeid", - hasXenSupport: true, - expectedError: mkError("xvdb", "volumeid"), - }, - { - name: "xen received sda shouldn't match with found a", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "a"}}}, - deviceName: "/dev/sda", - volumeId: "volumeid", - hasXenSupport: true, - expectedError: mkError("sda", "volumeid"), - }, - { - name: "xen received xvda shouldn't match with found a", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "a"}}}, - deviceName: "/dev/xvda", - volumeId: "volumeid", - hasXenSupport: true, - expectedError: mkError("xvda", "volumeid"), - }, - { - name: "xen received a shouldn't match with found sda", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "sda"}}}, - deviceName: "/dev/a", - volumeId: "volumeid", - hasXenSupport: true, - expectedError: mkError("a", "volumeid"), - }, - { - name: "xen received a shouldn't match with found xvda", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "xvda"}}}, - deviceName: "/dev/a", - volumeId: "volumeid", - hasXenSupport: true, - expectedError: mkError("a", "volumeid"), - }, - { - name: "xen received abc should match with found abc", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "abc"}}}, - deviceName: "/dev/abc", - volumeId: "volumeid", - hasXenSupport: true, - expectedActualDeviceName: "abc", - }, - { - name: "xen received abc shouldn't match with found xyz", - lsblkOutput: LsblkOutput{[]BlockDevice{{Name: "xyz"}}}, - deviceName: "/dev/abc", - volumeId: "volumeid", - hasXenSupport: true, - expectedError: mkError("abc", "volumeid"), - }, - { - name: "xen received xvd found sd multiple devices", - lsblkOutput: LsblkOutput{[]BlockDevice{ - {Name: "some_other_device"}, - {Name: "sddevice"}, - }}, - deviceName: "/dev/xvddevice", - volumeId: "volumeid", - hasXenSupport: true, - expectedActualDeviceName: "sddevice", - }, - } - - for _, tc := range tcs { - t.Run(tc.name, func(t *testing.T) { - actualDeviceName, err := parseLsblkOutput( - &tc.lsblkOutput, tc.deviceName, tc.volumeId, tc.hasXenSupport) - if tc.expectedError == "" { - assert.NoError(t, err) - assert.Equal(t, tc.expectedActualDeviceName, actualDeviceName) - } else { - assert.EqualError(t, err, tc.expectedError) - } - }) - } -} - -func TestWithXenSupport(t *testing.T) { - t.Run("no xen support by default", func(t *testing.T) { - assert.False(t, NewDiscoveryClient(context.Background()).HasXenSupport()) - }) - t.Run("with xen support", func(t *testing.T) { - assert.True(t, NewDiscoveryClient(context.Background(), WithXenSupport()).HasXenSupport()) - }) -} diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/attachment_info.go b/ecs-agent/api/attachmentinfo/attachment_info.go similarity index 92% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/attachment_info.go rename to ecs-agent/api/attachmentinfo/attachment_info.go index 8b2d1e956ec..6f929c246e8 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/attachment_info.go +++ b/ecs-agent/api/attachmentinfo/attachment_info.go @@ -11,10 +11,12 @@ // express or implied. See the License for the specific language governing // permissions and limitations under the License. -package attachment +package attachmentinfo import ( "time" + + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" ) type AttachmentInfo struct { @@ -23,7 +25,7 @@ type AttachmentInfo struct { // AttachmentARN is the identifier for the attachment AttachmentARN string `json:"attachmentArn"` // Status is the status of the attachment: none/attached/detached - Status AttachmentStatus `json:"status"` + Status status.AttachmentStatus `json:"status"` // ExpiresAt is the timestamp past which the attachment is considered // unsuccessful. The SubmitTaskStateChange API, with the attachment information // should be invoked before this timestamp. diff --git a/ecs-agent/api/ecs/statechange/statechange_test.go b/ecs-agent/api/ecs/statechange/statechange_test.go index 1e5299dcbd3..2b28600d9e7 100644 --- a/ecs-agent/api/ecs/statechange/statechange_test.go +++ b/ecs-agent/api/ecs/statechange/statechange_test.go @@ -22,9 +22,10 @@ import ( "testing" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" apicontainerstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/container/status" mock_statechange "github.com/aws/amazon-ecs-agent/ecs-agent/api/ecs/statechange/mocks" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" apitaskstatus "github.com/aws/amazon-ecs-agent/ecs-agent/api/task/status" "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" @@ -105,7 +106,7 @@ func TestTaskStateChangeString(t *testing.T) { TaskARN: taskArn, Status: apitaskstatus.TaskRunning, Attachment: &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: attachmentArn, }, }, @@ -147,9 +148,9 @@ func TestTaskStateChangeString(t *testing.T) { func TestAttachmentStateChangeString(t *testing.T) { change := &AttachmentStateChange{ Attachment: &ni.ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ AttachmentARN: attachmentArn, - Status: attachment.AttachmentAttached, + Status: status.AttachmentAttached, TaskARN: taskArn, AttachStatusSent: true, ExpiresAt: dummyTime, diff --git a/ecs-agent/api/eni/eni.go b/ecs-agent/api/eni/eni.go new file mode 100644 index 00000000000..21cef1748c8 --- /dev/null +++ b/ecs-agent/api/eni/eni.go @@ -0,0 +1,386 @@ +// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"). You may +// not use this file except in compliance with the License. A copy of the +// License is located at +// +// http://aws.amazon.com/apache2.0/ +// +// or in the "license" file accompanying this file. This file is distributed +// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either +// express or implied. See the License for the specific language governing +// permissions and limitations under the License. + +package eni + +import ( + "fmt" + "net" + "strings" + "sync" + + "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" + "github.com/aws/amazon-ecs-agent/ecs-agent/logger" + loggerfield "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" + "github.com/aws/aws-sdk-go/aws" + "github.com/pkg/errors" +) + +// ENI contains information of the eni +type ENI struct { + // ID is the id of eni + ID string `json:"ec2Id"` + // LinkName is the name of the ENI on the instance. + // Currently, this field is being used only for Windows and is used during task networking setup. + LinkName string + // MacAddress is the mac address of the eni + MacAddress string + // IPV4Addresses is the ipv4 address associated with the eni + IPV4Addresses []*ENIIPV4Address + // IPV6Addresses is the ipv6 address associated with the eni + IPV6Addresses []*ENIIPV6Address + // SubnetGatewayIPV4Address is the IPv4 address of the subnet gateway of the ENI + SubnetGatewayIPV4Address string `json:",omitempty"` + // DomainNameServers specifies the nameserver IP addresses for the eni + DomainNameServers []string `json:",omitempty"` + // DomainNameSearchList specifies the search list for the domain + // name lookup, for the eni + DomainNameSearchList []string `json:",omitempty"` + // PrivateDNSName is the dns name assigned by the vpc to this eni + PrivateDNSName string `json:",omitempty"` + // InterfaceAssociationProtocol is the type of ENI, valid value: "default", "vlan" + InterfaceAssociationProtocol string `json:",omitempty"` + // InterfaceVlanProperties contains information for an interface + // that is supposed to be used as a VLAN device + InterfaceVlanProperties *InterfaceVlanProperties `json:",omitempty"` + + // Due to historical reasons, the IPv4 subnet prefix length is sent with IPv4 subnet gateway + // address instead of the ENI's IP addresses. However, CNI plugins and many OS APIs expect it + // the other way around. Instead of doing this conversion all the time for each CNI and TMDS + // request, compute it once on demand and cache it here. + ipv4SubnetPrefixLength string + ipv4SubnetCIDRBlock string + ipv6SubnetCIDRBlock string + + // guard protects access to fields of this struct. + guard sync.RWMutex +} + +// InterfaceVlanProperties contains information for an interface that +// is supposed to be used as a VLAN device +type InterfaceVlanProperties struct { + VlanID string + TrunkInterfaceMacAddress string +} + +const ( + // DefaultInterfaceAssociationProtocol represents the standard ENI type. + DefaultInterfaceAssociationProtocol = "default" + + // VLANInterfaceAssociationProtocol represents the ENI with trunking enabled. + VLANInterfaceAssociationProtocol = "vlan" + + // IPv6SubnetPrefixLength is the IPv6 global unicast address prefix length, consisting of + // global routing prefix and subnet ID lengths as specified in IPv6 addressing architecture + // (RFC 4291 section 2.5.4) and IPv6 Global Unicast Address Format (RFC 3587). + // The ACS ENI payload structure does not contain an IPv6 subnet prefix length because "/64" is + // the only allowed length per RFCs above, and the only one that VPC supports. + IPv6SubnetPrefixLength = "64" +) + +var ( + // netInterfaces is the Interfaces() method of net package. + netInterfaces = net.Interfaces +) + +// GetIPV4Addresses returns the list of IPv4 addresses assigned to the ENI. +func (eni *ENI) GetIPV4Addresses() []string { + var addresses []string + for _, addr := range eni.IPV4Addresses { + addresses = append(addresses, addr.Address) + } + + return addresses +} + +// GetIPV6Addresses returns the list of IPv6 addresses assigned to the ENI. +func (eni *ENI) GetIPV6Addresses() []string { + var addresses []string + for _, addr := range eni.IPV6Addresses { + addresses = append(addresses, addr.Address) + } + + return addresses +} + +// GetPrimaryIPv4Address returns the primary IPv4 address assigned to the ENI. +func (eni *ENI) GetPrimaryIPv4Address() string { + var primaryAddr string + for _, addr := range eni.IPV4Addresses { + if addr.Primary { + primaryAddr = addr.Address + break + } + } + + return primaryAddr +} + +// GetPrimaryIPv4AddressWithPrefixLength returns the primary IPv4 address assigned to the ENI with +// its subnet prefix length. +func (eni *ENI) GetPrimaryIPv4AddressWithPrefixLength() string { + return eni.GetPrimaryIPv4Address() + "/" + eni.GetIPv4SubnetPrefixLength() +} + +// GetIPAddressesWithPrefixLength returns the list of all IP addresses assigned to the ENI with +// their subnet prefix length. +func (eni *ENI) GetIPAddressesWithPrefixLength() []string { + var addresses []string + for _, addr := range eni.IPV4Addresses { + addresses = append(addresses, addr.Address+"/"+eni.GetIPv4SubnetPrefixLength()) + } + for _, addr := range eni.IPV6Addresses { + addresses = append(addresses, addr.Address+"/"+IPv6SubnetPrefixLength) + } + + return addresses +} + +// GetIPv4SubnetPrefixLength returns the IPv4 prefix length of the ENI's subnet. +func (eni *ENI) GetIPv4SubnetPrefixLength() string { + if eni.ipv4SubnetPrefixLength == "" && eni.SubnetGatewayIPV4Address != "" { + eni.ipv4SubnetPrefixLength = strings.Split(eni.SubnetGatewayIPV4Address, "/")[1] + } + + return eni.ipv4SubnetPrefixLength +} + +// GetIPv4SubnetCIDRBlock returns the IPv4 CIDR block, if any, of the ENI's subnet. +func (eni *ENI) GetIPv4SubnetCIDRBlock() string { + if eni.ipv4SubnetCIDRBlock == "" && eni.SubnetGatewayIPV4Address != "" { + _, ipv4Net, err := net.ParseCIDR(eni.SubnetGatewayIPV4Address) + if err == nil { + eni.ipv4SubnetCIDRBlock = ipv4Net.String() + } + } + + return eni.ipv4SubnetCIDRBlock +} + +// GetIPv6SubnetCIDRBlock returns the IPv6 CIDR block, if any, of the ENI's subnet. +func (eni *ENI) GetIPv6SubnetCIDRBlock() string { + if eni.ipv6SubnetCIDRBlock == "" && len(eni.IPV6Addresses) > 0 { + ipv6Addr := eni.IPV6Addresses[0].Address + "/" + IPv6SubnetPrefixLength + _, ipv6Net, err := net.ParseCIDR(ipv6Addr) + if err == nil { + eni.ipv6SubnetCIDRBlock = ipv6Net.String() + } + } + + return eni.ipv6SubnetCIDRBlock +} + +// GetSubnetGatewayIPv4Address returns the subnet gateway IPv4 address for the ENI. +func (eni *ENI) GetSubnetGatewayIPv4Address() string { + var gwAddr string + if eni.SubnetGatewayIPV4Address != "" { + gwAddr = strings.Split(eni.SubnetGatewayIPV4Address, "/")[0] + } + + return gwAddr +} + +// GetHostname returns the hostname assigned to the ENI +func (eni *ENI) GetHostname() string { + return eni.PrivateDNSName +} + +// GetLinkName returns the name of the ENI on the instance. +func (eni *ENI) GetLinkName() string { + eni.guard.Lock() + defer eni.guard.Unlock() + + if eni.LinkName == "" { + // Find all interfaces on the instance. + ifaces, err := netInterfaces() + if err != nil { + logger.Error("Failed to find link name:", logger.Fields{ + loggerfield.Error: err, + }) + return "" + } + // Iterate over the list and find the interface with the ENI's MAC address. + for _, iface := range ifaces { + if strings.EqualFold(eni.MacAddress, iface.HardwareAddr.String()) { + eni.LinkName = iface.Name + break + } + } + // If the ENI is not matched by MAC address above, we will fail to + // assign the LinkName. Log that here since CNI will fail with the empty + // name. + if eni.LinkName == "" { + logger.Error("Failed to find LinkName for given MAC", logger.Fields{ + "mac": eni.MacAddress, + }) + } + } + + return eni.LinkName +} + +// IsStandardENI returns true if the ENI is a standard/regular ENI. That is, if it +// has its association protocol as standard. To be backwards compatible, if the +// association protocol is not set for an ENI, it's considered a standard ENI as well. +func (eni *ENI) IsStandardENI() bool { + switch eni.InterfaceAssociationProtocol { + case "", DefaultInterfaceAssociationProtocol: + return true + case VLANInterfaceAssociationProtocol: + return false + default: + return false + } +} + +// String returns a human readable version of the ENI object +func (eni *ENI) String() string { + var ipv4Addresses []string + for _, addr := range eni.IPV4Addresses { + ipv4Addresses = append(ipv4Addresses, addr.Address) + } + var ipv6Addresses []string + for _, addr := range eni.IPV6Addresses { + ipv6Addresses = append(ipv6Addresses, addr.Address) + } + + eniString := "" + + if len(eni.InterfaceAssociationProtocol) == 0 { + eniString += fmt.Sprintf(" ,ENI type: [%s]", eni.InterfaceAssociationProtocol) + } + + if eni.InterfaceVlanProperties != nil { + eniString += fmt.Sprintf(" ,VLan ID: [%s], TrunkInterfaceMacAddress: [%s]", + eni.InterfaceVlanProperties.VlanID, eni.InterfaceVlanProperties.TrunkInterfaceMacAddress) + } + + return fmt.Sprintf( + "eni id:%s, mac: %s, hostname: %s, ipv4addresses: [%s], ipv6addresses: [%s], dns: [%s], dns search: [%s],"+ + " gateway ipv4: [%s][%s]", eni.ID, eni.MacAddress, eni.GetHostname(), strings.Join(ipv4Addresses, ","), + strings.Join(ipv6Addresses, ","), strings.Join(eni.DomainNameServers, ","), + strings.Join(eni.DomainNameSearchList, ","), eni.SubnetGatewayIPV4Address, eniString) +} + +// ENIIPV4Address is the ipv4 information of the eni +type ENIIPV4Address struct { + // Primary indicates whether the ip address is primary + Primary bool + // Address is the ipv4 address associated with eni + Address string +} + +// ENIIPV6Address is the ipv6 information of the eni +type ENIIPV6Address struct { + // Address is the ipv6 address associated with eni + Address string +} + +// ENIFromACS validates the given ACS ENI information and creates an ENI object from it. +func ENIFromACS(acsENI *ecsacs.ElasticNetworkInterface) (*ENI, error) { + err := ValidateENI(acsENI) + if err != nil { + return nil, err + } + + var ipv4Addrs []*ENIIPV4Address + var ipv6Addrs []*ENIIPV6Address + + // Read IPv4 address information of the ENI. + for _, ec2Ipv4 := range acsENI.Ipv4Addresses { + ipv4Addrs = append(ipv4Addrs, &ENIIPV4Address{ + Primary: aws.BoolValue(ec2Ipv4.Primary), + Address: aws.StringValue(ec2Ipv4.PrivateAddress), + }) + } + + // Read IPv6 address information of the ENI. + for _, ec2Ipv6 := range acsENI.Ipv6Addresses { + ipv6Addrs = append(ipv6Addrs, &ENIIPV6Address{ + Address: aws.StringValue(ec2Ipv6.Address), + }) + } + + // Read ENI association properties. + var interfaceVlanProperties InterfaceVlanProperties + + if aws.StringValue(acsENI.InterfaceAssociationProtocol) == VLANInterfaceAssociationProtocol { + interfaceVlanProperties.TrunkInterfaceMacAddress = aws.StringValue(acsENI.InterfaceVlanProperties.TrunkInterfaceMacAddress) + interfaceVlanProperties.VlanID = aws.StringValue(acsENI.InterfaceVlanProperties.VlanId) + } + + eni := &ENI{ + ID: aws.StringValue(acsENI.Ec2Id), + MacAddress: aws.StringValue(acsENI.MacAddress), + IPV4Addresses: ipv4Addrs, + IPV6Addresses: ipv6Addrs, + SubnetGatewayIPV4Address: aws.StringValue(acsENI.SubnetGatewayIpv4Address), + PrivateDNSName: aws.StringValue(acsENI.PrivateDnsName), + InterfaceAssociationProtocol: aws.StringValue(acsENI.InterfaceAssociationProtocol), + InterfaceVlanProperties: &interfaceVlanProperties, + } + + for _, nameserverIP := range acsENI.DomainNameServers { + eni.DomainNameServers = append(eni.DomainNameServers, aws.StringValue(nameserverIP)) + } + for _, nameserverDomain := range acsENI.DomainName { + eni.DomainNameSearchList = append(eni.DomainNameSearchList, aws.StringValue(nameserverDomain)) + } + + return eni, nil +} + +// ValidateENI validates the ENI information sent from ACS. +func ValidateENI(acsENI *ecsacs.ElasticNetworkInterface) error { + // At least one IPv4 address should be associated with the ENI. + if len(acsENI.Ipv4Addresses) < 1 { + return errors.Errorf("eni message validation: no ipv4 addresses in the message") + } + + if acsENI.SubnetGatewayIpv4Address == nil { + return errors.Errorf("eni message validation: no subnet gateway ipv4 address in the message") + } + gwIPv4Addr := aws.StringValue(acsENI.SubnetGatewayIpv4Address) + s := strings.Split(gwIPv4Addr, "/") + if len(s) != 2 { + return errors.Errorf( + "eni message validation: invalid subnet gateway ipv4 address %s", gwIPv4Addr) + } + + if acsENI.MacAddress == nil { + return errors.Errorf("eni message validation: empty eni mac address in the message") + } + + if acsENI.Ec2Id == nil { + return errors.Errorf("eni message validation: empty eni id in the message") + } + + // The association protocol, if specified, must be a supported value. + if (acsENI.InterfaceAssociationProtocol != nil) && + (aws.StringValue(acsENI.InterfaceAssociationProtocol) != VLANInterfaceAssociationProtocol) && + (aws.StringValue(acsENI.InterfaceAssociationProtocol) != DefaultInterfaceAssociationProtocol) { + return errors.Errorf("invalid interface association protocol: %s", + aws.StringValue(acsENI.InterfaceAssociationProtocol)) + } + + // If the interface association protocol is vlan, InterfaceVlanProperties must be specified. + if aws.StringValue(acsENI.InterfaceAssociationProtocol) == VLANInterfaceAssociationProtocol { + if acsENI.InterfaceVlanProperties == nil || + len(aws.StringValue(acsENI.InterfaceVlanProperties.VlanId)) == 0 || + len(aws.StringValue(acsENI.InterfaceVlanProperties.TrunkInterfaceMacAddress)) == 0 { + return errors.New("vlan interface properties missing") + } + } + + return nil +} diff --git a/ecs-agent/api/attachment/eni/eni_test.go b/ecs-agent/api/eni/eni_test.go similarity index 100% rename from ecs-agent/api/attachment/eni/eni_test.go rename to ecs-agent/api/eni/eni_test.go diff --git a/ecs-agent/api/eni/eniattachment.go b/ecs-agent/api/eni/eniattachment.go new file mode 100644 index 00000000000..8b45d2f75cd --- /dev/null +++ b/ecs-agent/api/eni/eniattachment.go @@ -0,0 +1,166 @@ +// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"). You may +// not use this file except in compliance with the License. A copy of the +// License is located at +// +// http://aws.amazon.com/apache2.0/ +// +// or in the "license" file accompanying this file. This file is distributed +// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either +// express or implied. See the License for the specific language governing +// permissions and limitations under the License. + +package eni + +import ( + "fmt" + "sync" + "time" + + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + + "github.com/aws/amazon-ecs-agent/ecs-agent/logger" + "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" + "github.com/aws/amazon-ecs-agent/ecs-agent/utils/arn" + "github.com/aws/amazon-ecs-agent/ecs-agent/utils/ttime" + + "github.com/pkg/errors" +) + +const ( + // ENIAttachmentTypeTaskENI represents the type of a task level eni + ENIAttachmentTypeTaskENI = "task-eni" + // ENIAttachmentTypeInstanceENI represents the type of an instance level eni + ENIAttachmentTypeInstanceENI = "instance-eni" +) + +// ENIAttachment contains the information of the eni attachment +type ENIAttachment struct { + attachmentinfo.AttachmentInfo + // AttachmentType is the type of the eni attachment, can either be "task-eni" or "instance-eni" + AttachmentType string `json:"attachmentType"` + // MACAddress is the mac address of eni + MACAddress string `json:"macAddress"` + // ackTimer is used to register the expiration timeout callback for unsuccessful + // ENI attachments + ackTimer ttime.Timer + // guard protects access to fields of this struct + guard sync.RWMutex +} + +func getEniAttachmentLogFields(eni *ENIAttachment, duration time.Duration) logger.Fields { + fields := logger.Fields{ + "duration": duration.String(), + "attachmentARN": eni.AttachmentARN, + "attachmentType": eni.AttachmentType, + "attachmentSent": eni.AttachStatusSent, + "mac": eni.MACAddress, + "status": eni.Status.String(), + "expiresAt": eni.ExpiresAt.Format(time.RFC3339), + } + + if eni.AttachmentType != ENIAttachmentTypeInstanceENI { + taskId, _ := arn.TaskIdFromArn(eni.TaskARN) + fields[field.TaskID] = taskId + } + + return fields +} + +// StartTimer starts the ack timer to record the expiration of ENI attachment +func (eni *ENIAttachment) StartTimer(timeoutFunc func()) error { + eni.guard.Lock() + defer eni.guard.Unlock() + + if eni.ackTimer != nil { + // The timer has already been initialized, do nothing + return nil + } + now := time.Now() + duration := eni.ExpiresAt.Sub(now) + if duration <= 0 { + return errors.Errorf("eni attachment: timer expiration is in the past; expiration [%s] < now [%s]", + eni.ExpiresAt.String(), now.String()) + } + logger.Info("Starting ENI ack timer", getEniAttachmentLogFields(eni, duration)) + eni.ackTimer = time.AfterFunc(duration, timeoutFunc) + return nil +} + +// Initialize initializes the fields that can't be populated from loading state file. +// Notably, this initializes the ack timer so that if we times out waiting for the eni to be attached, the attachment +// can be removed from state. +func (eni *ENIAttachment) Initialize(timeoutFunc func()) error { + eni.guard.Lock() + defer eni.guard.Unlock() + + if eni.AttachStatusSent { // eni attachment status has been sent, no need to start ack timer. + return nil + } + + now := time.Now() + duration := eni.ExpiresAt.Sub(now) + if duration <= 0 { + return errors.New("ENI attachment has already expired") + } + + logger.Info("Starting ENI ack timer", getEniAttachmentLogFields(eni, duration)) + eni.ackTimer = time.AfterFunc(duration, timeoutFunc) + return nil +} + +// IsSent checks if the eni attached status has been sent +func (eni *ENIAttachment) IsSent() bool { + eni.guard.RLock() + defer eni.guard.RUnlock() + + return eni.AttachStatusSent +} + +// SetSentStatus marks the eni attached status has been sent +func (eni *ENIAttachment) SetSentStatus() { + eni.guard.Lock() + defer eni.guard.Unlock() + + eni.AttachStatusSent = true +} + +// StopAckTimer stops the ack timer set on the ENI attachment +func (eni *ENIAttachment) StopAckTimer() { + eni.guard.Lock() + defer eni.guard.Unlock() + + eni.ackTimer.Stop() +} + +// HasExpired returns true if the ENI attachment object has exceeded the +// threshold for notifying the backend of the attachment +func (eni *ENIAttachment) HasExpired() bool { + eni.guard.RLock() + defer eni.guard.RUnlock() + + return time.Now().After(eni.ExpiresAt) +} + +// String returns a string representation of the ENI Attachment +func (eni *ENIAttachment) String() string { + eni.guard.RLock() + defer eni.guard.RUnlock() + + return eni.stringUnsafe() +} + +// stringUnsafe returns a string representation of the ENI Attachment +func (eni *ENIAttachment) stringUnsafe() string { + // skip TaskArn field for instance level eni attachment since it won't have a task arn + if eni.AttachmentType == ENIAttachmentTypeInstanceENI { + return fmt.Sprintf( + "ENI Attachment: attachment=%s attachmentType=%s attachmentSent=%t mac=%s status=%s expiresAt=%s", + eni.AttachmentARN, eni.AttachmentType, eni.AttachStatusSent, eni.MACAddress, eni.Status.String(), eni.ExpiresAt.Format(time.RFC3339)) + } + + return fmt.Sprintf( + "ENI Attachment: task=%s attachment=%s attachmentType=%s attachmentSent=%t mac=%s status=%s expiresAt=%s", + eni.TaskARN, eni.AttachmentARN, eni.AttachmentType, eni.AttachStatusSent, eni.MACAddress, eni.Status.String(), eni.ExpiresAt.Format(time.RFC3339)) +} diff --git a/ecs-agent/api/attachment/eni/eniattachment_test.go b/ecs-agent/api/eni/eniattachment_test.go similarity index 87% rename from ecs-agent/api/attachment/eni/eniattachment_test.go rename to ecs-agent/api/eni/eniattachment_test.go index 12fa6ef2108..58d1d1b1bf2 100644 --- a/ecs-agent/api/attachment/eni/eniattachment_test.go +++ b/ecs-agent/api/eni/eniattachment_test.go @@ -22,7 +22,8 @@ import ( "testing" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/stretchr/testify/assert" ) @@ -38,11 +39,11 @@ const ( func TestMarshalUnmarshal(t *testing.T) { expiresAt := time.Now() attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: expiresAt, }, MACAddress: mac, @@ -68,11 +69,11 @@ func TestMarshalUnmarshal(t *testing.T) { func TestMarshalUnmarshalWithAttachmentType(t *testing.T) { expiresAt := time.Now() attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: expiresAt, }, AttachmentType: attachmentType, @@ -100,11 +101,11 @@ func TestMarshalUnmarshalWithAttachmentType(t *testing.T) { func TestStartTimerErrorWhenExpiresAtIsInThePast(t *testing.T) { expiresAt := time.Now().Unix() - 1 attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, MACAddress: mac, @@ -123,11 +124,11 @@ func TestHasExpired(t *testing.T) { } { t.Run(tc.name, func(t *testing.T) { attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(tc.expiresAt, 0), }, MACAddress: mac, @@ -146,10 +147,10 @@ func TestInitialize(t *testing.T) { expiresAt := time.Now().Unix() + 1 attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, MACAddress: mac, @@ -161,10 +162,10 @@ func TestInitialize(t *testing.T) { func TestInitializeExpired(t *testing.T) { expiresAt := time.Now().Unix() - 1 attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, MACAddress: mac, @@ -175,11 +176,11 @@ func TestInitializeExpired(t *testing.T) { func TestInitializeExpiredButAlreadySent(t *testing.T) { expiresAt := time.Now().Unix() - 1 attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, MACAddress: mac, diff --git a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/ebs_discovery.go b/ecs-agent/api/resource/ebs_discovery.go similarity index 77% rename from agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/ebs_discovery.go rename to ecs-agent/api/resource/ebs_discovery.go index 4076c24169d..95c442d9264 100644 --- a/agent/vendor/github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource/ebs_discovery.go +++ b/ecs-agent/api/resource/ebs_discovery.go @@ -35,31 +35,13 @@ var ( ) type EBSDiscoveryClient struct { - ctx context.Context - hasXenSupport bool + ctx context.Context } -type EBSDiscoveryClientOption func(*EBSDiscoveryClient) - -// Enable Xen instances support for EBS Discovery Client -func WithXenSupport() EBSDiscoveryClientOption { - return func(ec *EBSDiscoveryClient) { - ec.hasXenSupport = true - } -} - -func NewDiscoveryClient(ctx context.Context, opts ...EBSDiscoveryClientOption) *EBSDiscoveryClient { - client := &EBSDiscoveryClient{ +func NewDiscoveryClient(ctx context.Context) *EBSDiscoveryClient { + return &EBSDiscoveryClient{ ctx: ctx, } - for _, opt := range opts { - opt(client) - } - return client -} - -func (client *EBSDiscoveryClient) HasXenSupport() bool { - return client.hasXenSupport } // ScanEBSVolumes will iterate through the entire list of provided EBS volume attachments within the agent state and checks if it's attached on the host. diff --git a/ecs-agent/api/attachment/resource/ebs_discovery_linux.go b/ecs-agent/api/resource/ebs_discovery_linux.go similarity index 62% rename from ecs-agent/api/attachment/resource/ebs_discovery_linux.go rename to ecs-agent/api/resource/ebs_discovery_linux.go index 3f8dbeeb446..21b6510fe81 100644 --- a/ecs-agent/api/attachment/resource/ebs_discovery_linux.go +++ b/ecs-agent/api/resource/ebs_discovery_linux.go @@ -25,11 +25,6 @@ import ( "strings" ) -const ( - sdPrefix = "sd" - xvdPrefix = "xvd" -) - // LsblkOutput is used to manage and track the output of `lsblk` type LsblkOutput struct { BlockDevices []BlockDevice `json:"blockdevices"` @@ -61,7 +56,7 @@ func (api *EBSDiscoveryClient) ConfirmEBSVolumeIsAttached(deviceName, volumeID s } expectedVolumeId := strings.ReplaceAll(volumeID, "-", "") - actualDeviceName, err := parseLsblkOutput(&lsblkOut, deviceName, expectedVolumeId, api.HasXenSupport()) + actualDeviceName, err := parseLsblkOutput(&lsblkOut, deviceName, expectedVolumeId) if err != nil { return "", err } @@ -83,57 +78,13 @@ func (api *EBSDiscoveryClient) ConfirmEBSVolumeIsAttached(deviceName, volumeID s // } // ] // } -// -// If hasXenSupport is true then, in addition to matching a device by its serial, this function -// matches devices by their names disregarding "sd" or "xvd" prefix if it exists in -// device name in parseLsblkOutput and deviceName both. -// This is because on Xen instances the device name received from upstream with "sd" or "xvd" -// prefix might appear on the instance with the prefix interchanged, that is "xvd" instead of "sd" -// and vice-versa. -func parseLsblkOutput( - output *LsblkOutput, - deviceName, volumeId string, - hasXenSupport bool, -) (string, error) { +func parseLsblkOutput(output *LsblkOutput, deviceName string, volumeId string) (string, error) { actualDeviceName := deviceName[strings.LastIndex(deviceName, "/")+1:] for _, block := range output.BlockDevices { + //TODO: Add edge case for Xen-based instances if block.Serial == volumeId { return block.Name, nil } - if hasXenSupport { - if foundDeviceName, found := matchXenBlockDevice(block, actualDeviceName); found { - return foundDeviceName, nil - } - } } return "", fmt.Errorf("cannot find EBS volume with device name: %v and volume ID: %v", actualDeviceName, volumeId) } - -// Matches a block device against a device name by matching the block device's name and -// the device name after stripping "sd" or "xvd" prefixes (whichever is present) from both names -// if it is present in both names. -func matchXenBlockDevice(block BlockDevice, deviceName string) (string, bool) { - if hasXenPrefix(block.Name) && hasXenPrefix(deviceName) { - if trimXenPrefix(block.Name) == trimXenPrefix(deviceName) { - return block.Name, true - } - } else if block.Name == deviceName { - return block.Name, true - } - return "", false -} - -// Checks if the device name has sd or xvd prefix. -func hasXenPrefix(name string) bool { - return strings.HasPrefix(name, sdPrefix) || strings.HasPrefix(name, xvdPrefix) -} - -// Trims "sd" or "xvd" prefix (whichever is present) from the given name. -func trimXenPrefix(name string) string { - if strings.HasPrefix(name, sdPrefix) { - return strings.TrimPrefix(name, sdPrefix) - } else if strings.HasPrefix(name, xvdPrefix) { - return strings.TrimPrefix(name, xvdPrefix) - } - return name -} diff --git a/ecs-agent/api/resource/ebs_discovery_linux_test.go b/ecs-agent/api/resource/ebs_discovery_linux_test.go new file mode 100644 index 00000000000..5b28a0a3854 --- /dev/null +++ b/ecs-agent/api/resource/ebs_discovery_linux_test.go @@ -0,0 +1,64 @@ +//go:build linux && unit +// +build linux,unit + +// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"). You may +// not use this file except in compliance with the License. A copy of the +// License is located at +// +// http://aws.amazon.com/apache2.0/ +// +// or in the "license" file accompanying this file. This file is distributed +// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either +// express or implied. See the License for the specific language governing +// permissions and limitations under the License. + +package resource + +import ( + "testing" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" +) + +const ( + testVolumeID = "vol-1234" + testDeviceName = "nvme0n1" +) + +func TestParseLsblkOutput(t *testing.T) { + blockDevice := BlockDevice{ + Name: testDeviceName, + Serial: testVolumeID, + Children: make([]*BlockDevice, 0), + } + + lsblkOutput := &LsblkOutput{ + BlockDevices: []BlockDevice{ + blockDevice, + }, + } + + actualDeviceName, err := parseLsblkOutput(lsblkOutput, "/dev/"+testDeviceName, testVolumeID) + require.NoError(t, err) + assert.Equal(t, testDeviceName, actualDeviceName) +} + +func TestParseLsblkOutputError(t *testing.T) { + blockDevice := BlockDevice{ + Name: testDeviceName, + Serial: "vol-456", + Children: make([]*BlockDevice, 0), + } + + lsblkOutput := &LsblkOutput{ + BlockDevices: []BlockDevice{ + blockDevice, + }, + } + actualDeviceName, err := parseLsblkOutput(lsblkOutput, testDeviceName, testVolumeID) + require.Error(t, err, "cannot find the device name: %v", "/dev/"+testDeviceName) + assert.Equal(t, "", actualDeviceName) +} diff --git a/ecs-agent/api/attachment/resource/ebs_discovery_windows.go b/ecs-agent/api/resource/ebs_discovery_windows.go similarity index 100% rename from ecs-agent/api/attachment/resource/ebs_discovery_windows.go rename to ecs-agent/api/resource/ebs_discovery_windows.go diff --git a/ecs-agent/api/attachment/resource/ebs_discovery_windows_test.go b/ecs-agent/api/resource/ebs_discovery_windows_test.go similarity index 100% rename from ecs-agent/api/attachment/resource/ebs_discovery_windows_test.go rename to ecs-agent/api/resource/ebs_discovery_windows_test.go diff --git a/ecs-agent/api/attachment/resource/generate_mocks.go b/ecs-agent/api/resource/generate_mocks.go similarity index 84% rename from ecs-agent/api/attachment/resource/generate_mocks.go rename to ecs-agent/api/resource/generate_mocks.go index 6c86d8825ee..a66369fc121 100644 --- a/ecs-agent/api/attachment/resource/generate_mocks.go +++ b/ecs-agent/api/resource/generate_mocks.go @@ -11,6 +11,6 @@ // express or implied. See the License for the specific language governing // permissions and limitations under the License. -//go:generate mockgen -destination=mocks/ebs_mocks.go -copyright_file=../../../../scripts/copyright_file github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource EBSDiscovery +//go:generate mockgen -destination=mocks/ebs_mocks.go -copyright_file=../../../scripts/copyright_file github.com/aws/amazon-ecs-agent/ecs-agent/api/resource EBSDiscovery package resource diff --git a/ecs-agent/api/attachment/resource/interfaces.go b/ecs-agent/api/resource/interfaces.go similarity index 100% rename from ecs-agent/api/attachment/resource/interfaces.go rename to ecs-agent/api/resource/interfaces.go diff --git a/ecs-agent/api/attachment/resource/mocks/ebs_mocks.go b/ecs-agent/api/resource/mocks/ebs_mocks.go similarity index 95% rename from ecs-agent/api/attachment/resource/mocks/ebs_mocks.go rename to ecs-agent/api/resource/mocks/ebs_mocks.go index 2c0abac5d48..9edfb8c25a6 100644 --- a/ecs-agent/api/attachment/resource/mocks/ebs_mocks.go +++ b/ecs-agent/api/resource/mocks/ebs_mocks.go @@ -13,7 +13,7 @@ // // Code generated by MockGen. DO NOT EDIT. -// Source: github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment/resource (interfaces: EBSDiscovery) +// Source: github.com/aws/amazon-ecs-agent/ecs-agent/api/resource (interfaces: EBSDiscovery) // Package mock_resource is a generated GoMock package. package mock_resource diff --git a/ecs-agent/api/attachment/resource/resource_attachment.go b/ecs-agent/api/resource/resource_attachment.go similarity index 87% rename from ecs-agent/api/attachment/resource/resource_attachment.go rename to ecs-agent/api/resource/resource_attachment.go index f4666867cef..bd8c27cd7c8 100644 --- a/ecs-agent/api/attachment/resource/resource_attachment.go +++ b/ecs-agent/api/resource/resource_attachment.go @@ -19,13 +19,14 @@ import ( "sync" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/ttime" ) type ResourceAttachment struct { - attachment.AttachmentInfo + attachmentinfo.AttachmentInfo // AttachmentType is the type of the resource attachment which can be "amazonebs" for EBS attach tasks. AttachmentType string `json:"AttachmentType,omitempty"` // AttachmentProperties is a map storing (name, value) representation of attachment properties. @@ -214,7 +215,7 @@ func (ra *ResourceAttachment) IsAttached() bool { ra.guard.RLock() defer ra.guard.RUnlock() - return ra.Status == attachment.AttachmentAttached + return ra.Status == status.AttachmentAttached } // SetAttachedStatus marks the resouce attachment as attached once it's been found on the host @@ -222,7 +223,7 @@ func (ra *ResourceAttachment) SetAttachedStatus() { ra.guard.Lock() defer ra.guard.Unlock() - ra.Status = attachment.AttachmentAttached + ra.Status = status.AttachmentAttached } // StopAckTimer stops the ack timer set on the resource attachment @@ -253,6 +254,7 @@ func (ra *ResourceAttachment) SetError(err error) { func (ra *ResourceAttachment) GetError() error { ra.guard.RLock() defer ra.guard.RUnlock() + return ra.err } @@ -260,6 +262,7 @@ func (ra *ResourceAttachment) GetError() error { func (ra *ResourceAttachment) EBSToString() string { ra.guard.RLock() defer ra.guard.RUnlock() + return ra.ebsToStringUnsafe() } @@ -284,74 +287,41 @@ func (ra *ResourceAttachment) GetAttachmentProperties(key string) string { func (ra *ResourceAttachment) GetAttachmentType() string { ra.guard.RLock() defer ra.guard.RUnlock() + return ra.AttachmentType } func (ra *ResourceAttachment) SetDeviceName(deviceName string) { ra.guard.Lock() defer ra.guard.Unlock() + ra.AttachmentProperties[DeviceNameKey] = deviceName } func (ra *ResourceAttachment) GetAttachmentARN() string { ra.guard.RLock() defer ra.guard.RUnlock() - return ra.AttachmentARN -} -func (ra *ResourceAttachment) GetStatus() attachment.AttachmentStatus { - ra.guard.RLock() - defer ra.guard.RUnlock() - return ra.Status + return ra.AttachmentARN } func (ra *ResourceAttachment) GetExpiresAt() time.Time { ra.guard.RLock() defer ra.guard.RUnlock() + return ra.ExpiresAt } func (ra *ResourceAttachment) GetClusterARN() string { ra.guard.RLock() defer ra.guard.RUnlock() + return ra.ClusterARN } func (ra *ResourceAttachment) GetContainerInstanceARN() string { ra.guard.RLock() defer ra.guard.RUnlock() - return ra.ContainerInstanceARN -} -// should attach when not attached, and not sent/not expired -func (ra *ResourceAttachment) ShouldAttach() bool { - ra.guard.RLock() - defer ra.guard.RUnlock() - return !(ra.Status == attachment.AttachmentAttached) && !ra.AttachStatusSent && !(time.Now().After(ra.ExpiresAt)) -} - -// should notify when attached, and not sent/not expired -func (ra *ResourceAttachment) ShouldNotify() bool { - ra.guard.RLock() - defer ra.guard.RUnlock() - return (ra.Status == attachment.AttachmentAttached) && !ra.AttachStatusSent && !(time.Now().After(ra.ExpiresAt)) -} - -func (ra *ResourceAttachment) String() string { - ra.guard.RLock() - defer ra.guard.RUnlock() - return ra.stringUnsafe() -} - -func (ra *ResourceAttachment) GetAttachmentStatus() attachment.AttachmentStatus { - ra.guard.RLock() - defer ra.guard.RUnlock() - return ra.Status -} - -// stringUnsafe returns a string representation of the ENI Attachment -func (ra *ResourceAttachment) stringUnsafe() string { - return fmt.Sprintf( - "Resource Attachment: attachment=%s attachmentType=%s attachmentSent=%t status=%s expiresAt=%s", - ra.AttachmentARN, ra.AttachmentType, ra.AttachStatusSent, ra.Status.String(), ra.ExpiresAt.Format(time.RFC3339)) + return ra.ContainerInstanceARN } diff --git a/ecs-agent/api/attachment/resource/resource_attachment_test.go b/ecs-agent/api/resource/resource_attachment_test.go similarity index 89% rename from ecs-agent/api/attachment/resource/resource_attachment_test.go rename to ecs-agent/api/resource/resource_attachment_test.go index 10ef4fd4c17..b9ccfbbf879 100644 --- a/ecs-agent/api/attachment/resource/resource_attachment_test.go +++ b/ecs-agent/api/resource/resource_attachment_test.go @@ -22,7 +22,8 @@ import ( "testing" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/stretchr/testify/assert" ) @@ -47,11 +48,11 @@ var ( func TestMarshalUnmarshal(t *testing.T) { expiresAt := time.Now() attachment := &ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: expiresAt, }, AttachmentProperties: testAttachmentProperties, @@ -85,11 +86,11 @@ func TestMarshalUnmarshal(t *testing.T) { func TestStartTimerErrorWhenExpiresAtIsInThePast(t *testing.T) { expiresAt := time.Now().Unix() - 1 attachment := &ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, AttachmentProperties: testAttachmentProperties, @@ -109,11 +110,11 @@ func TestHasExpired(t *testing.T) { } { t.Run(tc.name, func(t *testing.T) { attachment := &ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(tc.expiresAt, 0), }, AttachmentProperties: testAttachmentProperties, @@ -133,10 +134,10 @@ func TestInitialize(t *testing.T) { expiresAt := time.Now().Unix() + 1 attachment := &ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, AttachmentProperties: testAttachmentProperties, @@ -149,10 +150,10 @@ func TestInitialize(t *testing.T) { func TestInitializeExpired(t *testing.T) { expiresAt := time.Now().Unix() - 1 attachment := &ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, AttachmentProperties: testAttachmentProperties, @@ -164,11 +165,11 @@ func TestInitializeExpired(t *testing.T) { func TestInitializeExpiredButAlreadySent(t *testing.T) { expiresAt := time.Now().Unix() - 1 attachment := &ResourceAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, AttachmentProperties: testAttachmentProperties, diff --git a/ecs-agent/api/attachment/resource/resource_type.go b/ecs-agent/api/resource/resource_type.go similarity index 100% rename from ecs-agent/api/attachment/resource/resource_type.go rename to ecs-agent/api/resource/resource_type.go diff --git a/ecs-agent/api/attachment/resource/resource_validation.go b/ecs-agent/api/resource/resource_validation.go similarity index 100% rename from ecs-agent/api/attachment/resource/resource_validation.go rename to ecs-agent/api/resource/resource_validation.go diff --git a/ecs-agent/api/attachment/resource/resource_validation_test.go b/ecs-agent/api/resource/resource_validation_test.go similarity index 100% rename from ecs-agent/api/attachment/resource/resource_validation_test.go rename to ecs-agent/api/resource/resource_validation_test.go diff --git a/ecs-agent/api/attachment/attachment_status.go b/ecs-agent/api/status/attachment_status.go similarity index 98% rename from ecs-agent/api/attachment/attachment_status.go rename to ecs-agent/api/status/attachment_status.go index 93f0ba49ea7..be8d9646d9d 100644 --- a/ecs-agent/api/attachment/attachment_status.go +++ b/ecs-agent/api/status/attachment_status.go @@ -11,7 +11,7 @@ // express or implied. See the License for the specific language governing // permissions and limitations under the License. -package attachment +package status const ( // AttachmentNone is zero state of a task when received attach message from acs diff --git a/ecs-agent/api/attachment/attachment_status_test.go b/ecs-agent/api/status/attachment_status_test.go similarity index 98% rename from ecs-agent/api/attachment/attachment_status_test.go rename to ecs-agent/api/status/attachment_status_test.go index 3df4129f8f5..7eea5778ed3 100644 --- a/ecs-agent/api/attachment/attachment_status_test.go +++ b/ecs-agent/api/status/attachment_status_test.go @@ -14,7 +14,7 @@ // express or implied. See the License for the specific language governing // permissions and limitations under the License. -package attachment +package status import ( "testing" diff --git a/ecs-agent/async/mocks/async_mocks.go b/ecs-agent/async/mocks/async_mocks.go index b797e422e0d..b96d4cc2fde 100644 --- a/ecs-agent/async/mocks/async_mocks.go +++ b/ecs-agent/async/mocks/async_mocks.go @@ -20,6 +20,7 @@ package mock_async import ( reflect "reflect" + time "time" async "github.com/aws/amazon-ecs-agent/ecs-agent/async" gomock "github.com/golang/mock/gomock" @@ -138,20 +139,6 @@ func (mr *MockTTLCacheMockRecorder) Get(arg0 interface{}) *gomock.Call { return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Get", reflect.TypeOf((*MockTTLCache)(nil).Get), arg0) } -// GetTTL mocks base method. -func (m *MockTTLCache) GetTTL() *async.TTL { - m.ctrl.T.Helper() - ret := m.ctrl.Call(m, "GetTTL") - ret0, _ := ret[0].(*async.TTL) - return ret0 -} - -// GetTTL indicates an expected call of GetTTL. -func (mr *MockTTLCacheMockRecorder) GetTTL() *gomock.Call { - mr.mock.ctrl.T.Helper() - return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "GetTTL", reflect.TypeOf((*MockTTLCache)(nil).GetTTL)) -} - // Set mocks base method. func (m *MockTTLCache) Set(arg0 string, arg1 interface{}) { m.ctrl.T.Helper() @@ -165,7 +152,7 @@ func (mr *MockTTLCacheMockRecorder) Set(arg0, arg1 interface{}) *gomock.Call { } // SetTTL mocks base method. -func (m *MockTTLCache) SetTTL(arg0 *async.TTL) { +func (m *MockTTLCache) SetTTL(arg0 time.Duration) { m.ctrl.T.Helper() m.ctrl.Call(m, "SetTTL", arg0) } diff --git a/ecs-agent/async/ttl_cache.go b/ecs-agent/async/ttl_cache.go index 7351fa6a987..ba10fcb8f82 100644 --- a/ecs-agent/async/ttl_cache.go +++ b/ecs-agent/async/ttl_cache.go @@ -19,32 +19,22 @@ import ( ) type TTLCache interface { - // Get fetches a value from cache, returns nil, false on miss. + // Get fetches a value from cache, returns nil, false on miss Get(key string) (value interface{}, expired bool, ok bool) - // Set sets a value in cache. This overwrites any existing value. + // Set sets a value in cache. overrites any existing value Set(key string, value interface{}) - // Delete deletes the value from the cache. + // Delete deletes the value from the cache Delete(key string) - // GetTTL gets the time-to-live of the cache. - GetTTL() *TTL - // SetTTL sets the time-to-live of the cache. - SetTTL(ttl *TTL) + // SetTTL sets the time-to-live of the cache + SetTTL(ttl time.Duration) } -// NewTTLCache creates a TTL cache with optional TTL for items. -func NewTTLCache(ttl *TTL) TTLCache { - ttlCache := &ttlCache{ +// Creates a TTL cache with ttl for items. +func NewTTLCache(ttl time.Duration) TTLCache { + return &ttlCache{ + ttl: ttl, cache: make(map[string]*ttlCacheEntry), } - // Only set TTL if it is not nil. - if ttl != nil { - ttlCache.ttl = ttl - } - return ttlCache -} - -type TTL struct { - Duration time.Duration } type ttlCacheEntry struct { @@ -55,7 +45,7 @@ type ttlCacheEntry struct { type ttlCache struct { mu sync.RWMutex cache map[string]*ttlCacheEntry - ttl *TTL + ttl time.Duration } // Get returns the value associated with the key. @@ -70,60 +60,34 @@ func (t *ttlCache) Get(key string) (value interface{}, expired bool, ok bool) { return nil, false, false } entry := t.cache[key] - // Entries can only be expired if the cache has a TTL set. - if t.ttl != nil { - expired = time.Now().After(entry.expiry) - } + expired = time.Now().After(entry.expiry) return entry.value, expired, true } -// Set sets the key-value pair in the cache. +// Set sets the key-value pair in the cache func (t *ttlCache) Set(key string, value interface{}) { t.mu.Lock() defer t.mu.Unlock() t.cache[key] = &ttlCacheEntry{ - value: value, - } - // Entries can only have expiry set if the cache has a TTL set. - if t.ttl != nil { - t.cache[key].expiry = time.Now().Add(t.ttl.Duration) + value: value, + expiry: time.Now().Add(t.ttl), } } -// Delete removes the entry associated with the key from cache. +// Delete removes the entry associated with the key from cache func (t *ttlCache) Delete(key string) { t.mu.Lock() defer t.mu.Unlock() delete(t.cache, key) } -// GetTTL gets the time-to-live of the cache. -func (t *ttlCache) GetTTL() *TTL { - t.mu.Lock() - defer t.mu.Unlock() - if t.ttl == nil { - return nil - } - return &TTL{Duration: t.ttl.Duration} -} - -// SetTTL sets the time-to-live of the cache. -func (t *ttlCache) SetTTL(newTTL *TTL) { +// SetTTL sets the time-to-live of the cache +func (t *ttlCache) SetTTL(ttl time.Duration) { t.mu.Lock() defer t.mu.Unlock() - - // Update expiry of all entries in the cache. - if t.ttl != nil { - oldTTLDuration := t.ttl.Duration - for _, val := range t.cache { - val.expiry = val.expiry.Add(newTTL.Duration - oldTTLDuration) - } - } else { - now := time.Now() - for _, val := range t.cache { - val.expiry = now.Add(newTTL.Duration) - } + oldTTL := t.ttl + t.ttl = ttl + for _, val := range t.cache { + val.expiry = val.expiry.Add(ttl - oldTTL) } - - t.ttl = &TTL{Duration: newTTL.Duration} } diff --git a/ecs-agent/async/ttl_cache_test.go b/ecs-agent/async/ttl_cache_test.go index 3e9f91822d7..01b403323a5 100644 --- a/ecs-agent/async/ttl_cache_test.go +++ b/ecs-agent/async/ttl_cache_test.go @@ -24,7 +24,7 @@ import ( ) func TestTTLSimple(t *testing.T) { - ttl := NewTTLCache(&TTL{Duration: time.Minute}) + ttl := NewTTLCache(time.Minute) ttl.Set("foo", "bar") bar, expired, ok := ttl.Get("foo") @@ -45,7 +45,7 @@ func TestTTLSimple(t *testing.T) { } func TestTTLSetDelete(t *testing.T) { - ttl := NewTTLCache(&TTL{Duration: time.Minute}) + ttl := NewTTLCache(time.Minute) ttl.Set("foo", "bar") bar, expired, ok := ttl.Get("foo") @@ -67,7 +67,7 @@ func TestTTLSetDelete(t *testing.T) { } func TestTTLCache(t *testing.T) { - ttl := NewTTLCache(&TTL{Duration: 50 * time.Millisecond}) + ttl := NewTTLCache(50 * time.Millisecond) ttl.Set("foo", "bar") bar, expired, ok := ttl.Get("foo") @@ -83,15 +83,12 @@ func TestTTLCache(t *testing.T) { require.Equal(t, bar, "bar") } -func TestTTLCacheGetTTLAndSetTTL(t *testing.T) { +func TestTTLCacheSetTTL(t *testing.T) { entryKey := "foo" entryVal := "bar" - // Initialize cache with a nil TTL (i.e., infinite amount of time). - cache := NewTTLCache(nil) - require.Nil(t, cache.GetTTL()) - - // Add entry to the cache. + // Initialize cache with a TTL that is a high amount of time. + cache := NewTTLCache(time.Hour) cache.Set(entryKey, entryVal) time.Sleep(100 * time.Millisecond) @@ -102,10 +99,7 @@ func TestTTLCacheGetTTLAndSetTTL(t *testing.T) { require.Equal(t, entryVal, actualVal) // Set TTL of cache to now be a low amount of time. - newTTLDuration := 1 * time.Millisecond - cache.SetTTL(&TTL{Duration: newTTLDuration}) - require.NotNil(t, cache.GetTTL()) - require.Equal(t, newTTLDuration, cache.GetTTL().Duration) + cache.SetTTL(1 * time.Millisecond) time.Sleep(100 * time.Millisecond) // We should be able to retrieve the entry - it should be expired since the cache's current TTL has elapsed. diff --git a/ecs-agent/credentials/instancecreds/instancecreds.go b/ecs-agent/credentials/instancecreds/instancecreds.go deleted file mode 100644 index 256dd843221..00000000000 --- a/ecs-agent/credentials/instancecreds/instancecreds.go +++ /dev/null @@ -1,25 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package instancecreds - -import ( - "sync" - - "github.com/aws/aws-sdk-go/aws/credentials" -) - -var ( - credentialChain *credentials.Credentials - mu sync.Mutex -) diff --git a/ecs-agent/credentials/instancecreds/instancecreds_linux.go b/ecs-agent/credentials/instancecreds/instancecreds_linux.go deleted file mode 100644 index 88ac75ee454..00000000000 --- a/ecs-agent/credentials/instancecreds/instancecreds_linux.go +++ /dev/null @@ -1,55 +0,0 @@ -//go:build linux - -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package instancecreds - -import ( - "fmt" - - "github.com/aws/amazon-ecs-agent/ecs-agent/credentials/providers" - "github.com/aws/amazon-ecs-agent/ecs-agent/logger" - - "github.com/aws/aws-sdk-go/aws/credentials" - "github.com/aws/aws-sdk-go/aws/defaults" -) - -// GetCredentials returns the instance credentials chain. This is the default chain -// credentials plus the "rotating shared credentials provider", so credentials will -// be checked in this order: -// 1. Env vars (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). -// 2. Shared credentials file (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/create-shared-credentials-file.html) (file at ~/.aws/credentials containing access key id and secret access key). -// 3. EC2 role credentials. This is an IAM role that the user specifies when they launch their EC2 container instance (ie ecsInstanceRole (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/instance_IAM_role.html)). -// 4. Rotating shared credentials file located at /rotatingcreds/credentials -func GetCredentials(isExternal bool) *credentials.Credentials { - mu.Lock() - if credentialChain == nil { - credProviders := defaults.CredProviders(defaults.Config(), defaults.Handlers()) - credProviders = append(credProviders, providers.NewRotatingSharedCredentialsProvider()) - credentialChain = credentials.NewCredentials(&credentials.ChainProvider{ - VerboseErrors: false, - Providers: credProviders, - }) - } - mu.Unlock() - - // credentials.Credentials is concurrency-safe, so lock not needed here - v, err := credentialChain.Get() - if err != nil { - logger.Error(fmt.Sprintf("Error getting ECS instance credentials from default chain: %s", err)) - } else { - logger.Info(fmt.Sprintf("Successfully got ECS instance credentials from provider: %s", v.ProviderName)) - } - return credentialChain -} diff --git a/ecs-agent/credentials/instancecreds/instancecreds_unsupported.go b/ecs-agent/credentials/instancecreds/instancecreds_unsupported.go deleted file mode 100644 index c7c27d44987..00000000000 --- a/ecs-agent/credentials/instancecreds/instancecreds_unsupported.go +++ /dev/null @@ -1,32 +0,0 @@ -//go:build !linux && !windows -// +build !linux,!windows - -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package instancecreds - -import ( - "github.com/aws/aws-sdk-go/aws/credentials" -) - -// GetCredentials returns the instance credentials chain. This is the default chain -// credentials plus the "rotating shared credentials provider", so credentials will -// be checked in this order: -// 1. Env vars (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). -// 2. Shared credentials file (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/create-shared-credentials-file.html) (file at ~/.aws/credentials containing access key id and secret access key). -// 3. EC2 role credentials. This is an IAM role that the user specifies when they launch their EC2 container instance (ie ecsInstanceRole (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/instance_IAM_role.html)). -// 4. Rotating shared credentials file located at /rotatingcreds/credentials -func GetCredentials(isExternal bool) *credentials.Credentials { - return nil -} diff --git a/ecs-agent/credentials/providers/credentials_filename_linux.go b/ecs-agent/credentials/providers/credentials_filename_linux.go deleted file mode 100644 index 965eebf15a0..00000000000 --- a/ecs-agent/credentials/providers/credentials_filename_linux.go +++ /dev/null @@ -1,22 +0,0 @@ -//go:build linux - -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package providers - -const ( - // defaultRotatingCredentialsFilename is the default location of the credentials file - // for RotatingSharedCredentialsProvider. - defaultRotatingCredentialsFilename = "/rotatingcreds/credentials" -) diff --git a/ecs-agent/credentials/providers/credentials_filename_unsupported.go b/ecs-agent/credentials/providers/credentials_filename_unsupported.go deleted file mode 100644 index 5995402c26d..00000000000 --- a/ecs-agent/credentials/providers/credentials_filename_unsupported.go +++ /dev/null @@ -1,23 +0,0 @@ -//go:build !linux && !windows -// +build !linux,!windows - -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package providers - -const ( - // defaultRotatingCredentialsFilename is the default location of the credentials file - // for RotatingSharedCredentialsProvider. - defaultRotatingCredentialsFilename = "/unsupported/rotatingcreds/credentials" -) diff --git a/ecs-agent/credentials/providers/credentials_filename_windows.go b/ecs-agent/credentials/providers/credentials_filename_windows.go deleted file mode 100644 index 58fbdc47da4..00000000000 --- a/ecs-agent/credentials/providers/credentials_filename_windows.go +++ /dev/null @@ -1,20 +0,0 @@ -//go:build windows - -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package providers - -// defaultRotatingCredentialsFilename is the default location of the credentials file -// for RotatingSharedCredentialsProvider. -const defaultRotatingCredentialsFilename = "C:\\Windows\\System32\\config\\systemprofile\\.aws\\credentials" diff --git a/ecs-agent/credentials/providers/rotating_shared_credentials_provider.go b/ecs-agent/credentials/providers/rotating_shared_credentials_provider.go deleted file mode 100644 index 9102f59673d..00000000000 --- a/ecs-agent/credentials/providers/rotating_shared_credentials_provider.go +++ /dev/null @@ -1,83 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package providers - -import ( - "fmt" - "os" - "time" - - "github.com/aws/amazon-ecs-agent/ecs-agent/logger" - - "github.com/aws/aws-sdk-go/aws/credentials" -) - -const ( - ALTERNATE_CREDENTIAL_PROFILE_ENV_VAR = "ECS_ALTERNATE_CREDENTIAL_PROFILE" - DEFAULT_CREDENTIAL_PROFILE = "default" - // defaultRotationInterval is how frequently to expire and re-retrieve the credentials from file. - defaultRotationInterval = time.Minute - // RotatingSharedCredentialsProviderName is the name of this provider - RotatingSharedCredentialsProviderName = "RotatingSharedCredentialsProvider" -) - -// RotatingSharedCredentialsProvider is a provider that retrieves credentials via the -// shared credentials provider, and adds the functionality of expiring and re-retrieving -// those credentials from the file. -type RotatingSharedCredentialsProvider struct { - credentials.Expiry - - RotationInterval time.Duration - sharedCredentialsProvider *credentials.SharedCredentialsProvider -} - -// NewRotatingSharedCredentials returns a rotating shared credentials provider -// with default values set. -func NewRotatingSharedCredentialsProvider() *RotatingSharedCredentialsProvider { - var credentialProfile = DEFAULT_CREDENTIAL_PROFILE - if alternateCredentialProfile := os.Getenv(ALTERNATE_CREDENTIAL_PROFILE_ENV_VAR); alternateCredentialProfile != "" { - logger.Info(fmt.Sprintf("Overriding %s credential profile; using: %s.", DEFAULT_CREDENTIAL_PROFILE, alternateCredentialProfile)) - credentialProfile = alternateCredentialProfile - } - - return &RotatingSharedCredentialsProvider{ - RotationInterval: defaultRotationInterval, - sharedCredentialsProvider: &credentials.SharedCredentialsProvider{ - Filename: defaultRotatingCredentialsFilename, - Profile: credentialProfile, - }, - } -} - -// Retrieve will use the given filename and profile and retrieve AWS credentials. -func (p *RotatingSharedCredentialsProvider) Retrieve() (credentials.Value, error) { - v, err := p.sharedCredentialsProvider.Retrieve() - v.ProviderName = RotatingSharedCredentialsProviderName - if err != nil { - return v, err - } - p.SetExpiration(time.Now().Add(p.RotationInterval), 0) - logger.Info(fmt.Sprintf("Successfully got instance credentials from file %s. %s", - p.sharedCredentialsProvider.Filename, credValueToString(v))) - return v, err -} - -func credValueToString(v credentials.Value) string { - akid := "" - // only print last 4 chars if it's less than half the full AKID - if len(v.AccessKeyID) > 8 { - akid = v.AccessKeyID[len(v.AccessKeyID)-4:] - } - return fmt.Sprintf("Provider: %s. Access Key ID XXXX%s", v.ProviderName, akid) -} diff --git a/ecs-agent/ecs/model/api/api-2.json b/ecs-agent/ecs/model/api/api-2.json deleted file mode 100644 index b75efbe4934..00000000000 --- a/ecs-agent/ecs/model/api/api-2.json +++ /dev/null @@ -1,7881 +0,0 @@ -{ - "version": "2.0", - "metadata": { - "apiVersion": "2014-11-13", - "endpointPrefix": "ecs", - "jsonVersion": "1.1", - "protocol": "json", - "serviceAbbreviation": "Amazon ECS", - "serviceFullName": "Amazon Elastic Container Service", - "serviceId": "ECS", - "signatureVersion": "v4", - "targetPrefix": "AmazonEC2ContainerServiceV20141113", - "uid": "ecs-2014-11-13" - }, - "operations": { - "CreateCapacityProvider": { - "name": "CreateCapacityProvider", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "CreateCapacityProviderRequest" - }, - "output": { - "shape": "CreateCapacityProviderResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "LimitExceededException" - }, - { - "shape": "ServerException" - }, - { - "shape": "UpdateInProgressException" - } - ] - }, - "CreateCluster": { - "name": "CreateCluster", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "CreateClusterRequest" - }, - "output": { - "shape": "CreateClusterResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "NamespaceNotFoundException" - } - ] - }, - "CreateService": { - "name": "CreateService", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "CreateServiceRequest" - }, - "output": { - "shape": "CreateServiceResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "NamespaceNotFoundException" - }, - { - "shape": "PlatformUnknownException" - }, - { - "shape": "PlatformTaskDefinitionIncompatibilityException" - }, - { - "shape": "ServerException" - }, - { - "shape": "UnsupportedFeatureException" - } - ] - }, - "CreateTaskSet": { - "name": "CreateTaskSet", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "CreateTaskSetRequest" - }, - "output": { - "shape": "CreateTaskSetResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "LimitExceededException" - }, - { - "shape": "NamespaceNotFoundException" - }, - { - "shape": "PlatformUnknownException" - }, - { - "shape": "PlatformTaskDefinitionIncompatibilityException" - }, - { - "shape": "ServerException" - }, - { - "shape": "ServiceNotFoundException" - }, - { - "shape": "ServiceNotActiveException" - }, - { - "shape": "UnsupportedFeatureException" - } - ] - }, - "DeleteAccountSetting": { - "name": "DeleteAccountSetting", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DeleteAccountSettingRequest" - }, - "output": { - "shape": "DeleteAccountSettingResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "DeleteAttributes": { - "name": "DeleteAttributes", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DeleteAttributesRequest" - }, - "output": { - "shape": "DeleteAttributesResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "TargetNotFoundException" - } - ] - }, - "DeleteCapacityProvider": { - "name": "DeleteCapacityProvider", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DeleteCapacityProviderRequest" - }, - "output": { - "shape": "DeleteCapacityProviderResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "UpdateInProgressException" - } - ] - }, - "DeleteCluster": { - "name": "DeleteCluster", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DeleteClusterRequest" - }, - "output": { - "shape": "DeleteClusterResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "ClusterContainsContainerInstancesException" - }, - { - "shape": "ClusterContainsServicesException" - }, - { - "shape": "ClusterContainsTasksException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "UpdateInProgressException" - } - ] - }, - "DeleteService": { - "name": "DeleteService", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DeleteServiceRequest" - }, - "output": { - "shape": "DeleteServiceResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "ServiceNotFoundException" - } - ] - }, - "DeleteTaskSet": { - "name": "DeleteTaskSet", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DeleteTaskSetRequest" - }, - "output": { - "shape": "DeleteTaskSetResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "LimitExceededException" - }, - { - "shape": "ServerException" - }, - { - "shape": "ServiceNotFoundException" - }, - { - "shape": "ServiceNotActiveException" - }, - { - "shape": "TaskSetNotFoundException" - }, - { - "shape": "UnsupportedFeatureException" - } - ] - }, - "DeregisterContainerInstance": { - "name": "DeregisterContainerInstance", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DeregisterContainerInstanceRequest" - }, - "output": { - "shape": "DeregisterContainerInstanceResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "DeregisterTaskDefinition": { - "name": "DeregisterTaskDefinition", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DeregisterTaskDefinitionRequest" - }, - "output": { - "shape": "DeregisterTaskDefinitionResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "DescribeCapacityProviders": { - "name": "DescribeCapacityProviders", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DescribeCapacityProvidersRequest" - }, - "output": { - "shape": "DescribeCapacityProvidersResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "DescribeClusters": { - "name": "DescribeClusters", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DescribeClustersRequest" - }, - "output": { - "shape": "DescribeClustersResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "DescribeContainerInstances": { - "name": "DescribeContainerInstances", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DescribeContainerInstancesRequest" - }, - "output": { - "shape": "DescribeContainerInstancesResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "ServerException" - } - ] - }, - "DescribeServices": { - "name": "DescribeServices", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DescribeServicesRequest" - }, - "output": { - "shape": "DescribeServicesResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "DescribeTaskDefinition": { - "name": "DescribeTaskDefinition", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DescribeTaskDefinitionRequest" - }, - "output": { - "shape": "DescribeTaskDefinitionResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "DescribeTaskSets": { - "name": "DescribeTaskSets", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DescribeTaskSetsRequest" - }, - "output": { - "shape": "DescribeTaskSetsResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "ServiceNotFoundException" - } - ] - }, - "DescribeTasks": { - "name": "DescribeTasks", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DescribeTasksRequest" - }, - "output": { - "shape": "DescribeTasksResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "DiscoverPollEndpoint": { - "name": "DiscoverPollEndpoint", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "DiscoverPollEndpointRequest" - }, - "output": { - "shape": "DiscoverPollEndpointResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "ExecuteCommand": { - "name": "ExecuteCommand", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ExecuteCommandRequest" - }, - "output": { - "shape": "ExecuteCommandResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "TargetNotConnectedException" - } - ] - }, - "GetTaskProtection": { - "name": "GetTaskProtection", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "GetTaskProtectionRequest" - }, - "output": { - "shape": "GetTaskProtectionResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ResourceNotFoundException" - }, - { - "shape": "ServerException" - }, - { - "shape": "UnsupportedFeatureException" - } - ] - }, - "ListAccountSettings": { - "name": "ListAccountSettings", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ListAccountSettingsRequest" - }, - "output": { - "shape": "ListAccountSettingsResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "ListAttributes": { - "name": "ListAttributes", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ListAttributesRequest" - }, - "output": { - "shape": "ListAttributesResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "ServerException" - }, - { - "shape": "InvalidParameterException" - } - ] - }, - "ListClusters": { - "name": "ListClusters", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ListClustersRequest" - }, - "output": { - "shape": "ListClustersResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "ListContainerInstances": { - "name": "ListContainerInstances", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ListContainerInstancesRequest" - }, - "output": { - "shape": "ListContainerInstancesResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "ServerException" - } - ] - }, - "ListServices": { - "name": "ListServices", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ListServicesRequest" - }, - "output": { - "shape": "ListServicesResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "ListServicesByNamespace": { - "name": "ListServicesByNamespace", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ListServicesByNamespaceRequest" - }, - "output": { - "shape": "ListServicesByNamespaceResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "NamespaceNotFoundException" - }, - { - "shape": "ServerException" - } - ] - }, - "ListTagsForResource": { - "name": "ListTagsForResource", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ListTagsForResourceRequest" - }, - "output": { - "shape": "ListTagsForResourceResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "ListTaskDefinitionFamilies": { - "name": "ListTaskDefinitionFamilies", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ListTaskDefinitionFamiliesRequest" - }, - "output": { - "shape": "ListTaskDefinitionFamiliesResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "ListTaskDefinitions": { - "name": "ListTaskDefinitions", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ListTaskDefinitionsRequest" - }, - "output": { - "shape": "ListTaskDefinitionsResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "ListTasks": { - "name": "ListTasks", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "ListTasksRequest" - }, - "output": { - "shape": "ListTasksResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "ServiceNotFoundException" - } - ] - }, - "PutAccountSetting": { - "name": "PutAccountSetting", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "PutAccountSettingRequest" - }, - "output": { - "shape": "PutAccountSettingResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "PutAccountSettingDefault": { - "name": "PutAccountSettingDefault", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "PutAccountSettingDefaultRequest" - }, - "output": { - "shape": "PutAccountSettingDefaultResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "PutAttributes": { - "name": "PutAttributes", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "PutAttributesRequest" - }, - "output": { - "shape": "PutAttributesResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "AttributeLimitExceededException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "TargetNotFoundException" - } - ] - }, - "PutClusterCapacityProviders": { - "name": "PutClusterCapacityProviders", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "PutClusterCapacityProvidersRequest" - }, - "output": { - "shape": "PutClusterCapacityProvidersResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ResourceInUseException" - }, - { - "shape": "ServerException" - }, - { - "shape": "UpdateInProgressException" - } - ] - }, - "RegisterContainerInstance": { - "name": "RegisterContainerInstance", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "RegisterContainerInstanceRequest" - }, - "output": { - "shape": "RegisterContainerInstanceResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "RegisterTaskDefinition": { - "name": "RegisterTaskDefinition", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "RegisterTaskDefinitionRequest" - }, - "output": { - "shape": "RegisterTaskDefinitionResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "LimitExceededException" - }, - { - "shape": "ServerException" - } - ] - }, - "RunTask": { - "name": "RunTask", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "RunTaskRequest" - }, - "output": { - "shape": "RunTaskResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "BlockedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "ConflictException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "PlatformUnknownException" - }, - { - "shape": "PlatformTaskDefinitionIncompatibilityException" - }, - { - "shape": "ServerException" - }, - { - "shape": "UnsupportedFeatureException" - } - ] - }, - "StartTask": { - "name": "StartTask", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "StartTaskRequest" - }, - "output": { - "shape": "StartTaskResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "NamespaceNotFoundException" - }, - { - "shape": "ServerException" - } - ] - }, - "StopTask": { - "name": "StopTask", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "StopTaskRequest" - }, - "output": { - "shape": "StopTaskResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "SubmitAttachmentStateChanges": { - "name": "SubmitAttachmentStateChanges", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "SubmitAttachmentStateChangesRequest" - }, - "output": { - "shape": "SubmitAttachmentStateChangesResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "SubmitContainerStateChange": { - "name": "SubmitContainerStateChange", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "SubmitContainerStateChangeRequest" - }, - "output": { - "shape": "SubmitContainerStateChangeResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "SubmitTaskStateChange": { - "name": "SubmitTaskStateChange", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "SubmitTaskStateChangeRequest" - }, - "output": { - "shape": "SubmitTaskStateChangeResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "TagResource": { - "name": "TagResource", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "TagResourceRequest" - }, - "output": { - "shape": "TagResourceResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "LimitExceededException" - }, - { - "shape": "ResourceNotFoundException" - }, - { - "shape": "ServerException" - } - ] - }, - "UntagResource": { - "name": "UntagResource", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "UntagResourceRequest" - }, - "output": { - "shape": "UntagResourceResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ResourceNotFoundException" - }, - { - "shape": "ServerException" - } - ] - }, - "UpdateCapacityProvider": { - "name": "UpdateCapacityProvider", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "UpdateCapacityProviderRequest" - }, - "output": { - "shape": "UpdateCapacityProviderResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "UpdateCluster": { - "name": "UpdateCluster", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "UpdateClusterRequest" - }, - "output": { - "shape": "UpdateClusterResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "NamespaceNotFoundException" - } - ] - }, - "UpdateClusterSettings": { - "name": "UpdateClusterSettings", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "UpdateClusterSettingsRequest" - }, - "output": { - "shape": "UpdateClusterSettingsResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "UpdateContainerAgent": { - "name": "UpdateContainerAgent", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "UpdateContainerAgentRequest" - }, - "output": { - "shape": "UpdateContainerAgentResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "MissingVersionException" - }, - { - "shape": "NoUpdateAvailableException" - }, - { - "shape": "ServerException" - }, - { - "shape": "UpdateInProgressException" - } - ] - }, - "UpdateContainerInstancesState": { - "name": "UpdateContainerInstancesState", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "UpdateContainerInstancesStateRequest" - }, - "output": { - "shape": "UpdateContainerInstancesStateResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - } - ] - }, - "UpdateService": { - "name": "UpdateService", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "UpdateServiceRequest" - }, - "output": { - "shape": "UpdateServiceResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "NamespaceNotFoundException" - }, - { - "shape": "PlatformTaskDefinitionIncompatibilityException" - }, - { - "shape": "ServerException" - }, - { - "shape": "ServiceNotFoundException" - }, - { - "shape": "ServiceNotActiveException" - }, - { - "shape": "PlatformUnknownException" - } - ] - }, - "UpdateServicePrimaryTaskSet": { - "name": "UpdateServicePrimaryTaskSet", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "UpdateServicePrimaryTaskSetRequest" - }, - "output": { - "shape": "UpdateServicePrimaryTaskSetResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ServerException" - }, - { - "shape": "ServiceNotFoundException" - }, - { - "shape": "ServiceNotActiveException" - }, - { - "shape": "TaskSetNotFoundException" - } - ] - }, - "UpdateTaskProtection": { - "name": "UpdateTaskProtection", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "UpdateTaskProtectionRequest" - }, - "output": { - "shape": "UpdateTaskProtectionResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "ResourceNotFoundException" - }, - { - "shape": "ServerException" - }, - { - "shape": "UnsupportedFeatureException" - } - ] - }, - "UpdateTaskSet": { - "name": "UpdateTaskSet", - "http": { - "method": "POST", - "requestUri": "/" - }, - "input": { - "shape": "UpdateTaskSetRequest" - }, - "output": { - "shape": "UpdateTaskSetResponse" - }, - "errors": [ - { - "shape": "AccessDeniedException" - }, - { - "shape": "ClientException" - }, - { - "shape": "ClusterNotFoundException" - }, - { - "shape": "InvalidParameterException" - }, - { - "shape": "LimitExceededException" - }, - { - "shape": "ServerException" - }, - { - "shape": "ServiceNotFoundException" - }, - { - "shape": "ServiceNotActiveException" - }, - { - "shape": "TaskSetNotFoundException" - }, - { - "shape": "UnsupportedFeatureException" - } - ] - } - }, - "shapes": { - "AccessDeniedException": { - "type": "structure", - "members": {}, - "exception": true - }, - "AccountDetail": { - "type": "structure", - "members": { - "accountId": { - "shape": "String" - }, - "credentialProvider": { - "shape": "String" - }, - "credentialToken": { - "shape": "SensitiveString" - }, - "token": { - "shape": "String" - } - } - }, - "AgentUpdateStatus": { - "type": "string", - "enum": [ - "PENDING", - "STAGING", - "STAGED", - "UPDATING", - "UPDATED", - "FAILED" - ] - }, - "ApplicationProtocol": { - "type": "string", - "enum": [ - "http", - "http2", - "grpc" - ] - }, - "AssignPublicIp": { - "type": "string", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "AssociateCapacityProvidersWithClusterRequest": { - "type": "structure", - "required": [ - "cluster", - "capacityProviders" - ], - "members": { - "cluster": { - "shape": "String" - }, - "capacityProviders": { - "shape": "StringList" - }, - "capacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - } - } - }, - "AssociateCapacityProvidersWithClusterResponse": { - "type": "structure", - "members": { - "associations": { - "shape": "ClusterCapacityProviderAssociations" - } - } - }, - "Attachment": { - "type": "structure", - "members": { - "id": { - "shape": "String" - }, - "type": { - "shape": "String" - }, - "status": { - "shape": "String" - }, - "details": { - "shape": "AttachmentDetails" - } - } - }, - "AttachmentDetails": { - "type": "list", - "member": { - "shape": "KeyValuePair" - } - }, - "AttachmentStateChange": { - "type": "structure", - "required": [ - "attachmentArn", - "status" - ], - "members": { - "attachmentArn": { - "shape": "String" - }, - "status": { - "shape": "String" - } - } - }, - "AttachmentStateChanges": { - "type": "list", - "member": { - "shape": "AttachmentStateChange" - } - }, - "Attachments": { - "type": "list", - "member": { - "shape": "Attachment" - } - }, - "Attribute": { - "type": "structure", - "required": [ - "name" - ], - "members": { - "name": { - "shape": "String" - }, - "value": { - "shape": "String" - }, - "targetType": { - "shape": "TargetType" - }, - "targetId": { - "shape": "String" - } - } - }, - "AttributeLimitExceededException": { - "type": "structure", - "members": {}, - "exception": true - }, - "Attributes": { - "type": "list", - "member": { - "shape": "Attribute" - } - }, - "AutoScalingGroupProvider": { - "type": "structure", - "required": [ - "autoScalingGroupArn" - ], - "members": { - "autoScalingGroupArn": { - "shape": "String" - }, - "managedScaling": { - "shape": "ManagedScaling" - }, - "managedTerminationProtection": { - "shape": "ManagedTerminationProtection" - } - } - }, - "AutoScalingGroupProviderUpdate": { - "type": "structure", - "members": { - "managedScaling": { - "shape": "ManagedScaling" - }, - "managedTerminationProtection": { - "shape": "ManagedTerminationProtection" - } - } - }, - "AwsVpcConfiguration": { - "type": "structure", - "members": { - "assignPublicIp": { - "shape": "AssignPublicIp" - }, - "securityGroups": { - "shape": "StringList" - }, - "subnets": { - "shape": "StringList" - } - } - }, - "BlockedException": { - "type": "structure", - "members": {}, - "exception": true - }, - "BlueGreenConfiguration": { - "type": "structure", - "members": { - "loadBalancerConfigurations": { - "shape": "LoadBalancerConfigurations" - } - } - }, - "Boolean": { - "type": "boolean" - }, - "BoxedBoolean": { - "type": "boolean", - "box": true - }, - "BoxedInteger": { - "type": "integer", - "box": true - }, - "CapacityProvider": { - "type": "structure", - "members": { - "capacityProviderArn": { - "shape": "String" - }, - "name": { - "shape": "String" - }, - "status": { - "shape": "CapacityProviderStatus" - }, - "autoScalingGroupProvider": { - "shape": "AutoScalingGroupProvider" - }, - "updateStatus": { - "shape": "CapacityProviderUpdateStatus" - }, - "updateStatusReason": { - "shape": "String" - }, - "tags": { - "shape": "Tags" - } - } - }, - "CapacityProviderField": { - "type": "string", - "enum": [ - "TAGS" - ] - }, - "CapacityProviderFieldList": { - "type": "list", - "member": { - "shape": "CapacityProviderField" - } - }, - "CapacityProviderStatus": { - "type": "string", - "enum": [ - "ACTIVE", - "INACTIVE" - ] - }, - "CapacityProviderStrategy": { - "type": "list", - "member": { - "shape": "CapacityProviderStrategyItem" - } - }, - "CapacityProviderStrategyItem": { - "type": "structure", - "required": [ - "capacityProvider" - ], - "members": { - "capacityProvider": { - "shape": "String" - }, - "weight": { - "shape": "CapacityProviderStrategyItemWeight" - }, - "base": { - "shape": "CapacityProviderStrategyItemBase" - } - } - }, - "CapacityProviderStrategyItemBase": { - "type": "integer", - "max": 100000, - "min": 0 - }, - "CapacityProviderStrategyItemWeight": { - "type": "integer", - "max": 1000, - "min": 0 - }, - "CapacityProviderUpdateStatus": { - "type": "string", - "enum": [ - "DELETE_IN_PROGRESS", - "DELETE_COMPLETE", - "DELETE_FAILED", - "UPDATE_IN_PROGRESS", - "UPDATE_COMPLETE", - "UPDATE_FAILED" - ] - }, - "CapacityProviders": { - "type": "list", - "member": { - "shape": "CapacityProvider" - } - }, - "ClientException": { - "type": "structure", - "members": {}, - "exception": true - }, - "Cluster": { - "type": "structure", - "members": { - "clusterArn": { - "shape": "String" - }, - "clusterName": { - "shape": "String" - }, - "configuration": { - "shape": "ClusterConfiguration" - }, - "serviceConnectDefaults": { - "shape": "ClusterServiceConnectDefaults" - }, - "status": { - "shape": "String" - }, - "registeredContainerInstancesCount": { - "shape": "Integer" - }, - "runningTasksCount": { - "shape": "Integer" - }, - "pendingTasksCount": { - "shape": "Integer" - }, - "activeServicesCount": { - "shape": "Integer" - }, - "statistics": { - "shape": "Statistics" - }, - "tags": { - "shape": "Tags" - }, - "settings": { - "shape": "ClusterSettings" - }, - "capacityProviders": { - "shape": "StringList" - }, - "defaultCapacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - }, - "attachments": { - "shape": "Attachments" - }, - "attachmentsStatus": { - "shape": "String" - } - } - }, - "ClusterCapacityProviderAssociation": { - "type": "structure", - "required": [ - "clusterCapacityProviderAssociationArn", - "cluster", - "capacityProviderName" - ], - "members": { - "clusterCapacityProviderAssociationArn": { - "shape": "String" - }, - "cluster": { - "shape": "String" - }, - "capacityProviderName": { - "shape": "String" - } - } - }, - "ClusterCapacityProviderAssociations": { - "type": "list", - "member": { - "shape": "ClusterCapacityProviderAssociation" - } - }, - "ClusterConfiguration": { - "type": "structure", - "members": { - "executeCommandConfiguration": { - "shape": "ExecuteCommandConfiguration" - } - } - }, - "ClusterContainsContainerInstancesException": { - "type": "structure", - "members": {}, - "exception": true - }, - "ClusterContainsServicesException": { - "type": "structure", - "members": {}, - "exception": true - }, - "ClusterContainsTasksException": { - "type": "structure", - "members": {}, - "exception": true - }, - "ClusterDefaults": { - "type": "structure", - "members": { - "awsvpcNetworkConfiguration": { - "shape": "NetworkConfiguration" - } - } - }, - "ClusterField": { - "type": "string", - "enum": [ - "ATTACHMENTS", - "CONFIGURATIONS", - "SETTINGS", - "STATISTICS", - "TAGS", - "DEFAULTS" - ] - }, - "ClusterFieldList": { - "type": "list", - "member": { - "shape": "ClusterField" - } - }, - "ClusterNotFoundException": { - "type": "structure", - "members": {}, - "exception": true - }, - "ClusterServiceConnectDefaults": { - "type": "structure", - "members": { - "namespace": { - "shape": "String" - } - } - }, - "ClusterServiceConnectDefaultsRequest": { - "type": "structure", - "members": { - "namespace": { - "shape": "String" - } - } - }, - "ClusterSetting": { - "type": "structure", - "members": { - "name": { - "shape": "ClusterSettingName" - }, - "value": { - "shape": "String" - } - } - }, - "ClusterSettingName": { - "type": "string", - "enum": [ - "containerInsights" - ] - }, - "ClusterSettings": { - "type": "list", - "member": { - "shape": "ClusterSetting" - } - }, - "Clusters": { - "type": "list", - "member": { - "shape": "Cluster" - } - }, - "Compatibility": { - "type": "string", - "enum": [ - "EC2", - "FARGATE", - "EXTERNAL" - ] - }, - "CompatibilityList": { - "type": "list", - "member": { - "shape": "Compatibility" - } - }, - "ConflictException": { - "type": "structure", - "members": { - "resourceIds": { - "shape": "ResourceIds" - } - }, - "exception": true - }, - "Connectivity": { - "type": "string", - "enum": [ - "CONNECTED", - "DISCONNECTED" - ] - }, - "Container": { - "type": "structure", - "members": { - "containerArn": { - "shape": "String" - }, - "taskArn": { - "shape": "String" - }, - "name": { - "shape": "String" - }, - "image": { - "shape": "String" - }, - "imageDigest": { - "shape": "String" - }, - "runtimeId": { - "shape": "String" - }, - "lastStatus": { - "shape": "String" - }, - "exitCode": { - "shape": "BoxedInteger" - }, - "reason": { - "shape": "String" - }, - "networkBindings": { - "shape": "NetworkBindings" - }, - "networkInterfaces": { - "shape": "NetworkInterfaces" - }, - "healthStatus": { - "shape": "HealthStatus" - }, - "managedAgents": { - "shape": "ManagedAgents" - }, - "cpu": { - "shape": "String" - }, - "memory": { - "shape": "String" - }, - "memoryReservation": { - "shape": "String" - }, - "gpuIds": { - "shape": "GpuIds" - } - } - }, - "ContainerCondition": { - "type": "string", - "enum": [ - "START", - "COMPLETE", - "SUCCESS", - "HEALTHY" - ] - }, - "ContainerDefinition": { - "type": "structure", - "required": [ - "name", - "image" - ], - "members": { - "name": { - "shape": "String" - }, - "image": { - "shape": "String" - }, - "repositoryCredentials": { - "shape": "RepositoryCredentials" - }, - "cpu": { - "shape": "Integer" - }, - "memory": { - "shape": "BoxedInteger" - }, - "memoryReservation": { - "shape": "BoxedInteger" - }, - "links": { - "shape": "StringList" - }, - "portMappings": { - "shape": "PortMappingList" - }, - "essential": { - "shape": "BoxedBoolean" - }, - "entryPoint": { - "shape": "StringList" - }, - "command": { - "shape": "StringList" - }, - "environment": { - "shape": "EnvironmentVariables" - }, - "mountPoints": { - "shape": "MountPointList" - }, - "volumesFrom": { - "shape": "VolumeFromList" - }, - "linuxParameters": { - "shape": "LinuxParameters" - }, - "secrets": { - "shape": "SecretList" - }, - "dependsOn": { - "shape": "ContainerDependencies" - }, - "startTimeout": { - "shape": "BoxedInteger" - }, - "stopTimeout": { - "shape": "BoxedInteger" - }, - "hostname": { - "shape": "String" - }, - "user": { - "shape": "String" - }, - "workingDirectory": { - "shape": "String" - }, - "disableNetworking": { - "shape": "BoxedBoolean" - }, - "privileged": { - "shape": "BoxedBoolean" - }, - "readonlyRootFilesystem": { - "shape": "BoxedBoolean" - }, - "dnsServers": { - "shape": "StringList" - }, - "dnsSearchDomains": { - "shape": "StringList" - }, - "extraHosts": { - "shape": "HostEntryList" - }, - "dockerSecurityOptions": { - "shape": "StringList" - }, - "interactive": { - "shape": "BoxedBoolean" - }, - "pseudoTerminal": { - "shape": "BoxedBoolean" - }, - "dockerLabels": { - "shape": "DockerLabelsMap" - }, - "ulimits": { - "shape": "UlimitList" - }, - "logConfiguration": { - "shape": "LogConfiguration" - }, - "healthCheck": { - "shape": "HealthCheck" - }, - "systemControls": { - "shape": "SystemControls" - }, - "resourceRequirements": { - "shape": "ResourceRequirements" - }, - "firelensConfiguration": { - "shape": "FirelensConfiguration" - }, - "credentialSpecs": { - "shape": "StringList" - } - } - }, - "ContainerDefinitions": { - "type": "list", - "member": { - "shape": "ContainerDefinition" - } - }, - "ContainerDependencies": { - "type": "list", - "member": { - "shape": "ContainerDependency" - } - }, - "ContainerDependency": { - "type": "structure", - "required": [ - "containerName", - "condition" - ], - "members": { - "containerName": { - "shape": "String" - }, - "condition": { - "shape": "ContainerCondition" - } - } - }, - "ContainerInstance": { - "type": "structure", - "members": { - "containerInstanceArn": { - "shape": "String" - }, - "ec2InstanceId": { - "shape": "String" - }, - "capacityProviderName": { - "shape": "String" - }, - "version": { - "shape": "Long" - }, - "versionInfo": { - "shape": "VersionInfo" - }, - "remainingResources": { - "shape": "Resources" - }, - "registeredResources": { - "shape": "Resources" - }, - "status": { - "shape": "String" - }, - "statusReason": { - "shape": "String" - }, - "agentConnected": { - "shape": "Boolean" - }, - "runningTasksCount": { - "shape": "Integer" - }, - "pendingTasksCount": { - "shape": "Integer" - }, - "agentUpdateStatus": { - "shape": "AgentUpdateStatus" - }, - "attributes": { - "shape": "Attributes" - }, - "registeredAt": { - "shape": "Timestamp" - }, - "attachments": { - "shape": "Attachments" - }, - "tags": { - "shape": "Tags" - } - } - }, - "ContainerInstanceField": { - "type": "string", - "enum": [ - "TAGS", - "CONTAINER_INSTANCE_HEALTH" - ] - }, - "ContainerInstanceFieldList": { - "type": "list", - "member": { - "shape": "ContainerInstanceField" - } - }, - "ContainerInstanceStatus": { - "type": "string", - "enum": [ - "ACTIVE", - "DRAINING", - "REGISTERING", - "DEREGISTERING", - "REGISTRATION_FAILED" - ] - }, - "ContainerInstances": { - "type": "list", - "member": { - "shape": "ContainerInstance" - } - }, - "ContainerOverride": { - "type": "structure", - "members": { - "name": { - "shape": "String" - }, - "command": { - "shape": "StringList" - }, - "environment": { - "shape": "EnvironmentVariables" - }, - "cpu": { - "shape": "BoxedInteger" - }, - "memory": { - "shape": "BoxedInteger" - }, - "memoryReservation": { - "shape": "BoxedInteger" - }, - "resourceRequirements": { - "shape": "ResourceRequirements" - } - } - }, - "ContainerOverrides": { - "type": "list", - "member": { - "shape": "ContainerOverride" - } - }, - "ContainerStateChange": { - "type": "structure", - "members": { - "containerName": { - "shape": "String" - }, - "imageDigest": { - "shape": "String" - }, - "runtimeId": { - "shape": "String" - }, - "exitCode": { - "shape": "BoxedInteger" - }, - "networkBindings": { - "shape": "NetworkBindings" - }, - "reason": { - "shape": "String" - }, - "status": { - "shape": "String" - } - } - }, - "ContainerStateChanges": { - "type": "list", - "member": { - "shape": "ContainerStateChange" - } - }, - "Containers": { - "type": "list", - "member": { - "shape": "Container" - } - }, - "CreateCapacityProviderRequest": { - "type": "structure", - "required": [ - "name", - "autoScalingGroupProvider" - ], - "members": { - "name": { - "shape": "String" - }, - "autoScalingGroupProvider": { - "shape": "AutoScalingGroupProvider" - }, - "tags": { - "shape": "Tags" - } - } - }, - "CreateCapacityProviderResponse": { - "type": "structure", - "members": { - "capacityProvider": { - "shape": "CapacityProvider" - } - } - }, - "CreateClusterRequest": { - "type": "structure", - "members": { - "clusterName": { - "shape": "String" - }, - "tags": { - "shape": "Tags" - }, - "settings": { - "shape": "ClusterSettings" - }, - "configuration": { - "shape": "ClusterConfiguration" - }, - "serviceConnectDefaults": { - "shape": "ClusterServiceConnectDefaultsRequest" - }, - "capacityProviders": { - "shape": "StringList" - }, - "defaultCapacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - } - } - }, - "CreateClusterResponse": { - "type": "structure", - "members": { - "cluster": { - "shape": "Cluster" - } - } - }, - "CreateServiceRequest": { - "type": "structure", - "required": [ - "serviceName" - ], - "members": { - "capacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - }, - "clientToken": { - "shape": "String" - }, - "cluster": { - "shape": "String" - }, - "deploymentConfiguration": { - "shape": "DeploymentConfiguration" - }, - "deploymentController": { - "shape": "DeploymentController" - }, - "desiredCount": { - "shape": "BoxedInteger" - }, - "enableECSManagedTags": { - "shape": "Boolean" - }, - "enableExecuteCommand": { - "shape": "Boolean" - }, - "healthCheckGracePeriodSeconds": { - "shape": "BoxedInteger" - }, - "launchType": { - "shape": "LaunchType" - }, - "loadBalancers": { - "shape": "LoadBalancers" - }, - "networkConfiguration": { - "shape": "NetworkConfiguration" - }, - "placementConstraints": { - "shape": "PlacementConstraints" - }, - "placementStrategy": { - "shape": "PlacementStrategies" - }, - "platformVersion": { - "shape": "String" - }, - "propagateTags": { - "shape": "PropagateTags" - }, - "role": { - "shape": "String" - }, - "schedulingStrategy": { - "shape": "SchedulingStrategy" - }, - "serviceName": { - "shape": "String" - }, - "serviceRegistries": { - "shape": "ServiceRegistries" - }, - "serviceConnectConfiguration": { - "shape": "ServiceConnectConfiguration" - }, - "tags": { - "shape": "Tags" - }, - "taskDefinition": { - "shape": "String" - } - } - }, - "CreateServiceResponse": { - "type": "structure", - "members": { - "service": { - "shape": "Service" - } - } - }, - "CreateTaskSetRequest": { - "type": "structure", - "required": [ - "service", - "cluster", - "taskDefinition" - ], - "members": { - "service": { - "shape": "String" - }, - "cluster": { - "shape": "String" - }, - "startedBy": { - "shape": "String" - }, - "externalId": { - "shape": "String" - }, - "taskDefinition": { - "shape": "String" - }, - "networkConfiguration": { - "shape": "NetworkConfiguration" - }, - "loadBalancers": { - "shape": "LoadBalancers" - }, - "serviceRegistries": { - "shape": "ServiceRegistries" - }, - "launchType": { - "shape": "LaunchType" - }, - "capacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - }, - "platformVersion": { - "shape": "String" - }, - "scale": { - "shape": "Scale" - }, - "clientToken": { - "shape": "String" - }, - "tags": { - "shape": "Tags" - } - } - }, - "CreateTaskSetResponse": { - "type": "structure", - "members": { - "taskSet": { - "shape": "TaskSet" - } - } - }, - "DeleteAccountSettingRequest": { - "type": "structure", - "required": [ - "name" - ], - "members": { - "name": { - "shape": "SettingName" - }, - "principalArn": { - "shape": "String" - } - } - }, - "DeleteAccountSettingResponse": { - "type": "structure", - "members": { - "setting": { - "shape": "Setting" - } - } - }, - "DeleteAttributesRequest": { - "type": "structure", - "required": [ - "attributes" - ], - "members": { - "cluster": { - "shape": "String" - }, - "attributes": { - "shape": "Attributes" - } - } - }, - "DeleteAttributesResponse": { - "type": "structure", - "members": { - "attributes": { - "shape": "Attributes" - } - } - }, - "DeleteCapacityProviderRequest": { - "type": "structure", - "required": [ - "capacityProvider" - ], - "members": { - "capacityProvider": { - "shape": "String" - } - } - }, - "DeleteCapacityProviderResponse": { - "type": "structure", - "members": { - "capacityProvider": { - "shape": "CapacityProvider" - } - } - }, - "DeleteClusterRequest": { - "type": "structure", - "required": [ - "cluster" - ], - "members": { - "cluster": { - "shape": "String" - } - } - }, - "DeleteClusterResponse": { - "type": "structure", - "members": { - "cluster": { - "shape": "Cluster" - } - } - }, - "DeleteServiceRequest": { - "type": "structure", - "required": [ - "service" - ], - "members": { - "cluster": { - "shape": "String" - }, - "service": { - "shape": "String" - }, - "force": { - "shape": "BoxedBoolean" - } - } - }, - "DeleteServiceResponse": { - "type": "structure", - "members": { - "service": { - "shape": "Service" - } - } - }, - "DeleteTaskSetRequest": { - "type": "structure", - "required": [ - "cluster", - "service", - "taskSet" - ], - "members": { - "cluster": { - "shape": "String" - }, - "service": { - "shape": "String" - }, - "taskSet": { - "shape": "String" - }, - "force": { - "shape": "BoxedBoolean" - } - } - }, - "DeleteTaskSetResponse": { - "type": "structure", - "members": { - "taskSet": { - "shape": "TaskSet" - } - } - }, - "Deployment": { - "type": "structure", - "members": { - "id": { - "shape": "String" - }, - "status": { - "shape": "String" - }, - "taskDefinition": { - "shape": "String" - }, - "desiredCount": { - "shape": "Integer" - }, - "pendingCount": { - "shape": "Integer" - }, - "runningCount": { - "shape": "Integer" - }, - "createdAt": { - "shape": "Timestamp" - }, - "updatedAt": { - "shape": "Timestamp" - }, - "capacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - }, - "launchType": { - "shape": "LaunchType" - }, - "platformVersion": { - "shape": "String" - }, - "networkConfiguration": { - "shape": "NetworkConfiguration" - }, - "serviceConnectConfiguration": { - "shape": "ServiceConnectConfiguration" - }, - "serviceConnectResources": { - "shape": "ServiceConnectServiceResourceList" - } - } - }, - "DeploymentAlarms": { - "type": "structure", - "required": [ - "alarmNames", - "rollback", - "enable" - ], - "members": { - "alarmNames": { - "shape": "StringList" - }, - "rollback": { - "shape": "Boolean" - }, - "enable": { - "shape": "Boolean" - } - } - }, - "DeploymentCircuitBreaker": { - "type": "structure", - "required": [ - "enable", - "rollback" - ], - "members": { - "enable": { - "shape": "Boolean" - }, - "rollback": { - "shape": "Boolean" - } - } - }, - "DeploymentConfiguration": { - "type": "structure", - "members": { - "deploymentCircuitBreaker": { - "shape": "DeploymentCircuitBreaker" - }, - "maximumPercent": { - "shape": "BoxedInteger" - }, - "minimumHealthyPercent": { - "shape": "BoxedInteger" - }, - "alarms": { - "shape": "DeploymentAlarms" - } - } - }, - "DeploymentController": { - "type": "structure", - "required": [ - "type" - ], - "members": { - "type": { - "shape": "DeploymentControllerType" - } - } - }, - "DeploymentControllerType": { - "type": "string", - "enum": [ - "ECS", - "CODE_DEPLOY", - "EXTERNAL" - ] - }, - "DeploymentStrategy": { - "type": "string", - "enum": [ - "ROLLING", - "BLUEGREEN" - ] - }, - "Deployments": { - "type": "list", - "member": { - "shape": "Deployment" - } - }, - "DeregisterContainerInstanceRequest": { - "type": "structure", - "required": [ - "containerInstance" - ], - "members": { - "cluster": { - "shape": "String" - }, - "containerInstance": { - "shape": "String" - }, - "force": { - "shape": "BoxedBoolean" - } - } - }, - "DeregisterContainerInstanceResponse": { - "type": "structure", - "members": { - "containerInstance": { - "shape": "ContainerInstance" - } - } - }, - "DeregisterTaskDefinitionRequest": { - "type": "structure", - "required": [ - "taskDefinition" - ], - "members": { - "taskDefinition": { - "shape": "String" - } - } - }, - "DeregisterTaskDefinitionResponse": { - "type": "structure", - "members": { - "taskDefinition": { - "shape": "TaskDefinition" - } - } - }, - "DescribeCapacityProvidersRequest": { - "type": "structure", - "members": { - "capacityProviders": { - "shape": "StringList" - }, - "include": { - "shape": "CapacityProviderFieldList" - }, - "maxResults": { - "shape": "BoxedInteger" - }, - "nextToken": { - "shape": "String" - } - } - }, - "DescribeCapacityProvidersResponse": { - "type": "structure", - "members": { - "capacityProviders": { - "shape": "CapacityProviders" - }, - "failures": { - "shape": "Failures" - }, - "nextToken": { - "shape": "String" - } - } - }, - "DescribeClusterCapacityProviderAssociationsRequest": { - "type": "structure", - "required": [ - "cluster" - ], - "members": { - "cluster": { - "shape": "String" - }, - "capacityProviders": { - "shape": "StringList" - }, - "maxResults": { - "shape": "BoxedInteger" - }, - "nextToken": { - "shape": "String" - } - } - }, - "DescribeClusterCapacityProviderAssociationsResponse": { - "type": "structure", - "members": { - "associations": { - "shape": "ClusterCapacityProviderAssociations" - }, - "nextToken": { - "shape": "String" - } - } - }, - "DescribeClustersRequest": { - "type": "structure", - "members": { - "clusters": { - "shape": "StringList" - }, - "include": { - "shape": "ClusterFieldList" - } - } - }, - "DescribeClustersResponse": { - "type": "structure", - "members": { - "clusters": { - "shape": "Clusters" - }, - "failures": { - "shape": "Failures" - } - } - }, - "DescribeContainerInstancesRequest": { - "type": "structure", - "required": [ - "containerInstances" - ], - "members": { - "cluster": { - "shape": "String" - }, - "containerInstances": { - "shape": "StringList" - }, - "include": { - "shape": "ContainerInstanceFieldList" - } - } - }, - "DescribeContainerInstancesResponse": { - "type": "structure", - "members": { - "containerInstances": { - "shape": "ContainerInstances" - }, - "failures": { - "shape": "Failures" - } - } - }, - "DescribeServicesRequest": { - "type": "structure", - "required": [ - "services" - ], - "members": { - "cluster": { - "shape": "String" - }, - "services": { - "shape": "StringList" - }, - "include": { - "shape": "ServiceFieldList" - } - } - }, - "DescribeServicesResponse": { - "type": "structure", - "members": { - "services": { - "shape": "Services" - }, - "failures": { - "shape": "Failures" - } - } - }, - "DescribeTaskDefinitionRequest": { - "type": "structure", - "required": [ - "taskDefinition" - ], - "members": { - "taskDefinition": { - "shape": "String" - }, - "include": { - "shape": "TaskDefinitionFieldList" - } - } - }, - "DescribeTaskDefinitionResponse": { - "type": "structure", - "members": { - "taskDefinition": { - "shape": "TaskDefinition" - }, - "tags": { - "shape": "Tags" - } - } - }, - "DescribeTaskSetsRequest": { - "type": "structure", - "required": [ - "cluster", - "service", - "taskSets" - ], - "members": { - "cluster": { - "shape": "String" - }, - "service": { - "shape": "String" - }, - "taskSets": { - "shape": "StringList" - }, - "include": { - "shape": "TaskSetFieldList" - } - } - }, - "DescribeTaskSetsResponse": { - "type": "structure", - "members": { - "taskSets": { - "shape": "TaskSets" - }, - "failures": { - "shape": "Failures" - } - } - }, - "DescribeTasksRequest": { - "type": "structure", - "required": [ - "tasks" - ], - "members": { - "cluster": { - "shape": "String" - }, - "tasks": { - "shape": "StringList" - }, - "include": { - "shape": "TaskFieldList" - } - } - }, - "DescribeTasksResponse": { - "type": "structure", - "members": { - "tasks": { - "shape": "Tasks" - }, - "failures": { - "shape": "Failures" - } - } - }, - "DesiredStatus": { - "type": "string", - "enum": [ - "RUNNING", - "PENDING", - "STOPPED" - ] - }, - "Device": { - "type": "structure", - "required": [ - "hostPath" - ], - "members": { - "hostPath": { - "shape": "String" - }, - "containerPath": { - "shape": "String" - }, - "permissions": { - "shape": "DeviceCgroupPermissions" - } - } - }, - "DeviceCgroupPermission": { - "type": "string", - "enum": [ - "read", - "write", - "mknod" - ] - }, - "DeviceCgroupPermissions": { - "type": "list", - "member": { - "shape": "DeviceCgroupPermission" - } - }, - "DevicesList": { - "type": "list", - "member": { - "shape": "Device" - } - }, - "DisassociateCapacityProvidersFromClusterRequest": { - "type": "structure", - "required": [ - "cluster", - "capacityProviders" - ], - "members": { - "cluster": { - "shape": "String" - }, - "capacityProviders": { - "shape": "StringList" - } - } - }, - "DisassociateCapacityProvidersFromClusterResponse": { - "type": "structure", - "members": { - "associations": { - "shape": "ClusterCapacityProviderAssociations" - } - } - }, - "DiscoverPollEndpointRequest": { - "type": "structure", - "members": { - "containerInstance": { - "shape": "String" - }, - "cluster": { - "shape": "String" - } - } - }, - "DiscoverPollEndpointResponse": { - "type": "structure", - "members": { - "endpoint": { - "shape": "String" - }, - "telemetryEndpoint": { - "shape": "String" - }, - "serviceConnectEndpoint": { - "shape": "String" - } - } - }, - "DockerLabelsMap": { - "type": "map", - "key": { - "shape": "String" - }, - "value": { - "shape": "String" - } - }, - "DockerVolumeConfiguration": { - "type": "structure", - "members": { - "scope": { - "shape": "Scope" - }, - "autoprovision": { - "shape": "BoxedBoolean" - }, - "driver": { - "shape": "String" - }, - "driverOpts": { - "shape": "StringMap" - }, - "labels": { - "shape": "StringMap" - } - } - }, - "Double": { - "type": "double" - }, - "Duration": { - "type": "integer", - "max": 2147483647, - "min": 0 - }, - "EFSAuthorizationConfigIAM": { - "type": "string", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "EFSTransitEncryption": { - "type": "string", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "EnvironmentFile": { - "type": "structure", - "required": [ - "value", - "type" - ], - "members": { - "value": { - "shape": "String" - }, - "type": { - "shape": "EnvironmentFileType" - } - } - }, - "EnvironmentFileType": { - "type": "string", - "enum": [ - "s3" - ] - }, - "EnvironmentFiles": { - "type": "list", - "member": { - "shape": "EnvironmentFile" - } - }, - "EnvironmentVariables": { - "type": "list", - "member": { - "shape": "KeyValuePair" - }, - "sensitive": true - }, - "EphemeralStorage": { - "type": "structure", - "required": [ - "sizeInGiB" - ], - "members": { - "sizeInGiB": { - "shape": "Integer" - } - } - }, - "ExecuteCommandConfiguration": { - "type": "structure", - "members": { - "kmsKeyId": { - "shape": "String" - }, - "logging": { - "shape": "ExecuteCommandLogging" - }, - "logConfiguration": { - "shape": "ExecuteCommandLogConfiguration" - } - } - }, - "ExecuteCommandLogConfiguration": { - "type": "structure", - "members": { - "cloudWatchLogGroupName": { - "shape": "String" - }, - "cloudWatchEncryptionEnabled": { - "shape": "Boolean" - }, - "s3BucketName": { - "shape": "String" - }, - "s3EncryptionEnabled": { - "shape": "Boolean" - }, - "s3KeyPrefix": { - "shape": "String" - } - } - }, - "ExecuteCommandLogging": { - "type": "string", - "enum": [ - "NONE", - "DEFAULT", - "OVERRIDE" - ] - }, - "ExecuteCommandRequest": { - "type": "structure", - "required": [ - "command", - "interactive", - "task" - ], - "members": { - "cluster": { - "shape": "String" - }, - "container": { - "shape": "String" - }, - "command": { - "shape": "String" - }, - "interactive": { - "shape": "Boolean" - }, - "task": { - "shape": "String" - } - } - }, - "ExecuteCommandResponse": { - "type": "structure", - "members": { - "clusterArn": { - "shape": "String" - }, - "containerArn": { - "shape": "String" - }, - "containerName": { - "shape": "String" - }, - "interactive": { - "shape": "Boolean" - }, - "session": { - "shape": "Session" - }, - "taskArn": { - "shape": "String" - } - } - }, - "Failure": { - "type": "structure", - "members": { - "arn": { - "shape": "String" - }, - "reason": { - "shape": "String" - }, - "detail": { - "shape": "String" - } - } - }, - "Failures": { - "type": "list", - "member": { - "shape": "Failure" - } - }, - "FirelensConfiguration": { - "type": "structure", - "required": [ - "type" - ], - "members": { - "type": { - "shape": "FirelensConfigurationType" - }, - "options": { - "shape": "FirelensConfigurationOptionsMap" - } - } - }, - "FirelensConfigurationOptionsMap": { - "type": "map", - "key": { - "shape": "String" - }, - "value": { - "shape": "String" - } - }, - "FirelensConfigurationType": { - "type": "string", - "enum": [ - "fluentd", - "fluentbit" - ] - }, - "GetTaskProtectionRequest": { - "type": "structure", - "required": [ - "cluster" - ], - "members": { - "cluster": { - "shape": "String" - }, - "tasks": { - "shape": "StringList" - } - } - }, - "GetTaskProtectionResponse": { - "type": "structure", - "members": { - "protectedTasks": { - "shape": "ProtectedTasks" - }, - "failures": { - "shape": "Failures" - } - } - }, - "GpuIds": { - "type": "list", - "member": { - "shape": "String" - } - }, - "HealthCheck": { - "type": "structure", - "required": [ - "command" - ], - "members": { - "command": { - "shape": "StringList" - }, - "interval": { - "shape": "BoxedInteger" - }, - "timeout": { - "shape": "BoxedInteger" - }, - "retries": { - "shape": "BoxedInteger" - }, - "startPeriod": { - "shape": "BoxedInteger" - } - } - }, - "HealthStatus": { - "type": "string", - "enum": [ - "HEALTHY", - "UNHEALTHY", - "UNKNOWN" - ] - }, - "HostEntry": { - "type": "structure", - "required": [ - "hostname", - "ipAddress" - ], - "members": { - "hostname": { - "shape": "String" - }, - "ipAddress": { - "shape": "String" - } - } - }, - "HostEntryList": { - "type": "list", - "member": { - "shape": "HostEntry" - } - }, - "HostVolumeProperties": { - "type": "structure", - "members": { - "sourcePath": { - "shape": "String" - } - } - }, - "InferenceAccelerator": { - "type": "structure", - "required": [ - "deviceName", - "deviceType" - ], - "members": { - "deviceName": { - "shape": "String" - }, - "deviceType": { - "shape": "String" - } - } - }, - "InferenceAcceleratorOverride": { - "type": "structure", - "members": { - "deviceName": { - "shape": "String" - }, - "deviceType": { - "shape": "String" - } - } - }, - "InferenceAcceleratorOverrides": { - "type": "list", - "member": { - "shape": "InferenceAcceleratorOverride" - } - }, - "InferenceAccelerators": { - "type": "list", - "member": { - "shape": "InferenceAccelerator" - } - }, - "InstanceHealthCheckType": { - "type": "string", - "enum": [ - "CONTAINER_RUNTIME" - ] - }, - "Integer": { - "type": "integer" - }, - "InterfaceOwner": { - "type": "string", - "enum": [ - "CALLER", - "ORIGINATOR" - ] - }, - "InvalidParameterException": { - "type": "structure", - "members": {}, - "exception": true - }, - "IpcMode": { - "type": "string", - "enum": [ - "host", - "task", - "none" - ] - }, - "KernelCapabilities": { - "type": "structure", - "members": { - "add": { - "shape": "StringList" - }, - "drop": { - "shape": "StringList" - } - } - }, - "KeyValuePair": { - "type": "structure", - "members": { - "name": { - "shape": "String" - }, - "value": { - "shape": "String" - } - } - }, - "LaunchType": { - "type": "string", - "enum": [ - "EC2", - "FARGATE", - "EXTERNAL" - ] - }, - "LimitExceededException": { - "type": "structure", - "members": {}, - "exception": true - }, - "LinuxParameters": { - "type": "structure", - "members": { - "capabilities": { - "shape": "KernelCapabilities" - }, - "devices": { - "shape": "DevicesList" - }, - "initProcessEnabled": { - "shape": "BoxedBoolean" - }, - "sharedMemorySize": { - "shape": "BoxedInteger" - }, - "tmpfs": { - "shape": "TmpfsList" - }, - "maxSwap": { - "shape": "BoxedInteger" - }, - "swappiness": { - "shape": "BoxedInteger" - } - } - }, - "ListAccountSettingsRequest": { - "type": "structure", - "members": { - "name": { - "shape": "SettingName" - }, - "value": { - "shape": "String" - }, - "principalArn": { - "shape": "String" - }, - "effectiveSettings": { - "shape": "Boolean" - }, - "nextToken": { - "shape": "String" - }, - "maxResults": { - "shape": "Integer" - } - } - }, - "ListAccountSettingsResponse": { - "type": "structure", - "members": { - "settings": { - "shape": "Settings" - }, - "nextToken": { - "shape": "String" - } - } - }, - "ListAttributesRequest": { - "type": "structure", - "required": [ - "targetType" - ], - "members": { - "cluster": { - "shape": "String" - }, - "targetType": { - "shape": "TargetType" - }, - "attributeName": { - "shape": "String" - }, - "attributeValue": { - "shape": "String" - }, - "nextToken": { - "shape": "String" - }, - "maxResults": { - "shape": "BoxedInteger" - } - } - }, - "ListAttributesResponse": { - "type": "structure", - "members": { - "attributes": { - "shape": "Attributes" - }, - "nextToken": { - "shape": "String" - } - } - }, - "ListClustersRequest": { - "type": "structure", - "members": { - "nextToken": { - "shape": "String" - }, - "maxResults": { - "shape": "BoxedInteger" - } - } - }, - "ListClustersResponse": { - "type": "structure", - "members": { - "clusterArns": { - "shape": "StringList" - }, - "nextToken": { - "shape": "String" - } - } - }, - "ListContainerInstancesRequest": { - "type": "structure", - "members": { - "cluster": { - "shape": "String" - }, - "filter": { - "shape": "String" - }, - "nextToken": { - "shape": "String" - }, - "maxResults": { - "shape": "BoxedInteger" - }, - "status": { - "shape": "ContainerInstanceStatus" - } - } - }, - "ListContainerInstancesResponse": { - "type": "structure", - "members": { - "containerInstanceArns": { - "shape": "StringList" - }, - "nextToken": { - "shape": "String" - } - } - }, - "ListServicesByNamespaceRequest": { - "type": "structure", - "required": [ - "namespace" - ], - "members": { - "namespace": { - "shape": "String" - }, - "nextToken": { - "shape": "String" - }, - "maxResults": { - "shape": "BoxedInteger" - } - } - }, - "ListServicesByNamespaceResponse": { - "type": "structure", - "members": { - "serviceArns": { - "shape": "StringList" - }, - "nextToken": { - "shape": "String" - } - } - }, - "ListServicesRequest": { - "type": "structure", - "members": { - "cluster": { - "shape": "String" - }, - "nextToken": { - "shape": "String" - }, - "maxResults": { - "shape": "BoxedInteger" - }, - "launchType": { - "shape": "LaunchType" - }, - "schedulingStrategy": { - "shape": "SchedulingStrategy" - } - } - }, - "ListServicesResponse": { - "type": "structure", - "members": { - "serviceArns": { - "shape": "StringList" - }, - "nextToken": { - "shape": "String" - } - } - }, - "ListTagsForResourceRequest": { - "type": "structure", - "required": [ - "resourceArn" - ], - "members": { - "resourceArn": { - "shape": "String" - } - } - }, - "ListTagsForResourceResponse": { - "type": "structure", - "members": { - "tags": { - "shape": "Tags" - } - } - }, - "ListTaskDefinitionFamiliesRequest": { - "type": "structure", - "members": { - "familyPrefix": { - "shape": "String" - }, - "status": { - "shape": "TaskDefinitionFamilyStatus" - }, - "nextToken": { - "shape": "String" - }, - "maxResults": { - "shape": "BoxedInteger" - } - } - }, - "ListTaskDefinitionFamiliesResponse": { - "type": "structure", - "members": { - "families": { - "shape": "StringList" - }, - "nextToken": { - "shape": "String" - } - } - }, - "ListTaskDefinitionsRequest": { - "type": "structure", - "members": { - "familyPrefix": { - "shape": "String" - }, - "status": { - "shape": "TaskDefinitionStatus" - }, - "sort": { - "shape": "SortOrder" - }, - "nextToken": { - "shape": "String" - }, - "maxResults": { - "shape": "BoxedInteger" - } - } - }, - "ListTaskDefinitionsResponse": { - "type": "structure", - "members": { - "taskDefinitionArns": { - "shape": "StringList" - }, - "nextToken": { - "shape": "String" - } - } - }, - "ListTasksRequest": { - "type": "structure", - "members": { - "cluster": { - "shape": "String" - }, - "containerInstance": { - "shape": "String" - }, - "family": { - "shape": "String" - }, - "nextToken": { - "shape": "String" - }, - "maxResults": { - "shape": "BoxedInteger" - }, - "startedBy": { - "shape": "String" - }, - "serviceName": { - "shape": "String" - }, - "desiredStatus": { - "shape": "DesiredStatus" - }, - "launchType": { - "shape": "LaunchType" - } - } - }, - "ListTasksResponse": { - "type": "structure", - "members": { - "taskArns": { - "shape": "StringList" - }, - "nextToken": { - "shape": "String" - } - } - }, - "LoadBalancer": { - "type": "structure", - "members": { - "loadBalancerName": { - "shape": "String" - }, - "targetGroupArn": { - "shape": "String" - }, - "containerName": { - "shape": "String" - }, - "containerPort": { - "shape": "BoxedInteger" - } - } - }, - "LoadBalancerConfiguration": { - "type": "structure", - "required": [ - "targetGroupArns", - "prodListenerArn" - ], - "members": { - "targetGroupArns": { - "shape": "TargetGroupArnList" - }, - "prodListenerArn": { - "shape": "String" - } - } - }, - "LoadBalancerConfigurations": { - "type": "list", - "member": { - "shape": "LoadBalancerConfiguration" - }, - "max": 1 - }, - "LoadBalancerMapping": { - "type": "structure", - "members": { - "currentLoadBalancer": { - "shape": "LoadBalancer" - }, - "newLoadBalancer": { - "shape": "LoadBalancer" - } - } - }, - "LoadBalancerMappings": { - "type": "list", - "member": { - "shape": "LoadBalancerMapping" - } - }, - "LoadBalancers": { - "type": "list", - "member": { - "shape": "LoadBalancer" - } - }, - "LogConfiguration": { - "type": "structure", - "required": [ - "logDriver" - ], - "members": { - "logDriver": { - "shape": "LogDriver" - }, - "options": { - "shape": "LogConfigurationOptionsMap" - }, - "secretOptions": { - "shape": "SecretList" - } - } - }, - "LogConfigurationOptionsMap": { - "type": "map", - "key": { - "shape": "String" - }, - "value": { - "shape": "String" - } - }, - "LogDriver": { - "type": "string", - "enum": [ - "json-file", - "syslog", - "journald", - "gelf", - "fluentd", - "awslogs", - "splunk", - "awsfirelens" - ] - }, - "Long": { - "type": "long" - }, - "ManagedAgent": { - "type": "structure", - "members": { - "lastStartedAt": { - "shape": "Timestamp" - }, - "name": { - "shape": "ManagedAgentName" - }, - "reason": { - "shape": "String" - }, - "lastStatus": { - "shape": "String" - } - } - }, - "ManagedAgentName": { - "type": "string", - "enum": [ - "ExecuteCommandAgent" - ] - }, - "ManagedAgentStateChange": { - "type": "structure", - "required": [ - "containerName", - "managedAgentName", - "status" - ], - "members": { - "containerName": { - "shape": "String" - }, - "managedAgentName": { - "shape": "ManagedAgentName" - }, - "status": { - "shape": "String" - }, - "reason": { - "shape": "String" - } - } - }, - "ManagedAgentStateChanges": { - "type": "list", - "member": { - "shape": "ManagedAgentStateChange" - } - }, - "ManagedAgents": { - "type": "list", - "member": { - "shape": "ManagedAgent" - } - }, - "ManagedScaling": { - "type": "structure", - "members": { - "status": { - "shape": "ManagedScalingStatus" - }, - "targetCapacity": { - "shape": "ManagedScalingTargetCapacity" - }, - "minimumScalingStepSize": { - "shape": "ManagedScalingStepSize" - }, - "maximumScalingStepSize": { - "shape": "ManagedScalingStepSize" - }, - "instanceWarmupPeriod": { - "shape": "ManagedScalingInstanceWarmupPeriod" - }, - "scalingApproach": { - "shape": "ManagedScalingScalingApproach" - } - } - }, - "ManagedScalingInstanceWarmupPeriod": { - "type": "integer", - "max": 10000, - "min": 0 - }, - "ManagedScalingScalingApproach": { - "type": "string", - "enum": [ - "SCALING_POLICY", - "SCALING_PLAN" - ] - }, - "ManagedScalingStatus": { - "type": "string", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "ManagedScalingStepSize": { - "type": "integer", - "max": 10000, - "min": 1 - }, - "ManagedScalingTargetCapacity": { - "type": "integer", - "max": 100, - "min": 1 - }, - "ManagedTerminationProtection": { - "type": "string", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "MissingVersionException": { - "type": "structure", - "members": {}, - "exception": true - }, - "MountPoint": { - "type": "structure", - "members": { - "sourceVolume": { - "shape": "String" - }, - "containerPath": { - "shape": "String" - }, - "readOnly": { - "shape": "BoxedBoolean" - } - } - }, - "MountPointList": { - "type": "list", - "member": { - "shape": "MountPoint" - } - }, - "NamespaceNotFoundException": { - "type": "structure", - "members": {}, - "exception": true - }, - "NetworkBinding": { - "type": "structure", - "members": { - "bindIP": { - "shape": "String" - }, - "containerPort": { - "shape": "BoxedInteger" - }, - "hostPort": { - "shape": "BoxedInteger" - }, - "protocol": { - "shape": "TransportProtocol" - } - } - }, - "NetworkBindings": { - "type": "list", - "member": { - "shape": "NetworkBinding" - } - }, - "NetworkConfiguration": { - "type": "structure", - "members": { - "awsvpcConfiguration": { - "shape": "AwsVpcConfiguration" - } - } - }, - "NetworkInterface": { - "type": "structure", - "members": { - "attachmentId": { - "shape": "String" - }, - "privateIpv4Address": { - "shape": "String" - }, - "ipv6Address": { - "shape": "String" - } - } - }, - "NetworkInterfaces": { - "type": "list", - "member": { - "shape": "NetworkInterface" - } - }, - "NetworkMode": { - "type": "string", - "enum": [ - "bridge", - "host", - "awsvpc", - "none" - ] - }, - "NoUpdateAvailableException": { - "type": "structure", - "members": {}, - "exception": true - }, - "PidMode": { - "type": "string", - "enum": [ - "host", - "task" - ] - }, - "PlacementConstraint": { - "type": "structure", - "members": { - "type": { - "shape": "PlacementConstraintType" - }, - "expression": { - "shape": "String" - } - } - }, - "PlacementConstraintType": { - "type": "string", - "enum": [ - "distinctInstance", - "memberOf" - ] - }, - "PlacementConstraints": { - "type": "list", - "member": { - "shape": "PlacementConstraint" - } - }, - "PlacementStrategies": { - "type": "list", - "member": { - "shape": "PlacementStrategy" - } - }, - "PlacementStrategy": { - "type": "structure", - "members": { - "type": { - "shape": "PlacementStrategyType" - }, - "field": { - "shape": "String" - } - } - }, - "PlacementStrategyType": { - "type": "string", - "enum": [ - "random", - "spread", - "binpack" - ] - }, - "PlatformDevice": { - "type": "structure", - "required": [ - "id", - "type" - ], - "members": { - "id": { - "shape": "String" - }, - "type": { - "shape": "PlatformDeviceType" - } - } - }, - "PlatformDeviceType": { - "type": "string", - "enum": [ - "GPU" - ] - }, - "PlatformDevices": { - "type": "list", - "member": { - "shape": "PlatformDevice" - } - }, - "PlatformTaskDefinitionIncompatibilityException": { - "type": "structure", - "members": {}, - "exception": true - }, - "PlatformUnknownException": { - "type": "structure", - "members": {}, - "exception": true - }, - "PortMapping": { - "type": "structure", - "members": { - "name": { - "shape": "String" - }, - "containerPort": { - "shape": "BoxedInteger" - }, - "hostPort": { - "shape": "BoxedInteger" - }, - "protocol": { - "shape": "TransportProtocol" - }, - "appProtocol": { - "shape": "ApplicationProtocol" - } - } - }, - "PortMappingList": { - "type": "list", - "member": { - "shape": "PortMapping" - } - }, - "PortNumber": { - "type": "integer", - "box": true, - "max": 65535, - "min": 0 - }, - "PropagateTags": { - "type": "string", - "enum": [ - "TASK_DEFINITION", - "SERVICE", - "NONE" - ] - }, - "ProtectedTask": { - "type": "structure", - "members": { - "taskArn": { - "shape": "String" - }, - "protectionEnabled": { - "shape": "Boolean" - }, - "expirationDate": { - "shape": "Timestamp" - } - } - }, - "ProtectedTasks": { - "type": "list", - "member": { - "shape": "ProtectedTask" - } - }, - "ProxyConfiguration": { - "type": "structure", - "required": [ - "containerName" - ], - "members": { - "type": { - "shape": "ProxyConfigurationType" - }, - "containerName": { - "shape": "String" - }, - "properties": { - "shape": "ProxyConfigurationProperties" - } - } - }, - "ProxyConfigurationProperties": { - "type": "list", - "member": { - "shape": "KeyValuePair" - } - }, - "ProxyConfigurationType": { - "type": "string", - "enum": [ - "APPMESH" - ] - }, - "PutAccountSettingDefaultRequest": { - "type": "structure", - "required": [ - "name", - "value" - ], - "members": { - "name": { - "shape": "SettingName" - }, - "value": { - "shape": "String" - } - } - }, - "PutAccountSettingDefaultResponse": { - "type": "structure", - "members": { - "setting": { - "shape": "Setting" - } - } - }, - "PutAccountSettingRequest": { - "type": "structure", - "required": [ - "name", - "value" - ], - "members": { - "name": { - "shape": "SettingName" - }, - "value": { - "shape": "String" - }, - "principalArn": { - "shape": "String" - } - } - }, - "PutAccountSettingResponse": { - "type": "structure", - "members": { - "setting": { - "shape": "Setting" - } - } - }, - "PutAttributesRequest": { - "type": "structure", - "required": [ - "attributes" - ], - "members": { - "cluster": { - "shape": "String" - }, - "attributes": { - "shape": "Attributes" - } - } - }, - "PutAttributesResponse": { - "type": "structure", - "members": { - "attributes": { - "shape": "Attributes" - } - } - }, - "PutClusterCapacityProvidersRequest": { - "type": "structure", - "required": [ - "cluster", - "capacityProviders", - "defaultCapacityProviderStrategy" - ], - "members": { - "cluster": { - "shape": "String" - }, - "capacityProviders": { - "shape": "StringList" - }, - "defaultCapacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - } - } - }, - "PutClusterCapacityProvidersResponse": { - "type": "structure", - "members": { - "cluster": { - "shape": "Cluster" - } - } - }, - "RegisterContainerInstanceRequest": { - "type": "structure", - "members": { - "cluster": { - "shape": "String" - }, - "instanceIdentityDocument": { - "shape": "String" - }, - "instanceIdentityDocumentSignature": { - "shape": "String" - }, - "totalResources": { - "shape": "Resources" - }, - "versionInfo": { - "shape": "VersionInfo" - }, - "containerInstanceArn": { - "shape": "String" - }, - "attributes": { - "shape": "Attributes" - }, - "tags": { - "shape": "Tags" - }, - "platformDevices": { - "shape": "PlatformDevices" - } - } - }, - "RegisterContainerInstanceResponse": { - "type": "structure", - "members": { - "containerInstance": { - "shape": "ContainerInstance" - } - } - }, - "RegisterTaskDefinitionRequest": { - "type": "structure", - "required": [ - "family", - "containerDefinitions" - ], - "members": { - "family": { - "shape": "String" - }, - "taskRoleArn": { - "shape": "String" - }, - "executionRoleArn": { - "shape": "String" - }, - "networkMode": { - "shape": "NetworkMode" - }, - "containerDefinitions": { - "shape": "ContainerDefinitions" - }, - "volumes": { - "shape": "VolumeList" - }, - "placementConstraints": { - "shape": "TaskDefinitionPlacementConstraints" - }, - "requiresCompatibilities": { - "shape": "CompatibilityList" - }, - "cpu": { - "shape": "String" - }, - "memory": { - "shape": "String" - }, - "inferenceAccelerators": { - "shape": "InferenceAccelerators" - }, - "pidMode": { - "shape": "PidMode" - }, - "ipcMode": { - "shape": "IpcMode" - }, - "tags": { - "shape": "Tags" - }, - "proxyConfiguration": { - "shape": "ProxyConfiguration" - } - } - }, - "RegisterTaskDefinitionResponse": { - "type": "structure", - "members": { - "taskDefinition": { - "shape": "TaskDefinition" - }, - "tags": { - "shape": "Tags" - } - } - }, - "RepositoryCredentials": { - "type": "structure", - "required": [ - "credentialsParameter" - ], - "members": { - "credentialsParameter": { - "shape": "String" - } - } - }, - "RequiresAttributes": { - "type": "list", - "member": { - "shape": "Attribute" - } - }, - "Resource": { - "type": "structure", - "members": { - "name": { - "shape": "String" - }, - "type": { - "shape": "String" - }, - "doubleValue": { - "shape": "Double" - }, - "longValue": { - "shape": "Long" - }, - "integerValue": { - "shape": "Integer" - }, - "stringSetValue": { - "shape": "StringList" - } - } - }, - "ResourceIds": { - "type": "list", - "member": { - "shape": "String" - } - }, - "ResourceInUseException": { - "type": "structure", - "members": {}, - "exception": true - }, - "ResourceNotFoundException": { - "type": "structure", - "members": {}, - "exception": true - }, - "ResourceRequirement": { - "type": "structure", - "required": [ - "value", - "type" - ], - "members": { - "value": { - "shape": "String" - }, - "type": { - "shape": "ResourceType" - } - } - }, - "ResourceRequirements": { - "type": "list", - "member": { - "shape": "ResourceRequirement" - } - }, - "ResourceType": { - "type": "string", - "enum": [ - "GPU", - "InferenceAccelerator" - ] - }, - "Resources": { - "type": "list", - "member": { - "shape": "Resource" - } - }, - "RunServiceTaskRequest": { - "type": "structure", - "required": [ - "clusterArn", - "taskDefinitionArn" - ], - "members": { - "capacityFeatureRequirements": { - "shape": "ServiceTaskCapacityFeatureRequirements" - }, - "capacityProviderStrategy": { - "shape": "ServiceTaskCapacityProviderStrategy" - }, - "clusterArn": { - "shape": "String" - }, - "clientToken": { - "shape": "String" - }, - "createdBy": { - "shape": "String" - }, - "count": { - "shape": "BoxedInteger" - }, - "enableECSManagedTags": { - "shape": "Boolean" - }, - "enableExecuteCommand": { - "shape": "Boolean" - }, - "essential": { - "shape": "Boolean" - }, - "group": { - "shape": "String" - }, - "launchType": { - "shape": "ServiceTaskLaunchType" - }, - "loadBalancers": { - "shape": "ServiceTaskLoadBalancers" - }, - "networkConfiguration": { - "shape": "ServiceTaskNetworkConfiguration" - }, - "originator": { - "shape": "ServiceTaskAccountDetail" - }, - "overrides": { - "shape": "ServiceTaskOverride" - }, - "placementConstraints": { - "shape": "ServiceTaskPlacementConstraints" - }, - "placementStrategy": { - "shape": "ServiceTaskPlacementStrategies" - }, - "platformFamily": { - "shape": "String" - }, - "platformVersion": { - "shape": "String" - }, - "propagateTags": { - "shape": "ServiceTaskPropagateTags" - }, - "referenceId": { - "shape": "String" - }, - "serviceConnectConfiguration": { - "shape": "ServiceTaskServiceConnectTaskConfiguration" - }, - "service": { - "shape": "ServiceTaskServiceReference" - }, - "serviceRegistries": { - "shape": "ServiceTaskServiceRegistries" - }, - "startedBy": { - "shape": "String" - }, - "tags": { - "shape": "ServiceTaskTags" - }, - "taskDefinitionArn": { - "shape": "String" - }, - "taskRoleArn": { - "shape": "String" - } - } - }, - "RunServiceTaskResponse": { - "type": "structure", - "members": { - "tasks": { - "shape": "ServiceTasks" - }, - "failures": { - "shape": "ServiceTaskFailures" - } - } - }, - "RunTaskRequest": { - "type": "structure", - "required": [ - "taskDefinition" - ], - "members": { - "capacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - }, - "clientToken": { - "shape": "String" - }, - "cluster": { - "shape": "String" - }, - "count": { - "shape": "BoxedInteger" - }, - "enableECSManagedTags": { - "shape": "Boolean" - }, - "enableExecuteCommand": { - "shape": "Boolean" - }, - "group": { - "shape": "String" - }, - "launchType": { - "shape": "LaunchType" - }, - "networkConfiguration": { - "shape": "NetworkConfiguration" - }, - "originator": { - "shape": "AccountDetail" - }, - "overrides": { - "shape": "TaskOverride" - }, - "placementConstraints": { - "shape": "PlacementConstraints" - }, - "placementStrategy": { - "shape": "PlacementStrategies" - }, - "platformVersion": { - "shape": "String" - }, - "propagateTags": { - "shape": "PropagateTags" - }, - "referenceId": { - "shape": "String" - }, - "startedBy": { - "shape": "String" - }, - "tags": { - "shape": "Tags" - }, - "taskDefinition": { - "shape": "String" - } - } - }, - "RunTaskResponse": { - "type": "structure", - "members": { - "tasks": { - "shape": "Tasks" - }, - "failures": { - "shape": "Failures" - } - } - }, - "Scale": { - "type": "structure", - "members": { - "value": { - "shape": "Double" - }, - "unit": { - "shape": "ScaleUnit" - } - } - }, - "ScaleUnit": { - "type": "string", - "enum": [ - "PERCENT" - ] - }, - "SchedulingStrategy": { - "type": "string", - "enum": [ - "REPLICA", - "DAEMON" - ] - }, - "Scope": { - "type": "string", - "enum": [ - "task", - "shared" - ] - }, - "Secret": { - "type": "structure", - "required": [ - "name", - "valueFrom" - ], - "members": { - "name": { - "shape": "String" - }, - "valueFrom": { - "shape": "String" - } - } - }, - "SecretList": { - "type": "list", - "member": { - "shape": "Secret" - } - }, - "SensitiveString": { - "type": "string", - "sensitive": true - }, - "ServerException": { - "type": "structure", - "members": {}, - "exception": true, - "fault": true - }, - "Service": { - "type": "structure", - "members": { - "serviceArn": { - "shape": "String" - }, - "serviceName": { - "shape": "String" - }, - "clusterArn": { - "shape": "String" - }, - "loadBalancers": { - "shape": "LoadBalancers" - }, - "serviceRegistries": { - "shape": "ServiceRegistries" - }, - "status": { - "shape": "String" - }, - "desiredCount": { - "shape": "Integer" - }, - "runningCount": { - "shape": "Integer" - }, - "pendingCount": { - "shape": "Integer" - }, - "launchType": { - "shape": "LaunchType" - }, - "capacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - }, - "platformVersion": { - "shape": "String" - }, - "taskDefinition": { - "shape": "String" - }, - "deploymentConfiguration": { - "shape": "DeploymentConfiguration" - }, - "taskSets": { - "shape": "TaskSets" - }, - "deployments": { - "shape": "Deployments" - }, - "roleArn": { - "shape": "String" - }, - "events": { - "shape": "ServiceEvents" - }, - "createdAt": { - "shape": "Timestamp" - }, - "placementConstraints": { - "shape": "PlacementConstraints" - }, - "placementStrategy": { - "shape": "PlacementStrategies" - }, - "networkConfiguration": { - "shape": "NetworkConfiguration" - }, - "healthCheckGracePeriodSeconds": { - "shape": "BoxedInteger" - }, - "schedulingStrategy": { - "shape": "SchedulingStrategy" - }, - "deploymentController": { - "shape": "DeploymentController" - }, - "tags": { - "shape": "Tags" - }, - "createdBy": { - "shape": "String" - }, - "enableECSManagedTags": { - "shape": "Boolean" - }, - "propagateTags": { - "shape": "PropagateTags" - }, - "enableExecuteCommand": { - "shape": "Boolean" - } - } - }, - "ServiceConnectClientAlias": { - "type": "structure", - "required": [ - "port" - ], - "members": { - "port": { - "shape": "PortNumber" - }, - "dnsName": { - "shape": "String" - } - } - }, - "ServiceConnectClientAliasList": { - "type": "list", - "member": { - "shape": "ServiceConnectClientAlias" - } - }, - "ServiceConnectConfiguration": { - "type": "structure", - "required": [ - "enabled" - ], - "members": { - "enabled": { - "shape": "Boolean" - }, - "namespace": { - "shape": "String" - }, - "services": { - "shape": "ServiceConnectServiceList" - }, - "logConfiguration": { - "shape": "LogConfiguration" - } - } - }, - "ServiceConnectService": { - "type": "structure", - "required": [ - "portName" - ], - "members": { - "portName": { - "shape": "String" - }, - "discoveryName": { - "shape": "String" - }, - "clientAliases": { - "shape": "ServiceConnectClientAliasList" - }, - "ingressPortOverride": { - "shape": "PortNumber" - }, - "tls": { - "shape": "ServiceConnectTlsConfiguration" - } - } - }, - "ServiceConnectServiceList": { - "type": "list", - "member": { - "shape": "ServiceConnectService" - } - }, - "ServiceConnectServiceResource": { - "type": "structure", - "members": { - "discoveryName": { - "shape": "String" - }, - "discoveryArn": { - "shape": "String" - } - } - }, - "ServiceConnectServiceResourceList": { - "type": "list", - "member": { - "shape": "ServiceConnectServiceResource" - } - }, - "ServiceConnectTlsCertificateAuthority": { - "type": "structure", - "members": { - "awsPcaAuthorityArn": { - "shape": "String" - } - } - }, - "ServiceConnectTlsConfiguration": { - "type": "structure", - "required": [ - "issuerCertificateAuthority" - ], - "members": { - "issuerCertificateAuthority": { - "shape": "ServiceConnectTlsCertificateAuthority" - }, - "kmsKey": { - "shape": "String" - }, - "roleArn": { - "shape": "String" - } - } - }, - "ServiceEvent": { - "type": "structure", - "members": { - "id": { - "shape": "String" - }, - "createdAt": { - "shape": "Timestamp" - }, - "message": { - "shape": "String" - } - } - }, - "ServiceEvents": { - "type": "list", - "member": { - "shape": "ServiceEvent" - } - }, - "ServiceField": { - "type": "string", - "enum": [ - "TAGS" - ] - }, - "ServiceFieldList": { - "type": "list", - "member": { - "shape": "ServiceField" - } - }, - "ServiceNotActiveException": { - "type": "structure", - "members": {}, - "exception": true - }, - "ServiceNotFoundException": { - "type": "structure", - "members": {}, - "exception": true - }, - "ServiceRegistries": { - "type": "list", - "member": { - "shape": "ServiceRegistry" - } - }, - "ServiceRegistry": { - "type": "structure", - "members": { - "registryArn": { - "shape": "String" - }, - "port": { - "shape": "BoxedInteger" - }, - "containerName": { - "shape": "String" - }, - "containerPort": { - "shape": "BoxedInteger" - } - } - }, - "ServiceTask": { - "type": "structure", - "members": { - "attachments": { - "shape": "ServiceTaskAttachments" - }, - "attributes": { - "shape": "ServiceTaskAttributes" - }, - "availabilityZone": { - "shape": "String" - }, - "capacityProviderName": { - "shape": "String" - }, - "clusterArn": { - "shape": "String" - }, - "connectivity": { - "shape": "ServiceTaskConnectivity" - }, - "connectivityAt": { - "shape": "Timestamp" - }, - "containerInstanceArn": { - "shape": "String" - }, - "containers": { - "shape": "ServiceTaskContainers" - }, - "cpu": { - "shape": "String" - }, - "createdAt": { - "shape": "Timestamp" - }, - "desiredStatus": { - "shape": "String" - }, - "enableExecuteCommand": { - "shape": "Boolean" - }, - "executionStoppedAt": { - "shape": "Timestamp" - }, - "group": { - "shape": "String" - }, - "healthStatus": { - "shape": "ServiceTaskHealthStatus" - }, - "lastStatus": { - "shape": "String" - }, - "launchType": { - "shape": "ServiceTaskLaunchType" - }, - "lifecycleHooks": { - "shape": "ServiceTaskLifecycleHooks" - }, - "memory": { - "shape": "String" - }, - "overrides": { - "shape": "ServiceTaskOverride" - }, - "platformFamily": { - "shape": "String" - }, - "platformVersion": { - "shape": "String" - }, - "pullStartedAt": { - "shape": "Timestamp" - }, - "pullStoppedAt": { - "shape": "Timestamp" - }, - "serviceConnectConfiguration": { - "shape": "ServiceTaskServiceConnectTaskConfiguration" - }, - "startedAt": { - "shape": "Timestamp" - }, - "startedBy": { - "shape": "String" - }, - "stopCode": { - "shape": "ServiceTaskStopCode" - }, - "stoppedAt": { - "shape": "Timestamp" - }, - "stoppedReason": { - "shape": "String" - }, - "stoppingAt": { - "shape": "Timestamp" - }, - "tags": { - "shape": "ServiceTaskTags" - }, - "taskArn": { - "shape": "String" - }, - "taskDefinitionArn": { - "shape": "String" - }, - "version": { - "shape": "Long" - }, - "ephemeralStorage": { - "shape": "ServiceTaskEphemeralStorage" - }, - "awaitingCapacity": { - "shape": "Boolean" - }, - "replaceBy": { - "shape": "Timestamp" - } - } - }, - "ServiceTaskAccountDetail": { - "type": "structure", - "members": { - "accountId": { - "shape": "String" - }, - "credentialProvider": { - "shape": "String" - }, - "credentialToken": { - "shape": "SensitiveString" - } - } - }, - "ServiceTaskAssignPublicIp": { - "type": "string", - "enum": [ - "ENABLED", - "DISABLED" - ] - }, - "ServiceTaskAttachment": { - "type": "structure", - "members": { - "id": { - "shape": "String" - }, - "type": { - "shape": "String" - }, - "status": { - "shape": "String" - }, - "details": { - "shape": "ServiceTaskAttachmentDetails" - } - } - }, - "ServiceTaskAttachmentDetails": { - "type": "list", - "member": { - "shape": "KeyValuePair" - } - }, - "ServiceTaskAttachments": { - "type": "list", - "member": { - "shape": "ServiceTaskAttachment" - } - }, - "ServiceTaskAttribute": { - "type": "structure", - "members": { - "name": { - "shape": "String" - }, - "value": { - "shape": "String" - }, - "targetType": { - "shape": "ServiceTaskTargetType" - }, - "targetId": { - "shape": "String" - } - } - }, - "ServiceTaskAttributes": { - "type": "list", - "member": { - "shape": "ServiceTaskAttribute" - } - }, - "ServiceTaskAwsVpcConfiguration": { - "type": "structure", - "members": { - "assignPublicIp": { - "shape": "ServiceTaskAssignPublicIp" - }, - "interfaceConfigurations": { - "shape": "ServiceTaskInterfaceConfigurations" - }, - "securityGroups": { - "shape": "StringList" - }, - "subnets": { - "shape": "StringList" - }, - "interfaceOwner": { - "shape": "ServiceTaskInterfaceOwner" - }, - "networkInterfaceOwner": { - "shape": "String" - }, - "networkInterfaceCredential": { - "shape": "String" - }, - "role": { - "shape": "String" - } - } - }, - "ServiceTaskCapacityFeatureRequirementType": { - "type": "string", - "enum": [ - "NonInterruptible" - ] - }, - "ServiceTaskCapacityFeatureRequirements": { - "type": "list", - "member": { - "shape": "ServiceTaskCapacityFeatureRequirementType" - } - }, - "ServiceTaskCapacityProviderStrategy": { - "type": "list", - "member": { - "shape": "ServiceTaskCapacityProviderStrategyItem" - } - }, - "ServiceTaskCapacityProviderStrategyItem": { - "type": "structure", - "required": [ - "capacityProvider" - ], - "members": { - "capacityProvider": { - "shape": "String" - }, - "weight": { - "shape": "ServiceTaskCapacityProviderStrategyItemWeight" - }, - "base": { - "shape": "ServiceTaskCapacityProviderStrategyItemBase" - } - } - }, - "ServiceTaskCapacityProviderStrategyItemBase": { - "type": "integer", - "max": 100000, - "min": 0 - }, - "ServiceTaskCapacityProviderStrategyItemWeight": { - "type": "integer", - "max": 1000, - "min": 0 - }, - "ServiceTaskConnectivity": { - "type": "string", - "enum": [ - "CONNECTED", - "DISCONNECTED" - ] - }, - "ServiceTaskContainer": { - "type": "structure", - "members": { - "containerArn": { - "shape": "String" - }, - "taskArn": { - "shape": "String" - }, - "name": { - "shape": "String" - }, - "image": { - "shape": "String" - }, - "imageDigest": { - "shape": "String" - }, - "runtimeId": { - "shape": "String" - }, - "lastStatus": { - "shape": "String" - }, - "exitCode": { - "shape": "BoxedInteger" - }, - "reason": { - "shape": "String" - }, - "networkBindings": { - "shape": "ServiceTaskNetworkBindings" - }, - "networkInterfaces": { - "shape": "ServiceTaskNetworkInterfaces" - }, - "healthStatus": { - "shape": "ServiceTaskHealthStatus" - }, - "managedAgents": { - "shape": "ServiceTaskManagedAgents" - }, - "cpu": { - "shape": "String" - }, - "memory": { - "shape": "String" - }, - "memoryReservation": { - "shape": "String" - }, - "gpuIds": { - "shape": "ServiceTaskGpuIds" - } - } - }, - "ServiceTaskContainerOverride": { - "type": "structure", - "members": { - "name": { - "shape": "String" - }, - "command": { - "shape": "StringList" - }, - "environment": { - "shape": "ServiceTaskEnvironmentVariables" - }, - "environmentFiles": { - "shape": "ServiceTaskEnvironmentFiles" - }, - "cpu": { - "shape": "BoxedInteger" - }, - "memory": { - "shape": "BoxedInteger" - }, - "memoryReservation": { - "shape": "BoxedInteger" - }, - "resourceRequirements": { - "shape": "ServiceTaskResourceRequirements" - } - } - }, - "ServiceTaskContainerOverrides": { - "type": "list", - "member": { - "shape": "ServiceTaskContainerOverride" - } - }, - "ServiceTaskContainers": { - "type": "list", - "member": { - "shape": "ServiceTaskContainer" - } - }, - "ServiceTaskDeploymentReference": { - "type": "structure", - "required": [ - "taskSetArn" - ], - "members": { - "taskSetArn": { - "shape": "String" - }, - "externalId": { - "shape": "String" - } - } - }, - "ServiceTaskEBSVolumeConfigurationOverride": { - "type": "structure", - "members": { - "snapshotId": { - "shape": "String" - }, - "sizeInGiB": { - "shape": "BoxedInteger" - }, - "deleteOnTermination": { - "shape": "BoxedBoolean" - }, - "volumeTags": { - "shape": "ServiceTaskTags" - }, - "volumeId": { - "shape": "String" - } - } - }, - "ServiceTaskEcsResourceType": { - "type": "string", - "enum": [ - "CLUSTER", - "CAPACITY_PROVIDER" - ] - }, - "ServiceTaskEnvironmentFile": { - "type": "structure", - "members": { - "value": { - "shape": "String" - }, - "type": { - "shape": "ServiceTaskEnvironmentFileType" - } - } - }, - "ServiceTaskEnvironmentFileType": { - "type": "string", - "enum": [ - "s3" - ] - }, - "ServiceTaskEnvironmentFiles": { - "type": "list", - "member": { - "shape": "ServiceTaskEnvironmentFile" - } - }, - "ServiceTaskEnvironmentVariables": { - "type": "list", - "member": { - "shape": "KeyValuePair" - }, - "sensitive": true - }, - "ServiceTaskEphemeralStorage": { - "type": "structure", - "members": { - "sizeInGiB": { - "shape": "Integer" - } - } - }, - "ServiceTaskFailure": { - "type": "structure", - "members": { - "arn": { - "shape": "String" - }, - "detail": { - "shape": "String" - }, - "reason": { - "shape": "String" - } - } - }, - "ServiceTaskFailures": { - "type": "list", - "member": { - "shape": "ServiceTaskFailure" - } - }, - "ServiceTaskGpuIds": { - "type": "list", - "member": { - "shape": "String" - } - }, - "ServiceTaskHealthStatus": { - "type": "string", - "enum": [ - "HEALTHY", - "UNHEALTHY", - "UNKNOWN" - ] - }, - "ServiceTaskInferenceAcceleratorOverride": { - "type": "structure", - "members": { - "deviceName": { - "shape": "String" - }, - "deviceType": { - "shape": "String" - }, - "devicePolicy": { - "shape": "String" - } - } - }, - "ServiceTaskInferenceAcceleratorOverrides": { - "type": "list", - "member": { - "shape": "ServiceTaskInferenceAcceleratorOverride" - } - }, - "ServiceTaskInterfaceConfiguration": { - "type": "structure", - "members": { - "assignPublicIp": { - "shape": "ServiceTaskAssignPublicIp" - }, - "name": { - "shape": "String" - }, - "options": { - "shape": "StringMap" - }, - "securityGroups": { - "shape": "StringList" - }, - "subnets": { - "shape": "StringList" - }, - "index": { - "shape": "Integer" - }, - "owner": { - "shape": "ServiceTaskInterfaceOwner" - }, - "secondaryPrivateIpAddressCount": { - "shape": "Integer" - }, - "subnet": { - "shape": "String" - } - } - }, - "ServiceTaskInterfaceConfigurations": { - "type": "list", - "member": { - "shape": "ServiceTaskInterfaceConfiguration" - } - }, - "ServiceTaskInterfaceOwner": { - "type": "string", - "enum": [ - "CALLER", - "ORIGINATOR" - ] - }, - "ServiceTaskLaunchType": { - "type": "string", - "enum": [ - "EC2", - "FARGATE", - "EXTERNAL" - ] - }, - "ServiceTaskLifecycleHook": { - "type": "structure", - "members": { - "activeAt": { - "shape": "Timestamp" - }, - "arn": { - "shape": "String" - }, - "completedAt": { - "shape": "Timestamp" - }, - "expiresAt": { - "shape": "Timestamp" - }, - "name": { - "shape": "String" - }, - "notificationArn": { - "shape": "String" - }, - "notificationToken": { - "shape": "String" - }, - "outcome": { - "shape": "ServiceTaskLifecycleHookOutcome" - }, - "outcomeDetail": { - "shape": "String" - }, - "stage": { - "shape": "ServiceTaskLifecycleHookStage" - }, - "status": { - "shape": "ServiceTaskLifecycleHookStatus" - } - } - }, - "ServiceTaskLifecycleHookOutcome": { - "type": "string", - "enum": [ - "ABANDONED", - "FAILURE", - "SKIPPED", - "SUCCESS", - "TIMEOUT" - ] - }, - "ServiceTaskLifecycleHookStage": { - "type": "string", - "enum": [ - "PRE_STARTUP", - "POST_STARTUP", - "PRE_SHUTDOWN", - "POST_SHUTDOWN" - ] - }, - "ServiceTaskLifecycleHookStatus": { - "type": "string", - "enum": [ - "ACTIVE", - "COMPLETED", - "PENDING" - ] - }, - "ServiceTaskLifecycleHooks": { - "type": "list", - "member": { - "shape": "ServiceTaskLifecycleHook" - } - }, - "ServiceTaskLoadBalancer": { - "type": "structure", - "members": { - "loadBalancerName": { - "shape": "String" - }, - "targetGroupArn": { - "shape": "String" - }, - "targetGroupTargetType": { - "shape": "String" - }, - "containerName": { - "shape": "String" - }, - "containerPort": { - "shape": "BoxedInteger" - } - } - }, - "ServiceTaskLoadBalancers": { - "type": "list", - "member": { - "shape": "ServiceTaskLoadBalancer" - } - }, - "ServiceTaskManagedAgent": { - "type": "structure", - "members": { - "lastStartedAt": { - "shape": "Timestamp" - }, - "name": { - "shape": "ServiceTaskManagedAgentName" - }, - "reason": { - "shape": "String" - }, - "lastStatus": { - "shape": "String" - } - } - }, - "ServiceTaskManagedAgentName": { - "type": "string", - "enum": [ - "ExecuteCommandAgent" - ] - }, - "ServiceTaskManagedAgents": { - "type": "list", - "member": { - "shape": "ServiceTaskManagedAgent" - } - }, - "ServiceTaskNetworkBinding": { - "type": "structure", - "members": { - "bindIP": { - "shape": "String" - }, - "containerPort": { - "shape": "BoxedInteger" - }, - "hostPort": { - "shape": "BoxedInteger" - }, - "protocol": { - "shape": "ServiceTaskTransportProtocol" - }, - "containerPortRange": { - "shape": "String" - }, - "hostPortRange": { - "shape": "String" - } - } - }, - "ServiceTaskNetworkBindings": { - "type": "list", - "member": { - "shape": "ServiceTaskNetworkBinding" - } - }, - "ServiceTaskNetworkConfiguration": { - "type": "structure", - "members": { - "awsvpcConfiguration": { - "shape": "ServiceTaskAwsVpcConfiguration" - } - } - }, - "ServiceTaskNetworkInterface": { - "type": "structure", - "members": { - "attachmentId": { - "shape": "String" - }, - "privateIpv4Address": { - "shape": "String" - }, - "ipv6Address": { - "shape": "String" - } - } - }, - "ServiceTaskNetworkInterfaces": { - "type": "list", - "member": { - "shape": "ServiceTaskNetworkInterface" - } - }, - "ServiceTaskOverride": { - "type": "structure", - "members": { - "containerOverrides": { - "shape": "ServiceTaskContainerOverrides" - }, - "cpu": { - "shape": "String" - }, - "inferenceAcceleratorOverrides": { - "shape": "ServiceTaskInferenceAcceleratorOverrides" - }, - "executionRoleCredentialProvider": { - "shape": "String" - }, - "executionRoleCredentialToken": { - "shape": "SensitiveString" - }, - "executionRoleArn": { - "shape": "String" - }, - "memory": { - "shape": "String" - }, - "taskRoleCredentialProvider": { - "shape": "String" - }, - "taskRoleCredentialToken": { - "shape": "SensitiveString" - }, - "taskRoleArn": { - "shape": "String" - }, - "ephemeralStorage": { - "shape": "ServiceTaskEphemeralStorage" - }, - "volumeOverrides": { - "shape": "ServiceTaskVolumeOverrides" - }, - "collectorSetting": { - "shape": "String" - }, - "infrastructureBlockDeviceConfig": { - "shape": "String" - } - } - }, - "ServiceTaskPlacementConstraint": { - "type": "structure", - "members": { - "type": { - "shape": "ServiceTaskPlacementConstraintType" - }, - "expression": { - "shape": "String" - } - } - }, - "ServiceTaskPlacementConstraintType": { - "type": "string", - "enum": [ - "distinctInstance", - "memberOf" - ] - }, - "ServiceTaskPlacementConstraints": { - "type": "list", - "member": { - "shape": "ServiceTaskPlacementConstraint" - } - }, - "ServiceTaskPlacementStrategies": { - "type": "list", - "member": { - "shape": "ServiceTaskPlacementStrategy" - } - }, - "ServiceTaskPlacementStrategy": { - "type": "structure", - "members": { - "type": { - "shape": "ServiceTaskPlacementStrategyType" - }, - "field": { - "shape": "String" - } - } - }, - "ServiceTaskPlacementStrategyType": { - "type": "string", - "enum": [ - "random", - "spread", - "binpack" - ] - }, - "ServiceTaskPropagateTags": { - "type": "string", - "enum": [ - "TASK_DEFINITION", - "SERVICE", - "NONE" - ] - }, - "ServiceTaskResourceRequirement": { - "type": "structure", - "members": { - "value": { - "shape": "String" - }, - "type": { - "shape": "ServiceTaskResourceType" - } - } - }, - "ServiceTaskResourceRequirements": { - "type": "list", - "member": { - "shape": "ServiceTaskResourceRequirement" - } - }, - "ServiceTaskResourceType": { - "type": "string", - "enum": [ - "GPU", - "InferenceAccelerator" - ] - }, - "ServiceTaskServiceConnectTaskConfiguration": { - "type": "structure", - "required": [ - "enabled" - ], - "members": { - "enabled": { - "shape": "Boolean" - } - } - }, - "ServiceTaskServiceReference": { - "type": "structure", - "required": [ - "serviceArn", - "deployment" - ], - "members": { - "serviceArn": { - "shape": "String" - }, - "deployment": { - "shape": "ServiceTaskDeploymentReference" - } - } - }, - "ServiceTaskServiceRegistries": { - "type": "list", - "member": { - "shape": "ServiceTaskServiceRegistry" - } - }, - "ServiceTaskServiceRegistry": { - "type": "structure", - "members": { - "registryArn": { - "shape": "String" - }, - "port": { - "shape": "BoxedInteger" - }, - "containerName": { - "shape": "String" - }, - "containerPort": { - "shape": "BoxedInteger" - } - } - }, - "ServiceTaskStopCode": { - "type": "string", - "enum": [ - "EssentialContainerExited", - "ServiceSchedulerInitiated", - "SpotInterruption", - "TaskFailedToStart", - "TerminationNotice", - "UserInitiated" - ] - }, - "ServiceTaskTag": { - "type": "structure", - "members": { - "key": { - "shape": "ServiceTaskTagKey" - }, - "value": { - "shape": "ServiceTaskTagValue" - } - } - }, - "ServiceTaskTagKey": { - "type": "string", - "max": 128, - "min": 1, - "pattern": "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "ServiceTaskTagValue": { - "type": "string", - "max": 256, - "min": 0, - "pattern": "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "ServiceTaskTags": { - "type": "list", - "member": { - "shape": "ServiceTaskTag" - }, - "max": 50, - "min": 0 - }, - "ServiceTaskTargetType": { - "type": "string", - "enum": [ - "container-instance" - ] - }, - "ServiceTaskTransportProtocol": { - "type": "string", - "enum": [ - "tcp", - "udp" - ] - }, - "ServiceTaskVolumeOverride": { - "type": "structure", - "members": { - "name": { - "shape": "String" - }, - "ebsVolumeConfiguration": { - "shape": "ServiceTaskEBSVolumeConfigurationOverride" - } - } - }, - "ServiceTaskVolumeOverrides": { - "type": "list", - "member": { - "shape": "ServiceTaskVolumeOverride" - } - }, - "ServiceTasks": { - "type": "list", - "member": { - "shape": "ServiceTask" - } - }, - "Services": { - "type": "list", - "member": { - "shape": "Service" - } - }, - "Session": { - "type": "structure", - "members": { - "sessionId": { - "shape": "String" - }, - "streamUrl": { - "shape": "String" - }, - "tokenValue": { - "shape": "SensitiveString" - } - } - }, - "Setting": { - "type": "structure", - "members": { - "name": { - "shape": "SettingName" - }, - "value": { - "shape": "String" - }, - "principalArn": { - "shape": "String" - } - } - }, - "SettingName": { - "type": "string", - "enum": [ - "serviceLongArnFormat", - "taskLongArnFormat", - "containerInstanceLongArnFormat", - "awsvpcTrunking", - "containerInsights", - "fargateVCPULimit", - "tagResourceAuthorization", - "fargateFIPSMode", - "guardDutyActivate", - "fargateTaskRetirementWaitPeriod" - ] - }, - "SettingType": { - "type": "string", - "enum": [ - "user", - "aws_managed" - ] - }, - "Settings": { - "type": "list", - "member": { - "shape": "Setting" - } - }, - "SoftwareManifest": { - "type": "list", - "member": { - "shape": "SoftwareManifestEntry" - } - }, - "SoftwareManifestEntry": { - "type": "structure", - "required": [ - "name" - ], - "members": { - "name": { - "shape": "String" - }, - "serial": { - "shape": "String" - }, - "version": { - "shape": "String" - } - } - }, - "SortOrder": { - "type": "string", - "enum": [ - "ASC", - "DESC" - ] - }, - "StabilityStatus": { - "type": "string", - "enum": [ - "STEADY_STATE", - "STABILIZING" - ] - }, - "StartTaskRequest": { - "type": "structure", - "required": [ - "containerInstances", - "taskDefinition" - ], - "members": { - "cluster": { - "shape": "String" - }, - "containerInstances": { - "shape": "StringList" - }, - "enableECSManagedTags": { - "shape": "Boolean" - }, - "enableExecuteCommand": { - "shape": "Boolean" - }, - "group": { - "shape": "String" - }, - "networkConfiguration": { - "shape": "NetworkConfiguration" - }, - "overrides": { - "shape": "TaskOverride" - }, - "propagateTags": { - "shape": "PropagateTags" - }, - "referenceId": { - "shape": "String" - }, - "startedBy": { - "shape": "String" - }, - "tags": { - "shape": "Tags" - }, - "taskDefinition": { - "shape": "String" - } - } - }, - "StartTaskResponse": { - "type": "structure", - "members": { - "tasks": { - "shape": "Tasks" - }, - "failures": { - "shape": "Failures" - } - } - }, - "Statistics": { - "type": "list", - "member": { - "shape": "KeyValuePair" - } - }, - "StopTaskRequest": { - "type": "structure", - "required": [ - "task" - ], - "members": { - "cluster": { - "shape": "String" - }, - "task": { - "shape": "String" - }, - "reason": { - "shape": "String" - } - } - }, - "StopTaskResponse": { - "type": "structure", - "members": { - "task": { - "shape": "Task" - } - } - }, - "String": { - "type": "string" - }, - "StringList": { - "type": "list", - "member": { - "shape": "String" - } - }, - "StringMap": { - "type": "map", - "key": { - "shape": "String" - }, - "value": { - "shape": "String" - } - }, - "SubmitAttachmentStateChangesRequest": { - "type": "structure", - "required": [ - "attachments" - ], - "members": { - "cluster": { - "shape": "String" - }, - "attachments": { - "shape": "AttachmentStateChanges" - } - } - }, - "SubmitAttachmentStateChangesResponse": { - "type": "structure", - "members": { - "acknowledgment": { - "shape": "String" - } - } - }, - "SubmitContainerStateChangeRequest": { - "type": "structure", - "members": { - "cluster": { - "shape": "String" - }, - "task": { - "shape": "String" - }, - "containerName": { - "shape": "String" - }, - "runtimeId": { - "shape": "String" - }, - "status": { - "shape": "String" - }, - "exitCode": { - "shape": "BoxedInteger" - }, - "reason": { - "shape": "String" - }, - "networkBindings": { - "shape": "NetworkBindings" - } - } - }, - "SubmitContainerStateChangeResponse": { - "type": "structure", - "members": { - "acknowledgment": { - "shape": "String" - } - } - }, - "SubmitTaskStateChangeRequest": { - "type": "structure", - "members": { - "cluster": { - "shape": "String" - }, - "task": { - "shape": "String" - }, - "status": { - "shape": "String" - }, - "reason": { - "shape": "String" - }, - "containers": { - "shape": "ContainerStateChanges" - }, - "attachments": { - "shape": "AttachmentStateChanges" - }, - "managedAgents": { - "shape": "ManagedAgentStateChanges" - }, - "pullStartedAt": { - "shape": "Timestamp" - }, - "pullStoppedAt": { - "shape": "Timestamp" - }, - "executionStoppedAt": { - "shape": "Timestamp" - } - } - }, - "SubmitTaskStateChangeResponse": { - "type": "structure", - "members": { - "acknowledgment": { - "shape": "String" - } - } - }, - "SystemControl": { - "type": "structure", - "members": { - "namespace": { - "shape": "String" - }, - "value": { - "shape": "String" - } - } - }, - "SystemControls": { - "type": "list", - "member": { - "shape": "SystemControl" - } - }, - "Tag": { - "type": "structure", - "members": { - "key": { - "shape": "TagKey" - }, - "value": { - "shape": "TagValue" - } - } - }, - "TagKey": { - "type": "string", - "max": 128, - "min": 1, - "pattern": "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "TagKeys": { - "type": "list", - "member": { - "shape": "TagKey" - } - }, - "TagResourceRequest": { - "type": "structure", - "required": [ - "resourceArn", - "tags" - ], - "members": { - "resourceArn": { - "shape": "String" - }, - "tags": { - "shape": "Tags" - } - } - }, - "TagResourceResponse": { - "type": "structure", - "members": {} - }, - "TagValue": { - "type": "string", - "max": 256, - "min": 0, - "pattern": "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$" - }, - "Tags": { - "type": "list", - "member": { - "shape": "Tag" - }, - "max": 50, - "min": 0 - }, - "TargetGroupArnList": { - "type": "list", - "member": { - "shape": "String" - }, - "max": 2, - "min": 2 - }, - "TargetNotConnectedException": { - "type": "structure", - "members": {}, - "exception": true - }, - "TargetNotFoundException": { - "type": "structure", - "members": {}, - "exception": true - }, - "TargetType": { - "type": "string", - "enum": [ - "container-instance" - ] - }, - "Task": { - "type": "structure", - "members": { - "attachments": { - "shape": "Attachments" - }, - "attributes": { - "shape": "Attributes" - }, - "availabilityZone": { - "shape": "String" - }, - "capacityProviderName": { - "shape": "String" - }, - "clusterArn": { - "shape": "String" - }, - "connectivity": { - "shape": "Connectivity" - }, - "connectivityAt": { - "shape": "Timestamp" - }, - "containerInstanceArn": { - "shape": "String" - }, - "containers": { - "shape": "Containers" - }, - "cpu": { - "shape": "String" - }, - "createdAt": { - "shape": "Timestamp" - }, - "desiredStatus": { - "shape": "String" - }, - "enableExecuteCommand": { - "shape": "Boolean" - }, - "executionStoppedAt": { - "shape": "Timestamp" - }, - "group": { - "shape": "String" - }, - "healthStatus": { - "shape": "HealthStatus" - }, - "lastStatus": { - "shape": "String" - }, - "launchType": { - "shape": "LaunchType" - }, - "memory": { - "shape": "String" - }, - "overrides": { - "shape": "TaskOverride" - }, - "platformVersion": { - "shape": "String" - }, - "pullStartedAt": { - "shape": "Timestamp" - }, - "pullStoppedAt": { - "shape": "Timestamp" - }, - "startedAt": { - "shape": "Timestamp" - }, - "startedBy": { - "shape": "String" - }, - "stopCode": { - "shape": "TaskStopCode" - }, - "stoppedAt": { - "shape": "Timestamp" - }, - "stoppedReason": { - "shape": "String" - }, - "stoppingAt": { - "shape": "Timestamp" - }, - "tags": { - "shape": "Tags" - }, - "taskArn": { - "shape": "String" - }, - "taskDefinitionArn": { - "shape": "String" - }, - "version": { - "shape": "Long" - } - } - }, - "TaskDefinition": { - "type": "structure", - "members": { - "taskDefinitionArn": { - "shape": "String" - }, - "containerDefinitions": { - "shape": "ContainerDefinitions" - }, - "family": { - "shape": "String" - }, - "taskRoleArn": { - "shape": "String" - }, - "executionRoleArn": { - "shape": "String" - }, - "networkMode": { - "shape": "NetworkMode" - }, - "revision": { - "shape": "Integer" - }, - "volumes": { - "shape": "VolumeList" - }, - "status": { - "shape": "TaskDefinitionStatus" - }, - "requiresAttributes": { - "shape": "RequiresAttributes" - }, - "placementConstraints": { - "shape": "TaskDefinitionPlacementConstraints" - }, - "compatibilities": { - "shape": "CompatibilityList" - }, - "requiresCompatibilities": { - "shape": "CompatibilityList" - }, - "cpu": { - "shape": "String" - }, - "memory": { - "shape": "String" - }, - "pidMode": { - "shape": "PidMode" - }, - "ipcMode": { - "shape": "IpcMode" - }, - "proxyConfiguration": { - "shape": "ProxyConfiguration" - } - } - }, - "TaskDefinitionDeleteStatus": { - "type": "string", - "enum": [ - "DELETE_IN_PROGRESS", - "DELETE_COMPLETE" - ] - }, - "TaskDefinitionFamilyStatus": { - "type": "string", - "enum": [ - "ACTIVE", - "INACTIVE", - "ALL" - ] - }, - "TaskDefinitionField": { - "type": "string", - "enum": [ - "TAGS" - ] - }, - "TaskDefinitionFieldList": { - "type": "list", - "member": { - "shape": "TaskDefinitionField" - } - }, - "TaskDefinitionList": { - "type": "list", - "member": { - "shape": "TaskDefinition" - } - }, - "TaskDefinitionNetworkInterface": { - "type": "structure", - "members": { - "name": { - "shape": "String" - }, - "options": { - "shape": "StringMap" - } - } - }, - "TaskDefinitionNetworkInterfaces": { - "type": "list", - "member": { - "shape": "TaskDefinitionNetworkInterface" - } - }, - "TaskDefinitionPlacementConstraint": { - "type": "structure", - "members": { - "type": { - "shape": "TaskDefinitionPlacementConstraintType" - }, - "expression": { - "shape": "String" - } - } - }, - "TaskDefinitionPlacementConstraintType": { - "type": "string", - "enum": [ - "memberOf" - ] - }, - "TaskDefinitionPlacementConstraints": { - "type": "list", - "member": { - "shape": "TaskDefinitionPlacementConstraint" - } - }, - "TaskDefinitionStatus": { - "type": "string", - "enum": [ - "ACTIVE", - "INACTIVE", - "DELETE_IN_PROGRESS" - ] - }, - "TaskField": { - "type": "string", - "enum": [ - "TAGS" - ] - }, - "TaskFieldList": { - "type": "list", - "member": { - "shape": "TaskField" - } - }, - "TaskOverride": { - "type": "structure", - "members": { - "containerOverrides": { - "shape": "ContainerOverrides" - }, - "cpu": { - "shape": "String" - }, - "inferenceAcceleratorOverrides": { - "shape": "InferenceAcceleratorOverrides" - }, - "executionRoleArn": { - "shape": "String" - }, - "memory": { - "shape": "String" - }, - "taskRoleArn": { - "shape": "String" - } - } - }, - "TaskSet": { - "type": "structure", - "members": { - "id": { - "shape": "String" - }, - "taskSetArn": { - "shape": "String" - }, - "serviceArn": { - "shape": "String" - }, - "clusterArn": { - "shape": "String" - }, - "startedBy": { - "shape": "String" - }, - "externalId": { - "shape": "String" - }, - "status": { - "shape": "String" - }, - "taskDefinition": { - "shape": "String" - }, - "computedDesiredCount": { - "shape": "Integer" - }, - "pendingCount": { - "shape": "Integer" - }, - "runningCount": { - "shape": "Integer" - }, - "createdAt": { - "shape": "Timestamp" - }, - "updatedAt": { - "shape": "Timestamp" - }, - "launchType": { - "shape": "LaunchType" - }, - "capacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - }, - "platformVersion": { - "shape": "String" - }, - "networkConfiguration": { - "shape": "NetworkConfiguration" - }, - "loadBalancers": { - "shape": "LoadBalancers" - }, - "serviceRegistries": { - "shape": "ServiceRegistries" - }, - "scale": { - "shape": "Scale" - }, - "stabilityStatus": { - "shape": "StabilityStatus" - }, - "stabilityStatusAt": { - "shape": "Timestamp" - }, - "tags": { - "shape": "Tags" - } - } - }, - "TaskSetField": { - "type": "string", - "enum": [ - "TAGS" - ] - }, - "TaskSetFieldList": { - "type": "list", - "member": { - "shape": "TaskSetField" - } - }, - "TaskSetNotFoundException": { - "type": "structure", - "members": {}, - "exception": true - }, - "TaskSets": { - "type": "list", - "member": { - "shape": "TaskSet" - } - }, - "TaskStatus": { - "type": "string", - "enum": [ - "PROVISIONING", - "PENDING", - "ACTIVATING", - "RUNNING", - "DEACTIVATING", - "STOPPING", - "DEPROVISIONING", - "STOPPED_CLEANING", - "STOPPED" - ] - }, - "TaskStatuses": { - "type": "list", - "member": { - "shape": "TaskStatus" - } - }, - "TaskStopCode": { - "type": "string", - "enum": [ - "TaskFailedToStart", - "EssentialContainerExited", - "UserInitiated", - "ServiceSchedulerInitiated", - "SpotInterruption", - "TerminationNotice" - ] - }, - "Tasks": { - "type": "list", - "member": { - "shape": "Task" - } - }, - "Timestamp": { - "type": "timestamp" - }, - "Tmpfs": { - "type": "structure", - "required": [ - "containerPath", - "size" - ], - "members": { - "containerPath": { - "shape": "String" - }, - "size": { - "shape": "Integer" - }, - "mountOptions": { - "shape": "StringList" - } - } - }, - "TmpfsList": { - "type": "list", - "member": { - "shape": "Tmpfs" - } - }, - "TransportProtocol": { - "type": "string", - "enum": [ - "tcp", - "udp" - ] - }, - "Ulimit": { - "type": "structure", - "required": [ - "name", - "softLimit", - "hardLimit" - ], - "members": { - "name": { - "shape": "UlimitName" - }, - "softLimit": { - "shape": "Integer" - }, - "hardLimit": { - "shape": "Integer" - } - } - }, - "UlimitList": { - "type": "list", - "member": { - "shape": "Ulimit" - } - }, - "UlimitName": { - "type": "string", - "enum": [ - "core", - "cpu", - "data", - "fsize", - "locks", - "memlock", - "msgqueue", - "nice", - "nofile", - "nproc", - "rss", - "rtprio", - "rttime", - "sigpending", - "stack" - ] - }, - "UnsupportedFeatureException": { - "type": "structure", - "members": {}, - "exception": true - }, - "UntagResourceRequest": { - "type": "structure", - "required": [ - "resourceArn", - "tagKeys" - ], - "members": { - "resourceArn": { - "shape": "String" - }, - "tagKeys": { - "shape": "TagKeys" - } - } - }, - "UntagResourceResponse": { - "type": "structure", - "members": {} - }, - "UpdateCapacityProviderRequest": { - "type": "structure", - "required": [ - "name", - "autoScalingGroupProvider" - ], - "members": { - "name": { - "shape": "String" - }, - "autoScalingGroupProvider": { - "shape": "AutoScalingGroupProviderUpdate" - } - } - }, - "UpdateCapacityProviderResponse": { - "type": "structure", - "members": { - "capacityProvider": { - "shape": "CapacityProvider" - } - } - }, - "UpdateClusterRequest": { - "type": "structure", - "required": [ - "cluster" - ], - "members": { - "cluster": { - "shape": "String" - }, - "settings": { - "shape": "ClusterSettings" - }, - "configuration": { - "shape": "ClusterConfiguration" - }, - "serviceConnectDefaults": { - "shape": "ClusterServiceConnectDefaultsRequest" - } - } - }, - "UpdateClusterResponse": { - "type": "structure", - "members": { - "cluster": { - "shape": "Cluster" - } - } - }, - "UpdateClusterSettingsRequest": { - "type": "structure", - "required": [ - "cluster", - "settings" - ], - "members": { - "cluster": { - "shape": "String" - }, - "settings": { - "shape": "ClusterSettings" - } - } - }, - "UpdateClusterSettingsResponse": { - "type": "structure", - "members": { - "cluster": { - "shape": "Cluster" - } - } - }, - "UpdateContainerAgentRequest": { - "type": "structure", - "required": [ - "containerInstance" - ], - "members": { - "cluster": { - "shape": "String" - }, - "containerInstance": { - "shape": "String" - } - } - }, - "UpdateContainerAgentResponse": { - "type": "structure", - "members": { - "containerInstance": { - "shape": "ContainerInstance" - } - } - }, - "UpdateContainerInstancesStateRequest": { - "type": "structure", - "required": [ - "containerInstances", - "status" - ], - "members": { - "cluster": { - "shape": "String" - }, - "containerInstances": { - "shape": "StringList" - }, - "status": { - "shape": "ContainerInstanceStatus" - } - } - }, - "UpdateContainerInstancesStateResponse": { - "type": "structure", - "members": { - "containerInstances": { - "shape": "ContainerInstances" - }, - "failures": { - "shape": "Failures" - } - } - }, - "UpdateInProgressException": { - "type": "structure", - "members": {}, - "exception": true - }, - "UpdateServicePrimaryTaskSetRequest": { - "type": "structure", - "required": [ - "cluster", - "service", - "primaryTaskSet" - ], - "members": { - "cluster": { - "shape": "String" - }, - "service": { - "shape": "String" - }, - "primaryTaskSet": { - "shape": "String" - } - } - }, - "UpdateServicePrimaryTaskSetResponse": { - "type": "structure", - "members": { - "taskSet": { - "shape": "TaskSet" - } - } - }, - "UpdateServiceRequest": { - "type": "structure", - "required": [ - "service" - ], - "members": { - "capacityProviderStrategy": { - "shape": "CapacityProviderStrategy" - }, - "cluster": { - "shape": "String" - }, - "deploymentConfiguration": { - "shape": "DeploymentConfiguration" - }, - "desiredCount": { - "shape": "BoxedInteger" - }, - "enableECSManagedTags": { - "shape": "BoxedBoolean" - }, - "enableExecuteCommand": { - "shape": "BoxedBoolean" - }, - "forceNewDeployment": { - "shape": "Boolean" - }, - "healthCheckGracePeriodSeconds": { - "shape": "BoxedInteger" - }, - "loadBalancers": { - "shape": "LoadBalancers" - }, - "networkConfiguration": { - "shape": "NetworkConfiguration" - }, - "placementConstraints": { - "shape": "PlacementConstraints" - }, - "placementStrategy": { - "shape": "PlacementStrategies" - }, - "platformVersion": { - "shape": "String" - }, - "propagateTags": { - "shape": "PropagateTags" - }, - "service": { - "shape": "String" - }, - "serviceRegistries": { - "shape": "ServiceRegistries" - }, - "serviceConnectConfiguration": { - "shape": "ServiceConnectConfiguration" - }, - "taskDefinition": { - "shape": "String" - }, - "launchType": { - "shape": "LaunchType" - } - } - }, - "UpdateServiceResponse": { - "type": "structure", - "members": { - "service": { - "shape": "Service" - } - } - }, - "UpdateTaskProtectionRequest": { - "type": "structure", - "required": [ - "cluster", - "tasks", - "protectionEnabled" - ], - "members": { - "cluster": { - "shape": "String" - }, - "tasks": { - "shape": "StringList" - }, - "protectionEnabled": { - "shape": "Boolean" - }, - "expiresInMinutes": { - "shape": "BoxedInteger" - } - } - }, - "UpdateTaskProtectionResponse": { - "type": "structure", - "members": { - "protectedTasks": { - "shape": "ProtectedTasks" - }, - "failures": { - "shape": "Failures" - } - } - }, - "UpdateTaskSetRequest": { - "type": "structure", - "required": [ - "cluster", - "service", - "taskSet" - ], - "members": { - "cluster": { - "shape": "String" - }, - "service": { - "shape": "String" - }, - "taskSet": { - "shape": "String" - }, - "scale": { - "shape": "Scale" - } - } - }, - "UpdateTaskSetResponse": { - "type": "structure", - "members": { - "taskSet": { - "shape": "TaskSet" - } - } - }, - "VersionInfo": { - "type": "structure", - "members": { - "agentVersion": { - "shape": "String" - }, - "agentHash": { - "shape": "String" - }, - "dockerVersion": { - "shape": "String" - } - } - }, - "Volume": { - "type": "structure", - "members": { - "name": { - "shape": "String" - }, - "host": { - "shape": "HostVolumeProperties" - }, - "dockerVolumeConfiguration": { - "shape": "DockerVolumeConfiguration" - } - } - }, - "VolumeFrom": { - "type": "structure", - "members": { - "sourceContainer": { - "shape": "String" - }, - "readOnly": { - "shape": "BoxedBoolean" - } - } - }, - "VolumeFromList": { - "type": "list", - "member": { - "shape": "VolumeFrom" - } - }, - "VolumeList": { - "type": "list", - "member": { - "shape": "Volume" - } - }, - "VolumeOverride": { - "type": "structure", - "members": { - "name": { - "shape": "String" - } - } - }, - "VolumeOverrides": { - "type": "list", - "member": { - "shape": "VolumeOverride" - } - } - } -} diff --git a/ecs-agent/ecs/model/api/docs-2.json b/ecs-agent/ecs/model/api/docs-2.json deleted file mode 100644 index 1419de9518c..00000000000 --- a/ecs-agent/ecs/model/api/docs-2.json +++ /dev/null @@ -1,4150 +0,0 @@ -{ - "version": "2.0", - "service": "Amazon Elastic Container Service

Amazon Elastic Container Service (Amazon ECS) is a highly scalable, fast, container management service. It makes it easy to run, stop, and manage Docker containers. You can host your cluster on a serverless infrastructure that's managed by Amazon ECS by launching your services or tasks on Fargate. For more control, you can host your tasks on a cluster of Amazon Elastic Compute Cloud (Amazon EC2) or External (on-premises) instances that you manage.

Amazon ECS makes it easy to launch and stop container-based applications with simple API calls. This makes it easy to get the state of your cluster from a centralized service, and gives you access to many familiar Amazon EC2 features.

You can use Amazon ECS to schedule the placement of containers across your cluster based on your resource needs, isolation policies, and availability requirements. With Amazon ECS, you don't need to operate your own cluster management and configuration management systems. You also don't need to worry about scaling your management infrastructure.

", - "operations": { - "AssociateCapacityProvidersWithCluster": null, - "CreateCapacityProvider": "

Creates a new capacity provider. Capacity providers are associated with an Amazon ECS cluster and are used in capacity provider strategies to facilitate cluster auto scaling.

Only capacity providers that use an Auto Scaling group can be created. Amazon ECS tasks on Fargate use the FARGATE and FARGATE_SPOT capacity providers. These providers are available to all accounts in the Amazon Web Services Regions that Fargate supports.

", - "CreateCluster": "

Creates a new Amazon ECS cluster. By default, your account receives a default cluster when you launch your first container instance. However, you can create your own cluster with a unique name with the CreateCluster action.

When you call the CreateCluster API operation, Amazon ECS attempts to create the Amazon ECS service-linked role for your account. This is so that it can manage required resources in other Amazon Web Services services on your behalf. However, if the user that makes the call doesn't have permissions to create the service-linked role, it isn't created. For more information, see Using service-linked roles for Amazon ECS in the Amazon Elastic Container Service Developer Guide.

", - "CreateService": "

Runs and maintains your desired number of tasks from a specified task definition. If the number of tasks running in a service drops below the desiredCount, Amazon ECS runs another copy of the task in the specified cluster. To update an existing service, see the UpdateService action.

Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service.

In addition to maintaining the desired count of tasks in your service, you can optionally run your service behind one or more load balancers. The load balancers distribute traffic across the tasks that are associated with the service. For more information, see Service load balancing in the Amazon Elastic Container Service Developer Guide.

Tasks for services that don't use a load balancer are considered healthy if they're in the RUNNING state. Tasks for services that use a load balancer are considered healthy if they're in the RUNNING state and are reported as healthy by the load balancer.

There are two service scheduler strategies available:

You can optionally specify a deployment configuration for your service. The deployment is initiated by changing properties. For example, the deployment might be initiated by the task definition or by your desired count of a service. This is done with an UpdateService operation. The default value for a replica service for minimumHealthyPercent is 100%. The default value for a daemon service for minimumHealthyPercent is 0%.

If a service uses the ECS deployment controller, the minimum healthy percent represents a lower limit on the number of tasks in a service that must remain in the RUNNING state during a deployment. Specifically, it represents it as a percentage of your desired number of tasks (rounded up to the nearest integer). This happens when any of your container instances are in the DRAINING state if the service contains tasks using the EC2 launch type. Using this parameter, you can deploy without using additional cluster capacity. For example, if you set your service to have desired number of four tasks and a minimum healthy percent of 50%, the scheduler might stop two existing tasks to free up cluster capacity before starting two new tasks. If they're in the RUNNING state, tasks for services that don't use a load balancer are considered healthy . If they're in the RUNNING state and reported as healthy by the load balancer, tasks for services that do use a load balancer are considered healthy . The default value for minimum healthy percent is 100%.

If a service uses the ECS deployment controller, the maximum percent parameter represents an upper limit on the number of tasks in a service that are allowed in the RUNNING or PENDING state during a deployment. Specifically, it represents it as a percentage of the desired number of tasks (rounded down to the nearest integer). This happens when any of your container instances are in the DRAINING state if the service contains tasks using the EC2 launch type. Using this parameter, you can define the deployment batch size. For example, if your service has a desired number of four tasks and a maximum percent value of 200%, the scheduler may start four new tasks before stopping the four older tasks (provided that the cluster resources required to do this are available). The default value for maximum percent is 200%.

If a service uses either the CODE_DEPLOY or EXTERNAL deployment controller types and tasks that use the EC2 launch type, the minimum healthy percent and maximum percent values are used only to define the lower and upper limit on the number of the tasks in the service that remain in the RUNNING state. This is while the container instances are in the DRAINING state. If the tasks in the service use the Fargate launch type, the minimum healthy percent and maximum percent values aren't used. This is the case even if they're currently visible when describing your service.

When creating a service that uses the EXTERNAL deployment controller, you can specify only parameters that aren't controlled at the task set level. The only required parameter is the service name. You control your services using the CreateTaskSet operation. For more information, see Amazon ECS deployment types in the Amazon Elastic Container Service Developer Guide.

When the service scheduler launches new tasks, it determines task placement. For information about task placement and task placement strategies, see Amazon ECS task placement in the Amazon Elastic Container Service Developer Guide.

", - "CreateTaskSet": "

Create a task set in the specified cluster and service. This is used when a service uses the EXTERNAL deployment controller type. For more information, see Amazon ECS deployment types in the Amazon Elastic Container Service Developer Guide.

", - "DeleteAccountSetting": "

Disables an account setting for a specified user, role, or the root user for an account.

", - "DeleteAttributes": "

Deletes one or more custom attributes from an Amazon ECS resource.

", - "DeleteCapacityProvider": "

Deletes the specified capacity provider.

The FARGATE and FARGATE_SPOT capacity providers are reserved and can't be deleted. You can disassociate them from a cluster using either the PutClusterCapacityProviders API or by deleting the cluster.

Prior to a capacity provider being deleted, the capacity provider must be removed from the capacity provider strategy from all services. The UpdateService API can be used to remove a capacity provider from a service's capacity provider strategy. When updating a service, the forceNewDeployment option can be used to ensure that any tasks using the Amazon EC2 instance capacity provided by the capacity provider are transitioned to use the capacity from the remaining capacity providers. Only capacity providers that aren't associated with a cluster can be deleted. To remove a capacity provider from a cluster, you can either use PutClusterCapacityProviders or delete the cluster.

", - "DeleteCluster": "

Deletes the specified cluster. The cluster transitions to the INACTIVE state. Clusters with an INACTIVE status might remain discoverable in your account for a period of time. However, this behavior is subject to change in the future. We don't recommend that you rely on INACTIVE clusters persisting.

You must deregister all container instances from this cluster before you may delete it. You can list the container instances in a cluster with ListContainerInstances and deregister them with DeregisterContainerInstance.

", - "DeleteService": "

Deletes a specified service within a cluster. You can delete a service if you have no running tasks in it and the desired task count is zero. If the service is actively maintaining tasks, you can't delete it, and you must update the service to a desired task count of zero. For more information, see UpdateService.

When you delete a service, if there are still running tasks that require cleanup, the service status moves from ACTIVE to DRAINING, and the service is no longer visible in the console or in the ListServices API operation. After all tasks have transitioned to either STOPPING or STOPPED status, the service status moves from DRAINING to INACTIVE. Services in the DRAINING or INACTIVE status can still be viewed with the DescribeServices API operation. However, in the future, INACTIVE services may be cleaned up and purged from Amazon ECS record keeping, and DescribeServices calls on those services return a ServiceNotFoundException error.

If you attempt to create a new service with the same name as an existing service in either ACTIVE or DRAINING status, you receive an error.

", - "DeleteTaskDefinitions": "

Deletes one or more task definitions.

You must deregister a task definition revision before you delete it. For more information, see DeregisterTaskDefinition.

When you delete a task definition revision, it is immediately transitions from the INACTIVE to DELETE_IN_PROGRESS. Existing tasks and services that reference a DELETE_IN_PROGRESS task definition revision continue to run without disruption. Existing services that reference a DELETE_IN_PROGRESS task definition revision can still scale up or down by modifying the service's desired count.

You can't use a DELETE_IN_PROGRESS task definition revision to run new tasks or create new services. You also can't update an existing service to reference a DELETE_IN_PROGRESS task definition revision.

A task definition revision will stay in DELETE_IN_PROGRESS status until all the associated tasks and services have been terminated.

When you delete all INACTIVE task definition revisions, the task definition name is not displayed in the console and not returned in the API. If a task definition revisions are in the DELETE_IN_PROGRESS state, the task definition name is displayed in the console and returned in the API. The task definition name is retained by Amazon ECS and the revision is incremented the next time you create a task definition with that name.

", - "DeleteTaskSet": "

Deletes a specified task set within a service. This is used when a service uses the EXTERNAL deployment controller type. For more information, see Amazon ECS deployment types in the Amazon Elastic Container Service Developer Guide.

", - "DeregisterContainerInstance": "

Deregisters an Amazon ECS container instance from the specified cluster. This instance is no longer available to run tasks.

If you intend to use the container instance for some other purpose after deregistration, we recommend that you stop all of the tasks running on the container instance before deregistration. That prevents any orphaned tasks from consuming resources.

Deregistering a container instance removes the instance from a cluster, but it doesn't terminate the EC2 instance. If you are finished using the instance, be sure to terminate it in the Amazon EC2 console to stop billing.

If you terminate a running container instance, Amazon ECS automatically deregisters the instance from your cluster (stopped container instances or instances with disconnected agents aren't automatically deregistered when terminated).

", - "DeregisterTaskDefinition": "

Deregisters the specified task definition by family and revision. Upon deregistration, the task definition is marked as INACTIVE. Existing tasks and services that reference an INACTIVE task definition continue to run without disruption. Existing services that reference an INACTIVE task definition can still scale up or down by modifying the service's desired count. If you want to delete a task definition revision, you must first deregister the task definition revision.

You can't use an INACTIVE task definition to run new tasks or create new services, and you can't update an existing service to reference an INACTIVE task definition. However, there may be up to a 10-minute window following deregistration where these restrictions have not yet taken effect.

At this time, INACTIVE task definitions remain discoverable in your account indefinitely. However, this behavior is subject to change in the future. We don't recommend that you rely on INACTIVE task definitions persisting beyond the lifecycle of any associated tasks and services.

You must deregister a task definition revision before you delete it. For more information, see DeleteTaskDefinitions.

", - "DescribeCapacityProviders": "

Describes one or more of your capacity providers.

", - "DescribeClusterCapacityProviderAssociations": null, - "DescribeClusters": "

Describes one or more of your clusters.

", - "DescribeContainerInstances": "

Describes one or more container instances. Returns metadata about each container instance requested.

", - "DescribeServices": "

Describes the specified services running in your cluster.

", - "DescribeTaskDefinition": "

Describes a task definition. You can specify a family and revision to find information about a specific task definition, or you can simply specify the family to find the latest ACTIVE revision in that family.

You can only describe INACTIVE task definitions while an active task or service references them.

", - "DescribeTaskSets": "

Describes the task sets in the specified cluster and service. This is used when a service uses the EXTERNAL deployment controller type. For more information, see Amazon ECS Deployment Types in the Amazon Elastic Container Service Developer Guide.

", - "DescribeTasks": "

Describes a specified task or tasks.

Currently, stopped tasks appear in the returned results for at least one hour.

If you have tasks with tags, and then delete the cluster, the tagged tasks are returned in the response. If you create a new cluster with the same name as the deleted cluster, the tagged tasks are not included in the response.

", - "DisassociateCapacityProvidersFromCluster": null, - "DiscoverPollEndpoint": "

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

Returns an endpoint for the Amazon ECS agent to poll for updates.

", - "ExecuteCommand": "

Runs a command remotely on a container within a task.

If you use a condition key in your IAM policy to refine the conditions for the policy statement, for example limit the actions to a specific cluster, you receive an AccessDeniedException when there is a mismatch between the condition key value and the corresponding parameter value.

For information about required permissions and considerations, see Using Amazon ECS Exec for debugging in the Amazon ECS Developer Guide.

", - "GetDeployment": null, - "GetTaskProtection": "

Retrieves the protection status of tasks in an Amazon ECS service.

", - "ListAccountSettings": "

Lists the account settings for a specified principal.

", - "ListAttributes": "

Lists the attributes for Amazon ECS resources within a specified target type and cluster. When you specify a target type and cluster, ListAttributes returns a list of attribute objects, one for each attribute on each resource. You can filter the list of results to a single attribute name to only return results that have that name. You can also filter the results by attribute name and value. You can do this, for example, to see which container instances in a cluster are running a Linux AMI (ecs.os-type=linux).

", - "ListClusters": "

Returns a list of existing clusters.

", - "ListContainerInstances": "

Returns a list of container instances in a specified cluster. You can filter the results of a ListContainerInstances operation with cluster query language statements inside the filter parameter. For more information, see Cluster Query Language in the Amazon Elastic Container Service Developer Guide.

", - "ListDeployments": null, - "ListServices": "

Returns a list of services. You can filter the results by cluster, launch type, and scheduling strategy.

", - "ListServicesByNamespace": "

This operation lists all of the services that are associated with a Cloud Map namespace. This list might include services in different clusters. In contrast, ListServices can only list services in one cluster at a time. If you need to filter the list of services in a single cluster by various parameters, use ListServices. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "ListTagsForResource": "

List the tags for an Amazon ECS resource.

", - "ListTaskDefinitionFamilies": "

Returns a list of task definition families that are registered to your account. This list includes task definition families that no longer have any ACTIVE task definition revisions.

You can filter out task definition families that don't contain any ACTIVE task definition revisions by setting the status parameter to ACTIVE. You can also filter the results with the familyPrefix parameter.

", - "ListTaskDefinitions": "

Returns a list of task definitions that are registered to your account. You can filter the results by family name with the familyPrefix parameter or by status with the status parameter.

", - "ListTasks": "

Returns a list of tasks. You can filter the results by cluster, task definition family, container instance, launch type, what IAM principal started the task, or by the desired status of the task.

Recently stopped tasks might appear in the returned results.

", - "NotifyLifecycleHookComplete": null, - "PutAccountSetting": "

Modifies an account setting. Account settings are set on a per-Region basis.

If you change the root user account setting, the default settings are reset for users and roles that do not have specified individual account settings. For more information, see Account Settings in the Amazon Elastic Container Service Developer Guide.

When you specify serviceLongArnFormat, taskLongArnFormat, or containerInstanceLongArnFormat, the Amazon Resource Name (ARN) and resource ID format of the resource type for a specified user, role, or the root user for an account is affected. The opt-in and opt-out account setting must be set for each Amazon ECS resource separately. The ARN and resource ID format of a resource is defined by the opt-in status of the user or role that created the resource. You must turn on this setting to use Amazon ECS features such as resource tagging.

When you specify awsvpcTrunking, the elastic network interface (ENI) limit for any new container instances that support the feature is changed. If awsvpcTrunking is turned on, any new container instances that support the feature are launched have the increased ENI limits available to them. For more information, see Elastic Network Interface Trunking in the Amazon Elastic Container Service Developer Guide.

When you specify containerInsights, the default setting indicating whether Amazon Web Services CloudWatch Container Insights is turned on for your clusters is changed. If containerInsights is turned on, any new clusters that are created will have Container Insights turned on unless you disable it during cluster creation. For more information, see CloudWatch Container Insights in the Amazon Elastic Container Service Developer Guide.

Amazon ECS is introducing tagging authorization for resource creation. Users must have permissions for actions that create the resource, such as ecsCreateCluster. If tags are specified when you create a resource, Amazon Web Services performs additional authorization to verify if users or roles have permissions to create tags. Therefore, you must grant explicit permissions to use the ecs:TagResource action. For more information, see Grant permission to tag resources on creation in the Amazon ECS Developer Guide.

When Amazon Web Services determines that a security or infrastructure update is needed for an Amazon ECS task hosted on Fargate, the tasks need to be stopped and new tasks launched to replace them. Use fargateTaskRetirementWaitPeriod to configure the wait time to retire a Fargate task. For information about the Fargate tasks maintenance, see Amazon Web Services Fargate task maintenance in the Amazon ECS Developer Guide.

", - "PutAccountSettingDefault": "

Modifies an account setting for all users on an account for whom no individual account setting has been specified. Account settings are set on a per-Region basis.

", - "PutAttributes": "

Create or update an attribute on an Amazon ECS resource. If the attribute doesn't exist, it's created. If the attribute exists, its value is replaced with the specified value. To delete an attribute, use DeleteAttributes. For more information, see Attributes in the Amazon Elastic Container Service Developer Guide.

", - "PutClusterCapacityProviders": "

Modifies the available capacity providers and the default capacity provider strategy for a cluster.

You must specify both the available capacity providers and a default capacity provider strategy for the cluster. If the specified cluster has existing capacity providers associated with it, you must specify all existing capacity providers in addition to any new ones you want to add. Any existing capacity providers that are associated with a cluster that are omitted from a PutClusterCapacityProviders API call will be disassociated with the cluster. You can only disassociate an existing capacity provider from a cluster if it's not being used by any existing tasks.

When creating a service or running a task on a cluster, if no capacity provider or launch type is specified, then the cluster's default capacity provider strategy is used. We recommend that you define a default capacity provider strategy for your cluster. However, you must specify an empty array ([]) to bypass defining a default strategy.

", - "RegisterContainerInstance": "

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

Registers an EC2 instance into the specified cluster. This instance becomes available to place containers on.

", - "RegisterTaskDefinition": "

Registers a new task definition from the supplied family and containerDefinitions. Optionally, you can add data volumes to your containers with the volumes parameter. For more information about task definition parameters and defaults, see Amazon ECS Task Definitions in the Amazon Elastic Container Service Developer Guide.

You can specify a role for your task with the taskRoleArn parameter. When you specify a role for a task, its containers can then use the latest versions of the CLI or SDKs to make API requests to the Amazon Web Services services that are specified in the policy that's associated with the role. For more information, see IAM Roles for Tasks in the Amazon Elastic Container Service Developer Guide.

You can specify a Docker networking mode for the containers in your task definition with the networkMode parameter. The available network modes correspond to those described in Network settings in the Docker run reference. If you specify the awsvpc network mode, the task is allocated an elastic network interface, and you must specify a NetworkConfiguration when you create a service or run a task with the task definition. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.

", - "RunServiceTask": null, - "RunTask": "

Starts a new task using the specified task definition.

You can allow Amazon ECS to place tasks for you, or you can customize how Amazon ECS places tasks using placement constraints and placement strategies. For more information, see Scheduling Tasks in the Amazon Elastic Container Service Developer Guide.

Alternatively, you can use StartTask to use your own scheduler or place tasks manually on specific container instances.

Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service.

The Amazon ECS API follows an eventual consistency model. This is because of the distributed nature of the system supporting the API. This means that the result of an API command you run that affects your Amazon ECS resources might not be immediately visible to all subsequent commands you run. Keep this in mind when you carry out an API command that immediately follows a previous API command.

To manage eventual consistency, you can do the following:

", - "StartTask": "

Starts a new task from the specified task definition on the specified container instance or instances.

Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performance. After April 15, 2023, new customers will not be able to launch instances with Amazon EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, customers who have used Amazon EI at least once during the past 30-day period are considered current customers and will be able to continue using the service.

Alternatively, you can use RunTask to place tasks for you. For more information, see Scheduling Tasks in the Amazon Elastic Container Service Developer Guide.

", - "StopTask": "

Stops a running task. Any tags associated with the task will be deleted.

When StopTask is called on a task, the equivalent of docker stop is issued to the containers running in the task. This results in a SIGTERM value and a default 30-second timeout, after which the SIGKILL value is sent and the containers are forcibly stopped. If the container handles the SIGTERM value gracefully and exits within 30 seconds from receiving it, no SIGKILL value is sent.

The default 30-second timeout can be configured on the Amazon ECS container agent with the ECS_CONTAINER_STOP_TIMEOUT variable. For more information, see Amazon ECS Container Agent Configuration in the Amazon Elastic Container Service Developer Guide.

", - "SubmitAttachmentStateChanges": "

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

Sent to acknowledge that an attachment changed states.

", - "SubmitContainerStateChange": "

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

Sent to acknowledge that a container changed states.

", - "SubmitTaskStateChange": "

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

Sent to acknowledge that a task changed states.

", - "TagResource": "

Associates the specified tags to a resource with the specified resourceArn. If existing tags on a resource aren't specified in the request parameters, they aren't changed. When a resource is deleted, the tags that are associated with that resource are deleted as well.

", - "UntagResource": "

Deletes specified tags from a resource.

", - "UpdateCapacityProvider": "

Modifies the parameters for a capacity provider.

", - "UpdateCluster": "

Updates the cluster.

", - "UpdateClusterSettings": "

Modifies the settings to use for a cluster.

", - "UpdateContainerAgent": "

Updates the Amazon ECS container agent on a specified container instance. Updating the Amazon ECS container agent doesn't interrupt running tasks or services on the container instance. The process for updating the agent differs depending on whether your container instance was launched with the Amazon ECS-optimized AMI or another operating system.

The UpdateContainerAgent API isn't supported for container instances using the Amazon ECS-optimized Amazon Linux 2 (arm64) AMI. To update the container agent, you can update the ecs-init package. This updates the agent. For more information, see Updating the Amazon ECS container agent in the Amazon Elastic Container Service Developer Guide.

Agent updates with the UpdateContainerAgent API operation do not apply to Windows container instances. We recommend that you launch new container instances to update the agent version in your Windows clusters.

The UpdateContainerAgent API requires an Amazon ECS-optimized AMI or Amazon Linux AMI with the ecs-init service installed and running. For help updating the Amazon ECS container agent on other operating systems, see Manually updating the Amazon ECS container agent in the Amazon Elastic Container Service Developer Guide.

", - "UpdateContainerInstancesState": "

Modifies the status of an Amazon ECS container instance.

Once a container instance has reached an ACTIVE state, you can change the status of a container instance to DRAINING to manually remove an instance from a cluster, for example to perform system updates, update the Docker daemon, or scale down the cluster size.

A container instance can't be changed to DRAINING until it has reached an ACTIVE status. If the instance is in any other status, an error will be received.

When you set a container instance to DRAINING, Amazon ECS prevents new tasks from being scheduled for placement on the container instance and replacement service tasks are started on other container instances in the cluster if the resources are available. Service tasks on the container instance that are in the PENDING state are stopped immediately.

Service tasks on the container instance that are in the RUNNING state are stopped and replaced according to the service's deployment configuration parameters, minimumHealthyPercent and maximumPercent. You can change the deployment configuration of your service using UpdateService.

Any PENDING or RUNNING tasks that do not belong to a service aren't affected. You must wait for them to finish or stop them manually.

A container instance has completed draining when it has no more RUNNING tasks. You can verify this using ListTasks.

When a container instance has been drained, you can set a container instance to ACTIVE status and once it has reached that status the Amazon ECS scheduler can begin scheduling tasks on the instance again.

", - "UpdateLifecycleHookExpiration": null, - "UpdateService": "

Modifies the parameters of a service.

For services using the rolling update (ECS) you can update the desired count, deployment configuration, network configuration, load balancers, service registries, enable ECS managed tags option, propagate tags option, task placement constraints and strategies, and task definition. When you update any of these parameters, Amazon ECS starts new tasks with the new configuration.

For services using the blue/green (CODE_DEPLOY) deployment controller, only the desired count, deployment configuration, health check grace period, task placement constraints and strategies, enable ECS managed tags option, and propagate tags can be updated using this API. If the network configuration, platform version, task definition, or load balancer need to be updated, create a new CodeDeploy deployment. For more information, see CreateDeployment in the CodeDeploy API Reference.

For services using an external deployment controller, you can update only the desired count, task placement constraints and strategies, health check grace period, enable ECS managed tags option, and propagate tags option, using this API. If the launch type, load balancer, network configuration, platform version, or task definition need to be updated, create a new task set For more information, see CreateTaskSet.

You can add to or subtract from the number of instantiations of a task definition in a service by specifying the cluster that the service is running in and a new desiredCount parameter.

If you have updated the Docker image of your application, you can create a new task definition with that image and deploy it to your service. The service scheduler uses the minimum healthy percent and maximum percent parameters (in the service's deployment configuration) to determine the deployment strategy.

If your updated Docker image uses the same tag as what is in the existing task definition for your service (for example, my_image:latest), you don't need to create a new revision of your task definition. You can update the service using the forceNewDeployment option. The new tasks launched by the deployment pull the current image/tag combination from your repository when they start.

You can also update the deployment configuration of a service. When a deployment is triggered by updating the task definition of a service, the service scheduler uses the deployment configuration parameters, minimumHealthyPercent and maximumPercent, to determine the deployment strategy.

When UpdateService stops a task during a deployment, the equivalent of docker stop is issued to the containers running in the task. This results in a SIGTERM and a 30-second timeout. After this, SIGKILL is sent and the containers are forcibly stopped. If the container handles the SIGTERM gracefully and exits within 30 seconds from receiving it, no SIGKILL is sent.

When the service scheduler launches new tasks, it determines task placement in your cluster with the following logic.

When the service scheduler stops running tasks, it attempts to maintain balance across the Availability Zones in your cluster using the following logic:

You must have a service-linked role when you update any of the following service properties:

For more information about the role see the CreateService request parameter role .

", - "UpdateServicePrimaryTaskSet": "

Modifies which task set in a service is the primary task set. Any parameters that are updated on the primary task set in a service will transition to the service. This is used when a service uses the EXTERNAL deployment controller type. For more information, see Amazon ECS Deployment Types in the Amazon Elastic Container Service Developer Guide.

", - "UpdateTaskProtection": "

Updates the protection status of a task. You can set protectionEnabled to true to protect your task from termination during scale-in events from Service Autoscaling or deployments.

Task-protection, by default, expires after 2 hours at which point Amazon ECS clears the protectionEnabled property making the task eligible for termination by a subsequent scale-in event.

You can specify a custom expiration period for task protection from 1 minute to up to 2,880 minutes (48 hours). To specify the custom expiration period, set the expiresInMinutes property. The expiresInMinutes property is always reset when you invoke this operation for a task that already has protectionEnabled set to true. You can keep extending the protection expiration period of a task by invoking this operation repeatedly.

To learn more about Amazon ECS task protection, see Task scale-in protection in the Amazon Elastic Container Service Developer Guide .

This operation is only supported for tasks belonging to an Amazon ECS service. Invoking this operation for a standalone task will result in an TASK_NOT_VALID failure. For more information, see API failure reasons.

If you prefer to set task protection from within the container, we recommend using the Task scale-in protection endpoint.

", - "UpdateTaskSet": "

Modifies a task set. This is used when a service uses the EXTERNAL deployment controller type. For more information, see Amazon ECS Deployment Types in the Amazon Elastic Container Service Developer Guide.

" - }, - "shapes": { - "AccessDeniedException": { - "base": "

You don't have authorization to perform the requested action.

", - "refs": { - } - }, - "AccountDetail": { - "base": null, - "refs": { - "CreateServiceRequest$originator": null, - "CreateTaskSetRequest$originator": null, - "RunTaskRequest$originator": null, - "UpdateServiceRequest$originator": null - } - }, - "AgentUpdateStatus": { - "base": null, - "refs": { - "ContainerInstance$agentUpdateStatus": "

The status of the most recent agent update. If an update wasn't ever requested, this value is NULL.

" - } - }, - "ApplicationProtocol": { - "base": null, - "refs": { - "PortMapping$appProtocol": "

The application protocol that's used for the port mapping. This parameter only applies to Service Connect. We recommend that you set this parameter to be consistent with the protocol that your application uses. If you set this parameter, Amazon ECS adds protocol-specific connection handling to the Service Connect proxy. If you set this parameter, Amazon ECS adds protocol-specific telemetry in the Amazon ECS console and CloudWatch.

If you don't set a value for this parameter, then TCP is used. However, Amazon ECS doesn't add protocol-specific telemetry for TCP.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "AssignPublicIp": { - "base": null, - "refs": { - "AwsVpcConfiguration$assignPublicIp": "

Whether the task's elastic network interface receives a public IP address. The default value is DISABLED.

" - } - }, - "AssociateCapacityProvidersWithClusterRequest": { - "base": null, - "refs": { - } - }, - "AssociateCapacityProvidersWithClusterResponse": { - "base": null, - "refs": { - } - }, - "Attachment": { - "base": "

An object representing a container instance or task attachment.

", - "refs": { - "Attachments$member": null - } - }, - "AttachmentDetails": { - "base": null, - "refs": { - "Attachment$details": "

Details of the attachment. For elastic network interfaces, this includes the network interface ID, the MAC address, the subnet ID, and the private IPv4 address.

" - } - }, - "AttachmentStateChange": { - "base": "

An object representing a change in state for a task attachment.

", - "refs": { - "AttachmentStateChanges$member": null - } - }, - "AttachmentStateChanges": { - "base": null, - "refs": { - "SubmitAttachmentStateChangesRequest$attachments": "

Any attachments associated with the state change request.

", - "SubmitTaskStateChangeRequest$attachments": "

Any attachments associated with the state change request.

" - } - }, - "Attachments": { - "base": null, - "refs": { - "Cluster$attachments": "

The resources attached to a cluster. When using a capacity provider with a cluster, the capacity provider and associated resources are returned as cluster attachments.

", - "ContainerInstance$attachments": "

The resources attached to a container instance, such as an elastic network interface.

", - "Task$attachments": "

The Elastic Network Adapter that's associated with the task if the task uses the awsvpc network mode.

" - } - }, - "Attribute": { - "base": "

An attribute is a name-value pair that's associated with an Amazon ECS object. Use attributes to extend the Amazon ECS data model by adding custom metadata to your resources. For more information, see Attributes in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "Attributes$member": null, - "RequiresAttributes$member": null - } - }, - "AttributeLimitExceededException": { - "base": "

You can apply up to 10 custom attributes for each resource. You can view the attributes of a resource with ListAttributes. You can remove existing attributes on a resource with DeleteAttributes.

", - "refs": { - } - }, - "Attributes": { - "base": null, - "refs": { - "ContainerInstance$attributes": "

The attributes set for the container instance, either by the Amazon ECS container agent at instance registration or manually with the PutAttributes operation.

", - "DeleteAttributesRequest$attributes": "

The attributes to delete from your resource. You can specify up to 10 attributes for each request. For custom attributes, specify the attribute name and target ID, but don't specify the value. If you specify the target ID using the short form, you must also specify the target type.

", - "DeleteAttributesResponse$attributes": "

A list of attribute objects that were successfully deleted from your resource.

", - "ListAttributesResponse$attributes": "

A list of attribute objects that meet the criteria of the request.

", - "PutAttributesRequest$attributes": "

The attributes to apply to your resource. You can specify up to 10 custom attributes for each resource. You can specify up to 10 attributes in a single call.

", - "PutAttributesResponse$attributes": "

The attributes applied to your resource.

", - "RegisterContainerInstanceRequest$attributes": "

The container instance attributes that this container instance supports.

", - "Task$attributes": "

The attributes of the task

" - } - }, - "AutoScalingGroupProvider": { - "base": "

The details of the Auto Scaling group for the capacity provider.

", - "refs": { - "CapacityProvider$autoScalingGroupProvider": "

The Auto Scaling group settings for the capacity provider.

", - "CreateCapacityProviderRequest$autoScalingGroupProvider": "

The details of the Auto Scaling group for the capacity provider.

" - } - }, - "AutoScalingGroupProviderUpdate": { - "base": "

The details of the Auto Scaling group capacity provider to update.

", - "refs": { - "UpdateCapacityProviderRequest$autoScalingGroupProvider": "

An object that represent the parameters to update for the Auto Scaling group capacity provider.

" - } - }, - "AwsVpcConfiguration": { - "base": "

An object representing the networking details for a task or service.

", - "refs": { - "NetworkConfiguration$awsvpcConfiguration": "

The VPC subnets and security groups that are associated with a task.

All specified subnets and security groups must be from the same VPC.

" - } - }, - "BadServiceConfigurationType": { - "base": null, - "refs": { - "ServiceTaskBadServiceConfigurationException$type": null - } - }, - "BlockedException": { - "base": "

Your Amazon Web Services account was blocked. For more information, contact Amazon Web Services Support.

", - "refs": { - } - }, - "BlueGreenConfiguration": { - "base": null, - "refs": { - "DeploymentConfiguration$blueGreenConfiguration": null - } - }, - "Boolean": { - "base": null, - "refs": { - "ContainerInstance$agentConnected": "

This parameter returns true if the agent is connected to Amazon ECS. An instance with an agent that may be unhealthy or stopped return false. Only instances connected to an agent can accept task placement requests.

", - "CreateServiceRequest$enableECSManagedTags": "

Specifies whether to turn on Amazon ECS managed tags for the tasks within the service. For more information, see Tagging your Amazon ECS resources in the Amazon Elastic Container Service Developer Guide.

When you use Amazon ECS managed tags, you need to set the propagateTags request parameter.

", - "CreateServiceRequest$enableExecuteCommand": "

Determines whether the execute command functionality is turned on for the service. If true, this enables execute command functionality on all containers in the service tasks.

", - "DeploymentAlarms$rollback": "

Determines whether to configure Amazon ECS to roll back the service if a service deployment fails. If rollback is used, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

", - "DeploymentAlarms$enable": "

Determines whether to use the CloudWatch alarm option in the service deployment process.

", - "DeploymentCircuitBreaker$enable": "

Determines whether to use the deployment circuit breaker logic for the service.

", - "DeploymentCircuitBreaker$rollback": "

Determines whether to configure Amazon ECS to roll back the service if a service deployment fails. If rollback is on, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.

", - "EBSVolumeConfiguration$deleteOnTermination": null, - "ExecuteCommandLogConfiguration$cloudWatchEncryptionEnabled": "

Determines whether to use encryption on the CloudWatch logs. If not specified, encryption will be off.

", - "ExecuteCommandLogConfiguration$s3EncryptionEnabled": "

Determines whether to use encryption on the S3 logs. If not specified, encryption is not used.

", - "ExecuteCommandRequest$interactive": "

Use this flag to run your command in interactive mode.

", - "ExecuteCommandResponse$interactive": "

Determines whether the execute command session is running in interactive mode. Amazon ECS only supports initiating interactive sessions, so you must specify true for this value.

", - "ListAccountSettingsRequest$effectiveSettings": "

Determines whether to return the effective settings. If true, the account settings for the root user or the default setting for the principalArn are returned. If false, the account settings for the principalArn are returned if they're set. Otherwise, no account settings are returned.

", - "ProtectedTask$protectionEnabled": "

The protection status of the task. If scale-in protection is on for a task, the value is true. Otherwise, it is false.

", - "RunServiceTaskRequest$enableECSManagedTags": null, - "RunServiceTaskRequest$enableExecuteCommand": null, - "RunServiceTaskRequest$essential": null, - "RunTaskRequest$enableECSManagedTags": "

Specifies whether to use Amazon ECS managed tags for the task. For more information, see Tagging Your Amazon ECS Resources in the Amazon Elastic Container Service Developer Guide.

", - "RunTaskRequest$enableExecuteCommand": "

Determines whether to use the execute command functionality for the containers in this task. If true, this enables execute command functionality on all containers in the task.

If true, then the task definition must have a task role, or you must provide one as an override.

", - "Service$enableECSManagedTags": "

Determines whether to use Amazon ECS managed tags for the tasks in the service. For more information, see Tagging Your Amazon ECS Resources in the Amazon Elastic Container Service Developer Guide.

", - "Service$enableExecuteCommand": "

Determines whether the execute command functionality is turned on for the service. If true, the execute command functionality is turned on for all containers in tasks as part of the service.

", - "ServiceConnectConfiguration$enabled": "

Specifies whether to use Service Connect with this service.

", - "ServiceConnectTaskConfiguration$enabled": null, - "ServiceTask$enableExecuteCommand": null, - "ServiceTask$awaitingCapacity": null, - "ServiceTaskServiceConnectTaskConfiguration$enabled": null, - "StartTaskRequest$enableECSManagedTags": "

Specifies whether to use Amazon ECS managed tags for the task. For more information, see Tagging Your Amazon ECS Resources in the Amazon Elastic Container Service Developer Guide.

", - "StartTaskRequest$enableExecuteCommand": "

Whether or not the execute command functionality is turned on for the task. If true, this turns on the execute command functionality on all containers in the task.

", - "Task$enableExecuteCommand": "

Determines whether execute command functionality is turned on for this task. If true, execute command functionality is turned on all the containers in the task.

", - "UpdateServiceRequest$forceNewDeployment": "

Determines whether to force a new deployment of the service. By default, deployments aren't forced. You can use this option to start a new deployment with no service definition changes. For example, you can update a service's tasks to use a newer Docker image with the same image/tag combination (my_image:latest) or to roll Fargate tasks onto a newer platform version.

", - "UpdateTaskProtectionRequest$protectionEnabled": "

Specify true to mark a task for protection and false to unset protection, making it eligible for termination.

" - } - }, - "BoxedBoolean": { - "base": null, - "refs": { - "ContainerDefinition$essential": "

If the essential parameter of a container is marked as true, and that container fails or stops for any reason, all other containers that are part of the task are stopped. If the essential parameter of a container is marked as false, its failure doesn't affect the rest of the containers in a task. If this parameter is omitted, a container is assumed to be essential.

All tasks must have at least one essential container. If you have an application that's composed of multiple containers, group containers that are used for a common purpose into components, and separate the different components into multiple task definitions. For more information, see Application Architecture in the Amazon Elastic Container Service Developer Guide.

", - "ContainerDefinition$disableNetworking": "

When this parameter is true, networking is off within the container. This parameter maps to NetworkDisabled in the Create a container section of the Docker Remote API.

This parameter is not supported for Windows containers.

", - "ContainerDefinition$privileged": "

When this parameter is true, the container is given elevated privileges on the host container instance (similar to the root user). This parameter maps to Privileged in the Create a container section of the Docker Remote API and the --privileged option to docker run.

This parameter is not supported for Windows containers or tasks run on Fargate.

", - "ContainerDefinition$readonlyRootFilesystem": "

When this parameter is true, the container is given read-only access to its root file system. This parameter maps to ReadonlyRootfs in the Create a container section of the Docker Remote API and the --read-only option to docker run.

This parameter is not supported for Windows containers.

", - "ContainerDefinition$interactive": "

When this parameter is true, you can deploy containerized applications that require stdin or a tty to be allocated. This parameter maps to OpenStdin in the Create a container section of the Docker Remote API and the --interactive option to docker run.

", - "ContainerDefinition$pseudoTerminal": "

When this parameter is true, a TTY is allocated. This parameter maps to Tty in the Create a container section of the Docker Remote API and the --tty option to docker run.

", - "DeleteServiceRequest$force": "

If true, allows you to delete a service even if it wasn't scaled down to zero tasks. It's only necessary to use this if the service uses the REPLICA scheduling strategy.

", - "DeleteTaskSetRequest$force": "

If true, you can delete a task set even if it hasn't been scaled down to zero.

", - "DeregisterContainerInstanceRequest$force": "

Forces the container instance to be deregistered. If you have tasks running on the container instance when you deregister it with the force option, these tasks remain running until you terminate the instance or the tasks stop through some other means, but they're orphaned (no longer monitored or accounted for by Amazon ECS). If an orphaned task on your container instance is part of an Amazon ECS service, then the service scheduler starts another copy of that task, on a different container instance if possible.

Any containers in orphaned service tasks that are registered with a Classic Load Balancer or an Application Load Balancer target group are deregistered. They begin connection draining according to the settings on the load balancer or target group.

", - "DockerVolumeConfiguration$autoprovision": "

If this value is true, the Docker volume is created if it doesn't already exist.

This field is only used if the scope is shared.

", - "EBSVolumeConfigurationOverride$deleteOnTermination": null, - "LinuxParameters$initProcessEnabled": "

Run an init process inside the container that forwards signals and reaps processes. This parameter maps to the --init option to docker run. This parameter requires version 1.25 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

", - "ListContainerInstancesRequest$exceedsWarmupPeriod": null, - "ListTasksRequest$awaitingCapacity": null, - "ListTasksRequest$hasRecentPlacementAttempts": null, - "ListTasksRequest$essential": null, - "MountPoint$readOnly": "

If this value is true, the container has read-only access to the volume. If this value is false, then the container can write to the volume. The default value is false.

", - "ServiceManagedEBSVolumeConfiguration$encrypted": null, - "ServiceTaskEBSVolumeConfigurationOverride$deleteOnTermination": null, - "TaskManagedEBSVolumeConfiguration$encrypted": null, - "TaskManagedEBSVolumeTerminationPolicy$deleteOnTermination": null, - "UpdateServiceRequest$enableECSManagedTags": "

Determines whether to turn on Amazon ECS managed tags for the tasks in the service. For more information, see Tagging Your Amazon ECS Resources in the Amazon Elastic Container Service Developer Guide.

Only tasks launched after the update will reflect the update. To update the tags on all tasks, set forceNewDeployment to true, so that Amazon ECS starts new tasks with the updated tags.

", - "UpdateServiceRequest$enableExecuteCommand": "

If true, this enables execute command functionality on all task containers.

If you do not want to override the value that was set when the service was created, you can set this to null when performing this action.

", - "Volume$configuredAtLaunch": null, - "VolumeFrom$readOnly": "

If this value is true, the container has read-only access to the volume. If this value is false, then the container can write to the volume. The default value is false.

" - } - }, - "BoxedInteger": { - "base": null, - "refs": { - "Container$exitCode": "

The exit code returned from the container.

", - "ContainerDefinition$memory": "

The amount (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed. The total amount of memory reserved for all containers within a task must be lower than the task memory value, if one is specified. This parameter maps to Memory in the Create a container section of the Docker Remote API and the --memory option to docker run.

If using the Fargate launch type, this parameter is optional.

If using the EC2 launch type, you must specify either a task-level memory value or a container-level memory value. If you specify both a container-level memory and memoryReservation value, memory must be greater than memoryReservation. If you specify memoryReservation, then that value is subtracted from the available memory resources for the container instance where the container is placed. Otherwise, the value of memory is used.

The Docker 20.10.0 or later daemon reserves a minimum of 6 MiB of memory for a container. So, don't specify less than 6 MiB of memory for your containers.

The Docker 19.03.13-ce or earlier daemon reserves a minimum of 4 MiB of memory for a container. So, don't specify less than 4 MiB of memory for your containers.

", - "ContainerDefinition$memoryReservation": "

The soft limit (in MiB) of memory to reserve for the container. When system memory is under heavy contention, Docker attempts to keep the container memory to this soft limit. However, your container can consume more memory when it needs to, up to either the hard limit specified with the memory parameter (if applicable), or all of the available memory on the container instance, whichever comes first. This parameter maps to MemoryReservation in the Create a container section of the Docker Remote API and the --memory-reservation option to docker run.

If a task-level memory value is not specified, you must specify a non-zero integer for one or both of memory or memoryReservation in a container definition. If you specify both, memory must be greater than memoryReservation. If you specify memoryReservation, then that value is subtracted from the available memory resources for the container instance where the container is placed. Otherwise, the value of memory is used.

For example, if your container normally uses 128 MiB of memory, but occasionally bursts to 256 MiB of memory for short periods of time, you can set a memoryReservation of 128 MiB, and a memory hard limit of 300 MiB. This configuration would allow the container to only reserve 128 MiB of memory from the remaining resources on the container instance, but also allow the container to consume more memory resources when needed.

The Docker 20.10.0 or later daemon reserves a minimum of 6 MiB of memory for a container. So, don't specify less than 6 MiB of memory for your containers.

The Docker 19.03.13-ce or earlier daemon reserves a minimum of 4 MiB of memory for a container. So, don't specify less than 4 MiB of memory for your containers.

", - "ContainerDefinition$restartMaxAttempts": null, - "ContainerDefinition$startTimeout": "

Time duration (in seconds) to wait before giving up on resolving dependencies for a container. For example, you specify two containers in a task definition with containerA having a dependency on containerB reaching a COMPLETE, SUCCESS, or HEALTHY status. If a startTimeout value is specified for containerB and it doesn't reach the desired status within that time then containerA gives up and not start. This results in the task transitioning to a STOPPED state.

When the ECS_CONTAINER_START_TIMEOUT container agent configuration variable is used, it's enforced independently from this start timeout value.

For tasks using the Fargate launch type, the task or service requires the following platforms:

For tasks using the EC2 launch type, your container instances require at least version 1.26.0 of the container agent to use a container start timeout value. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see Updating the Amazon ECS Container Agent in the Amazon Elastic Container Service Developer Guide. If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 of the ecs-init package. If your container instances are launched from version 20190301 or later, then they contain the required versions of the container agent and ecs-init. For more information, see Amazon ECS-optimized Linux AMI in the Amazon Elastic Container Service Developer Guide.

The valid values are 2-120 seconds.

", - "ContainerDefinition$stopTimeout": "

Time duration (in seconds) to wait before the container is forcefully killed if it doesn't exit normally on its own.

For tasks using the Fargate launch type, the task or service requires the following platforms:

The max stop timeout value is 120 seconds and if the parameter is not specified, the default value of 30 seconds is used.

For tasks that use the EC2 launch type, if the stopTimeout parameter isn't specified, the value set for the Amazon ECS container agent configuration variable ECS_CONTAINER_STOP_TIMEOUT is used. If neither the stopTimeout parameter or the ECS_CONTAINER_STOP_TIMEOUT agent configuration variable are set, then the default values of 30 seconds for Linux containers and 30 seconds on Windows containers are used. Your container instances require at least version 1.26.0 of the container agent to use a container stop timeout value. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see Updating the Amazon ECS Container Agent in the Amazon Elastic Container Service Developer Guide. If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 of the ecs-init package. If your container instances are launched from version 20190301 or later, then they contain the required versions of the container agent and ecs-init. For more information, see Amazon ECS-optimized Linux AMI in the Amazon Elastic Container Service Developer Guide.

The valid values are 2-120 seconds.

", - "ContainerOverride$cpu": "

The number of cpu units reserved for the container, instead of the default value from the task definition. You must also specify a container name.

", - "ContainerOverride$memory": "

The hard limit (in MiB) of memory to present to the container, instead of the default value from the task definition. If your container attempts to exceed the memory specified here, the container is killed. You must also specify a container name.

", - "ContainerOverride$memoryReservation": "

The soft limit (in MiB) of memory to reserve for the container, instead of the default value from the task definition. You must also specify a container name.

", - "ContainerStateChange$exitCode": "

The exit code for the container, if the state change is a result of the container exiting.

", - "CreateServiceRequest$desiredCount": "

The number of instantiations of the specified task definition to place and keep running in your service.

This is required if schedulingStrategy is REPLICA or isn't specified. If schedulingStrategy is DAEMON then this isn't required.

", - "CreateServiceRequest$healthCheckGracePeriodSeconds": "

The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. This is only used when your service is configured to use a load balancer. If your service has a load balancer defined and you don't specify a health check grace period value, the default value of 0 is used.

If you do not use an Elastic Load Balancing, we recommend that you use the startPeriod in the task definition health check parameters. For more information, see Health check.

If your service's tasks take a while to start and respond to Elastic Load Balancing health checks, you can specify a health check grace period of up to 2,147,483,647 seconds (about 69 years). During that time, the Amazon ECS service scheduler ignores health check status. This grace period can prevent the service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.

", - "DeploymentConfiguration$maximumPercent": "

If a service is using the rolling update (ECS) deployment type, the maximumPercent parameter represents an upper limit on the number of your service's tasks that are allowed in the RUNNING or PENDING state during a deployment, as a percentage of the desiredCount (rounded down to the nearest integer). This parameter enables you to define the deployment batch size. For example, if your service is using the REPLICA service scheduler and has a desiredCount of four tasks and a maximumPercent value of 200%, the scheduler may start four new tasks before stopping the four older tasks (provided that the cluster resources required to do this are available). The default maximumPercent value for a service using the REPLICA service scheduler is 200%.

If a service is using either the blue/green (CODE_DEPLOY) or EXTERNAL deployment types and tasks that use the EC2 launch type, the maximum percent value is set to the default value and is used to define the upper limit on the number of the tasks in the service that remain in the RUNNING state while the container instances are in the DRAINING state. If the tasks in the service use the Fargate launch type, the maximum percent value is not used, although it is returned when describing your service.

", - "DeploymentConfiguration$minimumHealthyPercent": "

If a service is using the rolling update (ECS) deployment type, the minimumHealthyPercent represents a lower limit on the number of your service's tasks that must remain in the RUNNING state during a deployment, as a percentage of the desiredCount (rounded up to the nearest integer). This parameter enables you to deploy without using additional cluster capacity. For example, if your service has a desiredCount of four tasks and a minimumHealthyPercent of 50%, the service scheduler may stop two existing tasks to free up cluster capacity before starting two new tasks.

For services that do not use a load balancer, the following should be noted:

For services are that do use a load balancer, the following should be noted:

If a service is using either the blue/green (CODE_DEPLOY) or EXTERNAL deployment types and is running tasks that use the EC2 launch type, the minimum healthy percent value is set to the default value and is used to define the lower limit on the number of the tasks in the service that remain in the RUNNING state while the container instances are in the DRAINING state. If a service is using either the blue/green (CODE_DEPLOY) or EXTERNAL deployment types and is running tasks that use the Fargate launch type, the minimum healthy percent value is not used, although it is returned when describing your service.

", - "DescribeCapacityProvidersRequest$maxResults": "

The maximum number of account setting results returned by DescribeCapacityProviders in paginated output. When this parameter is used, DescribeCapacityProviders only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another DescribeCapacityProviders request with the returned nextToken value. This value can be between 1 and 10. If this parameter is not used, then DescribeCapacityProviders returns up to 10 results and a nextToken value if applicable.

", - "DescribeClusterCapacityProviderAssociationsRequest$maxResults": null, - "EBSVolumeConfiguration$sizeInGiB": null, - "EBSVolumeConfigurationOverride$sizeInGiB": null, - "EFSVolumeConfiguration$transitEncryptionPort": "

The port to use when sending encrypted data between the Amazon ECS host and the Amazon EFS server. If you do not specify a transit encryption port, it will use the port selection strategy that the Amazon EFS mount helper uses. For more information, see EFS mount helper in the Amazon Elastic File System User Guide.

", - "HealthCheck$interval": "

The time period in seconds between each health check execution. You may specify between 5 and 300 seconds. The default value is 30 seconds.

", - "HealthCheck$timeout": "

The time period in seconds to wait for a health check to succeed before it is considered a failure. You may specify between 2 and 60 seconds. The default value is 5.

", - "HealthCheck$retries": "

The number of times to retry a failed health check before the container is considered unhealthy. You may specify between 1 and 10 retries. The default value is 3.

", - "HealthCheck$startPeriod": "

The optional grace period to provide containers time to bootstrap before failed health checks count towards the maximum number of retries. You can specify between 0 and 300 seconds. By default, the startPeriod is off.

If a health check succeeds within the startPeriod, then the container is considered healthy and any subsequent failures count toward the maximum number of retries.

", - "LifecycleHookDefinition$timeout": null, - "LinuxParameters$sharedMemorySize": "

The value for the size (in MiB) of the /dev/shm volume. This parameter maps to the --shm-size option to docker run.

If you are using tasks that use the Fargate launch type, the sharedMemorySize parameter is not supported.

", - "LinuxParameters$maxSwap": "

The total amount of swap memory (in MiB) a container can use. This parameter will be translated to the --memory-swap option to docker run where the value would be the sum of the container memory plus the maxSwap value.

If a maxSwap value of 0 is specified, the container will not use swap. Accepted values are 0 or any positive integer. If the maxSwap parameter is omitted, the container will use the swap configuration for the container instance it is running on. A maxSwap value must be set for the swappiness parameter to be used.

If you're using tasks that use the Fargate launch type, the maxSwap parameter isn't supported.

If you're using tasks on Amazon Linux 2023 the swappiness parameter isn't supported.

", - "LinuxParameters$swappiness": "

This allows you to tune a container's memory swappiness behavior. A swappiness value of 0 will cause swapping to not happen unless absolutely necessary. A swappiness value of 100 will cause pages to be swapped very aggressively. Accepted values are whole numbers between 0 and 100. If the swappiness parameter is not specified, a default value of 60 is used. If a value is not specified for maxSwap then this parameter is ignored. This parameter maps to the --memory-swappiness option to docker run.

If you're using tasks that use the Fargate launch type, the swappiness parameter isn't supported.

If you're using tasks on Amazon Linux 2023 the swappiness parameter isn't supported.

", - "ListAttributesRequest$maxResults": "

The maximum number of cluster results that ListAttributes returned in paginated output. When this parameter is used, ListAttributes only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListAttributes request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn't used, then ListAttributes returns up to 100 results and a nextToken value if applicable.

", - "ListClustersRequest$maxResults": "

The maximum number of cluster results that ListClusters returned in paginated output. When this parameter is used, ListClusters only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListClusters request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn't used, then ListClusters returns up to 100 results and a nextToken value if applicable.

", - "ListContainerInstancesRequest$maxResults": "

The maximum number of container instance results that ListContainerInstances returned in paginated output. When this parameter is used, ListContainerInstances only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListContainerInstances request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn't used, then ListContainerInstances returns up to 100 results and a nextToken value if applicable.

", - "ListDeploymentsRequest$maxResults": null, - "ListServicesByNamespaceRequest$maxResults": "

The maximum number of service results that ListServicesByNamespace returns in paginated output. When this parameter is used, ListServicesByNamespace only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListServicesByNamespace request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn't used, then ListServicesByNamespace returns up to 10 results and a nextToken value if applicable.

", - "ListServicesRequest$maxResults": "

The maximum number of service results that ListServices returned in paginated output. When this parameter is used, ListServices only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListServices request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn't used, then ListServices returns up to 10 results and a nextToken value if applicable.

", - "ListTaskDefinitionFamiliesRequest$maxResults": "

The maximum number of task definition family results that ListTaskDefinitionFamilies returned in paginated output. When this parameter is used, ListTaskDefinitions only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListTaskDefinitionFamilies request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn't used, then ListTaskDefinitionFamilies returns up to 100 results and a nextToken value if applicable.

", - "ListTaskDefinitionsRequest$maxResults": "

The maximum number of task definition results that ListTaskDefinitions returned in paginated output. When this parameter is used, ListTaskDefinitions only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListTaskDefinitions request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn't used, then ListTaskDefinitions returns up to 100 results and a nextToken value if applicable.

", - "ListTasksRequest$maxResults": "

The maximum number of task results that ListTasks returned in paginated output. When this parameter is used, ListTasks only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListTasks request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn't used, then ListTasks returns up to 100 results and a nextToken value if applicable.

", - "LoadBalancer$containerPort": "

The port on the container to associate with the load balancer. This port must correspond to a containerPort in the task definition the tasks in the service are using. For tasks that use the EC2 launch type, the container instance they're launched on must allow ingress traffic on the hostPort of the port mapping.

", - "NetworkBinding$containerPort": "

The port number on the container that's used with the network binding.

", - "NetworkBinding$hostPort": "

The port number on the host that's used with the network binding.

", - "PortMapping$containerPort": "

The port number on the container that's bound to the user-specified or automatically assigned host port.

If you use containers in a task with the awsvpc or host network mode, specify the exposed ports using containerPort.

If you use containers in a task with the bridge network mode and you specify a container port and not a host port, your container automatically receives a host port in the ephemeral port range. For more information, see hostPort. Port mappings that are automatically assigned in this way do not count toward the 100 reserved ports limit of a container instance.

", - "PortMapping$hostPort": "

The port number on the container instance to reserve for your container.

If you specify a containerPortRange, leave this field empty and the value of the hostPort is set as follows:

If you use containers in a task with the awsvpc or host network mode, the hostPort can either be left blank or set to the same value as the containerPort.

If you use containers in a task with the bridge network mode, you can specify a non-reserved host port for your container port mapping, or you can omit the hostPort (or set it to 0) while specifying a containerPort and your container automatically receives a port in the ephemeral port range for your container instance operating system and Docker version.

The default ephemeral port range for Docker version 1.6.0 and later is listed on the instance under /proc/sys/net/ipv4/ip_local_port_range. If this kernel parameter is unavailable, the default ephemeral port range from 49153 through 65535 (Linux) or 49152 through 65535 (Windows) is used. Do not attempt to specify a host port in the ephemeral port range as these are reserved for automatic assignment. In general, ports below 32768 are outside of the ephemeral port range.

The default reserved ports are 22 for SSH, the Docker ports 2375 and 2376, and the Amazon ECS container agent ports 51678-51680. Any host port that was previously specified in a running task is also reserved while the task is running. That is, after a task stops, the host port is released. The current reserved ports are displayed in the remainingResources of DescribeContainerInstances output. A container instance can have up to 100 reserved ports at a time. This number includes the default reserved ports. Automatically assigned ports aren't included in the 100 reserved ports quota.

", - "RunServiceTaskRequest$count": null, - "RunTaskRequest$count": "

The number of instantiations of the specified task to place on your cluster. You can specify up to 10 tasks for each call.

", - "Service$healthCheckGracePeriodSeconds": "

The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started.

", - "ServiceManagedEBSVolumeConfiguration$sizeInGiB": null, - "ServiceManagedEBSVolumeConfiguration$iops": null, - "ServiceManagedEBSVolumeConfiguration$throughput": null, - "ServiceRegistry$port": "

The port value used if your service discovery service specified an SRV record. This field might be used if both the awsvpc network mode and SRV records are used.

", - "ServiceRegistry$containerPort": "

The port value to be used for your service discovery service. It's already specified in the task definition. If the task definition your service task specifies uses the bridge or host network mode, you must specify a containerName and containerPort combination from the task definition. If the task definition your service task specifies uses the awsvpc network mode and a type SRV DNS record is used, you must specify either a containerName and containerPort combination or a port value. However, you can't specify both.

", - "ServiceTaskContainer$exitCode": null, - "ServiceTaskContainerOverride$cpu": null, - "ServiceTaskContainerOverride$memory": null, - "ServiceTaskContainerOverride$memoryReservation": null, - "ServiceTaskEBSVolumeConfigurationOverride$sizeInGiB": null, - "ServiceTaskLoadBalancer$containerPort": null, - "ServiceTaskNetworkBinding$containerPort": null, - "ServiceTaskNetworkBinding$hostPort": null, - "ServiceTaskServiceRegistry$port": null, - "ServiceTaskServiceRegistry$containerPort": null, - "SubmitContainerStateChangeRequest$exitCode": "

The exit code that's returned for the state change request.

", - "TaskManagedEBSVolumeConfiguration$sizeInGiB": null, - "TaskManagedEBSVolumeConfiguration$iops": null, - "TaskManagedEBSVolumeConfiguration$throughput": null, - "UpdateServiceRequest$desiredCount": "

The number of instantiations of the task to place and keep running in your service.

", - "UpdateServiceRequest$healthCheckGracePeriodSeconds": "

The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first started. This is only valid if your service is configured to use a load balancer. If your service's tasks take a while to start and respond to Elastic Load Balancing health checks, you can specify a health check grace period of up to 2,147,483,647 seconds. During that time, the Amazon ECS service scheduler ignores the Elastic Load Balancing health check status. This grace period can prevent the ECS service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.

", - "UpdateTaskProtectionRequest$expiresInMinutes": "

If you set protectionEnabled to true, you can specify the duration for task protection in minutes. You can specify a value from 1 minute to up to 2,880 minutes (48 hours). During this time, your task will not be terminated by scale-in events from Service Auto Scaling or deployments. After this time period lapses, protectionEnabled will be reset to false.

If you don’t specify the time, then the task is automatically protected for 120 minutes (2 hours).

" - } - }, - "CPUArchitecture": { - "base": null, - "refs": { - "RuntimePlatform$cpuArchitecture": "

The CPU architecture.

You can run your Linux tasks on an ARM-based platform by setting the value to ARM64. This option is available for tasks that run on Linux Amazon EC2 instance or Linux containers on Fargate.

" - } - }, - "CapacityProvider": { - "base": "

The details for a capacity provider.

", - "refs": { - "CapacityProviders$member": null, - "CreateCapacityProviderResponse$capacityProvider": "

The full description of the new capacity provider.

", - "DeleteCapacityProviderResponse$capacityProvider": "

The details of the capacity provider.

", - "UpdateCapacityProviderResponse$capacityProvider": "

Details about the capacity provider.

" - } - }, - "CapacityProviderField": { - "base": null, - "refs": { - "CapacityProviderFieldList$member": null - } - }, - "CapacityProviderFieldList": { - "base": null, - "refs": { - "DescribeCapacityProvidersRequest$include": "

Specifies whether or not you want to see the resource tags for the capacity provider. If TAGS is specified, the tags are included in the response. If this field is omitted, tags aren't included in the response.

" - } - }, - "CapacityProviderStatus": { - "base": null, - "refs": { - "CapacityProvider$status": "

The current status of the capacity provider. Only capacity providers in an ACTIVE state can be used in a cluster. When a capacity provider is successfully deleted, it has an INACTIVE status.

" - } - }, - "CapacityProviderStrategy": { - "base": null, - "refs": { - "AssociateCapacityProvidersWithClusterRequest$capacityProviderStrategy": null, - "Cluster$defaultCapacityProviderStrategy": "

The default capacity provider strategy for the cluster. When services or tasks are run in the cluster with no launch type or capacity provider strategy specified, the default capacity provider strategy is used.

", - "CreateClusterRequest$defaultCapacityProviderStrategy": "

The capacity provider strategy to set as the default for the cluster. After a default capacity provider strategy is set for a cluster, when you call the CreateService or RunTask APIs with no capacity provider strategy or launch type specified, the default capacity provider strategy for the cluster is used.

If a default capacity provider strategy isn't defined for a cluster when it was created, it can be defined later with the PutClusterCapacityProviders API operation.

", - "CreateServiceRequest$capacityProviderStrategy": "

The capacity provider strategy to use for the service.

If a capacityProviderStrategy is specified, the launchType parameter must be omitted. If no capacityProviderStrategy or launchType is specified, the defaultCapacityProviderStrategy for the cluster is used.

A capacity provider strategy may contain a maximum of 6 capacity providers.

", - "CreateTaskSetRequest$capacityProviderStrategy": "

The capacity provider strategy to use for the task set.

A capacity provider strategy consists of one or more capacity providers along with the base and weight to assign to them. A capacity provider must be associated with the cluster to be used in a capacity provider strategy. The PutClusterCapacityProviders API is used to associate a capacity provider with a cluster. Only capacity providers with an ACTIVE or UPDATING status can be used.

If a capacityProviderStrategy is specified, the launchType parameter must be omitted. If no capacityProviderStrategy or launchType is specified, the defaultCapacityProviderStrategy for the cluster is used.

If specifying a capacity provider that uses an Auto Scaling group, the capacity provider must already be created. New capacity providers can be created with the CreateCapacityProvider API operation.

To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT capacity providers. The Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used.

The PutClusterCapacityProviders API operation is used to update the list of available capacity providers for a cluster after the cluster is created.

", - "Deployment$capacityProviderStrategy": "

The capacity provider strategy that the deployment is using.

", - "PutClusterCapacityProvidersRequest$defaultCapacityProviderStrategy": "

The capacity provider strategy to use by default for the cluster.

When creating a service or running a task on a cluster, if no capacity provider or launch type is specified then the default capacity provider strategy for the cluster is used.

A capacity provider strategy consists of one or more capacity providers along with the base and weight to assign to them. A capacity provider must be associated with the cluster to be used in a capacity provider strategy. The PutClusterCapacityProviders API is used to associate a capacity provider with a cluster. Only capacity providers with an ACTIVE or UPDATING status can be used.

If specifying a capacity provider that uses an Auto Scaling group, the capacity provider must already be created. New capacity providers can be created with the CreateCapacityProvider API operation.

To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT capacity providers. The Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used.

", - "RunTaskRequest$capacityProviderStrategy": "

The capacity provider strategy to use for the task.

If a capacityProviderStrategy is specified, the launchType parameter must be omitted. If no capacityProviderStrategy or launchType is specified, the defaultCapacityProviderStrategy for the cluster is used.

When you use cluster auto scaling, you must specify capacityProviderStrategy and not launchType.

A capacity provider strategy may contain a maximum of 6 capacity providers.

", - "Service$capacityProviderStrategy": "

The capacity provider strategy the service uses. When using the DescribeServices API, this field is omitted if the service was created using a launch type.

", - "TaskSet$capacityProviderStrategy": "

The capacity provider strategy that are associated with the task set.

", - "UpdateServiceRequest$capacityProviderStrategy": "

The capacity provider strategy to update the service to use.

if the service uses the default capacity provider strategy for the cluster, the service can be updated to use one or more capacity providers as opposed to the default capacity provider strategy. However, when a service is using a capacity provider strategy that's not the default capacity provider strategy, the service can't be updated to use the cluster's default capacity provider strategy.

A capacity provider strategy consists of one or more capacity providers along with the base and weight to assign to them. A capacity provider must be associated with the cluster to be used in a capacity provider strategy. The PutClusterCapacityProviders API is used to associate a capacity provider with a cluster. Only capacity providers with an ACTIVE or UPDATING status can be used.

If specifying a capacity provider that uses an Auto Scaling group, the capacity provider must already be created. New capacity providers can be created with the CreateCapacityProvider API operation.

To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT capacity providers. The Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used.

The PutClusterCapacityProviders API operation is used to update the list of available capacity providers for a cluster after the cluster is created.

" - } - }, - "CapacityProviderStrategyItem": { - "base": "

The details of a capacity provider strategy. A capacity provider strategy can be set when using the RunTask or CreateCluster APIs or as the default capacity provider strategy for a cluster with the CreateCluster API.

Only capacity providers that are already associated with a cluster and have an ACTIVE or UPDATING status can be used in a capacity provider strategy. The PutClusterCapacityProviders API is used to associate a capacity provider with a cluster.

If specifying a capacity provider that uses an Auto Scaling group, the capacity provider must already be created. New Auto Scaling group capacity providers can be created with the CreateCapacityProvider API operation.

To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT capacity providers. The Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used in a capacity provider strategy.

A capacity provider strategy may contain a maximum of 6 capacity providers.

", - "refs": { - "CapacityProviderStrategy$member": null - } - }, - "CapacityProviderStrategyItemBase": { - "base": null, - "refs": { - "CapacityProviderStrategyItem$base": "

The base value designates how many tasks, at a minimum, to run on the specified capacity provider. Only one capacity provider in a capacity provider strategy can have a base defined. If no value is specified, the default value of 0 is used.

" - } - }, - "CapacityProviderStrategyItemWeight": { - "base": null, - "refs": { - "CapacityProviderStrategyItem$weight": "

The weight value designates the relative percentage of the total number of tasks launched that should use the specified capacity provider. The weight value is taken into consideration after the base value, if defined, is satisfied.

If no weight value is specified, the default value of 0 is used. When multiple capacity providers are specified within a capacity provider strategy, at least one of the capacity providers must have a weight value greater than zero and any capacity providers with a weight of 0 can't be used to place tasks. If you specify multiple capacity providers in a strategy that all have a weight of 0, any RunTask or CreateService actions using the capacity provider strategy will fail.

An example scenario for using weights is defining a strategy that contains two capacity providers and both have a weight of 1, then when the base is satisfied, the tasks will be split evenly across the two capacity providers. Using that same logic, if you specify a weight of 1 for capacityProviderA and a weight of 4 for capacityProviderB, then for every one task that's run using capacityProviderA, four tasks would use capacityProviderB.

" - } - }, - "CapacityProviderUpdateStatus": { - "base": null, - "refs": { - "CapacityProvider$updateStatus": "

The update status of the capacity provider. The following are the possible states that is returned.

DELETE_IN_PROGRESS

The capacity provider is in the process of being deleted.

DELETE_COMPLETE

The capacity provider was successfully deleted and has an INACTIVE status.

DELETE_FAILED

The capacity provider can't be deleted. The update status reason provides further details about why the delete failed.

" - } - }, - "CapacityProviders": { - "base": null, - "refs": { - "DescribeCapacityProvidersResponse$capacityProviders": "

The list of capacity providers.

" - } - }, - "ClientException": { - "base": "

These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource,. Or, it might be specifying an identifier that isn't valid.

", - "refs": { - } - }, - "Cluster": { - "base": "

A regional grouping of one or more container instances where you can run task requests. Each account receives a default cluster the first time you use the Amazon ECS service, but you may also create other clusters. Clusters may contain more than one instance type simultaneously.

", - "refs": { - "Clusters$member": null, - "CreateClusterResponse$cluster": "

The full description of your new cluster.

", - "DeleteClusterResponse$cluster": "

The full description of the deleted cluster.

", - "PutClusterCapacityProvidersResponse$cluster": "

Details about the cluster.

", - "UpdateClusterResponse$cluster": "

Details about the cluster.

", - "UpdateClusterSettingsResponse$cluster": "

Details about the cluster

" - } - }, - "ClusterCapacityProviderAssociation": { - "base": null, - "refs": { - "ClusterCapacityProviderAssociations$member": null - } - }, - "ClusterCapacityProviderAssociations": { - "base": null, - "refs": { - "AssociateCapacityProvidersWithClusterResponse$associations": null, - "DescribeClusterCapacityProviderAssociationsResponse$associations": null, - "DisassociateCapacityProvidersFromClusterResponse$associations": null - } - }, - "ClusterConfiguration": { - "base": "

The execute command configuration for the cluster.

", - "refs": { - "Cluster$configuration": "

The execute command configuration for the cluster.

", - "CreateClusterRequest$configuration": "

The execute command configuration for the cluster.

", - "UpdateClusterRequest$configuration": "

The execute command configuration for the cluster.

" - } - }, - "ClusterContainsContainerInstancesException": { - "base": "

You can't delete a cluster that has registered container instances. First, deregister the container instances before you can delete the cluster. For more information, see DeregisterContainerInstance.

", - "refs": { - } - }, - "ClusterContainsServicesException": { - "base": "

You can't delete a cluster that contains services. First, update the service to reduce its desired task count to 0, and then delete the service. For more information, see UpdateService and DeleteService.

", - "refs": { - } - }, - "ClusterContainsTasksException": { - "base": "

You can't delete a cluster that has active tasks.

", - "refs": { - } - }, - "ClusterDefaults": { - "base": null, - "refs": { - "Cluster$clusterDefaults": null - } - }, - "ClusterField": { - "base": null, - "refs": { - "ClusterFieldList$member": null - } - }, - "ClusterFieldList": { - "base": null, - "refs": { - "DescribeClustersRequest$include": "

Determines whether to include additional information about the clusters in the response. If this field is omitted, this information isn't included.

If ATTACHMENTS is specified, the attachments for the container instances or tasks within the cluster are included, for example the capacity providers.

If SETTINGS is specified, the settings for the cluster are included.

If CONFIGURATIONS is specified, the configuration for the cluster is included.

If STATISTICS is specified, the task and service count is included, separated by launch type.

If TAGS is specified, the metadata tags associated with the cluster are included.

" - } - }, - "ClusterNotFoundException": { - "base": "

The specified cluster wasn't found. You can view your available clusters with ListClusters. Amazon ECS clusters are Region specific.

", - "refs": { - } - }, - "ClusterServiceConnectDefaults": { - "base": "

Use this parameter to set a default Service Connect namespace. After you set a default Service Connect namespace, any new services with Service Connect turned on that are created in the cluster are added as client services in the namespace. This setting only applies to new services that set the enabled parameter to true in the ServiceConnectConfiguration. You can set the namespace of each service individually in the ServiceConnectConfiguration to override this default parameter.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "Cluster$serviceConnectDefaults": "

Use this parameter to set a default Service Connect namespace. After you set a default Service Connect namespace, any new services with Service Connect turned on that are created in the cluster are added as client services in the namespace. This setting only applies to new services that set the enabled parameter to true in the ServiceConnectConfiguration. You can set the namespace of each service individually in the ServiceConnectConfiguration to override this default parameter.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "ClusterServiceConnectDefaultsRequest": { - "base": "

Use this parameter to set a default Service Connect namespace. After you set a default Service Connect namespace, any new services with Service Connect turned on that are created in the cluster are added as client services in the namespace. This setting only applies to new services that set the enabled parameter to true in the ServiceConnectConfiguration. You can set the namespace of each service individually in the ServiceConnectConfiguration to override this default parameter.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "CreateClusterRequest$serviceConnectDefaults": "

Use this parameter to set a default Service Connect namespace. After you set a default Service Connect namespace, any new services with Service Connect turned on that are created in the cluster are added as client services in the namespace. This setting only applies to new services that set the enabled parameter to true in the ServiceConnectConfiguration. You can set the namespace of each service individually in the ServiceConnectConfiguration to override this default parameter.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "UpdateClusterRequest$serviceConnectDefaults": "

Use this parameter to set a default Service Connect namespace. After you set a default Service Connect namespace, any new services with Service Connect turned on that are created in the cluster are added as client services in the namespace. This setting only applies to new services that set the enabled parameter to true in the ServiceConnectConfiguration. You can set the namespace of each service individually in the ServiceConnectConfiguration to override this default parameter.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "ClusterSetting": { - "base": "

The settings to use when creating a cluster. This parameter is used to turn on CloudWatch Container Insights for a cluster.

", - "refs": { - "ClusterSettings$member": null - } - }, - "ClusterSettingName": { - "base": null, - "refs": { - "ClusterSetting$name": "

The name of the cluster setting. The value is containerInsights .

" - } - }, - "ClusterSettings": { - "base": null, - "refs": { - "Cluster$settings": "

The settings for the cluster. This parameter indicates whether CloudWatch Container Insights is on or off for a cluster.

", - "CreateClusterRequest$settings": "

The setting to use when creating a cluster. This parameter is used to turn on CloudWatch Container Insights for a cluster. If this value is specified, it overrides the containerInsights value set with PutAccountSetting or PutAccountSettingDefault.

", - "UpdateClusterRequest$settings": "

The cluster settings for your cluster.

", - "UpdateClusterSettingsRequest$settings": "

The setting to use by default for a cluster. This parameter is used to turn on CloudWatch Container Insights for a cluster. If this value is specified, it overrides the containerInsights value set with PutAccountSetting or PutAccountSettingDefault.

Currently, if you delete an existing cluster that does not have Container Insights turned on, and then create a new cluster with the same name with Container Insights tuned on, Container Insights will not actually be turned on. If you want to preserve the same name for your existing cluster and turn on Container Insights, you must wait 7 days before you can re-create it.

" - } - }, - "Clusters": { - "base": null, - "refs": { - "DescribeClustersResponse$clusters": "

The list of clusters.

" - } - }, - "Compatibility": { - "base": null, - "refs": { - "CompatibilityList$member": null - } - }, - "CompatibilityList": { - "base": null, - "refs": { - "RegisterTaskDefinitionRequest$requiresCompatibilities": "

The task launch type that Amazon ECS validates the task definition against. A client exception is returned if the task definition doesn't validate against the compatibilities specified. If no value is specified, the parameter is omitted from the response.

", - "TaskDefinition$compatibilities": "

The task launch types the task definition validated against during task definition registration. For more information, see Amazon ECS launch types in the Amazon Elastic Container Service Developer Guide.

", - "TaskDefinition$requiresCompatibilities": "

The task launch types the task definition was validated against. The valid values are EC2, FARGATE, and EXTERNAL. For more information, see Amazon ECS launch types in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "ConflictException": { - "base": null, - "refs": { - } - }, - "Connectivity": { - "base": null, - "refs": { - "Task$connectivity": "

The connectivity status of a task.

" - } - }, - "Container": { - "base": "

A Docker container that's part of a task.

", - "refs": { - "Containers$member": null - } - }, - "ContainerCondition": { - "base": null, - "refs": { - "ContainerDependency$condition": "

The dependency condition of the container. The following are the available conditions and their behavior:

" - } - }, - "ContainerDefinition": { - "base": "

Container definitions are used in task definitions to describe the different containers that are launched as part of a task.

", - "refs": { - "ContainerDefinitions$member": null - } - }, - "ContainerDefinitions": { - "base": null, - "refs": { - "RegisterTaskDefinitionRequest$containerDefinitions": "

A list of container definitions in JSON format that describe the different containers that make up your task.

", - "TaskDefinition$containerDefinitions": "

A list of container definitions in JSON format that describe the different containers that make up your task. For more information about container definition parameters and defaults, see Amazon ECS Task Definitions in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "ContainerDependencies": { - "base": null, - "refs": { - "ContainerDefinition$dependsOn": "

The dependencies defined for container startup and shutdown. A container can contain multiple dependencies on other containers in a task definition. When a dependency is defined for container startup, for container shutdown it is reversed.

For tasks using the EC2 launch type, the container instances require at least version 1.26.0 of the container agent to turn on container dependencies. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see Updating the Amazon ECS Container Agent in the Amazon Elastic Container Service Developer Guide. If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 of the ecs-init package. If your container instances are launched from version 20190301 or later, then they contain the required versions of the container agent and ecs-init. For more information, see Amazon ECS-optimized Linux AMI in the Amazon Elastic Container Service Developer Guide.

For tasks using the Fargate launch type, the task or service requires the following platforms:

" - } - }, - "ContainerDependency": { - "base": "

The dependencies defined for container startup and shutdown. A container can contain multiple dependencies. When a dependency is defined for container startup, for container shutdown it is reversed.

Your Amazon ECS container instances require at least version 1.26.0 of the container agent to use container dependencies. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see Updating the Amazon ECS Container Agent in the Amazon Elastic Container Service Developer Guide. If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 of the ecs-init package. If your container instances are launched from version 20190301 or later, then they contain the required versions of the container agent and ecs-init. For more information, see Amazon ECS-optimized Linux AMI in the Amazon Elastic Container Service Developer Guide.

For tasks that use the Fargate launch type, the task or service requires the following platforms:

", - "refs": { - "ContainerDependencies$member": null - } - }, - "ContainerInstance": { - "base": "

An Amazon EC2 or External instance that's running the Amazon ECS agent and has been registered with a cluster.

", - "refs": { - "ContainerInstances$member": null, - "DeregisterContainerInstanceResponse$containerInstance": "

The container instance that was deregistered.

", - "RegisterContainerInstanceResponse$containerInstance": "

The container instance that was registered.

", - "UpdateContainerAgentResponse$containerInstance": "

The container instance that the container agent was updated for.

" - } - }, - "ContainerInstanceField": { - "base": null, - "refs": { - "ContainerInstanceFieldList$member": null - } - }, - "ContainerInstanceFieldList": { - "base": null, - "refs": { - "DescribeContainerInstancesRequest$include": "

Specifies whether you want to see the resource tags for the container instance. If TAGS is specified, the tags are included in the response. If CONTAINER_INSTANCE_HEALTH is specified, the container instance health is included in the response. If this field is omitted, tags and container instance health status aren't included in the response.

" - } - }, - "ContainerInstanceHealthStatus": { - "base": "

An object representing the health status of the container instance.

", - "refs": { - "ContainerInstance$healthStatus": "

An object representing the health status of the container instance.

" - } - }, - "ContainerInstanceStatus": { - "base": null, - "refs": { - "ListContainerInstancesRequest$status": "

Filters the container instances by status. For example, if you specify the DRAINING status, the results include only container instances that have been set to DRAINING using UpdateContainerInstancesState. If you don't specify this parameter, the default is to include container instances set to all states other than INACTIVE.

", - "UpdateContainerInstancesStateRequest$status": "

The container instance state to update the container instance with. The only valid values for this action are ACTIVE and DRAINING. A container instance can only be updated to DRAINING status once it has reached an ACTIVE state. If a container instance is in REGISTERING, DEREGISTERING, or REGISTRATION_FAILED state you can describe the container instance but can't update the container instance state.

" - } - }, - "ContainerInstances": { - "base": null, - "refs": { - "DescribeContainerInstancesResponse$containerInstances": "

The list of container instances.

", - "UpdateContainerInstancesStateResponse$containerInstances": "

The list of container instances.

" - } - }, - "ContainerOverride": { - "base": "

The overrides that are sent to a container. An empty container override can be passed in. An example of an empty container override is {\"containerOverrides\": [ ] }. If a non-empty container override is specified, the name parameter must be included.

You can use Secrets Manager or Amazon Web Services Systems Manager Parameter Store to store the sensitive data. For more information, see Retrieve secrets through environment variables in the Amazon ECS Developer Guide.

", - "refs": { - "ContainerOverrides$member": null - } - }, - "ContainerOverrides": { - "base": null, - "refs": { - "TaskOverride$containerOverrides": "

One or more container overrides that are sent to a task.

" - } - }, - "ContainerStateChange": { - "base": "

An object that represents a change in state for a container.

", - "refs": { - "ContainerStateChanges$member": null - } - }, - "ContainerStateChanges": { - "base": null, - "refs": { - "SubmitTaskStateChangeRequest$containers": "

Any containers that's associated with the state change request.

" - } - }, - "Containers": { - "base": null, - "refs": { - "Task$containers": "

The containers that's associated with the task.

" - } - }, - "CreateCapacityProviderRequest": { - "base": null, - "refs": { - } - }, - "CreateCapacityProviderResponse": { - "base": null, - "refs": { - } - }, - "CreateClusterRequest": { - "base": null, - "refs": { - } - }, - "CreateClusterResponse": { - "base": null, - "refs": { - } - }, - "CreateServiceRequest": { - "base": null, - "refs": { - } - }, - "CreateServiceResponse": { - "base": null, - "refs": { - } - }, - "CreateTaskSetRequest": { - "base": null, - "refs": { - } - }, - "CreateTaskSetResponse": { - "base": null, - "refs": { - } - }, - "DeleteAccountSettingRequest": { - "base": null, - "refs": { - } - }, - "DeleteAccountSettingResponse": { - "base": null, - "refs": { - } - }, - "DeleteAttributesRequest": { - "base": null, - "refs": { - } - }, - "DeleteAttributesResponse": { - "base": null, - "refs": { - } - }, - "DeleteCapacityProviderRequest": { - "base": null, - "refs": { - } - }, - "DeleteCapacityProviderResponse": { - "base": null, - "refs": { - } - }, - "DeleteClusterRequest": { - "base": null, - "refs": { - } - }, - "DeleteClusterResponse": { - "base": null, - "refs": { - } - }, - "DeleteServiceRequest": { - "base": null, - "refs": { - } - }, - "DeleteServiceResponse": { - "base": null, - "refs": { - } - }, - "DeleteTaskDefinitionsRequest": { - "base": null, - "refs": { - } - }, - "DeleteTaskDefinitionsResponse": { - "base": null, - "refs": { - } - }, - "DeleteTaskSetRequest": { - "base": null, - "refs": { - } - }, - "DeleteTaskSetResponse": { - "base": null, - "refs": { - } - }, - "Deployment": { - "base": "

The details of an Amazon ECS service deployment. This is used only when a service uses the ECS deployment controller type.

", - "refs": { - "Deployments$member": null - } - }, - "DeploymentAlarms": { - "base": "

One of the methods which provide a way for you to quickly identify when a deployment has failed, and then to optionally roll back the failure to the last working deployment.

When the alarms are generated, Amazon ECS sets the service deployment to failed. Set the rollback parameter to have Amazon ECS to roll back your service to the last completed deployment after a failure.

You can only use the DeploymentAlarms method to detect failures when the DeploymentController is set to ECS (rolling update).

For more information, see Rolling update in the Amazon Elastic Container Service Developer Guide .

", - "refs": { - "DeploymentConfiguration$alarms": "

Information about the CloudWatch alarms.

" - } - }, - "DeploymentCircuitBreaker": { - "base": "

The deployment circuit breaker can only be used for services using the rolling update (ECS) deployment type.

The deployment circuit breaker determines whether a service deployment will fail if the service can't reach a steady state. If it is turned on, a service deployment will transition to a failed state and stop launching new tasks. You can also configure Amazon ECS to roll back your service to the last completed deployment after a failure. For more information, see Rolling update in the Amazon Elastic Container Service Developer Guide.

For more information about API failure reasons, see API failure reasons in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "DeploymentConfiguration$deploymentCircuitBreaker": "

The deployment circuit breaker can only be used for services using the rolling update (ECS) deployment type.

The deployment circuit breaker determines whether a service deployment will fail if the service can't reach a steady state. If you use the deployment circuit breaker, a service deployment will transition to a failed state and stop launching new tasks. If you use the rollback option, when a service deployment fails, the service is rolled back to the last deployment that completed successfully. For more information, see Rolling update in the Amazon Elastic Container Service Developer Guide

" - } - }, - "DeploymentConfiguration": { - "base": "

Optional deployment parameters that control how many tasks run during a deployment and the ordering of stopping and starting tasks.

", - "refs": { - "CreateServiceRequest$deploymentConfiguration": "

Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.

", - "Service$deploymentConfiguration": "

Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.

", - "UpdateServiceRequest$deploymentConfiguration": "

Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.

" - } - }, - "DeploymentController": { - "base": "

The deployment controller to use for the service. For more information, see Amazon ECS deployment types in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "CreateServiceRequest$deploymentController": "

The deployment controller to use for the service. If no deployment controller is specified, the default value of ECS is used.

", - "Service$deploymentController": "

The deployment controller type the service is using.

", - "UpdateServiceRequest$deploymentController": null - } - }, - "DeploymentControllerType": { - "base": null, - "refs": { - "DeploymentController$type": "

The deployment controller type to use.

There are three deployment controller types available:

ECS

The rolling update (ECS) deployment type involves replacing the current running version of the container with the latest version. The number of containers Amazon ECS adds or removes from the service during a rolling update is controlled by adjusting the minimum and maximum number of healthy tasks allowed during a service deployment, as specified in the DeploymentConfiguration.

CODE_DEPLOY

The blue/green (CODE_DEPLOY) deployment type uses the blue/green deployment model powered by CodeDeploy, which allows you to verify a new deployment of a service before sending production traffic to it.

EXTERNAL

The external (EXTERNAL) deployment type enables you to use any third-party deployment controller for full control over the deployment process for an Amazon ECS service.

" - } - }, - "DeploymentRolloutState": { - "base": null, - "refs": { - "Deployment$rolloutState": "

The rolloutState of a service is only returned for services that use the rolling update (ECS) deployment type that aren't behind a Classic Load Balancer.

The rollout state of the deployment. When a service deployment is started, it begins in an IN_PROGRESS state. When the service reaches a steady state, the deployment transitions to a COMPLETED state. If the service fails to reach a steady state and circuit breaker is turned on, the deployment transitions to a FAILED state. A deployment in FAILED state doesn't launch any new tasks. For more information, see DeploymentCircuitBreaker.

", - "UpdateTaskSetRequest$rolloutState": null - } - }, - "DeploymentStatus": { - "base": null, - "refs": { - "DeploymentV2$status": null, - "DeploymentV2Summary$status": null - } - }, - "DeploymentStrategy": { - "base": null, - "refs": { - "DeploymentConfiguration$strategy": null - } - }, - "DeploymentV2": { - "base": null, - "refs": { - "GetDeploymentResponse$deploymentV2": null - } - }, - "DeploymentV2Summary": { - "base": null, - "refs": { - "DeploymentV2SummaryList$member": null - } - }, - "DeploymentV2SummaryList": { - "base": null, - "refs": { - "ListDeploymentsResponse$deploymentV2SummaryList": null - } - }, - "Deployments": { - "base": null, - "refs": { - "Service$deployments": "

The current state of deployments for the service.

" - } - }, - "DeregisterContainerInstanceRequest": { - "base": null, - "refs": { - } - }, - "DeregisterContainerInstanceResponse": { - "base": null, - "refs": { - } - }, - "DeregisterTaskDefinitionRequest": { - "base": null, - "refs": { - } - }, - "DeregisterTaskDefinitionResponse": { - "base": null, - "refs": { - } - }, - "DescribeCapacityProvidersRequest": { - "base": null, - "refs": { - } - }, - "DescribeCapacityProvidersResponse": { - "base": null, - "refs": { - } - }, - "DescribeClusterCapacityProviderAssociationsRequest": { - "base": null, - "refs": { - } - }, - "DescribeClusterCapacityProviderAssociationsResponse": { - "base": null, - "refs": { - } - }, - "DescribeClustersRequest": { - "base": null, - "refs": { - } - }, - "DescribeClustersResponse": { - "base": null, - "refs": { - } - }, - "DescribeContainerInstancesRequest": { - "base": null, - "refs": { - } - }, - "DescribeContainerInstancesResponse": { - "base": null, - "refs": { - } - }, - "DescribeServicesRequest": { - "base": null, - "refs": { - } - }, - "DescribeServicesResponse": { - "base": null, - "refs": { - } - }, - "DescribeTaskDefinitionRequest": { - "base": null, - "refs": { - } - }, - "DescribeTaskDefinitionResponse": { - "base": null, - "refs": { - } - }, - "DescribeTaskSetsRequest": { - "base": null, - "refs": { - } - }, - "DescribeTaskSetsResponse": { - "base": null, - "refs": { - } - }, - "DescribeTasksRequest": { - "base": null, - "refs": { - } - }, - "DescribeTasksResponse": { - "base": null, - "refs": { - } - }, - "DesiredStatus": { - "base": null, - "refs": { - "ListTasksRequest$desiredStatus": "

The task desired status to use when filtering the ListTasks results. Specifying a desiredStatus of STOPPED limits the results to tasks that Amazon ECS has set the desired status to STOPPED. This can be useful for debugging tasks that aren't starting properly or have died or finished. The default status filter is RUNNING, which shows tasks that Amazon ECS has set the desired status to RUNNING.

Although you can filter results based on a desired status of PENDING, this doesn't return any results. Amazon ECS never sets the desired status of a task to that value (only a task's lastStatus may have a value of PENDING).

" - } - }, - "Device": { - "base": "

An object representing a container instance host device.

", - "refs": { - "DevicesList$member": null - } - }, - "DeviceCgroupPermission": { - "base": null, - "refs": { - "DeviceCgroupPermissions$member": null - } - }, - "DeviceCgroupPermissions": { - "base": null, - "refs": { - "Device$permissions": "

The explicit permissions to provide to the container for the device. By default, the container has permissions for read, write, and mknod for the device.

" - } - }, - "DevicesList": { - "base": null, - "refs": { - "LinuxParameters$devices": "

Any host devices to expose to the container. This parameter maps to Devices in the Create a container section of the Docker Remote API and the --device option to docker run.

If you're using tasks that use the Fargate launch type, the devices parameter isn't supported.

" - } - }, - "DisassociateCapacityProvidersFromClusterRequest": { - "base": null, - "refs": { - } - }, - "DisassociateCapacityProvidersFromClusterResponse": { - "base": null, - "refs": { - } - }, - "DiscoverPollEndpointRequest": { - "base": null, - "refs": { - } - }, - "DiscoverPollEndpointResponse": { - "base": null, - "refs": { - } - }, - "DockerLabelsMap": { - "base": null, - "refs": { - "ContainerDefinition$dockerLabels": "

A key/value map of labels to add to the container. This parameter maps to Labels in the Create a container section of the Docker Remote API and the --label option to docker run. This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

" - } - }, - "DockerVolumeConfiguration": { - "base": "

This parameter is specified when you're using Docker volumes. Docker volumes are only supported when you're using the EC2 launch type. Windows containers only support the use of the local driver. To use bind mounts, specify a host instead.

", - "refs": { - "Volume$dockerVolumeConfiguration": "

This parameter is specified when you use Docker volumes.

Windows containers only support the use of the local driver. To use bind mounts, specify the host parameter instead.

Docker volumes aren't supported by tasks run on Fargate.

" - } - }, - "Double": { - "base": null, - "refs": { - "Resource$doubleValue": "

When the doubleValue type is set, the value of the resource must be a double precision floating-point type.

", - "Scale$value": "

The value, specified as a percent total of a service's desiredCount, to scale the task set. Accepted values are numbers between 0 and 100.

" - } - }, - "Duration": { - "base": null, - "refs": { - "TimeoutConfiguration$idleTimeoutSeconds": null, - "TimeoutConfiguration$perRequestTimeoutSeconds": null - } - }, - "EBSKMSKeyId": { - "base": null, - "refs": { - "ServiceManagedEBSVolumeConfiguration$kmsKeyId": null, - "TaskManagedEBSVolumeConfiguration$kmsKeyId": null - } - }, - "EBSResourceType": { - "base": null, - "refs": { - "EBSTagSpecification$resourceType": null - } - }, - "EBSSnapshotId": { - "base": null, - "refs": { - "ServiceManagedEBSVolumeConfiguration$snapshotId": null, - "TaskManagedEBSVolumeConfiguration$snapshotId": null - } - }, - "EBSTagSpecification": { - "base": null, - "refs": { - "EBSTagSpecifications$member": null - } - }, - "EBSTagSpecifications": { - "base": null, - "refs": { - "ServiceManagedEBSVolumeConfiguration$tagSpecifications": null, - "TaskManagedEBSVolumeConfiguration$tagSpecifications": null - } - }, - "EBSVolumeConfiguration": { - "base": null, - "refs": { - "Volume$ebsVolumeConfiguration": null - } - }, - "EBSVolumeConfigurationOverride": { - "base": null, - "refs": { - "VolumeOverride$ebsVolumeConfiguration": null - } - }, - "EBSVolumeType": { - "base": null, - "refs": { - "ServiceManagedEBSVolumeConfiguration$volumeType": null, - "TaskManagedEBSVolumeConfiguration$volumeType": null - } - }, - "ECSVolumeName": { - "base": null, - "refs": { - "ServiceVolumeConfiguration$name": null, - "TaskVolumeConfiguration$name": null - } - }, - "EFSAuthorizationConfig": { - "base": "

The authorization configuration details for the Amazon EFS file system.

", - "refs": { - "EFSVolumeConfiguration$authorizationConfig": "

The authorization configuration details for the Amazon EFS file system.

" - } - }, - "EFSAuthorizationConfigIAM": { - "base": null, - "refs": { - "EFSAuthorizationConfig$iam": "

Determines whether to use the Amazon ECS task role defined in a task definition when mounting the Amazon EFS file system. If it is turned on, transit encryption must be turned on in the EFSVolumeConfiguration. If this parameter is omitted, the default value of DISABLED is used. For more information, see Using Amazon EFS access points in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "EFSTransitEncryption": { - "base": null, - "refs": { - "EFSVolumeConfiguration$transitEncryption": "

Determines whether to use encryption for Amazon EFS data in transit between the Amazon ECS host and the Amazon EFS server. Transit encryption must be turned on if Amazon EFS IAM authorization is used. If this parameter is omitted, the default value of DISABLED is used. For more information, see Encrypting data in transit in the Amazon Elastic File System User Guide.

" - } - }, - "EFSVolumeConfiguration": { - "base": "

This parameter is specified when you're using an Amazon Elastic File System file system for task storage. For more information, see Amazon EFS volumes in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "Volume$efsVolumeConfiguration": "

This parameter is specified when you use an Amazon Elastic File System file system for task storage.

" - } - }, - "EnvironmentFile": { - "base": "

A list of files containing the environment variables to pass to a container. You can specify up to ten environment files. The file must have a .env file extension. Each line in an environment file should contain an environment variable in VARIABLE=VALUE format. Lines beginning with # are treated as comments and are ignored. For more information about the environment variable file syntax, see Declare default environment variables in file.

If there are environment variables specified using the environment parameter in a container definition, they take precedence over the variables contained within an environment file. If multiple environment files are specified that contain the same variable, they're processed from the top down. We recommend that you use unique variable names. For more information, see Specifying environment variables in the Amazon Elastic Container Service Developer Guide.

You must use the following platforms for the Fargate launch type:

", - "refs": { - "EnvironmentFiles$member": null - } - }, - "EnvironmentFileType": { - "base": null, - "refs": { - "EnvironmentFile$type": "

The file type to use. The only supported value is s3.

" - } - }, - "EnvironmentFiles": { - "base": null, - "refs": { - "ContainerDefinition$environmentFiles": "

A list of files containing the environment variables to pass to a container. This parameter maps to the --env-file option to docker run.

You can specify up to ten environment files. The file must have a .env file extension. Each line in an environment file contains an environment variable in VARIABLE=VALUE format. Lines beginning with # are treated as comments and are ignored. For more information about the environment variable file syntax, see Declare default environment variables in file.

If there are environment variables specified using the environment parameter in a container definition, they take precedence over the variables contained within an environment file. If multiple environment files are specified that contain the same variable, they're processed from the top down. We recommend that you use unique variable names. For more information, see Specifying Environment Variables in the Amazon Elastic Container Service Developer Guide.

", - "ContainerOverride$environmentFiles": "

A list of files containing the environment variables to pass to a container, instead of the value from the container definition.

" - } - }, - "EnvironmentVariables": { - "base": null, - "refs": { - "ContainerDefinition$environment": "

The environment variables to pass to a container. This parameter maps to Env in the Create a container section of the Docker Remote API and the --env option to docker run.

We don't recommend that you use plaintext environment variables for sensitive information, such as credential data.

", - "ContainerOverride$environment": "

The environment variables to send to the container. You can add new environment variables, which are added to the container at launch, or you can override the existing environment variables from the Docker image or the task definition. You must also specify a container name.

" - } - }, - "EphemeralStorage": { - "base": "

The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on Fargate. For more information, see Fargate task storage in the Amazon ECS User Guide for Fargate.

For tasks using the Fargate launch type, the task requires the following platforms:

", - "refs": { - "RegisterTaskDefinitionRequest$ephemeralStorage": "

The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on Fargate. For more information, see Fargate task storage in the Amazon ECS User Guide for Fargate.

For tasks using the Fargate launch type, the task requires the following platforms:

", - "Task$ephemeralStorage": "

The ephemeral storage settings for the task.

", - "TaskDefinition$ephemeralStorage": "

The ephemeral storage settings to use for tasks run with the task definition.

", - "TaskOverride$ephemeralStorage": "

The ephemeral storage setting override for the task.

This parameter is only supported for tasks hosted on Fargate that use the following platform versions:

" - } - }, - "ExecuteCommandConfiguration": { - "base": "

The details of the execute command configuration.

", - "refs": { - "ClusterConfiguration$executeCommandConfiguration": "

The details of the execute command configuration.

" - } - }, - "ExecuteCommandLogConfiguration": { - "base": "

The log configuration for the results of the execute command actions. The logs can be sent to CloudWatch Logs or an Amazon S3 bucket.

", - "refs": { - "ExecuteCommandConfiguration$logConfiguration": "

The log configuration for the results of the execute command actions. The logs can be sent to CloudWatch Logs or an Amazon S3 bucket. When logging=OVERRIDE is specified, a logConfiguration must be provided.

" - } - }, - "ExecuteCommandLogging": { - "base": null, - "refs": { - "ExecuteCommandConfiguration$logging": "

The log setting to use for redirecting logs for your execute command results. The following log settings are available.

" - } - }, - "ExecuteCommandRequest": { - "base": null, - "refs": { - } - }, - "ExecuteCommandResponse": { - "base": null, - "refs": { - } - }, - "FSxWindowsFileServerAuthorizationConfig": { - "base": "

The authorization configuration details for Amazon FSx for Windows File Server file system. See FSxWindowsFileServerVolumeConfiguration in the Amazon ECS API Reference.

For more information and the input format, see Amazon FSx for Windows File Server Volumes in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "FSxWindowsFileServerVolumeConfiguration$authorizationConfig": "

The authorization configuration details for the Amazon FSx for Windows File Server file system.

" - } - }, - "FSxWindowsFileServerVolumeConfiguration": { - "base": "

This parameter is specified when you're using Amazon FSx for Windows File Server file system for task storage.

For more information and the input format, see Amazon FSx for Windows File Server volumes in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "Volume$fsxWindowsFileServerVolumeConfiguration": "

This parameter is specified when you use Amazon FSx for Windows File Server file system for task storage.

" - } - }, - "Failure": { - "base": "

A failed resource. For a list of common causes, see API failure reasons in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "Failures$member": null - } - }, - "Failures": { - "base": null, - "refs": { - "DeleteTaskDefinitionsResponse$failures": "

Any failures associated with the call.

", - "DescribeCapacityProvidersResponse$failures": "

Any failures associated with the call.

", - "DescribeClustersResponse$failures": "

Any failures associated with the call.

", - "DescribeContainerInstancesResponse$failures": "

Any failures associated with the call.

", - "DescribeServicesResponse$failures": "

Any failures associated with the call.

", - "DescribeTaskSetsResponse$failures": "

Any failures associated with the call.

", - "DescribeTasksResponse$failures": "

Any failures associated with the call.

", - "GetTaskProtectionResponse$failures": "

Any failures associated with the call.

", - "RunTaskResponse$failures": "

Any failures associated with the call.

", - "StartTaskResponse$failures": "

Any failures associated with the call.

", - "UpdateContainerInstancesStateResponse$failures": "

Any failures associated with the call.

", - "UpdateTaskProtectionResponse$failures": "

Any failures associated with the call.

" - } - }, - "FirelensConfiguration": { - "base": "

The FireLens configuration for the container. This is used to specify and configure a log router for container logs. For more information, see Custom log routing in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "ContainerDefinition$firelensConfiguration": "

The FireLens configuration for the container. This is used to specify and configure a log router for container logs. For more information, see Custom Log Routing in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "FirelensConfigurationOptionsMap": { - "base": null, - "refs": { - "FirelensConfiguration$options": "

The options to use when configuring the log router. This field is optional and can be used to specify a custom configuration file or to add additional metadata, such as the task, task definition, cluster, and container instance details to the log event. If specified, the syntax to use is \"options\":{\"enable-ecs-log-metadata\":\"true|false\",\"config-file-type:\"s3|file\",\"config-file-value\":\"arn:aws:s3:::mybucket/fluent.conf|filepath\"}. For more information, see Creating a task definition that uses a FireLens configuration in the Amazon Elastic Container Service Developer Guide.

Tasks hosted on Fargate only support the file configuration file type.

" - } - }, - "FirelensConfigurationType": { - "base": null, - "refs": { - "FirelensConfiguration$type": "

The log router to use. The valid values are fluentd or fluentbit.

" - } - }, - "GetDeploymentRequest": { - "base": null, - "refs": { - } - }, - "GetDeploymentResponse": { - "base": null, - "refs": { - } - }, - "GetTaskProtectionRequest": { - "base": null, - "refs": { - } - }, - "GetTaskProtectionResponse": { - "base": null, - "refs": { - } - }, - "GpuIds": { - "base": null, - "refs": { - "Container$gpuIds": "

The IDs of each GPU assigned to the container.

" - } - }, - "HealthCheck": { - "base": "

An object representing a container health check. Health check parameters that are specified in a container definition override any Docker health checks that exist in the container image (such as those specified in a parent image or from the image's Dockerfile). This configuration maps to the HEALTHCHECK parameter of docker run.

The Amazon ECS container agent only monitors and reports on the health checks specified in the task definition. Amazon ECS does not monitor Docker health checks that are embedded in a container image and not specified in the container definition. Health check parameters that are specified in a container definition override any Docker health checks that exist in the container image.

You can view the health status of both individual containers and a task with the DescribeTasks API operation or when viewing the task details in the console.

The health check is designed to make sure that your containers survive agent restarts, upgrades, or temporary unavailability.

The following describes the possible healthStatus values for a container:

The following describes the possible healthStatus values for a task. The container health check status of non-essential containers don't have an effect on the health status of a task.

If a task is run manually, and not as part of a service, the task will continue its lifecycle regardless of its health status. For tasks that are part of a service, if the task reports as unhealthy then the task will be stopped and the service scheduler will replace it.

The following are notes about container health check support:

", - "refs": { - "ContainerDefinition$healthCheck": "

The container health check command and associated configuration parameters for the container. This parameter maps to HealthCheck in the Create a container section of the Docker Remote API and the HEALTHCHECK parameter of docker run.

" - } - }, - "HealthStatus": { - "base": null, - "refs": { - "Container$healthStatus": "

The health status of the container. If health checks aren't configured for this container in its task definition, then it reports the health status as UNKNOWN.

", - "Task$healthStatus": "

The health status for the task. It's determined by the health of the essential containers in the task. If all essential containers in the task are reporting as HEALTHY, the task status also reports as HEALTHY. If any essential containers in the task are reporting as UNHEALTHY or UNKNOWN, the task status also reports as UNHEALTHY or UNKNOWN.

The Amazon ECS container agent doesn't monitor or report on Docker health checks that are embedded in a container image and not specified in the container definition. For example, this includes those specified in a parent image or from the image's Dockerfile. Health check parameters that are specified in a container definition override any Docker health checks that are found in the container image.

" - } - }, - "HostEntry": { - "base": "

Hostnames and IP address entries that are added to the /etc/hosts file of a container via the extraHosts parameter of its ContainerDefinition.

", - "refs": { - "HostEntryList$member": null - } - }, - "HostEntryList": { - "base": null, - "refs": { - "ContainerDefinition$extraHosts": "

A list of hostnames and IP address mappings to append to the /etc/hosts file on the container. This parameter maps to ExtraHosts in the Create a container section of the Docker Remote API and the --add-host option to docker run.

This parameter isn't supported for Windows containers or tasks that use the awsvpc network mode.

" - } - }, - "HostVolumeProperties": { - "base": "

Details on a container instance bind mount host volume.

", - "refs": { - "ServiceVolumeConfiguration$host": null, - "TaskVolumeConfiguration$host": null, - "Volume$host": "

This parameter is specified when you use bind mount host volumes. The contents of the host parameter determine whether your bind mount host volume persists on the host container instance and where it's stored. If the host parameter is empty, then the Docker daemon assigns a host path for your data volume. However, the data isn't guaranteed to persist after the containers that are associated with it stop running.

Windows containers can mount whole directories on the same drive as $env:ProgramData. Windows containers can't mount directories on a different drive, and mount point can't be across drives. For example, you can mount C:\\my\\path:C:\\my\\path and D:\\:D:\\, but not D:\\my\\path:C:\\my\\path or D:\\:C:\\my\\path.

" - } - }, - "IAMRoleArn": { - "base": null, - "refs": { - "ServiceManagedEBSVolumeConfiguration$roleArn": null, - "TaskManagedEBSVolumeConfiguration$roleArn": null - } - }, - "InferenceAccelerator": { - "base": "

Details on an Elastic Inference accelerator. For more information, see Working with Amazon Elastic Inference on Amazon ECS in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "InferenceAccelerators$member": null - } - }, - "InferenceAcceleratorOverride": { - "base": "

Details on an Elastic Inference accelerator task override. This parameter is used to override the Elastic Inference accelerator specified in the task definition. For more information, see Working with Amazon Elastic Inference on Amazon ECS in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "InferenceAcceleratorOverrides$member": null - } - }, - "InferenceAcceleratorOverrides": { - "base": null, - "refs": { - "TaskOverride$inferenceAcceleratorOverrides": "

The Elastic Inference accelerator override for the task.

" - } - }, - "InferenceAccelerators": { - "base": null, - "refs": { - "RegisterTaskDefinitionRequest$inferenceAccelerators": "

The Elastic Inference accelerators to use for the containers in the task.

", - "TaskDefinition$inferenceAccelerators": "

The Elastic Inference accelerator that's associated with the task.

" - } - }, - "InstanceHealthCheckResult": { - "base": "

An object representing the result of a container instance health status check.

", - "refs": { - "InstanceHealthCheckResultList$member": null - } - }, - "InstanceHealthCheckResultList": { - "base": null, - "refs": { - "ContainerInstanceHealthStatus$details": "

An array of objects representing the details of the container instance health status.

" - } - }, - "InstanceHealthCheckState": { - "base": null, - "refs": { - "ContainerInstanceHealthStatus$overallStatus": "

The overall health status of the container instance. This is an aggregate status of all container instance health checks.

", - "InstanceHealthCheckResult$status": "

The container instance health status.

" - } - }, - "InstanceHealthCheckType": { - "base": null, - "refs": { - "InstanceHealthCheckResult$type": "

The type of container instance health status that was verified.

" - } - }, - "Integer": { - "base": null, - "refs": { - "Cluster$registeredContainerInstancesCount": "

The number of container instances registered into the cluster. This includes container instances in both ACTIVE and DRAINING status.

", - "Cluster$runningTasksCount": "

The number of tasks in the cluster that are in the RUNNING state.

", - "Cluster$pendingTasksCount": "

The number of tasks in the cluster that are in the PENDING state.

", - "Cluster$activeServicesCount": "

The number of services that are running on the cluster in an ACTIVE state. You can view these services with ListServices.

", - "ContainerDefinition$cpu": "

The number of cpu units reserved for the container. This parameter maps to CpuShares in the Create a container section of the Docker Remote API and the --cpu-shares option to docker run.

This field is optional for tasks using the Fargate launch type, and the only requirement is that the total amount of CPU reserved for all containers within a task be lower than the task-level cpu value.

You can determine the number of CPU units that are available per EC2 instance type by multiplying the vCPUs listed for that instance type on the Amazon EC2 Instances detail page by 1,024.

Linux containers share unallocated CPU units with other containers on the container instance with the same ratio as their allocated amount. For example, if you run a single-container task on a single-core instance type with 512 CPU units specified for that container, and that's the only task running on the container instance, that container could use the full 1,024 CPU unit share at any given time. However, if you launched another copy of the same task on that container instance, each task is guaranteed a minimum of 512 CPU units when needed. Moreover, each container could float to higher CPU usage if the other container was not using it. If both tasks were 100% active all of the time, they would be limited to 512 CPU units.

On Linux container instances, the Docker daemon on the container instance uses the CPU value to calculate the relative CPU share ratios for running containers. For more information, see CPU share constraint in the Docker documentation. The minimum valid CPU share value that the Linux kernel allows is 2. However, the CPU parameter isn't required, and you can use CPU values below 2 in your container definitions. For CPU values below 2 (including null), the behavior varies based on your Amazon ECS container agent version:

On Windows container instances, the CPU limit is enforced as an absolute limit, or a quota. Windows containers only have access to the specified amount of CPU that's described in the task definition. A null or zero CPU value is passed to Docker as 0, which Windows interprets as 1% of one CPU.

", - "ContainerInstance$runningTasksCount": "

The number of tasks on the container instance that have a desired status (desiredStatus) of RUNNING.

", - "ContainerInstance$pendingTasksCount": "

The number of tasks on the container instance that are in the PENDING status.

", - "CreateClusterResponse$clusterCount": null, - "DeleteClusterResponse$clusterCount": null, - "Deployment$desiredCount": "

The most recent desired count of tasks that was specified for the service to deploy or maintain.

", - "Deployment$pendingCount": "

The number of tasks in the deployment that are in the PENDING status.

", - "Deployment$runningCount": "

The number of tasks in the deployment that are in the RUNNING status.

", - "Deployment$failedTasks": "

The number of consecutively failed tasks in the deployment. A task is considered a failure if the service scheduler can't launch the task, the task doesn't transition to a RUNNING state, or if it fails any of its defined health checks and is stopped.

Once a service deployment has one or more successfully running tasks, the failed task count resets to zero and stops being evaluated.

", - "Deployment$failedLaunchTaskCount": null, - "Deployment$replacedTaskCount": null, - "EphemeralStorage$sizeInGiB": "

The total amount, in GiB, of ephemeral storage to set for the task. The minimum supported value is 21 GiB and the maximum supported value is 200 GiB.

", - "ListAccountSettingsRequest$maxResults": "

The maximum number of account setting results returned by ListAccountSettings in paginated output. When this parameter is used, ListAccountSettings only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListAccountSettings request with the returned nextToken value. This value can be between 1 and 10. If this parameter isn't used, then ListAccountSettings returns up to 10 results and a nextToken value if applicable.

", - "Resource$integerValue": "

When the integerValue type is set, the value of the resource must be an integer.

", - "Service$desiredCount": "

The desired number of instantiations of the task definition to keep running on the service. This value is specified when the service is created with CreateService, and it can be modified with UpdateService.

", - "Service$runningCount": "

The number of tasks in the cluster that are in the RUNNING state.

", - "Service$pendingCount": "

The number of tasks in the cluster that are in the PENDING state.

", - "ServiceTaskEphemeralStorage$sizeInGiB": null, - "ServiceTaskInterfaceConfiguration$index": null, - "ServiceTaskInterfaceConfiguration$secondaryPrivateIpAddressCount": null, - "TaskDefinition$revision": "

The revision of the task in a particular family. The revision is a version number of a task definition in a family. When you register a task definition for the first time, the revision is 1. Each time that you register a new revision of a task definition in the same family, the revision value always increases by one. This is even if you deregistered previous revisions in this family.

", - "TaskSet$computedDesiredCount": "

The computed desired count for the task set. This is calculated by multiplying the service's desiredCount by the task set's scale percentage. The result is always rounded up. For example, if the computed desired count is 1.2, it rounds up to 2 tasks.

", - "TaskSet$pendingCount": "

The number of tasks in the task set that are in the PENDING status during a deployment. A task in the PENDING state is preparing to enter the RUNNING state. A task set enters the PENDING status when it launches for the first time or when it's restarted after being in the STOPPED state.

", - "TaskSet$runningCount": "

The number of tasks in the task set that are in the RUNNING status during a deployment. A task in the RUNNING state is running and ready for use.

", - "Tmpfs$size": "

The maximum size (in MiB) of the tmpfs volume.

", - "Ulimit$softLimit": "

The soft limit for the ulimit type.

", - "Ulimit$hardLimit": "

The hard limit for the ulimit type.

" - } - }, - "InterfaceOwner": { - "base": null, - "refs": { - "AwsVpcConfiguration$interfaceOwner": null - } - }, - "InvalidParameterException": { - "base": "

The specified parameter isn't valid. Review the available parameters for the API request.

", - "refs": { - } - }, - "IpcMode": { - "base": null, - "refs": { - "RegisterTaskDefinitionRequest$ipcMode": "

The IPC resource namespace to use for the containers in the task. The valid values are host, task, or none. If host is specified, then all containers within the tasks that specified the host IPC mode on the same container instance share the same IPC resources with the host Amazon EC2 instance. If task is specified, all containers within the specified task share the same IPC resources. If none is specified, then IPC resources within the containers of a task are private and not shared with other containers in a task or on the container instance. If no value is specified, then the IPC resource namespace sharing depends on the Docker daemon setting on the container instance. For more information, see IPC settings in the Docker run reference.

If the host IPC mode is used, be aware that there is a heightened risk of undesired IPC namespace expose. For more information, see Docker security.

If you are setting namespaced kernel parameters using systemControls for the containers in the task, the following will apply to your IPC resource namespace. For more information, see System Controls in the Amazon Elastic Container Service Developer Guide.

This parameter is not supported for Windows containers or tasks run on Fargate.

", - "TaskDefinition$ipcMode": "

The IPC resource namespace to use for the containers in the task. The valid values are host, task, or none. If host is specified, then all containers within the tasks that specified the host IPC mode on the same container instance share the same IPC resources with the host Amazon EC2 instance. If task is specified, all containers within the specified task share the same IPC resources. If none is specified, then IPC resources within the containers of a task are private and not shared with other containers in a task or on the container instance. If no value is specified, then the IPC resource namespace sharing depends on the Docker daemon setting on the container instance. For more information, see IPC settings in the Docker run reference.

If the host IPC mode is used, be aware that there is a heightened risk of undesired IPC namespace expose. For more information, see Docker security.

If you are setting namespaced kernel parameters using systemControls for the containers in the task, the following will apply to your IPC resource namespace. For more information, see System Controls in the Amazon Elastic Container Service Developer Guide.

This parameter is not supported for Windows containers or tasks run on Fargate.

" - } - }, - "KernelCapabilities": { - "base": "

The Linux capabilities for the container that are added to or dropped from the default configuration provided by Docker. For more information about the default capabilities and the non-default available capabilities, see Runtime privilege and Linux capabilities in the Docker run reference. For more detailed information about these Linux capabilities, see the capabilities(7) Linux manual page.

", - "refs": { - "LinuxParameters$capabilities": "

The Linux capabilities for the container that are added to or dropped from the default configuration provided by Docker.

For tasks that use the Fargate launch type, capabilities is supported for all platform versions but the add parameter is only supported if using platform version 1.4.0 or later.

" - } - }, - "KeyValuePair": { - "base": "

A key-value pair object.

", - "refs": { - "AttachmentDetails$member": null, - "EnvironmentVariables$member": null, - "Properties$member": null, - "ProxyConfigurationProperties$member": null, - "ServiceTaskAttachmentDetails$member": null, - "ServiceTaskEnvironmentVariables$member": null, - "Statistics$member": null - } - }, - "LaunchType": { - "base": null, - "refs": { - "CreateServiceRequest$launchType": "

The infrastructure that you run your service on. For more information, see Amazon ECS launch types in the Amazon Elastic Container Service Developer Guide.

The FARGATE launch type runs your tasks on Fargate On-Demand infrastructure.

Fargate Spot infrastructure is available for use but a capacity provider strategy must be used. For more information, see Fargate capacity providers in the Amazon ECS User Guide for Fargate.

The EC2 launch type runs your tasks on Amazon EC2 instances registered to your cluster.

The EXTERNAL launch type runs your tasks on your on-premises server or virtual machine (VM) capacity registered to your cluster.

A service can use either a launch type or a capacity provider strategy. If a launchType is specified, the capacityProviderStrategy parameter must be omitted.

", - "CreateTaskSetRequest$launchType": "

The launch type that new tasks in the task set uses. For more information, see Amazon ECS launch types in the Amazon Elastic Container Service Developer Guide.

If a launchType is specified, the capacityProviderStrategy parameter must be omitted.

", - "Deployment$launchType": "

The launch type the tasks in the service are using. For more information, see Amazon ECS Launch Types in the Amazon Elastic Container Service Developer Guide.

", - "ListServicesRequest$launchType": "

The launch type to use when filtering the ListServices results.

", - "ListTasksRequest$launchType": "

The launch type to use when filtering the ListTasks results.

", - "RunTaskRequest$launchType": "

The infrastructure to run your standalone task on. For more information, see Amazon ECS launch types in the Amazon Elastic Container Service Developer Guide.

The FARGATE launch type runs your tasks on Fargate On-Demand infrastructure.

Fargate Spot infrastructure is available for use but a capacity provider strategy must be used. For more information, see Fargate capacity providers in the Amazon ECS User Guide for Fargate.

The EC2 launch type runs your tasks on Amazon EC2 instances registered to your cluster.

The EXTERNAL launch type runs your tasks on your on-premises server or virtual machine (VM) capacity registered to your cluster.

A task can use either a launch type or a capacity provider strategy. If a launchType is specified, the capacityProviderStrategy parameter must be omitted.

When you use cluster auto scaling, you must specify capacityProviderStrategy and not launchType.

", - "Service$launchType": "

The launch type the service is using. When using the DescribeServices API, this field is omitted if the service was created using a capacity provider strategy.

", - "Task$launchType": "

The infrastructure where your task runs on. For more information, see Amazon ECS launch types in the Amazon Elastic Container Service Developer Guide.

", - "TaskSet$launchType": "

The launch type the tasks in the task set are using. For more information, see Amazon ECS launch types in the Amazon Elastic Container Service Developer Guide.

", - "UpdateServiceRequest$launchType": null - } - }, - "LifecycleHook": { - "base": null, - "refs": { - "LifecycleHooks$member": null, - "NotifyLifecycleHookCompleteResponse$lifecycleHook": null, - "UpdateLifecycleHookExpirationResponse$lifecycleHook": null - } - }, - "LifecycleHookAction": { - "base": null, - "refs": { - "LifecycleHookDefinition$defaultAction": null - } - }, - "LifecycleHookDefinition": { - "base": null, - "refs": { - "LifecycleHookDefinitions$member": null - } - }, - "LifecycleHookDefinitions": { - "base": null, - "refs": { - "RegisterTaskDefinitionRequest$lifecycleHooks": null, - "TaskDefinition$lifecycleHooks": null - } - }, - "LifecycleHookOutcome": { - "base": null, - "refs": { - "LifecycleHook$outcome": null, - "NotifyLifecycleHookCompleteRequest$outcome": null - } - }, - "LifecycleHookStage": { - "base": null, - "refs": { - "LifecycleHook$stage": null, - "LifecycleHookDefinition$stage": null - } - }, - "LifecycleHookStatus": { - "base": null, - "refs": { - "LifecycleHook$status": null - } - }, - "LifecycleHooks": { - "base": null, - "refs": { - "Task$lifecycleHooks": null - } - }, - "LimitExceededException": { - "base": "

The limit for the resource was exceeded.

", - "refs": { - } - }, - "LinuxParameters": { - "base": "

The Linux-specific options that are applied to the container, such as Linux KernelCapabilities.

", - "refs": { - "ContainerDefinition$linuxParameters": "

Linux-specific modifications that are applied to the container, such as Linux kernel capabilities. For more information see KernelCapabilities.

This parameter is not supported for Windows containers.

" - } - }, - "ListAccountSettingsRequest": { - "base": null, - "refs": { - } - }, - "ListAccountSettingsResponse": { - "base": null, - "refs": { - } - }, - "ListAttributesRequest": { - "base": null, - "refs": { - } - }, - "ListAttributesResponse": { - "base": null, - "refs": { - } - }, - "ListClustersRequest": { - "base": null, - "refs": { - } - }, - "ListClustersResponse": { - "base": null, - "refs": { - } - }, - "ListContainerInstancesRequest": { - "base": null, - "refs": { - } - }, - "ListContainerInstancesResponse": { - "base": null, - "refs": { - } - }, - "ListDeploymentsRequest": { - "base": null, - "refs": { - } - }, - "ListDeploymentsResponse": { - "base": null, - "refs": { - } - }, - "ListServicesByNamespaceRequest": { - "base": null, - "refs": { - } - }, - "ListServicesByNamespaceResponse": { - "base": null, - "refs": { - } - }, - "ListServicesRequest": { - "base": null, - "refs": { - } - }, - "ListServicesResponse": { - "base": null, - "refs": { - } - }, - "ListTagsForResourceRequest": { - "base": null, - "refs": { - } - }, - "ListTagsForResourceResponse": { - "base": null, - "refs": { - } - }, - "ListTaskDefinitionFamiliesRequest": { - "base": null, - "refs": { - } - }, - "ListTaskDefinitionFamiliesResponse": { - "base": null, - "refs": { - } - }, - "ListTaskDefinitionsRequest": { - "base": null, - "refs": { - } - }, - "ListTaskDefinitionsResponse": { - "base": null, - "refs": { - } - }, - "ListTasksRequest": { - "base": null, - "refs": { - } - }, - "ListTasksResponse": { - "base": null, - "refs": { - } - }, - "LoadBalancer": { - "base": "

The load balancer configuration to use with a service or task set.

When you add, update, or remove a load balancer configuration, Amazon ECS starts a new deployment with the updated Elastic Load Balancing configuration. This causes tasks to register to and deregister from load balancers.

We recommend that you verify this on a test environment before you update the Elastic Load Balancing configuration.

A service-linked role is required for services that use multiple target groups. For more information, see Using service-linked roles in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "LoadBalancerMapping$currentLoadBalancer": null, - "LoadBalancerMapping$newLoadBalancer": null, - "LoadBalancers$member": null - } - }, - "LoadBalancerConfiguration": { - "base": null, - "refs": { - "LoadBalancerConfigurations$member": null - } - }, - "LoadBalancerConfigurations": { - "base": null, - "refs": { - "BlueGreenConfiguration$loadBalancerConfigurations": null - } - }, - "LoadBalancerMapping": { - "base": null, - "refs": { - "LoadBalancerMappings$member": null - } - }, - "LoadBalancerMappings": { - "base": null, - "refs": { - "UpdateTaskSetRequest$loadBalancerMappings": null - } - }, - "LoadBalancers": { - "base": null, - "refs": { - "CreateServiceRequest$loadBalancers": "

A load balancer object representing the load balancers to use with your service. For more information, see Service load balancing in the Amazon Elastic Container Service Developer Guide.

If the service uses the rolling update (ECS) deployment controller and using either an Application Load Balancer or Network Load Balancer, you must specify one or more target group ARNs to attach to the service. The service-linked role is required for services that use multiple target groups. For more information, see Using service-linked roles for Amazon ECS in the Amazon Elastic Container Service Developer Guide.

If the service uses the CODE_DEPLOY deployment controller, the service is required to use either an Application Load Balancer or Network Load Balancer. When creating an CodeDeploy deployment group, you specify two target groups (referred to as a targetGroupPair). During a deployment, CodeDeploy determines which task set in your service has the status PRIMARY, and it associates one target group with it. Then, it also associates the other target group with the replacement task set. The load balancer can also have up to two listeners: a required listener for production traffic and an optional listener that you can use to perform validation tests with Lambda functions before routing production traffic to it.

If you use the CODE_DEPLOY deployment controller, these values can be changed when updating the service.

For Application Load Balancers and Network Load Balancers, this object must contain the load balancer target group ARN, the container name, and the container port to access from the load balancer. The container name must be as it appears in a container definition. The load balancer name parameter must be omitted. When a task from this service is placed on a container instance, the container instance and port combination is registered as a target in the target group that's specified here.

For Classic Load Balancers, this object must contain the load balancer name, the container name , and the container port to access from the load balancer. The container name must be as it appears in a container definition. The target group ARN parameter must be omitted. When a task from this service is placed on a container instance, the container instance is registered with the load balancer that's specified here.

Services with tasks that use the awsvpc network mode (for example, those with the Fargate launch type) only support Application Load Balancers and Network Load Balancers. Classic Load Balancers aren't supported. Also, when you create any target groups for these services, you must choose ip as the target type, not instance. This is because tasks that use the awsvpc network mode are associated with an elastic network interface, not an Amazon EC2 instance.

", - "CreateTaskSetRequest$loadBalancers": "

A load balancer object representing the load balancer to use with the task set. The supported load balancer types are either an Application Load Balancer or a Network Load Balancer.

", - "Service$loadBalancers": "

A list of Elastic Load Balancing load balancer objects. It contains the load balancer name, the container name, and the container port to access from the load balancer. The container name is as it appears in a container definition.

", - "TaskSet$loadBalancers": "

Details on a load balancer that are used with a task set.

", - "UpdateServiceRequest$loadBalancers": "

A list of Elastic Load Balancing load balancer objects. It contains the load balancer name, the container name, and the container port to access from the load balancer. The container name is as it appears in a container definition.

When you add, update, or remove a load balancer configuration, Amazon ECS starts new tasks with the updated Elastic Load Balancing configuration, and then stops the old tasks when the new tasks are running.

For services that use rolling updates, you can add, update, or remove Elastic Load Balancing target groups. You can update from a single target group to multiple target groups and from multiple target groups to a single target group.

For services that use blue/green deployments, you can update Elastic Load Balancing target groups by using CreateDeployment through CodeDeploy. Note that multiple target groups are not supported for blue/green deployments. For more information see Register multiple target groups with a service in the Amazon Elastic Container Service Developer Guide.

For services that use the external deployment controller, you can add, update, or remove load balancers by using CreateTaskSet. Note that multiple target groups are not supported for external deployments. For more information see Register multiple target groups with a service in the Amazon Elastic Container Service Developer Guide.

You can remove existing loadBalancers by passing an empty list.

" - } - }, - "LogConfiguration": { - "base": "

The log configuration for the container. This parameter maps to LogConfig in the Create a container section of the Docker Remote API and the --log-driver option to docker run .

By default, containers use the same logging driver that the Docker daemon uses. However, the container might use a different logging driver than the Docker daemon by specifying a log driver configuration in the container definition. For more information about the options for different supported log drivers, see Configure logging drivers in the Docker documentation.

Understand the following when specifying a log configuration for your containers.

", - "refs": { - "ContainerDefinition$logConfiguration": "

The log configuration specification for the container.

This parameter maps to LogConfig in the Create a container section of the Docker Remote API and the --log-driver option to docker run. By default, containers use the same logging driver that the Docker daemon uses. However the container can use a different logging driver than the Docker daemon by specifying a log driver with this parameter in the container definition. To use a different logging driver for a container, the log system must be configured properly on the container instance (or on a different log server for remote logging options). For more information about the options for different supported log drivers, see Configure logging drivers in the Docker documentation.

Amazon ECS currently supports a subset of the logging drivers available to the Docker daemon (shown in the LogConfiguration data type). Additional log drivers may be available in future releases of the Amazon ECS container agent.

This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

The Amazon ECS container agent running on a container instance must register the logging drivers available on that instance with the ECS_AVAILABLE_LOGGING_DRIVERS environment variable before containers placed on that instance can use these log configuration options. For more information, see Amazon ECS Container Agent Configuration in the Amazon Elastic Container Service Developer Guide.

", - "ServiceConnectConfiguration$logConfiguration": null - } - }, - "LogConfigurationOptionsMap": { - "base": null, - "refs": { - "LogConfiguration$options": "

The configuration options to send to the log driver. This parameter requires version 1.19 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

" - } - }, - "LogDriver": { - "base": null, - "refs": { - "LogConfiguration$logDriver": "

The log driver to use for the container.

For tasks on Fargate, the supported log drivers are awslogs, splunk, and awsfirelens.

For tasks hosted on Amazon EC2 instances, the supported log drivers are awslogs, fluentd, gelf, json-file, journald, logentries,syslog, splunk, and awsfirelens.

For more information about using the awslogs log driver, see Using the awslogs log driver in the Amazon Elastic Container Service Developer Guide.

For more information about using the awsfirelens log driver, see Custom log routing in the Amazon Elastic Container Service Developer Guide.

If you have a custom driver that isn't listed, you can fork the Amazon ECS container agent project that's available on GitHub and customize it to work with that driver. We encourage you to submit pull requests for changes that you would like to have included. However, we don't currently provide support for running modified copies of this software.

" - } - }, - "Long": { - "base": null, - "refs": { - "ContainerInstance$version": "

The version counter for the container instance. Every time a container instance experiences a change that triggers a CloudWatch event, the version counter is incremented. If you're replicating your Amazon ECS container instance state with CloudWatch Events, you can compare the version of a container instance reported by the Amazon ECS APIs with the version reported in CloudWatch Events for the container instance (inside the detail object) to verify that the version in your event stream is current.

", - "Resource$longValue": "

When the longValue type is set, the value of the resource must be an extended precision floating-point type.

", - "Service$version": null, - "ServiceTask$version": null, - "Task$version": "

The version counter for the task. Every time a task experiences a change that starts a CloudWatch event, the version counter is incremented. If you replicate your Amazon ECS task state with CloudWatch Events, you can compare the version of a task reported by the Amazon ECS API actions with the version reported in CloudWatch Events for the task (inside the detail object) to verify that the version in your event stream is current.

", - "UpdateLifecycleHookExpirationRequest$timeSeconds": null - } - }, - "ManagedAgent": { - "base": "

Details about the managed agent status for the container.

", - "refs": { - "ManagedAgents$member": null - } - }, - "ManagedAgentName": { - "base": null, - "refs": { - "ManagedAgent$name": "

The name of the managed agent. When the execute command feature is turned on, the managed agent name is ExecuteCommandAgent.

", - "ManagedAgentStateChange$managedAgentName": "

The name of the managed agent.

" - } - }, - "ManagedAgentStateChange": { - "base": "

An object representing a change in state for a managed agent.

", - "refs": { - "ManagedAgentStateChanges$member": null - } - }, - "ManagedAgentStateChanges": { - "base": null, - "refs": { - "SubmitTaskStateChangeRequest$managedAgents": "

The details for the managed agent that's associated with the task.

" - } - }, - "ManagedAgents": { - "base": null, - "refs": { - "Container$managedAgents": "

The details of any Amazon ECS managed agents associated with the container.

" - } - }, - "ManagedDraining": { - "base": null, - "refs": { - "AutoScalingGroupProvider$managedDraining": null, - "AutoScalingGroupProviderUpdate$managedDraining": null - } - }, - "ManagedScaling": { - "base": "

The managed scaling settings for the Auto Scaling group capacity provider.

When managed scaling is turned on, Amazon ECS manages the scale-in and scale-out actions of the Auto Scaling group. Amazon ECS manages a target tracking scaling policy using an Amazon ECS managed CloudWatch metric with the specified targetCapacity value as the target value for the metric. For more information, see Using managed scaling in the Amazon Elastic Container Service Developer Guide.

If managed scaling is off, the user must manage the scaling of the Auto Scaling group.

", - "refs": { - "AutoScalingGroupProvider$managedScaling": "

The managed scaling settings for the Auto Scaling group capacity provider.

", - "AutoScalingGroupProviderUpdate$managedScaling": "

The managed scaling settings for the Auto Scaling group capacity provider.

" - } - }, - "ManagedScalingInstanceWarmupPeriod": { - "base": null, - "refs": { - "ManagedScaling$instanceWarmupPeriod": "

The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of 300 seconds is used.

" - } - }, - "ManagedScalingScalingApproach": { - "base": null, - "refs": { - "ManagedScaling$scalingApproach": null - } - }, - "ManagedScalingStatus": { - "base": null, - "refs": { - "ManagedScaling$status": "

Determines whether to use managed scaling for the capacity provider.

" - } - }, - "ManagedScalingStepSize": { - "base": null, - "refs": { - "ManagedScaling$minimumScalingStepSize": "

The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of 1 is used.

When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.

If you use a capacity provider with an Auto Scaling group configured with more than one Amazon EC2 instance type or Availability Zone, Amazon ECS will scale up by the exact minimum scaling step size value and will ignore both the maximum scaling step size as well as the capacity demand.

", - "ManagedScaling$maximumScalingStepSize": "

The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter. If this parameter is omitted, the default value of 10000 is used.

" - } - }, - "ManagedScalingTargetCapacity": { - "base": null, - "refs": { - "ManagedScaling$targetCapacity": "

The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than 0 and less than or equal to 100. For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use a targetCapacity of 90. The default value of 100 percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.

" - } - }, - "ManagedTerminationProtection": { - "base": null, - "refs": { - "AutoScalingGroupProvider$managedTerminationProtection": "

The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.

When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.

When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the Auto Scaling User Guide.

When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.

", - "AutoScalingGroupProviderUpdate$managedTerminationProtection": "

The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection.

When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.

When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on. For more information, see Instance Protection in the Auto Scaling User Guide.

When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.

" - } - }, - "MissingVersionException": { - "base": "

Amazon ECS can't determine the current version of the Amazon ECS container agent on the container instance and doesn't have enough information to proceed with an update. This could be because the agent running on the container instance is a previous or custom version that doesn't use our version information.

", - "refs": { - } - }, - "MountPoint": { - "base": "

The details for a volume mount point that's used in a container definition.

", - "refs": { - "MountPointList$member": null - } - }, - "MountPointList": { - "base": null, - "refs": { - "ContainerDefinition$mountPoints": "

The mount points for data volumes in your container.

This parameter maps to Volumes in the Create a container section of the Docker Remote API and the --volume option to docker run.

Windows containers can mount whole directories on the same drive as $env:ProgramData. Windows containers can't mount directories on a different drive, and mount point can't be across drives.

" - } - }, - "NamespaceNotFoundException": { - "base": "

The specified namespace wasn't found.

", - "refs": { - } - }, - "NetworkBinding": { - "base": "

Details on the network bindings between a container and its host container instance. After a task reaches the RUNNING status, manual and automatic host and container port assignments are visible in the networkBindings section of DescribeTasks API responses.

", - "refs": { - "NetworkBindings$member": null - } - }, - "NetworkBindings": { - "base": null, - "refs": { - "Container$networkBindings": "

The network bindings associated with the container.

", - "ContainerStateChange$networkBindings": "

Any network bindings that are associated with the container.

", - "SubmitContainerStateChangeRequest$networkBindings": "

The network bindings of the container.

" - } - }, - "NetworkConfiguration": { - "base": "

The network configuration for a task or service.

", - "refs": { - "ClusterDefaults$awsvpcNetworkConfiguration": null, - "CreateClusterRequest$defaultNetworkConfiguration": null, - "CreateServiceRequest$networkConfiguration": "

The network configuration for the service. This parameter is required for task definitions that use the awsvpc network mode to receive their own elastic network interface, and it isn't supported for other network modes. For more information, see Task networking in the Amazon Elastic Container Service Developer Guide.

", - "CreateTaskSetRequest$networkConfiguration": "

An object representing the network configuration for a task set.

", - "Deployment$networkConfiguration": "

The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.

", - "RunTaskRequest$networkConfiguration": "

The network configuration for the task. This parameter is required for task definitions that use the awsvpc network mode to receive their own elastic network interface, and it isn't supported for other network modes. For more information, see Task networking in the Amazon Elastic Container Service Developer Guide.

", - "Service$networkConfiguration": "

The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.

", - "StartTaskRequest$networkConfiguration": "

The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.

", - "TaskSet$networkConfiguration": "

The network configuration for the task set.

", - "UpdateClusterRequest$defaultNetworkConfiguration": null, - "UpdateServiceRequest$networkConfiguration": "

An object representing the network configuration for the service.

" - } - }, - "NetworkInterface": { - "base": "

An object representing the elastic network interface for tasks that use the awsvpc network mode.

", - "refs": { - "NetworkInterfaces$member": null - } - }, - "NetworkInterfaces": { - "base": null, - "refs": { - "Container$networkInterfaces": "

The network interfaces associated with the container.

" - } - }, - "NetworkMode": { - "base": null, - "refs": { - "RegisterTaskDefinitionRequest$networkMode": "

The Docker networking mode to use for the containers in the task. The valid values are none, bridge, awsvpc, and host. If no network mode is specified, the default is bridge.

For Amazon ECS tasks on Fargate, the awsvpc network mode is required. For Amazon ECS tasks on Amazon EC2 Linux instances, any network mode can be used. For Amazon ECS tasks on Amazon EC2 Windows instances, <default> or awsvpc can be used. If the network mode is set to none, you cannot specify port mappings in your container definitions, and the tasks containers do not have external connectivity. The host and awsvpc network modes offer the highest networking performance for containers because they use the EC2 network stack instead of the virtualized network stack provided by the bridge mode.

With the host and awsvpc network modes, exposed container ports are mapped directly to the corresponding host port (for the host network mode) or the attached elastic network interface port (for the awsvpc network mode), so you cannot take advantage of dynamic host port mappings.

When using the host network mode, you should not run containers using the root user (UID 0). It is considered best practice to use a non-root user.

If the network mode is awsvpc, the task is allocated an elastic network interface, and you must specify a NetworkConfiguration value when you create a service or run a task with the task definition. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.

If the network mode is host, you cannot run multiple instantiations of the same task on a single container instance when port mappings are used.

For more information, see Network settings in the Docker run reference.

", - "TaskDefinition$networkMode": "

The Docker networking mode to use for the containers in the task. The valid values are none, bridge, awsvpc, and host. If no network mode is specified, the default is bridge.

For Amazon ECS tasks on Fargate, the awsvpc network mode is required. For Amazon ECS tasks on Amazon EC2 Linux instances, any network mode can be used. For Amazon ECS tasks on Amazon EC2 Windows instances, <default> or awsvpc can be used. If the network mode is set to none, you cannot specify port mappings in your container definitions, and the tasks containers do not have external connectivity. The host and awsvpc network modes offer the highest networking performance for containers because they use the EC2 network stack instead of the virtualized network stack provided by the bridge mode.

With the host and awsvpc network modes, exposed container ports are mapped directly to the corresponding host port (for the host network mode) or the attached elastic network interface port (for the awsvpc network mode), so you cannot take advantage of dynamic host port mappings.

When using the host network mode, you should not run containers using the root user (UID 0). It is considered best practice to use a non-root user.

If the network mode is awsvpc, the task is allocated an elastic network interface, and you must specify a NetworkConfiguration value when you create a service or run a task with the task definition. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.

If the network mode is host, you cannot run multiple instantiations of the same task on a single container instance when port mappings are used.

For more information, see Network settings in the Docker run reference.

" - } - }, - "NoUpdateAvailableException": { - "base": "

There's no update available for this Amazon ECS container agent. This might be because the agent is already running the latest version or because it's so old that there's no update path to the current version.

", - "refs": { - } - }, - "NotifyLifecycleHookCompleteRequest": { - "base": null, - "refs": { - } - }, - "NotifyLifecycleHookCompleteResponse": { - "base": null, - "refs": { - } - }, - "OSFamily": { - "base": null, - "refs": { - "RuntimePlatform$operatingSystemFamily": "

The operating system.

" - } - }, - "PidMode": { - "base": null, - "refs": { - "RegisterTaskDefinitionRequest$pidMode": "

The process namespace to use for the containers in the task. The valid values are host or task. On Fargate for Linux containers, the only valid value is task. For example, monitoring sidecars might need pidMode to access information about other containers running in the same task.

If host is specified, all containers within the tasks that specified the host PID mode on the same container instance share the same process namespace with the host Amazon EC2 instance.

If task is specified, all containers within the specified task share the same process namespace.

If no value is specified, the default is a private namespace for each container. For more information, see PID settings in the Docker run reference.

If the host PID mode is used, there's a heightened risk of undesired process namespace exposure. For more information, see Docker security.

This parameter is not supported for Windows containers.

This parameter is only supported for tasks that are hosted on Fargate if the tasks are using platform version 1.4.0 or later (Linux). This isn't supported for Windows containers on Fargate.

", - "TaskDefinition$pidMode": "

The process namespace to use for the containers in the task. The valid values are host or task. On Fargate for Linux containers, the only valid value is task. For example, monitoring sidecars might need pidMode to access information about other containers running in the same task.

If host is specified, all containers within the tasks that specified the host PID mode on the same container instance share the same process namespace with the host Amazon EC2 instance.

If task is specified, all containers within the specified task share the same process namespace.

If no value is specified, the default is a private namespace for each container. For more information, see PID settings in the Docker run reference.

If the host PID mode is used, there's a heightened risk of undesired process namespace exposure. For more information, see Docker security.

This parameter is not supported for Windows containers.

This parameter is only supported for tasks that are hosted on Fargate if the tasks are using platform version 1.4.0 or later (Linux). This isn't supported for Windows containers on Fargate.

" - } - }, - "PlacementConstraint": { - "base": "

An object representing a constraint on task placement. For more information, see Task placement constraints in the Amazon Elastic Container Service Developer Guide.

If you're using the Fargate launch type, task placement constraints aren't supported.

", - "refs": { - "PlacementConstraints$member": null - } - }, - "PlacementConstraintType": { - "base": null, - "refs": { - "PlacementConstraint$type": "

The type of constraint. Use distinctInstance to ensure that each task in a particular group is running on a different container instance. Use memberOf to restrict the selection to a group of valid candidates.

" - } - }, - "PlacementConstraints": { - "base": null, - "refs": { - "CreateServiceRequest$placementConstraints": "

An array of placement constraint objects to use for tasks in your service. You can specify a maximum of 10 constraints for each task. This limit includes constraints in the task definition and those specified at runtime.

", - "RunTaskRequest$placementConstraints": "

An array of placement constraint objects to use for the task. You can specify up to 10 constraints for each task (including constraints in the task definition and those specified at runtime).

", - "Service$placementConstraints": "

The placement constraints for the tasks in the service.

", - "UpdateServiceRequest$placementConstraints": "

An array of task placement constraint objects to update the service to use. If no value is specified, the existing placement constraints for the service will remain unchanged. If this value is specified, it will override any existing placement constraints defined for the service. To remove all existing placement constraints, specify an empty array.

You can specify a maximum of 10 constraints for each task. This limit includes constraints in the task definition and those specified at runtime.

" - } - }, - "PlacementStrategies": { - "base": null, - "refs": { - "CreateServiceRequest$placementStrategy": "

The placement strategy objects to use for tasks in your service. You can specify a maximum of 5 strategy rules for each service.

", - "RunTaskRequest$placementStrategy": "

The placement strategy objects to use for the task. You can specify a maximum of 5 strategy rules for each task.

", - "Service$placementStrategy": "

The placement strategy that determines how tasks for the service are placed.

", - "UpdateServiceRequest$placementStrategy": "

The task placement strategy objects to update the service to use. If no value is specified, the existing placement strategy for the service will remain unchanged. If this value is specified, it will override the existing placement strategy defined for the service. To remove an existing placement strategy, specify an empty object.

You can specify a maximum of five strategy rules for each service.

" - } - }, - "PlacementStrategy": { - "base": "

The task placement strategy for a task or service. For more information, see Task placement strategies in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "PlacementStrategies$member": null - } - }, - "PlacementStrategyType": { - "base": null, - "refs": { - "PlacementStrategy$type": "

The type of placement strategy. The random placement strategy randomly places tasks on available candidates. The spread placement strategy spreads placement across available candidates evenly based on the field parameter. The binpack strategy places tasks on available candidates that have the least available amount of the resource that's specified with the field parameter. For example, if you binpack on memory, a task is placed on the instance with the least amount of remaining memory but still enough to run the task.

" - } - }, - "PlatformDevice": { - "base": "

The devices that are available on the container instance. The only supported device type is a GPU.

", - "refs": { - "PlatformDevices$member": null - } - }, - "PlatformDeviceType": { - "base": null, - "refs": { - "PlatformDevice$type": "

The type of device that's available on the container instance. The only supported value is GPU.

" - } - }, - "PlatformDevices": { - "base": null, - "refs": { - "RegisterContainerInstanceRequest$platformDevices": "

The devices that are available on the container instance. The only supported device type is a GPU.

" - } - }, - "PlatformTaskDefinitionIncompatibilityException": { - "base": "

The specified platform version doesn't satisfy the required capabilities of the task definition.

", - "refs": { - } - }, - "PlatformUnknownException": { - "base": "

The specified platform version doesn't exist.

", - "refs": { - } - }, - "PortMapping": { - "base": "

Port mappings allow containers to access ports on the host container instance to send or receive traffic. Port mappings are specified as part of the container definition.

If you use containers in a task with the awsvpc or host network mode, specify the exposed ports using containerPort. The hostPort can be left blank or it must be the same value as the containerPort.

Most fields of this parameter (containerPort, hostPort, protocol) maps to PortBindings in the Create a container section of the Docker Remote API and the --publish option to docker run . If the network mode of a task definition is set to host, host ports must either be undefined or match the container port in the port mapping.

You can't expose the same container port for multiple protocols. If you attempt this, an error is returned.

After a task reaches the RUNNING status, manual and automatic host and container port assignments are visible in the networkBindings section of DescribeTasks API responses.

", - "refs": { - "PortMappingList$member": null - } - }, - "PortMappingList": { - "base": null, - "refs": { - "ContainerDefinition$portMappings": "

The list of port mappings for the container. Port mappings allow containers to access ports on the host container instance to send or receive traffic.

For task definitions that use the awsvpc network mode, only specify the containerPort. The hostPort can be left blank or it must be the same value as the containerPort.

Port mappings on Windows use the NetNAT gateway address rather than localhost. There's no loopback for port mappings on Windows, so you can't access a container's mapped port from the host itself.

This parameter maps to PortBindings in the Create a container section of the Docker Remote API and the --publish option to docker run. If the network mode of a task definition is set to none, then you can't specify port mappings. If the network mode of a task definition is set to host, then host ports must either be undefined or they must match the container port in the port mapping.

After a task reaches the RUNNING status, manual and automatic host and container port assignments are visible in the Network Bindings section of a container description for a selected task in the Amazon ECS console. The assignments are also visible in the networkBindings section DescribeTasks responses.

" - } - }, - "PortNumber": { - "base": null, - "refs": { - "ServiceConnectClientAlias$port": "

The listening port number for the Service Connect proxy. This port is available inside of all of the tasks within the same namespace.

To avoid changing your applications in client Amazon ECS services, set this to the same port that the client application uses by default. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "ServiceConnectService$ingressPortOverride": "

The port number for the Service Connect proxy to listen on.

Use the value of this field to bypass the proxy for traffic on the port number specified in the named portMapping in the task definition of this application, and then use it in your VPC security groups to allow traffic into the proxy for this Amazon ECS service.

In awsvpc mode and Fargate, the default value is the container port number. The container port number is in the portMapping in the task definition. In bridge mode, the default value is the ephemeral port of the Service Connect proxy.

" - } - }, - "PropagateTags": { - "base": null, - "refs": { - "CreateServiceRequest$propagateTags": "

Specifies whether to propagate the tags from the task definition to the task. If no value is specified, the tags aren't propagated. Tags can only be propagated to the task during task creation. To add tags to a task after task creation, use the TagResource API action.

The default is NONE.

", - "EBSTagSpecification$propagateTags": null, - "RunTaskRequest$propagateTags": "

Specifies whether to propagate the tags from the task definition to the task. If no value is specified, the tags aren't propagated. Tags can only be propagated to the task during task creation. To add tags to a task after task creation, use the TagResource API action.

An error will be received if you specify the SERVICE option when running a task.

", - "Service$propagateTags": "

Determines whether to propagate the tags from the task definition or the service to the task. If no value is specified, the tags aren't propagated.

", - "StartTaskRequest$propagateTags": "

Specifies whether to propagate the tags from the task definition or the service to the task. If no value is specified, the tags aren't propagated.

", - "UpdateServiceRequest$propagateTags": "

Determines whether to propagate the tags from the task definition or the service to the task. If no value is specified, the tags aren't propagated.

Only tasks launched after the update will reflect the update. To update the tags on all tasks, set forceNewDeployment to true, so that Amazon ECS starts new tasks with the updated tags.

" - } - }, - "Properties": { - "base": null, - "refs": { - "StartTaskRequest$properties": null - } - }, - "ProtectedTask": { - "base": "

An object representing the protection status details for a task. You can set the protection status with the UpdateTaskProtection API and get the status of tasks with the GetTaskProtection API.

", - "refs": { - "ProtectedTasks$member": null - } - }, - "ProtectedTasks": { - "base": null, - "refs": { - "GetTaskProtectionResponse$protectedTasks": "

A list of tasks with the following information.

", - "UpdateTaskProtectionResponse$protectedTasks": "

A list of tasks with the following information.

" - } - }, - "ProxyConfiguration": { - "base": "

The configuration details for the App Mesh proxy.

For tasks that use the EC2 launch type, the container instances require at least version 1.26.0 of the container agent and at least version 1.26.0-1 of the ecs-init package to use a proxy configuration. If your container instances are launched from the Amazon ECS optimized AMI version 20190301 or later, then they contain the required versions of the container agent and ecs-init. For more information, see Amazon ECS-optimized Linux AMI

", - "refs": { - "RegisterTaskDefinitionRequest$proxyConfiguration": "

The configuration details for the App Mesh proxy.

For tasks hosted on Amazon EC2 instances, the container instances require at least version 1.26.0 of the container agent and at least version 1.26.0-1 of the ecs-init package to use a proxy configuration. If your container instances are launched from the Amazon ECS-optimized AMI version 20190301 or later, then they contain the required versions of the container agent and ecs-init. For more information, see Amazon ECS-optimized AMI versions in the Amazon Elastic Container Service Developer Guide.

", - "TaskDefinition$proxyConfiguration": "

The configuration details for the App Mesh proxy.

Your Amazon ECS container instances require at least version 1.26.0 of the container agent and at least version 1.26.0-1 of the ecs-init package to use a proxy configuration. If your container instances are launched from the Amazon ECS optimized AMI version 20190301 or later, they contain the required versions of the container agent and ecs-init. For more information, see Amazon ECS-optimized Linux AMI in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "ProxyConfigurationProperties": { - "base": null, - "refs": { - "ProxyConfiguration$properties": "

The set of network configuration parameters to provide the Container Network Interface (CNI) plugin, specified as key-value pairs.

" - } - }, - "ProxyConfigurationType": { - "base": null, - "refs": { - "ProxyConfiguration$type": "

The proxy type. The only supported value is APPMESH.

" - } - }, - "PutAccountSettingDefaultRequest": { - "base": null, - "refs": { - } - }, - "PutAccountSettingDefaultResponse": { - "base": null, - "refs": { - } - }, - "PutAccountSettingRequest": { - "base": null, - "refs": { - } - }, - "PutAccountSettingResponse": { - "base": null, - "refs": { - } - }, - "PutAttributesRequest": { - "base": null, - "refs": { - } - }, - "PutAttributesResponse": { - "base": null, - "refs": { - } - }, - "PutClusterCapacityProvidersRequest": { - "base": null, - "refs": { - } - }, - "PutClusterCapacityProvidersResponse": { - "base": null, - "refs": { - } - }, - "RegisterContainerInstanceRequest": { - "base": null, - "refs": { - } - }, - "RegisterContainerInstanceResponse": { - "base": null, - "refs": { - } - }, - "RegisterTaskDefinitionRequest": { - "base": null, - "refs": { - } - }, - "RegisterTaskDefinitionResponse": { - "base": null, - "refs": { - } - }, - "RepositoryCredentials": { - "base": "

The repository credentials for private registry authentication.

", - "refs": { - "ContainerDefinition$repositoryCredentials": "

The private repository authentication credentials to use.

" - } - }, - "RequiresAttributes": { - "base": null, - "refs": { - "TaskDefinition$requiresAttributes": "

The container instance attributes required by your task. When an Amazon EC2 instance is registered to your cluster, the Amazon ECS container agent assigns some standard attributes to the instance. You can apply custom attributes. These are specified as key-value pairs using the Amazon ECS console or the PutAttributes API. These attributes are used when determining task placement for tasks hosted on Amazon EC2 instances. For more information, see Attributes in the Amazon Elastic Container Service Developer Guide.

This parameter isn't supported for tasks run on Fargate.

" - } - }, - "Resource": { - "base": "

Describes the resources available for a container instance.

", - "refs": { - "Resources$member": null - } - }, - "ResourceIds": { - "base": null, - "refs": { - "ConflictException$resourceIds": null - } - }, - "ResourceInUseException": { - "base": "

The specified resource is in-use and can't be removed.

", - "refs": { - } - }, - "ResourceNotFoundException": { - "base": "

The specified resource wasn't found.

", - "refs": { - } - }, - "ResourceRequirement": { - "base": "

The type and amount of a resource to assign to a container. The supported resource types are GPUs and Elastic Inference accelerators. For more information, see Working with GPUs on Amazon ECS or Working with Amazon Elastic Inference on Amazon ECS in the Amazon Elastic Container Service Developer Guide

", - "refs": { - "ResourceRequirements$member": null - } - }, - "ResourceRequirements": { - "base": null, - "refs": { - "ContainerDefinition$resourceRequirements": "

The type and amount of a resource to assign to a container. The only supported resource is a GPU.

", - "ContainerOverride$resourceRequirements": "

The type and amount of a resource to assign to a container, instead of the default value from the task definition. The only supported resource is a GPU.

" - } - }, - "ResourceType": { - "base": null, - "refs": { - "ResourceRequirement$type": "

The type of resource to assign to a container. The supported values are GPU or InferenceAccelerator.

" - } - }, - "Resources": { - "base": null, - "refs": { - "ContainerInstance$remainingResources": "

For CPU and memory resource types, this parameter describes the remaining CPU and memory that wasn't already allocated to tasks and is therefore available for new tasks. For port resource types, this parameter describes the ports that were reserved by the Amazon ECS container agent (at instance registration time) and any task containers that have reserved port mappings on the host (with the host or bridge network mode). Any port that's not specified here is available for new tasks.

", - "ContainerInstance$registeredResources": "

For CPU and memory resource types, this parameter describes the amount of each resource that was available on the container instance when the container agent registered it with Amazon ECS. This value represents the total amount of CPU and memory that can be allocated on this container instance to tasks. For port resource types, this parameter describes the ports that were reserved by the Amazon ECS container agent when it registered the container instance with Amazon ECS.

", - "RegisterContainerInstanceRequest$totalResources": "

The resources available on the instance.

" - } - }, - "RestartPolicy": { - "base": null, - "refs": { - "ContainerDefinition$restartPolicy": null - } - }, - "RunServiceTaskRequest": { - "base": null, - "refs": { - } - }, - "RunServiceTaskResponse": { - "base": null, - "refs": { - } - }, - "RunTaskRequest": { - "base": null, - "refs": { - } - }, - "RunTaskResponse": { - "base": null, - "refs": { - } - }, - "RuntimePlatform": { - "base": "

Information about the platform for the Amazon ECS service or task.

For more information about RuntimePlatform, see RuntimePlatform in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "RegisterTaskDefinitionRequest$runtimePlatform": "

The operating system that your tasks definitions run on. A platform family is specified only for tasks using the Fargate launch type.

When you specify a task definition in a service, this value must match the runtimePlatform value of the service.

", - "TaskDefinition$runtimePlatform": "

The operating system that your task definitions are running on. A platform family is specified only for tasks using the Fargate launch type.

When you specify a task in a service, this value must match the runtimePlatform value of the service.

" - } - }, - "Scale": { - "base": "

A floating-point percentage of the desired number of tasks to place and keep running in the task set.

", - "refs": { - "CreateTaskSetRequest$scale": "

A floating-point percentage of the desired number of tasks to place and keep running in the task set.

", - "TaskSet$scale": "

A floating-point percentage of your desired number of tasks to place and keep running in the task set.

", - "UpdateTaskSetRequest$scale": "

A floating-point percentage of the desired number of tasks to place and keep running in the task set.

" - } - }, - "ScaleUnit": { - "base": null, - "refs": { - "Scale$unit": "

The unit of measure for the scale value.

" - } - }, - "SchedulingStrategy": { - "base": null, - "refs": { - "CreateServiceRequest$schedulingStrategy": "

The scheduling strategy to use for the service. For more information, see Services.

There are two service scheduler strategies available:

", - "ListServicesRequest$schedulingStrategy": "

The scheduling strategy to use when filtering the ListServices results.

", - "Service$schedulingStrategy": "

The scheduling strategy to use for the service. For more information, see Services.

There are two service scheduler strategies available.

" - } - }, - "Scope": { - "base": null, - "refs": { - "DockerVolumeConfiguration$scope": "

The scope for the Docker volume that determines its lifecycle. Docker volumes that are scoped to a task are automatically provisioned when the task starts and destroyed when the task stops. Docker volumes that are scoped as shared persist after the task stops.

" - } - }, - "Secret": { - "base": "

An object representing the secret to expose to your container. Secrets can be exposed to a container in the following ways:

For more information, see Specifying sensitive data in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "SecretList$member": null - } - }, - "SecretList": { - "base": null, - "refs": { - "ContainerDefinition$secrets": "

The secrets to pass to the container. For more information, see Specifying Sensitive Data in the Amazon Elastic Container Service Developer Guide.

", - "LogConfiguration$secretOptions": "

The secrets to pass to the log configuration. For more information, see Specifying sensitive data in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "SensitiveString": { - "base": null, - "refs": { - "AccountDetail$credentialToken": null, - "RegisterTaskDefinitionRequest$taskRoleCredentialToken": null, - "RegisterTaskDefinitionRequest$executionRoleCredentialToken": null, - "ServiceTaskAccountDetail$credentialToken": null, - "ServiceTaskOverride$executionRoleCredentialToken": null, - "ServiceTaskOverride$taskRoleCredentialToken": null, - "Session$tokenValue": "

An encrypted token value containing session and caller information. It's used to authenticate the connection to the container.

", - "TaskDefinition$taskRoleCredentialToken": null, - "TaskDefinition$executionRoleCredentialToken": null, - "TaskOverride$executionRoleCredentialToken": null, - "TaskOverride$taskRoleCredentialToken": null - } - }, - "ServerException": { - "base": "

These errors are usually caused by a server issue.

", - "refs": { - } - }, - "Service": { - "base": "

Details on a service within a cluster.

", - "refs": { - "CreateServiceResponse$service": "

The full description of your service following the create call.

A service will return either a capacityProviderStrategy or launchType parameter, but not both, depending where one was specified when it was created.

If a service is using the ECS deployment controller, the deploymentController and taskSets parameters will not be returned.

if the service uses the CODE_DEPLOY deployment controller, the deploymentController, taskSets and deployments parameters will be returned, however the deployments parameter will be an empty list.

", - "DeleteServiceResponse$service": "

The full description of the deleted service.

", - "Services$member": null, - "UpdateServiceResponse$service": "

The full description of your service following the update call.

" - } - }, - "ServiceConnectClientAlias": { - "base": "

Each alias (\"endpoint\") is a fully-qualified name and port number that other tasks (\"clients\") can use to connect to this service.

Each name and port mapping must be unique within the namespace.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "ServiceConnectClientAliasList$member": null - } - }, - "ServiceConnectClientAliasList": { - "base": null, - "refs": { - "ServiceConnectService$clientAliases": "

The list of client aliases for this Service Connect service. You use these to assign names that can be used by client applications. The maximum number of client aliases that you can have in this list is 1.

Each alias (\"endpoint\") is a fully-qualified name and port number that other Amazon ECS tasks (\"clients\") can use to connect to this service.

Each name and port mapping must be unique within the namespace.

For each ServiceConnectService, you must provide at least one clientAlias with one port.

" - } - }, - "ServiceConnectConfiguration": { - "base": "

The Service Connect configuration of your Amazon ECS service. The configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "CreateServiceRequest$serviceConnectConfiguration": "

The configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "CreateTaskSetRequest$serviceConnectConfiguration": null, - "Deployment$serviceConnectConfiguration": "

The details of the Service Connect configuration that's used by this deployment. Compare the configuration between multiple deployments when troubleshooting issues with new deployments.

The configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "UpdateServiceRequest$serviceConnectConfiguration": "

The configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

" - } - }, - "ServiceConnectService": { - "base": "

The Service Connect service object configuration. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - "ServiceConnectServiceList$member": null - } - }, - "ServiceConnectServiceList": { - "base": null, - "refs": { - "ServiceConnectConfiguration$services": "

The list of Service Connect service objects. These are names and aliases (also known as endpoints) that are used by other Amazon ECS services to connect to this service.

This field is not required for a \"client\" Amazon ECS service that's a member of a namespace only to connect to other services within the namespace. An example of this would be a frontend application that accepts incoming requests from either a load balancer that's attached to the service or by other means.

An object selects a port from the task definition, assigns a name for the Cloud Map service, and a list of aliases (endpoints) and ports for client applications to refer to this service.

" - } - }, - "ServiceConnectServiceResource": { - "base": "

The Service Connect resource. Each configuration maps a discovery name to a Cloud Map service name. The data is stored in Cloud Map as part of the Service Connect configuration for each discovery name of this Amazon ECS service.

A task can resolve the dnsName for each of the clientAliases of a service. However a task can't resolve the discovery names. If you want to connect to a service, refer to the ServiceConnectConfiguration of that service for the list of clientAliases that you can use.

", - "refs": { - "ServiceConnectServiceResourceList$member": null - } - }, - "ServiceConnectServiceResourceList": { - "base": null, - "refs": { - "Deployment$serviceConnectResources": "

The list of Service Connect resources that are associated with this deployment. Each list entry maps a discovery name to a Cloud Map service name.

" - } - }, - "ServiceConnectTaskConfiguration": { - "base": null, - "refs": { - "RunTaskRequest$serviceConnectConfiguration": null, - "StartTaskRequest$serviceConnectConfiguration": null, - "Task$serviceConnectConfiguration": null - } - }, - "ServiceConnectTlsCertificateAuthority": { - "base": null, - "refs": { - "ServiceConnectTlsConfiguration$issuerCertificateAuthority": null - } - }, - "ServiceConnectTlsConfiguration": { - "base": null, - "refs": { - "ServiceConnectService$tls": null - } - }, - "ServiceEvent": { - "base": "

The details for an event that's associated with a service.

", - "refs": { - "ServiceEvents$member": null - } - }, - "ServiceEvents": { - "base": null, - "refs": { - "Service$events": "

The event stream for your service. A maximum of 100 of the latest events are displayed.

" - } - }, - "ServiceField": { - "base": null, - "refs": { - "ServiceFieldList$member": null - } - }, - "ServiceFieldList": { - "base": null, - "refs": { - "DescribeServicesRequest$include": "

Determines whether you want to see the resource tags for the service. If TAGS is specified, the tags are included in the response. If this field is omitted, tags aren't included in the response.

" - } - }, - "ServiceManagedEBSVolumeConfiguration": { - "base": null, - "refs": { - "ServiceVolumeConfiguration$managedEBSVolume": null - } - }, - "ServiceNotActiveException": { - "base": "

The specified service isn't active. You can't update a service that's inactive. If you have previously deleted a service, you can re-create it with CreateService.

", - "refs": { - } - }, - "ServiceNotFoundException": { - "base": "

The specified service wasn't found. You can view your available services with ListServices. Amazon ECS services are cluster specific and Region specific.

", - "refs": { - } - }, - "ServiceRegistries": { - "base": null, - "refs": { - "CreateServiceRequest$serviceRegistries": "

The details of the service discovery registry to associate with this service. For more information, see Service discovery.

Each service may be associated with one service registry. Multiple service registries for each service isn't supported.

", - "CreateTaskSetRequest$serviceRegistries": "

The details of the service discovery registries to assign to this task set. For more information, see Service discovery.

", - "Service$serviceRegistries": "

The details for the service discovery registries to assign to this service. For more information, see Service Discovery.

", - "TaskSet$serviceRegistries": "

The details for the service discovery registries to assign to this task set. For more information, see Service discovery.

", - "UpdateServiceRequest$serviceRegistries": "

The details for the service discovery registries to assign to this service. For more information, see Service Discovery.

When you add, update, or remove the service registries configuration, Amazon ECS starts new tasks with the updated service registries configuration, and then stops the old tasks when the new tasks are running.

You can remove existing serviceRegistries by passing an empty list.

" - } - }, - "ServiceRegistry": { - "base": "

The details for the service registry.

Each service may be associated with one service registry. Multiple service registries for each service are not supported.

When you add, update, or remove the service registries configuration, Amazon ECS starts a new deployment. New tasks are registered and deregistered to the updated service registry configuration.

", - "refs": { - "ServiceRegistries$member": null - } - }, - "ServiceTask": { - "base": null, - "refs": { - "ServiceTasks$member": null - } - }, - "ServiceTaskAccountDetail": { - "base": null, - "refs": { - "RunServiceTaskRequest$originator": null - } - }, - "ServiceTaskAssignPublicIp": { - "base": null, - "refs": { - "ServiceTaskAwsVpcConfiguration$assignPublicIp": null, - "ServiceTaskInterfaceConfiguration$assignPublicIp": null - } - }, - "ServiceTaskAttachment": { - "base": null, - "refs": { - "ServiceTaskAttachments$member": null - } - }, - "ServiceTaskAttachmentDetails": { - "base": null, - "refs": { - "ServiceTaskAttachment$details": null - } - }, - "ServiceTaskAttachments": { - "base": null, - "refs": { - "ServiceTask$attachments": null - } - }, - "ServiceTaskAttribute": { - "base": null, - "refs": { - "ServiceTaskAttributes$member": null - } - }, - "ServiceTaskAttributes": { - "base": null, - "refs": { - "ServiceTask$attributes": null - } - }, - "ServiceTaskAwsVpcConfiguration": { - "base": null, - "refs": { - "ServiceTaskNetworkConfiguration$awsvpcConfiguration": null - } - }, - "ServiceTaskBadServiceConfigurationException": { - "base": null, - "refs": { - } - }, - "ServiceTaskBlockedException": { - "base": null, - "refs": { - } - }, - "ServiceTaskCapacityFeatureRequirementType": { - "base": null, - "refs": { - "ServiceTaskCapacityFeatureRequirements$member": null - } - }, - "ServiceTaskCapacityFeatureRequirements": { - "base": null, - "refs": { - "RunServiceTaskRequest$capacityFeatureRequirements": null - } - }, - "ServiceTaskCapacityProviderStrategy": { - "base": null, - "refs": { - "RunServiceTaskRequest$capacityProviderStrategy": null - } - }, - "ServiceTaskCapacityProviderStrategyItem": { - "base": null, - "refs": { - "ServiceTaskCapacityProviderStrategy$member": null - } - }, - "ServiceTaskCapacityProviderStrategyItemBase": { - "base": null, - "refs": { - "ServiceTaskCapacityProviderStrategyItem$base": null - } - }, - "ServiceTaskCapacityProviderStrategyItemWeight": { - "base": null, - "refs": { - "ServiceTaskCapacityProviderStrategyItem$weight": null - } - }, - "ServiceTaskConnectivity": { - "base": null, - "refs": { - "ServiceTask$connectivity": null - } - }, - "ServiceTaskContainer": { - "base": null, - "refs": { - "ServiceTaskContainers$member": null - } - }, - "ServiceTaskContainerOverride": { - "base": null, - "refs": { - "ServiceTaskContainerOverrides$member": null - } - }, - "ServiceTaskContainerOverrides": { - "base": null, - "refs": { - "ServiceTaskOverride$containerOverrides": null - } - }, - "ServiceTaskContainers": { - "base": null, - "refs": { - "ServiceTask$containers": null - } - }, - "ServiceTaskDeploymentReference": { - "base": null, - "refs": { - "ServiceTaskServiceReference$deployment": null - } - }, - "ServiceTaskEBSVolumeConfigurationOverride": { - "base": null, - "refs": { - "ServiceTaskVolumeOverride$ebsVolumeConfiguration": null - } - }, - "ServiceTaskEcsDependency": { - "base": null, - "refs": { - "ServiceTaskBlockedException$originator": null, - "ServiceTaskThrottlingException$originator": null - } - }, - "ServiceTaskEcsLimit": { - "base": null, - "refs": { - "ServiceTaskLimitExceededException$limitType": null - } - }, - "ServiceTaskEcsResourceType": { - "base": null, - "refs": { - "ServiceTaskInsufficientCapacityException$resourceType": null - } - }, - "ServiceTaskEnvironmentFile": { - "base": null, - "refs": { - "ServiceTaskEnvironmentFiles$member": null - } - }, - "ServiceTaskEnvironmentFileType": { - "base": null, - "refs": { - "ServiceTaskEnvironmentFile$type": null - } - }, - "ServiceTaskEnvironmentFiles": { - "base": null, - "refs": { - "ServiceTaskContainerOverride$environmentFiles": null - } - }, - "ServiceTaskEnvironmentVariables": { - "base": null, - "refs": { - "ServiceTaskContainerOverride$environment": null - } - }, - "ServiceTaskEphemeralStorage": { - "base": null, - "refs": { - "ServiceTask$ephemeralStorage": null, - "ServiceTaskOverride$ephemeralStorage": null - } - }, - "ServiceTaskFailure": { - "base": null, - "refs": { - "ServiceTaskFailures$member": null - } - }, - "ServiceTaskFailures": { - "base": null, - "refs": { - "RunServiceTaskResponse$failures": null - } - }, - "ServiceTaskGpuIds": { - "base": null, - "refs": { - "ServiceTaskContainer$gpuIds": null - } - }, - "ServiceTaskHealthStatus": { - "base": null, - "refs": { - "ServiceTask$healthStatus": null, - "ServiceTaskContainer$healthStatus": null - } - }, - "ServiceTaskInferenceAcceleratorOverride": { - "base": null, - "refs": { - "ServiceTaskInferenceAcceleratorOverrides$member": null - } - }, - "ServiceTaskInferenceAcceleratorOverrides": { - "base": null, - "refs": { - "ServiceTaskOverride$inferenceAcceleratorOverrides": null - } - }, - "ServiceTaskInsufficientCapacityException": { - "base": null, - "refs": { - } - }, - "ServiceTaskInterfaceConfiguration": { - "base": null, - "refs": { - "ServiceTaskInterfaceConfigurations$member": null - } - }, - "ServiceTaskInterfaceConfigurations": { - "base": null, - "refs": { - "ServiceTaskAwsVpcConfiguration$interfaceConfigurations": null - } - }, - "ServiceTaskInterfaceOwner": { - "base": null, - "refs": { - "ServiceTaskAwsVpcConfiguration$interfaceOwner": null, - "ServiceTaskInterfaceConfiguration$owner": null - } - }, - "ServiceTaskInvalidIamPrincipalException": { - "base": null, - "refs": { - } - }, - "ServiceTaskInvalidPlacementException": { - "base": null, - "refs": { - } - }, - "ServiceTaskInvalidPlatformException": { - "base": null, - "refs": { - } - }, - "ServiceTaskLaunchType": { - "base": null, - "refs": { - "RunServiceTaskRequest$launchType": null, - "ServiceTask$launchType": null - } - }, - "ServiceTaskLifecycleHook": { - "base": null, - "refs": { - "ServiceTaskLifecycleHooks$member": null - } - }, - "ServiceTaskLifecycleHookOutcome": { - "base": null, - "refs": { - "ServiceTaskLifecycleHook$outcome": null - } - }, - "ServiceTaskLifecycleHookStage": { - "base": null, - "refs": { - "ServiceTaskLifecycleHook$stage": null - } - }, - "ServiceTaskLifecycleHookStatus": { - "base": null, - "refs": { - "ServiceTaskLifecycleHook$status": null - } - }, - "ServiceTaskLifecycleHooks": { - "base": null, - "refs": { - "ServiceTask$lifecycleHooks": null - } - }, - "ServiceTaskLimitExceededException": { - "base": null, - "refs": { - } - }, - "ServiceTaskLoadBalancer": { - "base": null, - "refs": { - "ServiceTaskLoadBalancers$member": null - } - }, - "ServiceTaskLoadBalancers": { - "base": null, - "refs": { - "RunServiceTaskRequest$loadBalancers": null - } - }, - "ServiceTaskManagedAgent": { - "base": null, - "refs": { - "ServiceTaskManagedAgents$member": null - } - }, - "ServiceTaskManagedAgentName": { - "base": null, - "refs": { - "ServiceTaskManagedAgent$name": null - } - }, - "ServiceTaskManagedAgents": { - "base": null, - "refs": { - "ServiceTaskContainer$managedAgents": null - } - }, - "ServiceTaskNetworkBinding": { - "base": null, - "refs": { - "ServiceTaskNetworkBindings$member": null - } - }, - "ServiceTaskNetworkBindings": { - "base": null, - "refs": { - "ServiceTaskContainer$networkBindings": null - } - }, - "ServiceTaskNetworkConfiguration": { - "base": null, - "refs": { - "RunServiceTaskRequest$networkConfiguration": null - } - }, - "ServiceTaskNetworkInterface": { - "base": null, - "refs": { - "ServiceTaskNetworkInterfaces$member": null - } - }, - "ServiceTaskNetworkInterfaces": { - "base": null, - "refs": { - "ServiceTaskContainer$networkInterfaces": null - } - }, - "ServiceTaskOverride": { - "base": null, - "refs": { - "RunServiceTaskRequest$overrides": null, - "ServiceTask$overrides": null - } - }, - "ServiceTaskPlacementConstraint": { - "base": null, - "refs": { - "ServiceTaskPlacementConstraints$member": null - } - }, - "ServiceTaskPlacementConstraintType": { - "base": null, - "refs": { - "ServiceTaskPlacementConstraint$type": null - } - }, - "ServiceTaskPlacementConstraints": { - "base": null, - "refs": { - "RunServiceTaskRequest$placementConstraints": null - } - }, - "ServiceTaskPlacementStrategies": { - "base": null, - "refs": { - "RunServiceTaskRequest$placementStrategy": null - } - }, - "ServiceTaskPlacementStrategy": { - "base": null, - "refs": { - "ServiceTaskPlacementStrategies$member": null - } - }, - "ServiceTaskPlacementStrategyType": { - "base": null, - "refs": { - "ServiceTaskPlacementStrategy$type": null - } - }, - "ServiceTaskPropagateTags": { - "base": null, - "refs": { - "RunServiceTaskRequest$propagateTags": null - } - }, - "ServiceTaskResourceRequirement": { - "base": null, - "refs": { - "ServiceTaskResourceRequirements$member": null - } - }, - "ServiceTaskResourceRequirements": { - "base": null, - "refs": { - "ServiceTaskContainerOverride$resourceRequirements": null - } - }, - "ServiceTaskResourceType": { - "base": null, - "refs": { - "ServiceTaskResourceRequirement$type": null - } - }, - "ServiceTaskServiceConnectTaskConfiguration": { - "base": null, - "refs": { - "RunServiceTaskRequest$serviceConnectConfiguration": null, - "ServiceTask$serviceConnectConfiguration": null - } - }, - "ServiceTaskServiceReference": { - "base": null, - "refs": { - "RunServiceTaskRequest$service": null - } - }, - "ServiceTaskServiceRegistries": { - "base": null, - "refs": { - "RunServiceTaskRequest$serviceRegistries": null - } - }, - "ServiceTaskServiceRegistry": { - "base": null, - "refs": { - "ServiceTaskServiceRegistries$member": null - } - }, - "ServiceTaskStopCode": { - "base": null, - "refs": { - "ServiceTask$stopCode": null - } - }, - "ServiceTaskTag": { - "base": null, - "refs": { - "ServiceTaskTags$member": null - } - }, - "ServiceTaskTagKey": { - "base": null, - "refs": { - "ServiceTaskTag$key": null - } - }, - "ServiceTaskTagValue": { - "base": null, - "refs": { - "ServiceTaskTag$value": null - } - }, - "ServiceTaskTaggingFailureException": { - "base": null, - "refs": { - } - }, - "ServiceTaskTags": { - "base": null, - "refs": { - "RunServiceTaskRequest$tags": null, - "ServiceTask$tags": null, - "ServiceTaskEBSVolumeConfigurationOverride$volumeTags": null - } - }, - "ServiceTaskTargetType": { - "base": null, - "refs": { - "ServiceTaskAttribute$targetType": null - } - }, - "ServiceTaskThrottlingException": { - "base": null, - "refs": { - } - }, - "ServiceTaskTransportProtocol": { - "base": null, - "refs": { - "ServiceTaskNetworkBinding$protocol": null - } - }, - "ServiceTaskVolumeOverride": { - "base": null, - "refs": { - "ServiceTaskVolumeOverrides$member": null - } - }, - "ServiceTaskVolumeOverrides": { - "base": null, - "refs": { - "ServiceTaskOverride$volumeOverrides": null - } - }, - "ServiceTasks": { - "base": null, - "refs": { - "RunServiceTaskResponse$tasks": null - } - }, - "ServiceVolumeConfiguration": { - "base": null, - "refs": { - "ServiceVolumeConfigurations$member": null - } - }, - "ServiceVolumeConfigurations": { - "base": null, - "refs": { - "CreateServiceRequest$volumeConfigurations": null, - "CreateTaskSetRequest$volumeConfigurations": null, - "Deployment$volumeConfigurations": null, - "TaskSet$volumeConfigurations": null, - "UpdateServiceRequest$volumeConfigurations": null - } - }, - "Services": { - "base": null, - "refs": { - "DescribeServicesResponse$services": "

The list of services described.

" - } - }, - "Session": { - "base": "

The details for the execute command session.

", - "refs": { - "ExecuteCommandResponse$session": "

The details of the SSM session that was created for this instance of execute-command.

" - } - }, - "Setting": { - "base": "

The current account setting for a resource.

", - "refs": { - "DeleteAccountSettingResponse$setting": "

The account setting for the specified principal ARN.

", - "PutAccountSettingDefaultResponse$setting": "

The current setting for a resource.

", - "PutAccountSettingResponse$setting": "

The current account setting for a resource.

", - "Settings$member": null - } - }, - "SettingName": { - "base": null, - "refs": { - "DeleteAccountSettingRequest$name": "

The resource name to disable the account setting for. If serviceLongArnFormat is specified, the ARN for your Amazon ECS services is affected. If taskLongArnFormat is specified, the ARN and resource ID for your Amazon ECS tasks is affected. If containerInstanceLongArnFormat is specified, the ARN and resource ID for your Amazon ECS container instances is affected. If awsvpcTrunking is specified, the ENI limit for your Amazon ECS container instances is affected.

", - "ListAccountSettingsRequest$name": "

The name of the account setting you want to list the settings for.

", - "PutAccountSettingDefaultRequest$name": "

The resource name for which to modify the account setting. If you specify serviceLongArnFormat, the ARN for your Amazon ECS services is affected. If you specify taskLongArnFormat, the ARN and resource ID for your Amazon ECS tasks is affected. If you specify containerInstanceLongArnFormat, the ARN and resource ID for your Amazon ECS container instances is affected. If you specify awsvpcTrunking, the ENI limit for your Amazon ECS container instances is affected. If you specify containerInsights, the default setting for Amazon Web Services CloudWatch Container Insights for your clusters is affected. If you specify tagResourceAuthorization, the opt-in option for tagging resources on creation is affected. For information about the opt-in timeline, see Tagging authorization timeline in the Amazon ECS Developer Guide. If you specify fargateTaskRetirementWaitPeriod, the default wait time to retire a Fargate task due to required maintenance is affected.

When you specify fargateFIPSMode for the name and enabled for the value, Fargate uses FIPS-140 compliant cryptographic algorithms on your tasks. For more information about FIPS-140 compliance with Fargate, see Amazon Web Services Fargate Federal Information Processing Standard (FIPS) 140-2 compliance in the Amazon Elastic Container Service Developer Guide.

When Amazon Web Services determines that a security or infrastructure update is needed for an Amazon ECS task hosted on Fargate, the tasks need to be stopped and new tasks launched to replace them. Use fargateTaskRetirementWaitPeriod to set the wait time to retire a Fargate task to the default. For information about the Fargate tasks maintenance, see Amazon Web Services Fargate task maintenance in the Amazon ECS Developer Guide.

", - "PutAccountSettingRequest$name": "

The Amazon ECS resource name for which to modify the account setting. If you specify serviceLongArnFormat, the ARN for your Amazon ECS services is affected. If you specify taskLongArnFormat, the ARN and resource ID for your Amazon ECS tasks is affected. If you specify containerInstanceLongArnFormat, the ARN and resource ID for your Amazon ECS container instances is affected. If you specify awsvpcTrunking, the elastic network interface (ENI) limit for your Amazon ECS container instances is affected. If you specify containerInsights, the default setting for Amazon Web Services CloudWatch Container Insights for your clusters is affected. If you specify fargateFIPSMode, Fargate FIPS 140 compliance is affected. If you specify tagResourceAuthorization, the opt-in option for tagging resources on creation is affected. For information about the opt-in timeline, see Tagging authorization timeline in the Amazon ECS Developer Guide. If you specify fargateTaskRetirementWaitPeriod, the wait time to retire a Fargate task is affected.

", - "Setting$name": "

The Amazon ECS resource name.

" - } - }, - "SettingType": { - "base": null, - "refs": { - "Setting$type": null - } - }, - "Settings": { - "base": null, - "refs": { - "ListAccountSettingsResponse$settings": "

The account settings for the resource.

" - } - }, - "SoftwareManifest": { - "base": null, - "refs": { - "RegisterContainerInstanceRequest$softwareManifest": null - } - }, - "SoftwareManifestEntry": { - "base": null, - "refs": { - "SoftwareManifest$member": null - } - }, - "SortOrder": { - "base": null, - "refs": { - "ListTaskDefinitionsRequest$sort": "

The order to sort the results in. Valid values are ASC and DESC. By default, (ASC) task definitions are listed lexicographically by family name and in ascending numerical order by revision so that the newest task definitions in a family are listed last. Setting this parameter to DESC reverses the sort order on family name and revision. This is so that the newest task definitions in a family are listed first.

" - } - }, - "StabilityStatus": { - "base": null, - "refs": { - "TaskSet$stabilityStatus": "

The stability status. This indicates whether the task set has reached a steady state. If the following conditions are met, the task set are in STEADY_STATE:

If any of those conditions aren't met, the stability status returns STABILIZING.

" - } - }, - "StartTaskRequest": { - "base": null, - "refs": { - } - }, - "StartTaskResponse": { - "base": null, - "refs": { - } - }, - "Statistics": { - "base": null, - "refs": { - "Cluster$statistics": "

Additional information about your clusters that are separated by launch type. They include the following:

" - } - }, - "StopTaskRequest": { - "base": null, - "refs": { - } - }, - "StopTaskResponse": { - "base": null, - "refs": { - } - }, - "String": { - "base": null, - "refs": { - "AccountDetail$accountId": null, - "AccountDetail$credentialProvider": null, - "AccountDetail$token": null, - "AssociateCapacityProvidersWithClusterRequest$cluster": null, - "Attachment$id": "

The unique identifier for the attachment.

", - "Attachment$type": "

The type of the attachment, such as ElasticNetworkInterface.

", - "Attachment$status": "

The status of the attachment. Valid values are PRECREATED, CREATED, ATTACHING, ATTACHED, DETACHING, DETACHED, DELETED, and FAILED.

", - "AttachmentStateChange$attachmentArn": "

The Amazon Resource Name (ARN) of the attachment.

", - "AttachmentStateChange$status": "

The status of the attachment.

", - "Attribute$name": "

The name of the attribute. The name must contain between 1 and 128 characters. The name may contain letters (uppercase and lowercase), numbers, hyphens (-), underscores (_), forward slashes (/), back slashes (\\), or periods (.).

", - "Attribute$value": "

The value of the attribute. The value must contain between 1 and 128 characters. It can contain letters (uppercase and lowercase), numbers, hyphens (-), underscores (_), periods (.), at signs (@), forward slashes (/), back slashes (\\), colons (:), or spaces. The value can't start or end with a space.

", - "Attribute$targetId": "

The ID of the target. You can specify the short form ID for a resource or the full Amazon Resource Name (ARN).

", - "AutoScalingGroupProvider$autoScalingGroupArn": "

The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.

", - "AwsVpcConfiguration$networkInterfaceOwner": null, - "AwsVpcConfiguration$networkInterfaceCredential": null, - "AwsVpcConfiguration$role": null, - "CapacityProvider$capacityProviderArn": "

The Amazon Resource Name (ARN) that identifies the capacity provider.

", - "CapacityProvider$name": "

The name of the capacity provider.

", - "CapacityProvider$updateStatusReason": "

The update status reason. This provides further details about the update status for the capacity provider.

", - "CapacityProviderStrategyItem$capacityProvider": "

The short name of the capacity provider.

", - "Cluster$clusterArn": "

The Amazon Resource Name (ARN) that identifies the cluster. For more information about the ARN format, see Amazon Resource Name (ARN) in the Amazon ECS Developer Guide.

", - "Cluster$clusterName": "

A user-generated string that you use to identify your cluster.

", - "Cluster$status": "

The status of the cluster. The following are the possible states that are returned.

ACTIVE

The cluster is ready to accept tasks and if applicable you can register container instances with the cluster.

PROVISIONING

The cluster has capacity providers that are associated with it and the resources needed for the capacity provider are being created.

DEPROVISIONING

The cluster has capacity providers that are associated with it and the resources needed for the capacity provider are being deleted.

FAILED

The cluster has capacity providers that are associated with it and the resources needed for the capacity provider have failed to create.

INACTIVE

The cluster has been deleted. Clusters with an INACTIVE status may remain discoverable in your account for a period of time. However, this behavior is subject to change in the future. We don't recommend that you rely on INACTIVE clusters persisting.

", - "Cluster$statusReason": null, - "Cluster$attachmentsStatus": "

The status of the capacity providers associated with the cluster. The following are the states that are returned.

UPDATE_IN_PROGRESS

The available capacity providers for the cluster are updating.

UPDATE_COMPLETE

The capacity providers have successfully updated.

UPDATE_FAILED

The capacity provider updates failed.

", - "ClusterCapacityProviderAssociation$clusterCapacityProviderAssociationArn": null, - "ClusterCapacityProviderAssociation$cluster": null, - "ClusterCapacityProviderAssociation$capacityProviderName": null, - "ClusterServiceConnectDefaults$namespace": "

The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace. When you create a service and don't specify a Service Connect configuration, this namespace is used.

", - "ClusterServiceConnectDefaultsRequest$namespace": "

The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace that's used when you create a service and don't specify a Service Connect configuration. The namespace name can include up to 1024 characters. The name is case-sensitive. The name can't include hyphens (-), tilde (~), greater than (>), less than (<), or slash (/).

If you enter an existing namespace name or ARN, then that namespace will be used. Any namespace type is supported. The namespace must be in this account and this Amazon Web Services Region.

If you enter a new name, a Cloud Map namespace will be created. Amazon ECS creates a Cloud Map namespace with the \"API calls\" method of instance discovery only. This instance discovery method is the \"HTTP\" namespace type in the Command Line Interface. Other types of instance discovery aren't used by Service Connect.

If you update the cluster with an empty string \"\" for the namespace name, the cluster configuration for Service Connect is removed. Note that the namespace will remain in Cloud Map and must be deleted separately.

For more information about Cloud Map, see Working with Services in the Cloud Map Developer Guide.

", - "ClusterSetting$value": "

The value to set for the cluster setting. The supported values are enabled and disabled.

If you set name to containerInsights and value to enabled, CloudWatch Container Insights will be on for the cluster, otherwise it will be off unless the containerInsights account setting is turned on. If a cluster value is specified, it will override the containerInsights value set with PutAccountSetting or PutAccountSettingDefault.

", - "Container$containerArn": "

The Amazon Resource Name (ARN) of the container.

", - "Container$taskArn": "

The ARN of the task.

", - "Container$name": "

The name of the container.

", - "Container$image": "

The image used for the container.

", - "Container$imageDigest": "

The container image manifest digest.

", - "Container$runtimeId": "

The ID of the Docker container.

", - "Container$lastStatus": "

The last known status of the container.

", - "Container$reason": "

A short (255 max characters) human-readable string to provide additional details about a running or stopped container.

", - "Container$cpu": "

The number of CPU units set for the container. The value is 0 if no value was specified in the container definition when the task definition was registered.

", - "Container$memory": "

The hard limit (in MiB) of memory set for the container.

", - "Container$memoryReservation": "

The soft limit (in MiB) of memory set for the container.

", - "ContainerDefinition$name": "

The name of a container. If you're linking multiple containers together in a task definition, the name of one container can be entered in the links of another container to connect the containers. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed. This parameter maps to name in the Create a container section of the Docker Remote API and the --name option to docker run.

", - "ContainerDefinition$image": "

The image used to start a container. This string is passed directly to the Docker daemon. By default, images in the Docker Hub registry are available. Other repositories are specified with either repository-url/image:tag or repository-url/image@digest . Up to 255 letters (uppercase and lowercase), numbers, hyphens, underscores, colons, periods, forward slashes, and number signs are allowed. This parameter maps to Image in the Create a container section of the Docker Remote API and the IMAGE parameter of docker run.

", - "ContainerDefinition$hostname": "

The hostname to use for your container. This parameter maps to Hostname in the Create a container section of the Docker Remote API and the --hostname option to docker run.

The hostname parameter is not supported if you're using the awsvpc network mode.

", - "ContainerDefinition$user": "

The user to use inside the container. This parameter maps to User in the Create a container section of the Docker Remote API and the --user option to docker run.

When running tasks using the host network mode, don't run containers using the root user (UID 0). We recommend using a non-root user for better security.

You can specify the user using the following formats. If specifying a UID or GID, you must specify it as a positive integer.

This parameter is not supported for Windows containers.

", - "ContainerDefinition$workingDirectory": "

The working directory to run commands inside the container in. This parameter maps to WorkingDir in the Create a container section of the Docker Remote API and the --workdir option to docker run.

", - "ContainerDependency$containerName": "

The name of a container.

", - "ContainerInstance$containerInstanceArn": "

The Amazon Resource Name (ARN) of the container instance. For more information about the ARN format, see Amazon Resource Name (ARN) in the Amazon ECS Developer Guide.

", - "ContainerInstance$ec2InstanceId": "

The ID of the container instance. For Amazon EC2 instances, this value is the Amazon EC2 instance ID. For external instances, this value is the Amazon Web Services Systems Manager managed instance ID.

", - "ContainerInstance$capacityProviderName": "

The capacity provider that's associated with the container instance.

", - "ContainerInstance$status": "

The status of the container instance. The valid values are REGISTERING, REGISTRATION_FAILED, ACTIVE, INACTIVE, DEREGISTERING, or DRAINING.

If your account has opted in to the awsvpcTrunking account setting, then any newly registered container instance will transition to a REGISTERING status while the trunk elastic network interface is provisioned for the instance. If the registration fails, the instance will transition to a REGISTRATION_FAILED status. You can describe the container instance and see the reason for failure in the statusReason parameter. Once the container instance is terminated, the instance transitions to a DEREGISTERING status while the trunk elastic network interface is deprovisioned. The instance then transitions to an INACTIVE status.

The ACTIVE status indicates that the container instance can accept tasks. The DRAINING indicates that new tasks aren't placed on the container instance and any service tasks running on the container instance are removed if possible. For more information, see Container instance draining in the Amazon Elastic Container Service Developer Guide.

", - "ContainerInstance$statusReason": "

The reason that the container instance reached its current status.

", - "ContainerInstance$clientToken": null, - "ContainerOverride$name": "

The name of the container that receives the override. This parameter is required if any override is specified.

", - "ContainerStateChange$containerName": "

The name of the container.

", - "ContainerStateChange$imageDigest": "

The container image SHA 256 digest.

", - "ContainerStateChange$runtimeId": "

The ID of the Docker container.

", - "ContainerStateChange$reason": "

The reason for the state change.

", - "ContainerStateChange$status": "

The status of the container.

", - "CreateCapacityProviderRequest$name": "

The name of the capacity provider. Up to 255 characters are allowed. They include letters (both upper and lowercase letters), numbers, underscores (_), and hyphens (-). The name can't be prefixed with \"aws\", \"ecs\", or \"fargate\".

", - "CreateClusterRequest$clusterName": "

The name of your cluster. If you don't specify a name for your cluster, you create a cluster that's named default. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed.

", - "CreateServiceRequest$clientToken": "

An identifier that you provide to ensure the idempotency of the request. It must be unique and is case sensitive. Up to 32 ASCII characters are allowed.

", - "CreateServiceRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that you run your service on. If you do not specify a cluster, the default cluster is assumed.

", - "CreateServiceRequest$platformVersion": "

The platform version that your tasks in the service are running on. A platform version is specified only for tasks using the Fargate launch type. If one isn't specified, the LATEST platform version is used. For more information, see Fargate platform versions in the Amazon Elastic Container Service Developer Guide.

", - "CreateServiceRequest$role": "

The name or full Amazon Resource Name (ARN) of the IAM role that allows Amazon ECS to make calls to your load balancer on your behalf. This parameter is only permitted if you are using a load balancer with your service and your task definition doesn't use the awsvpc network mode. If you specify the role parameter, you must also specify a load balancer object with the loadBalancers parameter.

If your account has already created the Amazon ECS service-linked role, that role is used for your service unless you specify a role here. The service-linked role is required if your task definition uses the awsvpc network mode or if the service is configured to use service discovery, an external deployment controller, multiple target groups, or Elastic Inference accelerators in which case you don't specify a role here. For more information, see Using service-linked roles for Amazon ECS in the Amazon Elastic Container Service Developer Guide.

If your specified role has a path other than /, then you must either specify the full role ARN (this is recommended) or prefix the role name with the path. For example, if a role with the name bar has a path of /foo/ then you would specify /foo/bar as the role name. For more information, see Friendly names and paths in the IAM User Guide.

", - "CreateServiceRequest$serviceName": "

The name of your service. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed. Service names must be unique within a cluster, but you can have similarly named services in multiple clusters within a Region or across multiple Regions.

", - "CreateServiceRequest$createdBy": null, - "CreateServiceRequest$taskDefinition": "

The family and revision (family:revision) or full ARN of the task definition to run in your service. If a revision isn't specified, the latest ACTIVE revision is used.

A task definition must be specified if the service uses either the ECS or CODE_DEPLOY deployment controllers.

For more information about deployment types, see Amazon ECS deployment types.

", - "CreateTaskSetRequest$service": "

The short name or full Amazon Resource Name (ARN) of the service to create the task set in.

", - "CreateTaskSetRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service to create the task set in.

", - "CreateTaskSetRequest$startedBy": null, - "CreateTaskSetRequest$externalId": "

An optional non-unique tag that identifies this task set in external systems. If the task set is associated with a service discovery registry, the tasks in this task set will have the ECS_TASK_SET_EXTERNAL_ID Cloud Map attribute set to the provided value.

", - "CreateTaskSetRequest$taskDefinition": "

The task definition for the tasks in the task set to use. If a revision isn't specified, the latest ACTIVE revision is used.

", - "CreateTaskSetRequest$platformVersion": "

The platform version that the tasks in the task set uses. A platform version is specified only for tasks using the Fargate launch type. If one isn't specified, the LATEST platform version is used.

", - "CreateTaskSetRequest$clientToken": "

The identifier that you provide to ensure the idempotency of the request. It's case sensitive and must be unique. It can be up to 32 ASCII characters are allowed.

", - "DeleteAccountSettingRequest$principalArn": "

The Amazon Resource Name (ARN) of the principal. It can be an user, role, or the root user. If you specify the root user, it disables the account setting for all users, roles, and the root user of the account unless a user or role explicitly overrides these settings. If this field is omitted, the setting is changed only for the authenticated user.

", - "DeleteAttributesRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that contains the resource to delete attributes. If you do not specify a cluster, the default cluster is assumed.

", - "DeleteCapacityProviderRequest$capacityProvider": "

The short name or full Amazon Resource Name (ARN) of the capacity provider to delete.

", - "DeleteClusterRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster to delete.

", - "DeleteServiceRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service to delete. If you do not specify a cluster, the default cluster is assumed.

", - "DeleteServiceRequest$service": "

The name of the service to delete.

", - "DeleteTaskSetRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service that the task set found in to delete.

", - "DeleteTaskSetRequest$service": "

The short name or full Amazon Resource Name (ARN) of the service that hosts the task set to delete.

", - "DeleteTaskSetRequest$taskSet": "

The task set ID or full Amazon Resource Name (ARN) of the task set to delete.

", - "Deployment$id": "

The ID of the deployment.

", - "Deployment$status": "

The status of the deployment. The following describes each state.

PRIMARY

The most recent deployment of a service.

ACTIVE

A service deployment that still has running tasks, but are in the process of being replaced with a new PRIMARY deployment.

INACTIVE

A deployment that has been completely replaced.

", - "Deployment$taskDefinition": "

The most recent task definition that was specified for the tasks in the service to use.

", - "Deployment$platformVersion": "

The platform version that your tasks in the service run on. A platform version is only specified for tasks using the Fargate launch type. If one isn't specified, the LATEST platform version is used. For more information, see Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

", - "Deployment$platformFamily": "

The operating system that your tasks in the service, or tasks are running on. A platform family is specified only for tasks using the Fargate launch type.

All tasks that run as part of this service must use the same platformFamily value as the service, for example, LINUX..

", - "Deployment$rolloutStateReason": "

A description of the rollout state of a deployment.

", - "DeploymentV2$id": null, - "DeploymentV2$serviceArn": null, - "DeploymentV2$serviceName": null, - "DeploymentV2$clusterArn": null, - "DeploymentV2Summary$id": null, - "DeregisterContainerInstanceRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instance to deregister. If you do not specify a cluster, the default cluster is assumed.

", - "DeregisterContainerInstanceRequest$containerInstance": "

The container instance ID or full ARN of the container instance to deregister. For more information about the ARN format, see Amazon Resource Name (ARN) in the Amazon ECS Developer Guide.

", - "DeregisterTaskDefinitionRequest$taskDefinition": "

The family and revision (family:revision) or full Amazon Resource Name (ARN) of the task definition to deregister. You must specify a revision.

", - "DescribeCapacityProvidersRequest$nextToken": "

The nextToken value returned from a previous paginated DescribeCapacityProviders request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

", - "DescribeCapacityProvidersResponse$nextToken": "

The nextToken value to include in a future DescribeCapacityProviders request. When the results of a DescribeCapacityProviders request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "DescribeClusterCapacityProviderAssociationsRequest$cluster": null, - "DescribeClusterCapacityProviderAssociationsRequest$nextToken": null, - "DescribeClusterCapacityProviderAssociationsResponse$nextToken": null, - "DescribeContainerInstancesRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instances to describe. If you do not specify a cluster, the default cluster is assumed. This parameter is required if the container instance or container instances you are describing were launched in any cluster other than the default cluster.

", - "DescribeServicesRequest$cluster": "

The short name or full Amazon Resource Name (ARN)the cluster that hosts the service to describe. If you do not specify a cluster, the default cluster is assumed. This parameter is required if the service or services you are describing were launched in any cluster other than the default cluster.

", - "DescribeTaskDefinitionRequest$taskDefinition": "

The family for the latest ACTIVE revision, family and revision (family:revision) for a specific revision in the family, or full Amazon Resource Name (ARN) of the task definition to describe.

", - "DescribeTaskSetsRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service that the task sets exist in.

", - "DescribeTaskSetsRequest$service": "

The short name or full Amazon Resource Name (ARN) of the service that the task sets exist in.

", - "DescribeTasksRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the task or tasks to describe. If you do not specify a cluster, the default cluster is assumed. This parameter is required if the task or tasks you are describing were launched in any cluster other than the default cluster.

", - "Device$hostPath": "

The path for the device on the host container instance.

", - "Device$containerPath": "

The path inside the container at which to expose the host device.

", - "DisassociateCapacityProvidersFromClusterRequest$cluster": null, - "DiscoverPollEndpointRequest$containerInstance": "

The container instance ID or full ARN of the container instance. For more information about the ARN format, see Amazon Resource Name (ARN) in the Amazon ECS Developer Guide.

", - "DiscoverPollEndpointRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that the container instance belongs to.

", - "DiscoverPollEndpointResponse$endpoint": "

The endpoint for the Amazon ECS agent to poll.

", - "DiscoverPollEndpointResponse$telemetryEndpoint": "

The telemetry endpoint for the Amazon ECS agent.

", - "DiscoverPollEndpointResponse$serviceConnectEndpoint": "

The endpoint for the Amazon ECS agent to poll for Service Connect configuration. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "DockerLabelsMap$key": null, - "DockerLabelsMap$value": null, - "DockerVolumeConfiguration$driver": "

The Docker volume driver to use. The driver value must match the driver name provided by Docker because it is used for task placement. If the driver was installed using the Docker plugin CLI, use docker plugin ls to retrieve the driver name from your container instance. If the driver was installed using another method, use Docker plugin discovery to retrieve the driver name. For more information, see Docker plugin discovery. This parameter maps to Driver in the Create a volume section of the Docker Remote API and the xxdriver option to docker volume create.

", - "EBSVolumeConfiguration$snapshotId": null, - "EBSVolumeConfigurationOverride$snapshotId": null, - "EBSVolumeConfigurationOverride$volumeId": null, - "EFSAuthorizationConfig$accessPointId": "

The Amazon EFS access point ID to use. If an access point is specified, the root directory value specified in the EFSVolumeConfiguration must either be omitted or set to / which will enforce the path set on the EFS access point. If an access point is used, transit encryption must be on in the EFSVolumeConfiguration. For more information, see Working with Amazon EFS access points in the Amazon Elastic File System User Guide.

", - "EFSVolumeConfiguration$fileSystemId": "

The Amazon EFS file system ID to use.

", - "EFSVolumeConfiguration$rootDirectory": "

The directory within the Amazon EFS file system to mount as the root directory inside the host. If this parameter is omitted, the root of the Amazon EFS volume will be used. Specifying / will have the same effect as omitting this parameter.

If an EFS access point is specified in the authorizationConfig, the root directory parameter must either be omitted or set to / which will enforce the path set on the EFS access point.

", - "EnvironmentFile$value": "

The Amazon Resource Name (ARN) of the Amazon S3 object containing the environment variable file.

", - "ExecuteCommandConfiguration$kmsKeyId": "

Specify an Key Management Service key ID to encrypt the data between the local client and the container.

", - "ExecuteCommandLogConfiguration$cloudWatchLogGroupName": "

The name of the CloudWatch log group to send logs to.

The CloudWatch log group must already be created.

", - "ExecuteCommandLogConfiguration$s3BucketName": "

The name of the S3 bucket to send logs to.

The S3 bucket must already be created.

", - "ExecuteCommandLogConfiguration$s3KeyPrefix": "

An optional folder in the S3 bucket to place logs in.

", - "ExecuteCommandRequest$cluster": "

The Amazon Resource Name (ARN) or short name of the cluster the task is running in. If you do not specify a cluster, the default cluster is assumed.

", - "ExecuteCommandRequest$container": "

The name of the container to execute the command on. A container name only needs to be specified for tasks containing multiple containers.

", - "ExecuteCommandRequest$command": "

The command to run on the container.

", - "ExecuteCommandRequest$task": "

The Amazon Resource Name (ARN) or ID of the task the container is part of.

", - "ExecuteCommandResponse$clusterArn": "

The Amazon Resource Name (ARN) of the cluster.

", - "ExecuteCommandResponse$containerArn": "

The Amazon Resource Name (ARN) of the container.

", - "ExecuteCommandResponse$containerName": "

The name of the container.

", - "ExecuteCommandResponse$taskArn": "

The Amazon Resource Name (ARN) of the task.

", - "FSxWindowsFileServerAuthorizationConfig$credentialsParameter": "

The authorization credential option to use. The authorization credential options can be provided using either the Amazon Resource Name (ARN) of an Secrets Manager secret or SSM Parameter Store parameter. The ARN refers to the stored credentials.

", - "FSxWindowsFileServerAuthorizationConfig$domain": "

A fully qualified domain name hosted by an Directory Service Managed Microsoft AD (Active Directory) or self-hosted AD on Amazon EC2.

", - "FSxWindowsFileServerVolumeConfiguration$fileSystemId": "

The Amazon FSx for Windows File Server file system ID to use.

", - "FSxWindowsFileServerVolumeConfiguration$rootDirectory": "

The directory within the Amazon FSx for Windows File Server file system to mount as the root directory inside the host.

", - "Failure$arn": "

The Amazon Resource Name (ARN) of the failed resource.

", - "Failure$reason": "

The reason for the failure.

", - "Failure$detail": "

The details of the failure.

", - "FirelensConfigurationOptionsMap$key": null, - "FirelensConfigurationOptionsMap$value": null, - "GetDeploymentRequest$id": null, - "GetDeploymentRequest$cluster": null, - "GetDeploymentRequest$service": null, - "GetTaskProtectionRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service that the task sets exist in.

", - "GpuIds$member": null, - "HostEntry$hostname": "

The hostname to use in the /etc/hosts entry.

", - "HostEntry$ipAddress": "

The IP address to use in the /etc/hosts entry.

", - "HostVolumeProperties$sourcePath": "

When the host parameter is used, specify a sourcePath to declare the path on the host container instance that's presented to the container. If this parameter is empty, then the Docker daemon has assigned a host path for you. If the host parameter contains a sourcePath file location, then the data volume persists at the specified location on the host container instance until you delete it manually. If the sourcePath value doesn't exist on the host container instance, the Docker daemon creates it. If the location does exist, the contents of the source path folder are exported.

If you're using the Fargate launch type, the sourcePath parameter is not supported.

", - "InferenceAccelerator$deviceName": "

The Elastic Inference accelerator device name. The deviceName must also be referenced in a container definition as a ResourceRequirement.

", - "InferenceAccelerator$deviceType": "

The Elastic Inference accelerator type to use.

", - "InferenceAccelerator$devicePolicy": null, - "InferenceAcceleratorOverride$deviceName": "

The Elastic Inference accelerator device name to override for the task. This parameter must match a deviceName specified in the task definition.

", - "InferenceAcceleratorOverride$deviceType": "

The Elastic Inference accelerator type to use.

", - "InferenceAcceleratorOverride$devicePolicy": null, - "KeyValuePair$name": "

The name of the key-value pair. For environment variables, this is the name of the environment variable.

", - "KeyValuePair$value": "

The value of the key-value pair. For environment variables, this is the value of the environment variable.

", - "LifecycleHook$arn": null, - "LifecycleHook$name": null, - "LifecycleHook$notificationArn": null, - "LifecycleHook$notificationToken": null, - "LifecycleHook$outcomeDetail": null, - "LifecycleHookDefinition$name": null, - "LifecycleHookDefinition$notificationArn": null, - "LifecycleHookDefinition$notificationToken": null, - "ListAccountSettingsRequest$value": "

The value of the account settings to filter results with. You must also specify an account setting name to use this parameter.

", - "ListAccountSettingsRequest$principalArn": "

The ARN of the principal, which can be a user, role, or the root user. If this field is omitted, the account settings are listed only for the authenticated user.

Federated users assume the account setting of the root user and can't have explicit account settings set for them.

", - "ListAccountSettingsRequest$nextToken": "

The nextToken value returned from a ListAccountSettings request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it's possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

", - "ListAccountSettingsResponse$nextToken": "

The nextToken value to include in a future ListAccountSettings request. When the results of a ListAccountSettings request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "ListAttributesRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster to list attributes. If you do not specify a cluster, the default cluster is assumed.

", - "ListAttributesRequest$attributeName": "

The name of the attribute to filter the results with.

", - "ListAttributesRequest$attributeValue": "

The value of the attribute to filter results with. You must also specify an attribute name to use this parameter.

", - "ListAttributesRequest$nextToken": "

The nextToken value returned from a ListAttributes request indicating that more results are available to fulfill the request and further calls are needed. If maxResults was provided, it's possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

", - "ListAttributesResponse$nextToken": "

The nextToken value to include in a future ListAttributes request. When the results of a ListAttributes request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "ListClustersRequest$nextToken": "

The nextToken value returned from a ListClusters request indicating that more results are available to fulfill the request and further calls are needed. If maxResults was provided, it's possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

", - "ListClustersResponse$nextToken": "

The nextToken value to include in a future ListClusters request. When the results of a ListClusters request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "ListContainerInstancesRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instances to list. If you do not specify a cluster, the default cluster is assumed.

", - "ListContainerInstancesRequest$filter": "

You can filter the results of a ListContainerInstances operation with cluster query language statements. For more information, see Cluster Query Language in the Amazon Elastic Container Service Developer Guide.

", - "ListContainerInstancesRequest$nextToken": "

The nextToken value returned from a ListContainerInstances request indicating that more results are available to fulfill the request and further calls are needed. If maxResults was provided, it's possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

", - "ListContainerInstancesRequest$capacityProviderName": null, - "ListContainerInstancesResponse$nextToken": "

The nextToken value to include in a future ListContainerInstances request. When the results of a ListContainerInstances request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "ListDeploymentsRequest$cluster": null, - "ListDeploymentsRequest$service": null, - "ListDeploymentsRequest$nextToken": null, - "ListDeploymentsResponse$nextToken": null, - "ListServicesByNamespaceRequest$namespace": "

The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace to list the services in.

Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "ListServicesByNamespaceRequest$nextToken": "

The nextToken value that's returned from a ListServicesByNamespace request. It indicates that more results are available to fulfill the request and further calls are needed. If maxResults is returned, it is possible the number of results is less than maxResults.

", - "ListServicesByNamespaceResponse$nextToken": "

The nextToken value to include in a future ListServicesByNamespace request. When the results of a ListServicesByNamespace request exceed maxResults, this value can be used to retrieve the next page of results. When there are no more results to return, this value is null.

", - "ListServicesRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering the ListServices results. If you do not specify a cluster, the default cluster is assumed.

", - "ListServicesRequest$nextToken": "

The nextToken value returned from a ListServices request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it is possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

", - "ListServicesResponse$nextToken": "

The nextToken value to include in a future ListServices request. When the results of a ListServices request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "ListTagsForResourceRequest$resourceArn": "

The Amazon Resource Name (ARN) that identifies the resource to list the tags for. Currently, the supported resources are Amazon ECS tasks, services, task definitions, clusters, and container instances.

", - "ListTaskDefinitionFamiliesRequest$familyPrefix": "

The familyPrefix is a string that's used to filter the results of ListTaskDefinitionFamilies. If you specify a familyPrefix, only task definition family names that begin with the familyPrefix string are returned.

", - "ListTaskDefinitionFamiliesRequest$nextToken": "

The nextToken value returned from a ListTaskDefinitionFamilies request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it is possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

", - "ListTaskDefinitionFamiliesResponse$nextToken": "

The nextToken value to include in a future ListTaskDefinitionFamilies request. When the results of a ListTaskDefinitionFamilies request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "ListTaskDefinitionsRequest$familyPrefix": "

The full family name to filter the ListTaskDefinitions results with. Specifying a familyPrefix limits the listed task definitions to task definition revisions that belong to that family.

", - "ListTaskDefinitionsRequest$nextToken": "

The nextToken value returned from a ListTaskDefinitions request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it is possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

", - "ListTaskDefinitionsResponse$nextToken": "

The nextToken value to include in a future ListTaskDefinitions request. When the results of a ListTaskDefinitions request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "ListTasksRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster to use when filtering the ListTasks results. If you do not specify a cluster, the default cluster is assumed.

", - "ListTasksRequest$containerInstance": "

The container instance ID or full ARN of the container instance to use when filtering the ListTasks results. Specifying a containerInstance limits the results to tasks that belong to that container instance.

", - "ListTasksRequest$family": "

The name of the task definition family to use when filtering the ListTasks results. Specifying a family limits the results to tasks that belong to that family.

", - "ListTasksRequest$nextToken": "

The nextToken value returned from a ListTasks request indicating that more results are available to fulfill the request and further calls will be needed. If maxResults was provided, it's possible the number of results to be fewer than maxResults.

This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

", - "ListTasksRequest$startedBy": "

The startedBy value to filter the task results with. Specifying a startedBy value limits the results to tasks that were started with that value.

When you specify startedBy as the filter, it must be the only filter that you use.

", - "ListTasksRequest$serviceName": "

The name of the service to use when filtering the ListTasks results. Specifying a serviceName limits the results to tasks that belong to that service.

", - "ListTasksRequest$capacityProviderName": null, - "ListTasksResponse$nextToken": "

The nextToken value to include in a future ListTasks request. When the results of a ListTasks request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

", - "LoadBalancer$loadBalancerName": "

The name of the load balancer to associate with the Amazon ECS service or task set.

If you are using an Application Load Balancer or a Network Load Balancer the load balancer name parameter should be omitted.

", - "LoadBalancer$targetGroupArn": "

The full Amazon Resource Name (ARN) of the Elastic Load Balancing target group or groups associated with a service or task set.

A target group ARN is only specified when using an Application Load Balancer or Network Load Balancer.

For services using the ECS deployment controller, you can specify one or multiple target groups. For more information, see Registering multiple target groups with a service in the Amazon Elastic Container Service Developer Guide.

For services using the CODE_DEPLOY deployment controller, you're required to define two target groups for the load balancer. For more information, see Blue/green deployment with CodeDeploy in the Amazon Elastic Container Service Developer Guide.

If your service's task definition uses the awsvpc network mode, you must choose ip as the target type, not instance. Do this when creating your target groups because tasks that use the awsvpc network mode are associated with an elastic network interface, not an Amazon EC2 instance. This network mode is required for the Fargate launch type.

", - "LoadBalancer$targetGroupTargetType": null, - "LoadBalancer$containerName": "

The name of the container (as it appears in a container definition) to associate with the load balancer.

", - "LoadBalancerConfiguration$prodListenerArn": null, - "LogConfigurationOptionsMap$key": null, - "LogConfigurationOptionsMap$value": null, - "ManagedAgent$reason": "

The reason for why the managed agent is in the state it is in.

", - "ManagedAgent$lastStatus": "

The last known status of the managed agent.

", - "ManagedAgentStateChange$containerName": "

The name of the container that's associated with the managed agent.

", - "ManagedAgentStateChange$status": "

The status of the managed agent.

", - "ManagedAgentStateChange$reason": "

The reason for the status of the managed agent.

", - "MountPoint$sourceVolume": "

The name of the volume to mount. Must be a volume name referenced in the name parameter of task definition volume.

", - "MountPoint$containerPath": "

The path on the container to mount the host volume at.

", - "NetworkBinding$bindIP": "

The IP address that the container is bound to on the container instance.

", - "NetworkBinding$containerPortRange": "

The port number range on the container that's bound to the dynamically mapped host port range.

The following rules apply when you specify a containerPortRange:

You can call DescribeTasks to view the hostPortRange which are the host ports that are bound to the container ports.

", - "NetworkBinding$hostPortRange": "

The port number range on the host that's used with the network binding. This is assigned is assigned by Docker and delivered by the Amazon ECS agent.

", - "NetworkInterface$attachmentId": "

The attachment ID for the network interface.

", - "NetworkInterface$privateIpv4Address": "

The private IPv4 address for the network interface.

", - "NetworkInterface$ipv6Address": "

The private IPv6 address for the network interface.

", - "NotifyLifecycleHookCompleteRequest$arn": null, - "NotifyLifecycleHookCompleteRequest$reason": null, - "PlacementConstraint$expression": "

A cluster query language expression to apply to the constraint. The expression can have a maximum length of 2000 characters. You can't specify an expression if the constraint type is distinctInstance. For more information, see Cluster query language in the Amazon Elastic Container Service Developer Guide.

", - "PlacementStrategy$field": "

The field to apply the placement strategy against. For the spread placement strategy, valid values are instanceId (or host, which has the same effect), or any platform or custom attribute that's applied to a container instance, such as attribute:ecs.availability-zone. For the binpack placement strategy, valid values are cpu and memory. For the random placement strategy, this field is not used.

", - "PlatformDevice$id": "

The ID for the GPUs on the container instance. The available GPU IDs can also be obtained on the container instance in the /var/lib/ecs/gpu/nvidia_gpu_info.json file.

", - "PortMapping$name": "

The name that's used for the port mapping. This parameter only applies to Service Connect. This parameter is the name that you use in the serviceConnectConfiguration of a service. The name can include up to 64 characters. The characters can include lowercase letters, numbers, underscores (_), and hyphens (-). The name can't start with a hyphen.

For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "PortMapping$containerPortRange": "

The port number range on the container that's bound to the dynamically mapped host port range.

The following rules apply when you specify a containerPortRange:

You can call DescribeTasks to view the hostPortRange which are the host ports that are bound to the container ports.

", - "ProtectedTask$taskArn": "

The task ARN.

", - "ProxyConfiguration$containerName": "

The name of the container that will serve as the App Mesh proxy.

", - "PutAccountSettingDefaultRequest$value": "

The account setting value for the specified principal ARN. Accepted values are enabled, disabled, on, and off.

When you specify fargateTaskRetirementWaitPeriod for the name, the following are the valid values:

", - "PutAccountSettingRequest$value": "

The account setting value for the specified principal ARN. Accepted values are enabled, disabled, on, and off.

When you specify fargateTaskRetirementWaitPeriod for the name, the following are the valid values:

", - "PutAccountSettingRequest$principalArn": "

The ARN of the principal, which can be a user, role, or the root user. If you specify the root user, it modifies the account setting for all users, roles, and the root user of the account unless a user or role explicitly overrides these settings. If this field is omitted, the setting is changed only for the authenticated user.

You must use the root user when you set the Fargate wait time (fargateTaskRetirementWaitPeriod).

Federated users assume the account setting of the root user and can't have explicit account settings set for them.

", - "PutAttributesRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that contains the resource to apply attributes. If you do not specify a cluster, the default cluster is assumed.

", - "PutClusterCapacityProvidersRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster to modify the capacity provider settings for. If you don't specify a cluster, the default cluster is assumed.

", - "RegisterContainerInstanceRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster to register your container instance with. If you do not specify a cluster, the default cluster is assumed.

", - "RegisterContainerInstanceRequest$instanceIdentityDocument": "

The instance identity document for the EC2 instance to register. This document can be found by running the following command from the instance: curl http://169.254.169.254/latest/dynamic/instance-identity/document/

", - "RegisterContainerInstanceRequest$instanceIdentityDocumentSignature": "

The instance identity document signature for the EC2 instance to register. This signature can be found by running the following command from the instance: curl http://169.254.169.254/latest/dynamic/instance-identity/signature/

", - "RegisterContainerInstanceRequest$containerInstanceArn": "

The ARN of the container instance (if it was previously registered).

", - "RegisterContainerInstanceRequest$clientToken": null, - "RegisterTaskDefinitionRequest$family": "

You must specify a family for a task definition. You can use it track multiple versions of the same task definition. The family is used as a name for your task definition. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed.

", - "RegisterTaskDefinitionRequest$taskRoleArn": "

The short name or full Amazon Resource Name (ARN) of the IAM role that containers in this task can assume. All containers in this task are granted the permissions that are specified in this role. For more information, see IAM Roles for Tasks in the Amazon Elastic Container Service Developer Guide.

", - "RegisterTaskDefinitionRequest$taskRoleCredentialProvider": null, - "RegisterTaskDefinitionRequest$executionRoleArn": "

The Amazon Resource Name (ARN) of the task execution role that grants the Amazon ECS container agent permission to make Amazon Web Services API calls on your behalf. The task execution IAM role is required depending on the requirements of your task. For more information, see Amazon ECS task execution IAM role in the Amazon Elastic Container Service Developer Guide.

", - "RegisterTaskDefinitionRequest$executionRoleCredentialProvider": null, - "RegisterTaskDefinitionRequest$cpu": "

The number of CPU units used by the task. It can be expressed as an integer using CPU units (for example, 1024) or as a string using vCPUs (for example, 1 vCPU or 1 vcpu) in a task definition. String values are converted to an integer indicating the CPU units when the task definition is registered.

Task-level CPU and memory parameters are ignored for Windows containers. We recommend specifying container-level resources for Windows containers.

If you're using the EC2 launch type, this field is optional. Supported values are between 128 CPU units (0.125 vCPUs) and 10240 CPU units (10 vCPUs). If you do not specify a value, the parameter is ignored.

If you're using the Fargate launch type, this field is required and you must use one of the following values, which determines your range of supported values for the memory parameter:

The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate.

", - "RegisterTaskDefinitionRequest$memory": "

The amount of memory (in MiB) used by the task. It can be expressed as an integer using MiB (for example ,1024) or as a string using GB (for example, 1GB or 1 GB) in a task definition. String values are converted to an integer indicating the MiB when the task definition is registered.

Task-level CPU and memory parameters are ignored for Windows containers. We recommend specifying container-level resources for Windows containers.

If using the EC2 launch type, this field is optional.

If using the Fargate launch type, this field is required and you must use one of the following values. This determines your range of supported values for the cpu parameter.

The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate.

", - "RepositoryCredentials$credentialsParameter": "

The Amazon Resource Name (ARN) of the secret containing the private repository credentials.

When you use the Amazon ECS API, CLI, or Amazon Web Services SDK, if the secret exists in the same Region as the task that you're launching then you can use either the full ARN or the name of the secret. When you use the Amazon Web Services Management Console, you must specify the full ARN of the secret.

", - "Resource$name": "

The name of the resource, such as CPU, MEMORY, PORTS, PORTS_UDP, or a user-defined resource.

", - "Resource$type": "

The type of the resource. Valid values: INTEGER, DOUBLE, LONG, or STRINGSET.

", - "ResourceIds$member": null, - "ResourceRequirement$value": "

The value for the specified resource type.

If the GPU type is used, the value is the number of physical GPUs the Amazon ECS container agent reserves for the container. The number of GPUs that's reserved for all containers in a task can't exceed the number of available GPUs on the container instance that the task is launched on.

If the InferenceAccelerator type is used, the value matches the deviceName for an InferenceAccelerator specified in a task definition.

", - "RunServiceTaskRequest$clusterArn": null, - "RunServiceTaskRequest$clientToken": null, - "RunServiceTaskRequest$createdBy": null, - "RunServiceTaskRequest$group": null, - "RunServiceTaskRequest$platformFamily": null, - "RunServiceTaskRequest$platformVersion": null, - "RunServiceTaskRequest$referenceId": null, - "RunServiceTaskRequest$requestHash": null, - "RunServiceTaskRequest$startedBy": null, - "RunServiceTaskRequest$taskDefinitionArn": null, - "RunServiceTaskRequest$taskRoleArn": null, - "RunTaskRequest$clientToken": null, - "RunTaskRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster to run your task on. If you do not specify a cluster, the default cluster is assumed.

", - "RunTaskRequest$group": "

The name of the task group to associate with the task. The default value is the family name of the task definition (for example, family:my-family-name).

", - "RunTaskRequest$requestHash": null, - "RunTaskRequest$platformVersion": "

The platform version the task uses. A platform version is only specified for tasks hosted on Fargate. If one isn't specified, the LATEST platform version is used. For more information, see Fargate platform versions in the Amazon Elastic Container Service Developer Guide.

", - "RunTaskRequest$referenceId": "

The reference ID to use for the task. The reference ID can have a maximum length of 1024 characters.

", - "RunTaskRequest$startedBy": "

An optional tag specified when a task is started. For example, if you automatically trigger a task to run a batch process job, you could apply a unique identifier for that job to your task with the startedBy parameter. You can then identify which tasks belong to that job by filtering the results of a ListTasks call with the startedBy value. Up to 36 letters (uppercase and lowercase), numbers, hyphens (-), and underscores (_) are allowed.

If a task is started by an Amazon ECS service, then the startedBy parameter contains the deployment ID of the service that starts it.

", - "RunTaskRequest$taskDefinition": "

The family and revision (family:revision) or full ARN of the task definition to run. If a revision isn't specified, the latest ACTIVE revision is used.

When you create a policy for run-task, you can set the resource to be the latest task definition revision, or a specific revision.

The full ARN value must match the value that you specified as the Resource of the principal's permissions policy.

When you specify the policy resource as the latest task definition version (by setting the Resource in the policy to arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName), then set this value to arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName.

When you specify the policy resource as a specific task definition version (by setting the Resource in the policy to arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1 or arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*), then set this value to arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1.

For more information, see Policy Resources for Amazon ECS in the Amazon Elastic Container Service developer Guide.

", - "Secret$name": "

The name of the secret.

", - "Secret$valueFrom": "

The secret to expose to the container. The supported values are either the full ARN of the Secrets Manager secret or the full ARN of the parameter in the SSM Parameter Store.

For information about the require Identity and Access Management permissions, see Required IAM permissions for Amazon ECS secrets (for Secrets Manager) or Required IAM permissions for Amazon ECS secrets (for Systems Manager Parameter store) in the Amazon Elastic Container Service Developer Guide.

If the SSM Parameter Store parameter exists in the same Region as the task you're launching, then you can use either the full ARN or name of the parameter. If the parameter exists in a different Region, then the full ARN must be specified.

", - "Service$serviceArn": "

The ARN that identifies the service. For more information about the ARN format, see Amazon Resource Name (ARN) in the Amazon ECS Developer Guide.

", - "Service$serviceName": "

The name of your service. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed. Service names must be unique within a cluster. However, you can have similarly named services in multiple clusters within a Region or across multiple Regions.

", - "Service$clusterArn": "

The Amazon Resource Name (ARN) of the cluster that hosts the service.

", - "Service$status": "

The status of the service. The valid values are ACTIVE, DRAINING, or INACTIVE.

", - "Service$platformVersion": "

The platform version to run your service on. A platform version is only specified for tasks that are hosted on Fargate. If one isn't specified, the LATEST platform version is used. For more information, see Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

", - "Service$platformFamily": "

The operating system that your tasks in the service run on. A platform family is specified only for tasks using the Fargate launch type.

All tasks that run as part of this service must use the same platformFamily value as the service (for example, LINUX).

", - "Service$taskDefinition": "

The task definition to use for tasks in the service. This value is specified when the service is created with CreateService, and it can be modified with UpdateService.

", - "Service$roleArn": "

The ARN of the IAM role that's associated with the service. It allows the Amazon ECS container agent to register container instances with an Elastic Load Balancing load balancer.

", - "Service$createdBy": "

The principal that created the service.

", - "Service$runStatus": null, - "ServiceConnectClientAlias$dnsName": "

The dnsName is the name that you use in the applications of client tasks to connect to this service. The name must be a valid DNS name but doesn't need to be fully-qualified. The name can include up to 127 characters. The name can include lowercase letters, numbers, underscores (_), hyphens (-), and periods (.). The name can't start with a hyphen.

If this parameter isn't specified, the default value of discoveryName.namespace is used. If the discoveryName isn't specified, the port mapping name from the task definition is used in portName.namespace.

To avoid changing your applications in client Amazon ECS services, set this to the same name that the client application uses by default. For example, a few common names are database, db, or the lowercase name of a database, such as mysql or redis. For more information, see Service Connect in the Amazon Elastic Container Service Developer Guide.

", - "ServiceConnectConfiguration$namespace": "

The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace for use with Service Connect. The namespace must be in the same Amazon Web Services Region as the Amazon ECS service and cluster. The type of namespace doesn't affect Service Connect. For more information about Cloud Map, see Working with Services in the Cloud Map Developer Guide.

", - "ServiceConnectService$portName": "

The portName must match the name of one of the portMappings from all the containers in the task definition of this Amazon ECS service.

", - "ServiceConnectService$discoveryName": "

The discoveryName is the name of the new Cloud Map service that Amazon ECS creates for this Amazon ECS service. This must be unique within the Cloud Map namespace. The name can contain up to 64 characters. The name can include lowercase letters, numbers, underscores (_), and hyphens (-). The name can't start with a hyphen.

If the discoveryName isn't specified, the port mapping name from the task definition is used in portName.namespace.

", - "ServiceConnectServiceResource$discoveryName": "

The discovery name of this Service Connect resource.

The discoveryName is the name of the new Cloud Map service that Amazon ECS creates for this Amazon ECS service. This must be unique within the Cloud Map namespace. The name can contain up to 64 characters. The name can include lowercase letters, numbers, underscores (_), and hyphens (-). The name can't start with a hyphen.

If the discoveryName isn't specified, the port mapping name from the task definition is used in portName.namespace.

", - "ServiceConnectServiceResource$discoveryArn": "

The Amazon Resource Name (ARN) for the namespace in Cloud Map that matches the discovery name for this Service Connect resource. You can use this ARN in other integrations with Cloud Map. However, Service Connect can't ensure connectivity outside of Amazon ECS.

", - "ServiceConnectTaskConfiguration$namespace": null, - "ServiceConnectTlsCertificateAuthority$awsPcaAuthorityArn": null, - "ServiceConnectTlsConfiguration$kmsKey": null, - "ServiceConnectTlsConfiguration$roleArn": null, - "ServiceEvent$id": "

The ID string for the event.

", - "ServiceEvent$message": "

The event message.

", - "ServiceRegistry$registryArn": "

The Amazon Resource Name (ARN) of the service registry. The currently supported service registry is Cloud Map. For more information, see CreateService.

", - "ServiceRegistry$containerName": "

The container name value to be used for your service discovery service. It's already specified in the task definition. If the task definition that your service task specifies uses the bridge or host network mode, you must specify a containerName and containerPort combination from the task definition. If the task definition that your service task specifies uses the awsvpc network mode and a type SRV DNS record is used, you must specify either a containerName and containerPort combination or a port value. However, you can't specify both.

", - "ServiceTask$availabilityZone": null, - "ServiceTask$capacityProviderName": null, - "ServiceTask$clusterArn": null, - "ServiceTask$containerInstanceArn": null, - "ServiceTask$cpu": null, - "ServiceTask$desiredStatus": null, - "ServiceTask$group": null, - "ServiceTask$lastStatus": null, - "ServiceTask$memory": null, - "ServiceTask$platformFamily": null, - "ServiceTask$platformVersion": null, - "ServiceTask$startedBy": null, - "ServiceTask$stoppedReason": null, - "ServiceTask$taskArn": null, - "ServiceTask$taskDefinitionArn": null, - "ServiceTaskAccountDetail$accountId": null, - "ServiceTaskAccountDetail$credentialProvider": null, - "ServiceTaskAttachment$id": null, - "ServiceTaskAttachment$type": null, - "ServiceTaskAttachment$status": null, - "ServiceTaskAttribute$name": null, - "ServiceTaskAttribute$value": null, - "ServiceTaskAttribute$targetId": null, - "ServiceTaskAwsVpcConfiguration$networkInterfaceOwner": null, - "ServiceTaskAwsVpcConfiguration$networkInterfaceCredential": null, - "ServiceTaskAwsVpcConfiguration$role": null, - "ServiceTaskCapacityProviderStrategyItem$capacityProvider": null, - "ServiceTaskContainer$containerArn": null, - "ServiceTaskContainer$taskArn": null, - "ServiceTaskContainer$name": null, - "ServiceTaskContainer$image": null, - "ServiceTaskContainer$imageDigest": null, - "ServiceTaskContainer$runtimeId": null, - "ServiceTaskContainer$lastStatus": null, - "ServiceTaskContainer$reason": null, - "ServiceTaskContainer$cpu": null, - "ServiceTaskContainer$memory": null, - "ServiceTaskContainer$memoryReservation": null, - "ServiceTaskContainerOverride$name": null, - "ServiceTaskDeploymentReference$taskSetArn": null, - "ServiceTaskDeploymentReference$externalId": null, - "ServiceTaskEBSVolumeConfigurationOverride$snapshotId": null, - "ServiceTaskEBSVolumeConfigurationOverride$volumeId": null, - "ServiceTaskEnvironmentFile$value": null, - "ServiceTaskFailure$arn": null, - "ServiceTaskFailure$detail": null, - "ServiceTaskFailure$reason": null, - "ServiceTaskGpuIds$member": null, - "ServiceTaskInferenceAcceleratorOverride$deviceName": null, - "ServiceTaskInferenceAcceleratorOverride$deviceType": null, - "ServiceTaskInferenceAcceleratorOverride$devicePolicy": null, - "ServiceTaskInterfaceConfiguration$name": null, - "ServiceTaskInterfaceConfiguration$subnet": null, - "ServiceTaskLifecycleHook$arn": null, - "ServiceTaskLifecycleHook$name": null, - "ServiceTaskLifecycleHook$notificationArn": null, - "ServiceTaskLifecycleHook$notificationToken": null, - "ServiceTaskLifecycleHook$outcomeDetail": null, - "ServiceTaskLoadBalancer$loadBalancerName": null, - "ServiceTaskLoadBalancer$targetGroupArn": null, - "ServiceTaskLoadBalancer$targetGroupTargetType": null, - "ServiceTaskLoadBalancer$containerName": null, - "ServiceTaskManagedAgent$reason": null, - "ServiceTaskManagedAgent$lastStatus": null, - "ServiceTaskNetworkBinding$bindIP": null, - "ServiceTaskNetworkBinding$containerPortRange": null, - "ServiceTaskNetworkBinding$hostPortRange": null, - "ServiceTaskNetworkInterface$attachmentId": null, - "ServiceTaskNetworkInterface$privateIpv4Address": null, - "ServiceTaskNetworkInterface$ipv6Address": null, - "ServiceTaskOverride$cpu": null, - "ServiceTaskOverride$executionRoleCredentialProvider": null, - "ServiceTaskOverride$executionRoleArn": null, - "ServiceTaskOverride$memory": null, - "ServiceTaskOverride$taskRoleCredentialProvider": null, - "ServiceTaskOverride$taskRoleArn": null, - "ServiceTaskOverride$collectorSetting": null, - "ServiceTaskOverride$infrastructureBlockDeviceConfig": null, - "ServiceTaskPlacementConstraint$expression": null, - "ServiceTaskPlacementStrategy$field": null, - "ServiceTaskResourceRequirement$value": null, - "ServiceTaskServiceReference$serviceArn": null, - "ServiceTaskServiceRegistry$registryArn": null, - "ServiceTaskServiceRegistry$containerName": null, - "ServiceTaskVolumeOverride$name": null, - "Session$sessionId": "

The ID of the execute command session.

", - "Session$streamUrl": "

A URL to the managed agent on the container that the SSM Session Manager client uses to send commands and receive output from the container.

", - "Setting$value": "

Determines whether the account setting is on or off for the specified resource.

", - "Setting$principalArn": "

The ARN of the principal. It can be a user, role, or the root user. If this field is omitted, the authenticated user is assumed.

", - "SoftwareManifestEntry$name": null, - "SoftwareManifestEntry$serial": null, - "SoftwareManifestEntry$version": null, - "StartTaskRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster where to start your task. If you do not specify a cluster, the default cluster is assumed.

", - "StartTaskRequest$group": "

The name of the task group to associate with the task. The default value is the family name of the task definition (for example, family:my-family-name).

", - "StartTaskRequest$referenceId": "

The reference ID to use for the task.

", - "StartTaskRequest$startedBy": "

An optional tag specified when a task is started. For example, if you automatically trigger a task to run a batch process job, you could apply a unique identifier for that job to your task with the startedBy parameter. You can then identify which tasks belong to that job by filtering the results of a ListTasks call with the startedBy value. Up to 36 letters (uppercase and lowercase), numbers, hyphens (-), and underscores (_) are allowed.

If a task is started by an Amazon ECS service, the startedBy parameter contains the deployment ID of the service that starts it.

", - "StartTaskRequest$taskDefinition": "

The family and revision (family:revision) or full ARN of the task definition to start. If a revision isn't specified, the latest ACTIVE revision is used.

", - "StopTaskRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the task to stop. If you do not specify a cluster, the default cluster is assumed.

", - "StopTaskRequest$task": "

The task ID of the task to stop.

", - "StopTaskRequest$reason": "

An optional message specified when a task is stopped. For example, if you're using a custom scheduler, you can use this parameter to specify the reason for stopping the task here, and the message appears in subsequent DescribeTasks API operations on this task. Up to 255 characters are allowed in this message.

", - "StringList$member": null, - "StringMap$key": null, - "StringMap$value": null, - "SubmitAttachmentStateChangesRequest$cluster": "

The short name or full ARN of the cluster that hosts the container instance the attachment belongs to.

", - "SubmitAttachmentStateChangesResponse$acknowledgment": "

Acknowledgement of the state change.

", - "SubmitContainerStateChangeRequest$cluster": "

The short name or full ARN of the cluster that hosts the container.

", - "SubmitContainerStateChangeRequest$task": "

The task ID or full Amazon Resource Name (ARN) of the task that hosts the container.

", - "SubmitContainerStateChangeRequest$containerName": "

The name of the container.

", - "SubmitContainerStateChangeRequest$runtimeId": "

The ID of the Docker container.

", - "SubmitContainerStateChangeRequest$status": "

The status of the state change request.

", - "SubmitContainerStateChangeRequest$reason": "

The reason for the state change request.

", - "SubmitContainerStateChangeResponse$acknowledgment": "

Acknowledgement of the state change.

", - "SubmitTaskStateChangeRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the task.

", - "SubmitTaskStateChangeRequest$task": "

The task ID or full ARN of the task in the state change request.

", - "SubmitTaskStateChangeRequest$status": "

The status of the state change request.

", - "SubmitTaskStateChangeRequest$reason": "

The reason for the state change request.

", - "SubmitTaskStateChangeResponse$acknowledgment": "

Acknowledgement of the state change.

", - "SystemControl$namespace": "

The namespaced kernel parameter to set a value for.

", - "SystemControl$value": "

The namespaced kernel parameter to set a value for.

Valid IPC namespace values: \"kernel.msgmax\" | \"kernel.msgmnb\" | \"kernel.msgmni\" | \"kernel.sem\" | \"kernel.shmall\" | \"kernel.shmmax\" | \"kernel.shmmni\" | \"kernel.shm_rmid_forced\", and Sysctls that start with \"fs.mqueue.*\"

Valid network namespace values: Sysctls that start with \"net.*\"

All of these values are supported by Fargate.

", - "TagResourceRequest$resourceArn": "

The Amazon Resource Name (ARN) of the resource to add tags to. Currently, the supported resources are Amazon ECS capacity providers, tasks, services, task definitions, clusters, and container instances.

", - "TargetGroupArnList$member": null, - "Task$availabilityZone": "

The Availability Zone for the task.

", - "Task$capacityProviderName": "

The capacity provider that's associated with the task.

", - "Task$clusterArn": "

The ARN of the cluster that hosts the task.

", - "Task$containerInstanceArn": "

The ARN of the container instances that host the task.

", - "Task$cpu": "

The number of CPU units used by the task as expressed in a task definition. It can be expressed as an integer using CPU units (for example, 1024). It can also be expressed as a string using vCPUs (for example, 1 vCPU or 1 vcpu). String values are converted to an integer that indicates the CPU units when the task definition is registered.

If you use the EC2 launch type, this field is optional. Supported values are between 128 CPU units (0.125 vCPUs) and 10240 CPU units (10 vCPUs).

If you use the Fargate launch type, this field is required. You must use one of the following values. These values determine the range of supported values for the memory parameter:

The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate.

", - "Task$desiredStatus": "

The desired status of the task. For more information, see Task Lifecycle.

", - "Task$group": "

The name of the task group that's associated with the task.

", - "Task$lastStatus": "

The last known status for the task. For more information, see Task Lifecycle.

", - "Task$memory": "

The amount of memory (in MiB) that the task uses as expressed in a task definition. It can be expressed as an integer using MiB (for example, 1024). If it's expressed as a string using GB (for example, 1GB or 1 GB), it's converted to an integer indicating the MiB when the task definition is registered.

If you use the EC2 launch type, this field is optional.

If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines the range of supported values for the cpu parameter.

", - "Task$platformFamily": "

The operating system that your tasks are running on. A platform family is specified only for tasks that use the Fargate launch type.

All tasks that run as part of this service must use the same platformFamily value as the service (for example, LINUX.).

", - "Task$platformVersion": "

The platform version where your task runs on. A platform version is only specified for tasks that use the Fargate launch type. If you didn't specify one, the LATEST platform version is used. For more information, see Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

", - "Task$startedBy": "

The tag specified when a task is started. If an Amazon ECS service started the task, the startedBy parameter contains the deployment ID of that service.

", - "Task$stoppedReason": "

The reason that the task was stopped.

", - "Task$taskArn": "

The Amazon Resource Name (ARN) of the task.

", - "Task$taskDefinitionArn": "

The ARN of the task definition that creates the task.

", - "TaskDefinition$taskDefinitionArn": "

The full Amazon Resource Name (ARN) of the task definition.

", - "TaskDefinition$family": "

The name of a family that this task definition is registered to. Up to 255 characters are allowed. Letters (both uppercase and lowercase letters), numbers, hyphens (-), and underscores (_) are allowed.

A family groups multiple versions of a task definition. Amazon ECS gives the first task definition that you registered to a family a revision number of 1. Amazon ECS gives sequential revision numbers to each task definition that you add.

", - "TaskDefinition$taskRoleArn": "

The short name or full Amazon Resource Name (ARN) of the Identity and Access Management role that grants containers in the task permission to call Amazon Web Services APIs on your behalf. For more information, see Amazon ECS Task Role in the Amazon Elastic Container Service Developer Guide.

IAM roles for tasks on Windows require that the -EnableTaskIAMRole option is set when you launch the Amazon ECS-optimized Windows AMI. Your containers must also run some configuration code to use the feature. For more information, see Windows IAM roles for tasks in the Amazon Elastic Container Service Developer Guide.

", - "TaskDefinition$taskRoleCredentialProvider": null, - "TaskDefinition$executionRoleArn": "

The Amazon Resource Name (ARN) of the task execution role that grants the Amazon ECS container agent permission to make Amazon Web Services API calls on your behalf. The task execution IAM role is required depending on the requirements of your task. For more information, see Amazon ECS task execution IAM role in the Amazon Elastic Container Service Developer Guide.

", - "TaskDefinition$executionRoleCredentialProvider": null, - "TaskDefinition$cpu": "

The number of cpu units used by the task. If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the memory parameter.

The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate.

", - "TaskDefinition$memory": "

The amount (in MiB) of memory used by the task.

If your tasks runs on Amazon EC2 instances, you must specify either a task-level memory value or a container-level memory value. This field is optional and any value can be used. If a task-level memory value is specified, the container-level memory value is optional. For more information regarding container-level memory and memory reservation, see ContainerDefinition.

If your tasks runs on Fargate, this field is required. You must use one of the following values. The value you choose determines your range of valid values for the cpu parameter.

", - "TaskDefinition$registeredBy": "

The principal that registered the task definition.

", - "TaskDefinitionNetworkInterface$name": null, - "TaskDefinitionPlacementConstraint$expression": "

A cluster query language expression to apply to the constraint. For more information, see Cluster query language in the Amazon Elastic Container Service Developer Guide.

", - "TaskOverride$cpu": "

The CPU override for the task.

", - "TaskOverride$executionRoleCredentialProvider": null, - "TaskOverride$executionRoleArn": "

The Amazon Resource Name (ARN) of the task execution role override for the task. For more information, see Amazon ECS task execution IAM role in the Amazon Elastic Container Service Developer Guide.

", - "TaskOverride$memory": "

The memory override for the task.

", - "TaskOverride$taskRoleCredentialProvider": null, - "TaskOverride$taskRoleArn": "

The Amazon Resource Name (ARN) of the role that containers in this task can assume. All containers in this task are granted the permissions that are specified in this role. For more information, see IAM Role for Tasks in the Amazon Elastic Container Service Developer Guide.

", - "TaskOverride$collectorSetting": null, - "TaskOverride$infrastructureBlockDeviceConfig": null, - "TaskSet$id": "

The ID of the task set.

", - "TaskSet$taskSetArn": "

The Amazon Resource Name (ARN) of the task set.

", - "TaskSet$serviceArn": "

The Amazon Resource Name (ARN) of the service the task set exists in.

", - "TaskSet$clusterArn": "

The Amazon Resource Name (ARN) of the cluster that the service that hosts the task set exists in.

", - "TaskSet$startedBy": "

The tag specified when a task set is started. If an CodeDeploy deployment created the task set, the startedBy parameter is CODE_DEPLOY. If an external deployment created the task set, the startedBy field isn't used.

", - "TaskSet$externalId": "

The external ID associated with the task set.

If an CodeDeploy deployment created a task set, the externalId parameter contains the CodeDeploy deployment ID.

If a task set is created for an external deployment and is associated with a service discovery registry, the externalId parameter contains the ECS_TASK_SET_EXTERNAL_ID Cloud Map attribute.

", - "TaskSet$status": "

The status of the task set. The following describes each state.

PRIMARY

The task set is serving production traffic.

ACTIVE

The task set isn't serving production traffic.

DRAINING

The tasks in the task set are being stopped, and their corresponding targets are being deregistered from their target group.

", - "TaskSet$taskDefinition": "

The task definition that the task set is using.

", - "TaskSet$platformVersion": "

The Fargate platform version where the tasks in the task set are running. A platform version is only specified for tasks run on Fargate. For more information, see Fargate platform versions in the Amazon Elastic Container Service Developer Guide.

", - "TaskSet$platformFamily": "

The operating system that your tasks in the set are running on. A platform family is specified only for tasks that use the Fargate launch type.

All tasks in the set must have the same value.

", - "Tmpfs$containerPath": "

The absolute file path where the tmpfs volume is to be mounted.

", - "UntagResourceRequest$resourceArn": "

The Amazon Resource Name (ARN) of the resource to delete tags from. Currently, the supported resources are Amazon ECS capacity providers, tasks, services, task definitions, clusters, and container instances.

", - "UpdateCapacityProviderRequest$name": "

The name of the capacity provider to update.

", - "UpdateClusterRequest$cluster": "

The name of the cluster to modify the settings for.

", - "UpdateClusterSettingsRequest$cluster": "

The name of the cluster to modify the settings for.

", - "UpdateContainerAgentRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that your container instance is running on. If you do not specify a cluster, the default cluster is assumed.

", - "UpdateContainerAgentRequest$containerInstance": "

The container instance ID or full ARN entries for the container instance where you would like to update the Amazon ECS container agent.

", - "UpdateContainerInstancesStateRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the container instance to update. If you do not specify a cluster, the default cluster is assumed.

", - "UpdateLifecycleHookExpirationRequest$arn": null, - "UpdateServicePrimaryTaskSetRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service that the task set exists in.

", - "UpdateServicePrimaryTaskSetRequest$service": "

The short name or full Amazon Resource Name (ARN) of the service that the task set exists in.

", - "UpdateServicePrimaryTaskSetRequest$primaryTaskSet": "

The short name or full Amazon Resource Name (ARN) of the task set to set as the primary task set in the deployment.

", - "UpdateServiceRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that your service runs on. If you do not specify a cluster, the default cluster is assumed.

", - "UpdateServiceRequest$platformVersion": "

The platform version that your tasks in the service run on. A platform version is only specified for tasks using the Fargate launch type. If a platform version is not specified, the LATEST platform version is used. For more information, see Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.

", - "UpdateServiceRequest$service": "

The name of the service to update.

", - "UpdateServiceRequest$taskDefinition": "

The family and revision (family:revision) or full ARN of the task definition to run in your service. If a revision is not specified, the latest ACTIVE revision is used. If you modify the task definition with UpdateService, Amazon ECS spawns a task with the new version of the task definition and then stops an old task after the new version is running.

", - "UpdateTaskProtectionRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service that the task sets exist in.

", - "UpdateTaskSetRequest$cluster": "

The short name or full Amazon Resource Name (ARN) of the cluster that hosts the service that the task set is found in.

", - "UpdateTaskSetRequest$service": "

The short name or full Amazon Resource Name (ARN) of the service that the task set is found in.

", - "UpdateTaskSetRequest$taskSet": "

The short name or full Amazon Resource Name (ARN) of the task set to update.

", - "UpdateTaskSetRequest$rolloutStateReason": null, - "VersionInfo$agentVersion": "

The version number of the Amazon ECS container agent.

", - "VersionInfo$agentHash": "

The Git commit hash for the Amazon ECS container agent build on the amazon-ecs-agent GitHub repository.

", - "VersionInfo$dockerVersion": "

The Docker version that's running on the container instance.

", - "Volume$name": "

The name of the volume. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed. This name is referenced in the sourceVolume parameter of container definition mountPoints.

This is required wwhen you use an Amazon EFS volume.

", - "VolumeFrom$sourceContainer": "

The name of another container within the same task definition to mount volumes from.

", - "VolumeOverride$name": null - } - }, - "StringList": { - "base": null, - "refs": { - "AssociateCapacityProvidersWithClusterRequest$capacityProviders": null, - "AwsVpcConfiguration$securityGroups": "

The IDs of the security groups associated with the task or service. If you don't specify a security group, the default security group for the VPC is used. There's a limit of 5 security groups that can be specified per AwsVpcConfiguration.

All specified security groups must be from the same VPC.

", - "AwsVpcConfiguration$subnets": "

The IDs of the subnets associated with the task or service. There's a limit of 16 subnets that can be specified per AwsVpcConfiguration.

All specified subnets must be from the same VPC.

", - "Cluster$capacityProviders": "

The capacity providers associated with the cluster.

", - "ContainerDefinition$links": "

The links parameter allows containers to communicate with each other without the need for port mappings. This parameter is only supported if the network mode of a task definition is bridge. The name:internalName construct is analogous to name:alias in Docker links. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed. For more information about linking Docker containers, go to Legacy container links in the Docker documentation. This parameter maps to Links in the Create a container section of the Docker Remote API and the --link option to docker run.

This parameter is not supported for Windows containers.

Containers that are collocated on a single container instance may be able to communicate with each other without requiring links or host port mappings. Network isolation is achieved on the container instance using security groups and VPC settings.

", - "ContainerDefinition$entryPoint": "

Early versions of the Amazon ECS container agent don't properly handle entryPoint parameters. If you have problems using entryPoint, update your container agent or enter your commands and arguments as command array items instead.

The entry point that's passed to the container. This parameter maps to Entrypoint in the Create a container section of the Docker Remote API and the --entrypoint option to docker run. For more information, see https://docs.docker.com/engine/reference/builder/#entrypoint.

", - "ContainerDefinition$command": "

The command that's passed to the container. This parameter maps to Cmd in the Create a container section of the Docker Remote API and the COMMAND parameter to docker run. For more information, see https://docs.docker.com/engine/reference/builder/#cmd. If there are multiple arguments, each argument is a separated string in the array.

", - "ContainerDefinition$inferenceDevices": null, - "ContainerDefinition$networkInterfaceNames": null, - "ContainerDefinition$dnsServers": "

A list of DNS servers that are presented to the container. This parameter maps to Dns in the Create a container section of the Docker Remote API and the --dns option to docker run.

This parameter is not supported for Windows containers.

", - "ContainerDefinition$dnsSearchDomains": "

A list of DNS search domains that are presented to the container. This parameter maps to DnsSearch in the Create a container section of the Docker Remote API and the --dns-search option to docker run.

This parameter is not supported for Windows containers.

", - "ContainerDefinition$dockerSecurityOptions": "

A list of strings to provide custom configuration for multiple security systems. For more information about valid values, see Docker Run Security Configuration. This field isn't valid for containers in tasks using the Fargate launch type.

For Linux tasks on EC2, this parameter can be used to reference custom labels for SELinux and AppArmor multi-level security systems.

For any tasks on EC2, this parameter can be used to reference a credential spec file that configures a container for Active Directory authentication. For more information, see Using gMSAs for Windows Containers and Using gMSAs for Linux Containers in the Amazon Elastic Container Service Developer Guide.

This parameter maps to SecurityOpt in the Create a container section of the Docker Remote API and the --security-opt option to docker run.

The Amazon ECS container agent running on a container instance must register with the ECS_SELINUX_CAPABLE=true or ECS_APPARMOR_CAPABLE=true environment variables before containers placed on that instance can use these security options. For more information, see Amazon ECS Container Agent Configuration in the Amazon Elastic Container Service Developer Guide.

For more information about valid values, see Docker Run Security Configuration.

Valid values: \"no-new-privileges\" | \"apparmor:PROFILE\" | \"label:value\" | \"credentialspec:CredentialSpecFilePath\"

", - "ContainerDefinition$credentialSpecs": "

A list of ARNs in SSM or Amazon S3 to a credential spec (CredSpec) file that configures the container for Active Directory authentication. We recommend that you use this parameter instead of the dockerSecurityOptions. The maximum number of ARNs is 1.

There are two formats for each ARN.

credentialspecdomainless:MyARN

You use credentialspecdomainless:MyARN to provide a CredSpec with an additional section for a secret in Secrets Manager. You provide the login credentials to the domain in the secret.

Each task that runs on any container instance can join different domains.

You can use this format without joining the container instance to a domain.

credentialspec:MyARN

You use credentialspec:MyARN to provide a CredSpec for a single domain.

You must join the container instance to the domain before you start any tasks that use this task definition.

In both formats, replace MyARN with the ARN in SSM or Amazon S3.

If you provide a credentialspecdomainless:MyARN, the credspec must provide a ARN in Secrets Manager for a secret containing the username, password, and the domain to connect to. For better security, the instance isn't joined to the domain for domainless authentication. Other applications on the instance can't use the domainless credentials. You can use this parameter to run tasks on the same instance, even it the tasks need to join different domains. For more information, see Using gMSAs for Windows Containers and Using gMSAs for Linux Containers.

", - "ContainerOverride$command": "

The command to send to the container that overrides the default command from the Docker image or the task definition. You must also specify a container name.

", - "CreateClusterRequest$capacityProviders": "

The short name of one or more capacity providers to associate with the cluster. A capacity provider must be associated with a cluster before it can be included as part of the default capacity provider strategy of the cluster or used in a capacity provider strategy when calling the CreateService or RunTask actions.

If specifying a capacity provider that uses an Auto Scaling group, the capacity provider must be created but not associated with another cluster. New Auto Scaling group capacity providers can be created with the CreateCapacityProvider API operation.

To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT capacity providers. The Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used.

The PutCapacityProvider API operation is used to update the list of available capacity providers for a cluster after the cluster is created.

", - "DeleteTaskDefinitionsRequest$taskDefinitions": "

The family and revision (family:revision) or full Amazon Resource Name (ARN) of the task definition to delete. You must specify a revision.

You can specify up to 10 task definitions as a comma separated list.

", - "DeploymentAlarms$alarmNames": "

One or more CloudWatch alarm names. Use a \",\" to separate the alarms.

", - "DescribeCapacityProvidersRequest$capacityProviders": "

The short name or full Amazon Resource Name (ARN) of one or more capacity providers. Up to 100 capacity providers can be described in an action.

", - "DescribeClusterCapacityProviderAssociationsRequest$capacityProviders": null, - "DescribeClustersRequest$clusters": "

A list of up to 100 cluster names or full cluster Amazon Resource Name (ARN) entries. If you do not specify a cluster, the default cluster is assumed.

", - "DescribeContainerInstancesRequest$containerInstances": "

A list of up to 100 container instance IDs or full Amazon Resource Name (ARN) entries.

", - "DescribeServicesRequest$services": "

A list of services to describe. You may specify up to 10 services to describe in a single operation.

", - "DescribeTaskSetsRequest$taskSets": "

The ID or full Amazon Resource Name (ARN) of task sets to describe.

", - "DescribeTasksRequest$tasks": "

A list of up to 100 task IDs or full ARN entries.

", - "DisassociateCapacityProvidersFromClusterRequest$capacityProviders": null, - "GetTaskProtectionRequest$tasks": "

A list of up to 100 task IDs or full ARN entries.

", - "HealthCheck$command": "

A string array representing the command that the container runs to determine if it is healthy. The string array must start with CMD to run the command arguments directly, or CMD-SHELL to run the command with the container's default shell.

When you use the Amazon Web Services Management Console JSON panel, the Command Line Interface, or the APIs, enclose the list of commands in double quotes and brackets.

[ \"CMD-SHELL\", \"curl -f http://localhost/ || exit 1\" ]

You don't include the double quotes and brackets when you use the Amazon Web Services Management Console.

CMD-SHELL, curl -f http://localhost/ || exit 1

An exit code of 0 indicates success, and non-zero exit code indicates failure. For more information, see HealthCheck in the Create a container section of the Docker Remote API.

", - "KernelCapabilities$add": "

The Linux capabilities for the container that have been added to the default configuration provided by Docker. This parameter maps to CapAdd in the Create a container section of the Docker Remote API and the --cap-add option to docker run.

Tasks launched on Fargate only support adding the SYS_PTRACE kernel capability.

Valid values: \"ALL\" | \"AUDIT_CONTROL\" | \"AUDIT_WRITE\" | \"BLOCK_SUSPEND\" | \"CHOWN\" | \"DAC_OVERRIDE\" | \"DAC_READ_SEARCH\" | \"FOWNER\" | \"FSETID\" | \"IPC_LOCK\" | \"IPC_OWNER\" | \"KILL\" | \"LEASE\" | \"LINUX_IMMUTABLE\" | \"MAC_ADMIN\" | \"MAC_OVERRIDE\" | \"MKNOD\" | \"NET_ADMIN\" | \"NET_BIND_SERVICE\" | \"NET_BROADCAST\" | \"NET_RAW\" | \"SETFCAP\" | \"SETGID\" | \"SETPCAP\" | \"SETUID\" | \"SYS_ADMIN\" | \"SYS_BOOT\" | \"SYS_CHROOT\" | \"SYS_MODULE\" | \"SYS_NICE\" | \"SYS_PACCT\" | \"SYS_PTRACE\" | \"SYS_RAWIO\" | \"SYS_RESOURCE\" | \"SYS_TIME\" | \"SYS_TTY_CONFIG\" | \"SYSLOG\" | \"WAKE_ALARM\"

", - "KernelCapabilities$drop": "

The Linux capabilities for the container that have been removed from the default configuration provided by Docker. This parameter maps to CapDrop in the Create a container section of the Docker Remote API and the --cap-drop option to docker run.

Valid values: \"ALL\" | \"AUDIT_CONTROL\" | \"AUDIT_WRITE\" | \"BLOCK_SUSPEND\" | \"CHOWN\" | \"DAC_OVERRIDE\" | \"DAC_READ_SEARCH\" | \"FOWNER\" | \"FSETID\" | \"IPC_LOCK\" | \"IPC_OWNER\" | \"KILL\" | \"LEASE\" | \"LINUX_IMMUTABLE\" | \"MAC_ADMIN\" | \"MAC_OVERRIDE\" | \"MKNOD\" | \"NET_ADMIN\" | \"NET_BIND_SERVICE\" | \"NET_BROADCAST\" | \"NET_RAW\" | \"SETFCAP\" | \"SETGID\" | \"SETPCAP\" | \"SETUID\" | \"SYS_ADMIN\" | \"SYS_BOOT\" | \"SYS_CHROOT\" | \"SYS_MODULE\" | \"SYS_NICE\" | \"SYS_PACCT\" | \"SYS_PTRACE\" | \"SYS_RAWIO\" | \"SYS_RESOURCE\" | \"SYS_TIME\" | \"SYS_TTY_CONFIG\" | \"SYSLOG\" | \"WAKE_ALARM\"

", - "ListClustersResponse$clusterArns": "

The list of full Amazon Resource Name (ARN) entries for each cluster that's associated with your account.

", - "ListContainerInstancesResponse$containerInstanceArns": "

The list of container instances with full ARN entries for each container instance associated with the specified cluster.

", - "ListServicesByNamespaceResponse$serviceArns": "

The list of full ARN entries for each service that's associated with the specified namespace.

", - "ListServicesResponse$serviceArns": "

The list of full ARN entries for each service that's associated with the specified cluster.

", - "ListTaskDefinitionFamiliesResponse$families": "

The list of task definition family names that match the ListTaskDefinitionFamilies request.

", - "ListTaskDefinitionsResponse$taskDefinitionArns": "

The list of task definition Amazon Resource Name (ARN) entries for the ListTaskDefinitions request.

", - "ListTasksResponse$taskArns": "

The list of task ARN entries for the ListTasks request.

", - "PutClusterCapacityProvidersRequest$capacityProviders": "

The name of one or more capacity providers to associate with the cluster.

If specifying a capacity provider that uses an Auto Scaling group, the capacity provider must already be created. New capacity providers can be created with the CreateCapacityProvider API operation.

To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT capacity providers. The Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used.

", - "Resource$stringSetValue": "

When the stringSetValue type is set, the value of the resource must be a string type.

", - "ServiceTaskAwsVpcConfiguration$securityGroups": null, - "ServiceTaskAwsVpcConfiguration$subnets": null, - "ServiceTaskContainerOverride$command": null, - "ServiceTaskInterfaceConfiguration$securityGroups": null, - "ServiceTaskInterfaceConfiguration$subnets": null, - "StartTaskRequest$containerInstances": "

The container instance IDs or full ARN entries for the container instances where you would like to place your task. You can specify up to 10 container instances.

", - "Tmpfs$mountOptions": "

The list of tmpfs volume mount options.

Valid values: \"defaults\" | \"ro\" | \"rw\" | \"suid\" | \"nosuid\" | \"dev\" | \"nodev\" | \"exec\" | \"noexec\" | \"sync\" | \"async\" | \"dirsync\" | \"remount\" | \"mand\" | \"nomand\" | \"atime\" | \"noatime\" | \"diratime\" | \"nodiratime\" | \"bind\" | \"rbind\" | \"unbindable\" | \"runbindable\" | \"private\" | \"rprivate\" | \"shared\" | \"rshared\" | \"slave\" | \"rslave\" | \"relatime\" | \"norelatime\" | \"strictatime\" | \"nostrictatime\" | \"mode\" | \"uid\" | \"gid\" | \"nr_inodes\" | \"nr_blocks\" | \"mpol\"

", - "UpdateContainerInstancesStateRequest$containerInstances": "

A list of up to 10 container instance IDs or full ARN entries.

", - "UpdateTaskProtectionRequest$tasks": "

A list of up to 10 task IDs or full ARN entries.

" - } - }, - "StringMap": { - "base": null, - "refs": { - "DockerVolumeConfiguration$driverOpts": "

A map of Docker driver-specific options passed through. This parameter maps to DriverOpts in the Create a volume section of the Docker Remote API and the xxopt option to docker volume create.

", - "DockerVolumeConfiguration$labels": "

Custom metadata to add to your Docker volume. This parameter maps to Labels in the Create a volume section of the Docker Remote API and the xxlabel option to docker volume create.

", - "ServiceTaskInterfaceConfiguration$options": null, - "TaskDefinitionNetworkInterface$options": null - } - }, - "SubmitAttachmentStateChangesRequest": { - "base": null, - "refs": { - } - }, - "SubmitAttachmentStateChangesResponse": { - "base": null, - "refs": { - } - }, - "SubmitContainerStateChangeRequest": { - "base": null, - "refs": { - } - }, - "SubmitContainerStateChangeResponse": { - "base": null, - "refs": { - } - }, - "SubmitTaskStateChangeRequest": { - "base": null, - "refs": { - } - }, - "SubmitTaskStateChangeResponse": { - "base": null, - "refs": { - } - }, - "SystemControl": { - "base": "

A list of namespaced kernel parameters to set in the container. This parameter maps to Sysctls in the Create a container section of the Docker Remote API and the --sysctl option to docker run.

We don't recommend that you specify network-related systemControls parameters for multiple containers in a single task. This task also uses either the awsvpc or host network mode. It does it for the following reasons.

", - "refs": { - "SystemControls$member": null - } - }, - "SystemControls": { - "base": null, - "refs": { - "ContainerDefinition$systemControls": "

A list of namespaced kernel parameters to set in the container. This parameter maps to Sysctls in the Create a container section of the Docker Remote API and the --sysctl option to docker run. For example, you can configure net.ipv4.tcp_keepalive_time setting to maintain longer lived connections.

We don't recommended that you specify network-related systemControls parameters for multiple containers in a single task that also uses either the awsvpc or host network modes. For tasks that use the awsvpc network mode, the container that's started last determines which systemControls parameters take effect. For tasks that use the host network mode, it changes the container instance's namespaced kernel parameters as well as the containers.

This parameter is not supported for Windows containers.

This parameter is only supported for tasks that are hosted on Fargate if the tasks are using platform version 1.4.0 or later (Linux). This isn't supported for Windows containers on Fargate.

" - } - }, - "Tag": { - "base": "

The metadata that you apply to a resource to help you categorize and organize them. Each tag consists of a key and an optional value. You define them.

The following basic restrictions apply to tags:

", - "refs": { - "Tags$member": null - } - }, - "TagKey": { - "base": null, - "refs": { - "Tag$key": "

One part of a key-value pair that make up a tag. A key is a general label that acts like a category for more specific tag values.

", - "TagKeys$member": null - } - }, - "TagKeys": { - "base": null, - "refs": { - "UntagResourceRequest$tagKeys": "

The keys of the tags to be removed.

" - } - }, - "TagResourceRequest": { - "base": null, - "refs": { - } - }, - "TagResourceResponse": { - "base": null, - "refs": { - } - }, - "TagValue": { - "base": null, - "refs": { - "Tag$value": "

The optional part of a key-value pair that make up a tag. A value acts as a descriptor within a tag category (key).

" - } - }, - "Tags": { - "base": null, - "refs": { - "CapacityProvider$tags": "

The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

", - "Cluster$tags": "

The metadata that you apply to the cluster to help you categorize and organize them. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

", - "ContainerInstance$tags": "

The metadata that you apply to the container instance to help you categorize and organize them. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

", - "CreateCapacityProviderRequest$tags": "

The metadata that you apply to the capacity provider to categorize and organize them more conveniently. Each tag consists of a key and an optional value. You define both of them.

The following basic restrictions apply to tags:

", - "CreateClusterRequest$tags": "

The metadata that you apply to the cluster to help you categorize and organize them. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

", - "CreateServiceRequest$tags": "

The metadata that you apply to the service to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. When a service is deleted, the tags are deleted as well.

The following basic restrictions apply to tags:

", - "CreateTaskSetRequest$tags": "

The metadata that you apply to the task set to help you categorize and organize them. Each tag consists of a key and an optional value. You define both. When a service is deleted, the tags are deleted.

The following basic restrictions apply to tags:

", - "DescribeTaskDefinitionResponse$tags": "

The metadata that's applied to the task definition to help you categorize and organize them. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

", - "EBSTagSpecification$tags": null, - "EBSVolumeConfiguration$volumeTags": null, - "EBSVolumeConfigurationOverride$volumeTags": null, - "ListTagsForResourceResponse$tags": "

The tags for the resource.

", - "RegisterContainerInstanceRequest$tags": "

The metadata that you apply to the container instance to help you categorize and organize them. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

", - "RegisterTaskDefinitionRequest$tags": "

The metadata that you apply to the task definition to help you categorize and organize them. Each tag consists of a key and an optional value. You define both of them.

The following basic restrictions apply to tags:

", - "RegisterTaskDefinitionResponse$tags": "

The list of tags associated with the task definition.

", - "RunTaskRequest$tags": "

The metadata that you apply to the task to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.

The following basic restrictions apply to tags:

", - "Service$tags": "

The metadata that you apply to the service to help you categorize and organize them. Each tag consists of a key and an optional value. You define bot the key and value.

The following basic restrictions apply to tags:

", - "StartTaskRequest$tags": "

The metadata that you apply to the task to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.

The following basic restrictions apply to tags:

", - "TagResourceRequest$tags": "

The tags to add to the resource. A tag is an array of key-value pairs.

The following basic restrictions apply to tags:

", - "Task$tags": "

The metadata that you apply to the task to help you categorize and organize the task. Each tag consists of a key and an optional value. You define both the key and value.

The following basic restrictions apply to tags:

", - "TaskSet$tags": "

The metadata that you apply to the task set to help you categorize and organize them. Each tag consists of a key and an optional value. You define both.

The following basic restrictions apply to tags:

" - } - }, - "TargetGroupArnList": { - "base": null, - "refs": { - "LoadBalancerConfiguration$targetGroupArns": null - } - }, - "TargetNotConnectedException": { - "base": "

The execute command cannot run. This error can be caused by any of the following configuration issues:

For information about how to troubleshoot the issues, see Troubleshooting issues with ECS Exec in the Amazon Elastic Container Service Developer Guide.

", - "refs": { - } - }, - "TargetNotFoundException": { - "base": "

The specified target wasn't found. You can view your available container instances with ListContainerInstances. Amazon ECS container instances are cluster-specific and Region-specific.

", - "refs": { - } - }, - "TargetType": { - "base": null, - "refs": { - "Attribute$targetType": "

The type of the target to attach the attribute with. This parameter is required if you use the short form ID for a resource instead of the full ARN.

", - "ListAttributesRequest$targetType": "

The type of the target to list attributes with.

" - } - }, - "Task": { - "base": "

Details on a task in a cluster.

", - "refs": { - "StopTaskResponse$task": "

The task that was stopped.

", - "Tasks$member": null - } - }, - "TaskDefinition": { - "base": "

The details of a task definition which describes the container and volume definitions of an Amazon Elastic Container Service task. You can specify which Docker images to use, the required resources, and other configurations related to launching the task definition through an Amazon ECS service or task.

", - "refs": { - "DeregisterTaskDefinitionResponse$taskDefinition": "

The full description of the deregistered task.

", - "DescribeTaskDefinitionResponse$taskDefinition": "

The full task definition description.

", - "RegisterTaskDefinitionResponse$taskDefinition": "

The full description of the registered task definition.

", - "TaskDefinitionList$member": null - } - }, - "TaskDefinitionDeleteStatus": { - "base": null, - "refs": { - "TaskDefinition$deleteStatus": null - } - }, - "TaskDefinitionFamilyStatus": { - "base": null, - "refs": { - "ListTaskDefinitionFamiliesRequest$status": "

The task definition family status to filter the ListTaskDefinitionFamilies results with. By default, both ACTIVE and INACTIVE task definition families are listed. If this parameter is set to ACTIVE, only task definition families that have an ACTIVE task definition revision are returned. If this parameter is set to INACTIVE, only task definition families that do not have any ACTIVE task definition revisions are returned. If you paginate the resulting output, be sure to keep the status value constant in each subsequent request.

" - } - }, - "TaskDefinitionField": { - "base": null, - "refs": { - "TaskDefinitionFieldList$member": null - } - }, - "TaskDefinitionFieldList": { - "base": null, - "refs": { - "DescribeTaskDefinitionRequest$include": "

Determines whether to see the resource tags for the task definition. If TAGS is specified, the tags are included in the response. If this field is omitted, tags aren't included in the response.

" - } - }, - "TaskDefinitionList": { - "base": null, - "refs": { - "DeleteTaskDefinitionsResponse$taskDefinitions": "

The list of deleted task definitions.

" - } - }, - "TaskDefinitionNetworkInterface": { - "base": null, - "refs": { - "TaskDefinitionNetworkInterfaces$member": null - } - }, - "TaskDefinitionNetworkInterfaces": { - "base": null, - "refs": { - "RegisterTaskDefinitionRequest$networkInterfaces": null, - "TaskDefinition$networkInterfaces": null - } - }, - "TaskDefinitionPlacementConstraint": { - "base": "

The constraint on task placement in the task definition. For more information, see Task placement constraints in the Amazon Elastic Container Service Developer Guide.

Task placement constraints aren't supported for tasks run on Fargate.

", - "refs": { - "TaskDefinitionPlacementConstraints$member": null - } - }, - "TaskDefinitionPlacementConstraintType": { - "base": null, - "refs": { - "TaskDefinitionPlacementConstraint$type": "

The type of constraint. The MemberOf constraint restricts selection to be from a group of valid candidates.

" - } - }, - "TaskDefinitionPlacementConstraints": { - "base": null, - "refs": { - "RegisterTaskDefinitionRequest$placementConstraints": "

An array of placement constraint objects to use for the task. You can specify a maximum of 10 constraints for each task. This limit includes constraints in the task definition and those specified at runtime.

", - "TaskDefinition$placementConstraints": "

An array of placement constraint objects to use for tasks.

This parameter isn't supported for tasks run on Fargate.

" - } - }, - "TaskDefinitionStatus": { - "base": null, - "refs": { - "ListTaskDefinitionsRequest$status": "

The task definition status to filter the ListTaskDefinitions results with. By default, only ACTIVE task definitions are listed. By setting this parameter to INACTIVE, you can view task definitions that are INACTIVE as long as an active task or service still references them. If you paginate the resulting output, be sure to keep the status value constant in each subsequent request.

", - "TaskDefinition$status": "

The status of the task definition.

", - "TaskDefinition$previousStatus": null - } - }, - "TaskField": { - "base": null, - "refs": { - "TaskFieldList$member": null - } - }, - "TaskFieldList": { - "base": null, - "refs": { - "DescribeTasksRequest$include": "

Specifies whether you want to see the resource tags for the task. If TAGS is specified, the tags are included in the response. If this field is omitted, tags aren't included in the response.

" - } - }, - "TaskFilesystemType": { - "base": null, - "refs": { - "ServiceManagedEBSVolumeConfiguration$filesystemType": null, - "TaskManagedEBSVolumeConfiguration$filesystemType": null - } - }, - "TaskManagedEBSVolumeConfiguration": { - "base": null, - "refs": { - "TaskVolumeConfiguration$managedEBSVolume": null - } - }, - "TaskManagedEBSVolumeTerminationPolicy": { - "base": null, - "refs": { - "TaskManagedEBSVolumeConfiguration$terminationPolicy": null - } - }, - "TaskOverride": { - "base": "

The overrides that are associated with a task.

", - "refs": { - "RunTaskRequest$overrides": "

A list of container overrides in JSON format that specify the name of a container in the specified task definition and the overrides it should receive. You can override the default command for a container (that's specified in the task definition or Docker image) with a command override. You can also override existing environment variables (that are specified in the task definition or Docker image) on a container or add new environment variables to it with an environment override.

A total of 8192 characters are allowed for overrides. This limit includes the JSON formatting characters of the override structure.

", - "StartTaskRequest$overrides": "

A list of container overrides in JSON format that specify the name of a container in the specified task definition and the overrides it receives. You can override the default command for a container (that's specified in the task definition or Docker image) with a command override. You can also override existing environment variables (that are specified in the task definition or Docker image) on a container or add new environment variables to it with an environment override.

A total of 8192 characters are allowed for overrides. This limit includes the JSON formatting characters of the override structure.

", - "Task$overrides": "

One or more container overrides.

" - } - }, - "TaskSet": { - "base": "

Information about a set of Amazon ECS tasks in either an CodeDeploy or an EXTERNAL deployment. An Amazon ECS task set includes details such as the desired number of tasks, how many tasks are running, and whether the task set serves production traffic.

", - "refs": { - "CreateTaskSetResponse$taskSet": "

Information about a set of Amazon ECS tasks in either an CodeDeploy or an EXTERNAL deployment. A task set includes details such as the desired number of tasks, how many tasks are running, and whether the task set serves production traffic.

", - "DeleteTaskSetResponse$taskSet": "

Details about the task set.

", - "TaskSets$member": null, - "UpdateServicePrimaryTaskSetResponse$taskSet": "

The details about the task set.

", - "UpdateTaskSetResponse$taskSet": "

Details about the task set.

" - } - }, - "TaskSetField": { - "base": null, - "refs": { - "TaskSetFieldList$member": null - } - }, - "TaskSetFieldList": { - "base": null, - "refs": { - "DescribeTaskSetsRequest$include": "

Specifies whether to see the resource tags for the task set. If TAGS is specified, the tags are included in the response. If this field is omitted, tags aren't included in the response.

" - } - }, - "TaskSetNotFoundException": { - "base": "

The specified task set wasn't found. You can view your available task sets with DescribeTaskSets. Task sets are specific to each cluster, service and Region.

", - "refs": { - } - }, - "TaskSets": { - "base": null, - "refs": { - "DeploymentV2$taskSets": null, - "DescribeTaskSetsResponse$taskSets": "

The list of task sets described.

", - "Service$taskSets": "

Information about a set of Amazon ECS tasks in either an CodeDeploy or an EXTERNAL deployment. An Amazon ECS task set includes details such as the desired number of tasks, how many tasks are running, and whether the task set serves production traffic.

" - } - }, - "TaskStatus": { - "base": null, - "refs": { - "TaskStatuses$member": null - } - }, - "TaskStatuses": { - "base": null, - "refs": { - "ListTasksRequest$lastStatuses": null - } - }, - "TaskStopCode": { - "base": null, - "refs": { - "Task$stopCode": "

The stop code indicating why a task was stopped. The stoppedReason might contain additional details.

For more information about stop code, see Stopped tasks error codes in the Amazon ECS User Guide.

The following are valid values:

" - } - }, - "TaskVolumeConfiguration": { - "base": null, - "refs": { - "TaskVolumeConfigurations$member": null - } - }, - "TaskVolumeConfigurations": { - "base": null, - "refs": { - "RunTaskRequest$volumeConfigurations": null, - "StartTaskRequest$volumeConfigurations": null - } - }, - "Tasks": { - "base": null, - "refs": { - "DescribeTasksResponse$tasks": "

The list of tasks.

", - "RunTaskResponse$tasks": "

A full description of the tasks that were run. The tasks that were successfully placed on your cluster are described here.

", - "StartTaskResponse$tasks": "

A full description of the tasks that were started. Each task that was successfully placed on your container instances is described.

" - } - }, - "TimeoutConfiguration": { - "base": null, - "refs": { - "ServiceConnectService$timeout": null - } - }, - "Timestamp": { - "base": null, - "refs": { - "ContainerInstance$statusUpdatedAt": null, - "ContainerInstance$registeredAt": "

The Unix timestamp for the time when the container instance was registered.

", - "Deployment$createdAt": "

The Unix timestamp for the time when the service deployment was created.

", - "Deployment$updatedAt": "

The Unix timestamp for the time when the service deployment was last updated.

", - "DeploymentV2$startedAt": null, - "DeploymentV2$updatedAt": null, - "InstanceHealthCheckResult$lastUpdated": "

The Unix timestamp for when the container instance health status was last updated.

", - "InstanceHealthCheckResult$lastStatusChange": "

The Unix timestamp for when the container instance health status last changed.

", - "LifecycleHook$activeAt": null, - "LifecycleHook$completedAt": null, - "LifecycleHook$expiresAt": null, - "ManagedAgent$lastStartedAt": "

The Unix timestamp for the time when the managed agent was last started.

", - "ProtectedTask$expirationDate": "

The epoch time when protection for the task will expire.

", - "Service$createdAt": "

The Unix timestamp for the time when the service was created.

", - "ServiceEvent$createdAt": "

The Unix timestamp for the time when the event was triggered.

", - "ServiceTask$connectivityAt": null, - "ServiceTask$createdAt": null, - "ServiceTask$executionStoppedAt": null, - "ServiceTask$pullStartedAt": null, - "ServiceTask$pullStoppedAt": null, - "ServiceTask$startedAt": null, - "ServiceTask$stoppedAt": null, - "ServiceTask$stoppingAt": null, - "ServiceTask$replaceBy": null, - "ServiceTaskLifecycleHook$activeAt": null, - "ServiceTaskLifecycleHook$completedAt": null, - "ServiceTaskLifecycleHook$expiresAt": null, - "ServiceTaskManagedAgent$lastStartedAt": null, - "SubmitTaskStateChangeRequest$pullStartedAt": "

The Unix timestamp for the time when the container image pull started.

", - "SubmitTaskStateChangeRequest$pullStoppedAt": "

The Unix timestamp for the time when the container image pull completed.

", - "SubmitTaskStateChangeRequest$executionStoppedAt": "

The Unix timestamp for the time when the task execution stopped.

", - "Task$connectivityAt": "

The Unix timestamp for the time when the task last went into CONNECTED status.

", - "Task$createdAt": "

The Unix timestamp for the time when the task was created. More specifically, it's for the time when the task entered the PENDING state.

", - "Task$executionStoppedAt": "

The Unix timestamp for the time when the task execution stopped.

", - "Task$pullStartedAt": "

The Unix timestamp for the time when the container image pull began.

", - "Task$pullStoppedAt": "

The Unix timestamp for the time when the container image pull completed.

", - "Task$startedAt": "

The Unix timestamp for the time when the task started. More specifically, it's for the time when the task transitioned from the PENDING state to the RUNNING state.

", - "Task$stoppedAt": "

The Unix timestamp for the time when the task was stopped. More specifically, it's for the time when the task transitioned from the RUNNING state to the STOPPED state.

", - "Task$stoppingAt": "

The Unix timestamp for the time when the task stops. More specifically, it's for the time when the task transitions from the RUNNING state to STOPPING.

", - "TaskDefinition$registeredAt": "

The Unix timestamp for the time when the task definition was registered.

", - "TaskDefinition$deregisteredAt": "

The Unix timestamp for the time when the task definition was deregistered.

", - "TaskSet$createdAt": "

The Unix timestamp for the time when the task set was created.

", - "TaskSet$updatedAt": "

The Unix timestamp for the time when the task set was last updated.

", - "TaskSet$stabilityStatusAt": "

The Unix timestamp for the time when the task set stability status was retrieved.

" - } - }, - "Tmpfs": { - "base": "

The container path, mount options, and size of the tmpfs mount.

", - "refs": { - "TmpfsList$member": null - } - }, - "TmpfsList": { - "base": null, - "refs": { - "LinuxParameters$tmpfs": "

The container path, mount options, and size (in MiB) of the tmpfs mount. This parameter maps to the --tmpfs option to docker run.

If you're using tasks that use the Fargate launch type, the tmpfs parameter isn't supported.

" - } - }, - "TransportProtocol": { - "base": null, - "refs": { - "NetworkBinding$protocol": "

The protocol used for the network binding.

", - "PortMapping$protocol": "

The protocol used for the port mapping. Valid values are tcp and udp. The default is tcp.

" - } - }, - "Ulimit": { - "base": "

The ulimit settings to pass to the container.

Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 4096.

You can specify the ulimit settings for a container in a task definition.

", - "refs": { - "UlimitList$member": null - } - }, - "UlimitList": { - "base": null, - "refs": { - "ContainerDefinition$ulimits": "

A list of ulimits to set in the container. If a ulimit value is specified in a task definition, it overrides the default values set by Docker. This parameter maps to Ulimits in the Create a container section of the Docker Remote API and the --ulimit option to docker run. Valid naming values are displayed in the Ulimit data type.

Amazon ECS tasks hosted on Fargate use the default resource limit values set by the operating system with the exception of the nofile resource limit parameter which Fargate overrides. The nofile resource limit sets a restriction on the number of open files that a container can use. The default nofile soft limit is 1024 and the default hard limit is 4096.

This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: sudo docker version --format '{{.Server.APIVersion}}'

This parameter is not supported for Windows containers.

" - } - }, - "UlimitName": { - "base": null, - "refs": { - "Ulimit$name": "

The type of the ulimit.

" - } - }, - "UnsupportedFeatureException": { - "base": "

The specified task isn't supported in this Region.

", - "refs": { - } - }, - "UntagResourceRequest": { - "base": null, - "refs": { - } - }, - "UntagResourceResponse": { - "base": null, - "refs": { - } - }, - "UpdateCapacityProviderRequest": { - "base": null, - "refs": { - } - }, - "UpdateCapacityProviderResponse": { - "base": null, - "refs": { - } - }, - "UpdateClusterRequest": { - "base": null, - "refs": { - } - }, - "UpdateClusterResponse": { - "base": null, - "refs": { - } - }, - "UpdateClusterSettingsRequest": { - "base": null, - "refs": { - } - }, - "UpdateClusterSettingsResponse": { - "base": null, - "refs": { - } - }, - "UpdateContainerAgentRequest": { - "base": null, - "refs": { - } - }, - "UpdateContainerAgentResponse": { - "base": null, - "refs": { - } - }, - "UpdateContainerInstancesStateRequest": { - "base": null, - "refs": { - } - }, - "UpdateContainerInstancesStateResponse": { - "base": null, - "refs": { - } - }, - "UpdateInProgressException": { - "base": "

There's already a current Amazon ECS container agent update in progress on the container instance that's specified. If the container agent becomes disconnected while it's in a transitional stage, such as PENDING or STAGING, the update process can get stuck in that state. However, when the agent reconnects, it resumes where it stopped previously.

", - "refs": { - } - }, - "UpdateLifecycleHookExpirationRequest": { - "base": null, - "refs": { - } - }, - "UpdateLifecycleHookExpirationResponse": { - "base": null, - "refs": { - } - }, - "UpdateServicePrimaryTaskSetRequest": { - "base": null, - "refs": { - } - }, - "UpdateServicePrimaryTaskSetResponse": { - "base": null, - "refs": { - } - }, - "UpdateServiceRequest": { - "base": null, - "refs": { - } - }, - "UpdateServiceResponse": { - "base": null, - "refs": { - } - }, - "UpdateTaskProtectionRequest": { - "base": null, - "refs": { - } - }, - "UpdateTaskProtectionResponse": { - "base": null, - "refs": { - } - }, - "UpdateTaskSetRequest": { - "base": null, - "refs": { - } - }, - "UpdateTaskSetResponse": { - "base": null, - "refs": { - } - }, - "VersionInfo": { - "base": "

The Docker and Amazon ECS container agent version information about a container instance.

", - "refs": { - "ContainerInstance$versionInfo": "

The version information for the Amazon ECS container agent and Docker daemon running on the container instance.

", - "RegisterContainerInstanceRequest$versionInfo": "

The version information for the Amazon ECS container agent and Docker daemon that runs on the container instance.

" - } - }, - "Volume": { - "base": "

A data volume that's used in a task definition. For tasks that use the Amazon Elastic File System (Amazon EFS), specify an efsVolumeConfiguration. For Windows tasks that use Amazon FSx for Windows File Server file system, specify a fsxWindowsFileServerVolumeConfiguration. For tasks that use a Docker volume, specify a DockerVolumeConfiguration. For tasks that use a bind mount host volume, specify a host and optional sourcePath. For more information, see Using Data Volumes in Tasks.

", - "refs": { - "VolumeList$member": null - } - }, - "VolumeFrom": { - "base": "

Details on a data volume from another container in the same task definition.

", - "refs": { - "VolumeFromList$member": null - } - }, - "VolumeFromList": { - "base": null, - "refs": { - "ContainerDefinition$volumesFrom": "

Data volumes to mount from another container. This parameter maps to VolumesFrom in the Create a container section of the Docker Remote API and the --volumes-from option to docker run.

" - } - }, - "VolumeList": { - "base": null, - "refs": { - "RegisterTaskDefinitionRequest$volumes": "

A list of volume definitions in JSON format that containers in your task might use.

", - "TaskDefinition$volumes": "

The list of data volume definitions for the task. For more information, see Using data volumes in tasks in the Amazon Elastic Container Service Developer Guide.

The host and sourcePath parameters aren't supported for tasks run on Fargate.

" - } - }, - "VolumeOverride": { - "base": null, - "refs": { - "VolumeOverrides$member": null - } - }, - "VolumeOverrides": { - "base": null, - "refs": { - "TaskOverride$volumeOverrides": null - } - } - } -} diff --git a/ecs-agent/ecs/model/api/paginators-1.json b/ecs-agent/ecs/model/api/paginators-1.json deleted file mode 100644 index 081a2df0025..00000000000 --- a/ecs-agent/ecs/model/api/paginators-1.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "pagination": { - "ListClusters": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "clusterArns" - }, - "ListContainerInstances": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "containerInstanceArns" - }, - "ListTaskDefinitions": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "taskDefinitionArns" - }, - "ListTaskDefinitionFamilies": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "families" - }, - "ListTasks": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "taskArns" - }, - "ListServices": { - "input_token": "nextToken", - "output_token": "nextToken", - "limit_key": "maxResults", - "result_key": "serviceArns" - } - } -} diff --git a/ecs-agent/ecs/model/api/waiters-2.json b/ecs-agent/ecs/model/api/waiters-2.json deleted file mode 100644 index 8866d15fdd8..00000000000 --- a/ecs-agent/ecs/model/api/waiters-2.json +++ /dev/null @@ -1,93 +0,0 @@ -{ - "version": 2, - "waiters": { - "TasksRunning": { - "delay": 6, - "operation": "DescribeTasks", - "maxAttempts": 100, - "acceptors": [ - { - "expected": "STOPPED", - "matcher": "pathAny", - "state": "failure", - "argument": "tasks[].lastStatus" - }, - { - "expected": "MISSING", - "matcher": "pathAny", - "state": "failure", - "argument": "failures[].reason" - }, - { - "expected": "RUNNING", - "matcher": "pathAll", - "state": "success", - "argument": "tasks[].lastStatus" - } - ] - }, - "TasksStopped": { - "delay": 6, - "operation": "DescribeTasks", - "maxAttempts": 100, - "acceptors": [ - { - "expected": "STOPPED", - "matcher": "pathAll", - "state": "success", - "argument": "tasks[].lastStatus" - } - ] - }, - "ServicesStable": { - "delay": 15, - "operation": "DescribeServices", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "MISSING", - "matcher": "pathAny", - "state": "failure", - "argument": "failures[].reason" - }, - { - "expected": "DRAINING", - "matcher": "pathAny", - "state": "failure", - "argument": "services[].status" - }, - { - "expected": "INACTIVE", - "matcher": "pathAny", - "state": "failure", - "argument": "services[].status" - }, - { - "expected": true, - "matcher": "path", - "state": "success", - "argument": "services | [@[?length(deployments)!=`1`], @[?desiredCount!=runningCount]][] | length(@) == `0`" - } - ] - }, - "ServicesInactive": { - "delay": 15, - "operation": "DescribeServices", - "maxAttempts": 40, - "acceptors": [ - { - "expected": "MISSING", - "matcher": "pathAny", - "state": "failure", - "argument": "failures[].reason" - }, - { - "expected": "INACTIVE", - "matcher": "pathAny", - "state": "success", - "argument": "services[].status" - } - ] - } - } -} diff --git a/ecs-agent/ecs/model/ecs/api.go b/ecs-agent/ecs/model/ecs/api.go deleted file mode 100644 index 52ba200ce1f..00000000000 --- a/ecs-agent/ecs/model/ecs/api.go +++ /dev/null @@ -1,26130 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. -// -// Code generated by [agent/gogenerate/awssdk.go] DO NOT EDIT. - -package ecs - -import ( - "fmt" - "time" - - "github.com/aws/aws-sdk-go/aws" - "github.com/aws/aws-sdk-go/aws/awsutil" - "github.com/aws/aws-sdk-go/aws/request" - "github.com/aws/aws-sdk-go/private/protocol" - "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" -) - -const opCreateCapacityProvider = "CreateCapacityProvider" - -// CreateCapacityProviderRequest generates a "aws/request.Request" representing the -// client's request for the CreateCapacityProvider operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See CreateCapacityProvider for more information on using the CreateCapacityProvider -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the CreateCapacityProviderRequest method. -// req, resp := client.CreateCapacityProviderRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) CreateCapacityProviderRequest(input *CreateCapacityProviderInput) (req *request.Request, output *CreateCapacityProviderOutput) { - op := &request.Operation{ - Name: opCreateCapacityProvider, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &CreateCapacityProviderInput{} - } - - output = &CreateCapacityProviderOutput{} - req = c.newRequest(op, input, output) - return -} - -// CreateCapacityProvider API operation for Amazon Elastic Container Service. -// -// Creates a new capacity provider. Capacity providers are associated with an -// Amazon ECS cluster and are used in capacity provider strategies to facilitate -// cluster auto scaling. -// -// Only capacity providers that use an Auto Scaling group can be created. Amazon -// ECS tasks on Fargate use the FARGATE and FARGATE_SPOT capacity providers. -// These providers are available to all accounts in the Amazon Web Services -// Regions that Fargate supports. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation CreateCapacityProvider for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - LimitExceededException -// The limit for the resource was exceeded. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - UpdateInProgressException -// There's already a current Amazon ECS container agent update in progress on -// the container instance that's specified. If the container agent becomes disconnected -// while it's in a transitional stage, such as PENDING or STAGING, the update -// process can get stuck in that state. However, when the agent reconnects, -// it resumes where it stopped previously. -func (c *ECS) CreateCapacityProvider(input *CreateCapacityProviderInput) (*CreateCapacityProviderOutput, error) { - req, out := c.CreateCapacityProviderRequest(input) - return out, req.Send() -} - -// CreateCapacityProviderWithContext is the same as CreateCapacityProvider with the addition of -// the ability to pass a context and additional request options. -// -// See CreateCapacityProvider for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) CreateCapacityProviderWithContext(ctx aws.Context, input *CreateCapacityProviderInput, opts ...request.Option) (*CreateCapacityProviderOutput, error) { - req, out := c.CreateCapacityProviderRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opCreateCluster = "CreateCluster" - -// CreateClusterRequest generates a "aws/request.Request" representing the -// client's request for the CreateCluster operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See CreateCluster for more information on using the CreateCluster -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the CreateClusterRequest method. -// req, resp := client.CreateClusterRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) CreateClusterRequest(input *CreateClusterInput) (req *request.Request, output *CreateClusterOutput) { - op := &request.Operation{ - Name: opCreateCluster, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &CreateClusterInput{} - } - - output = &CreateClusterOutput{} - req = c.newRequest(op, input, output) - return -} - -// CreateCluster API operation for Amazon Elastic Container Service. -// -// Creates a new Amazon ECS cluster. By default, your account receives a default -// cluster when you launch your first container instance. However, you can create -// your own cluster with a unique name with the CreateCluster action. -// -// When you call the CreateCluster API operation, Amazon ECS attempts to create -// the Amazon ECS service-linked role for your account. This is so that it can -// manage required resources in other Amazon Web Services services on your behalf. -// However, if the user that makes the call doesn't have permissions to create -// the service-linked role, it isn't created. For more information, see Using -// service-linked roles for Amazon ECS (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation CreateCluster for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - NamespaceNotFoundException -// The specified namespace wasn't found. -func (c *ECS) CreateCluster(input *CreateClusterInput) (*CreateClusterOutput, error) { - req, out := c.CreateClusterRequest(input) - return out, req.Send() -} - -// CreateClusterWithContext is the same as CreateCluster with the addition of -// the ability to pass a context and additional request options. -// -// See CreateCluster for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) CreateClusterWithContext(ctx aws.Context, input *CreateClusterInput, opts ...request.Option) (*CreateClusterOutput, error) { - req, out := c.CreateClusterRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opCreateService = "CreateService" - -// CreateServiceRequest generates a "aws/request.Request" representing the -// client's request for the CreateService operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See CreateService for more information on using the CreateService -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the CreateServiceRequest method. -// req, resp := client.CreateServiceRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) CreateServiceRequest(input *CreateServiceInput) (req *request.Request, output *CreateServiceOutput) { - op := &request.Operation{ - Name: opCreateService, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &CreateServiceInput{} - } - - output = &CreateServiceOutput{} - req = c.newRequest(op, input, output) - return -} - -// CreateService API operation for Amazon Elastic Container Service. -// -// Runs and maintains your desired number of tasks from a specified task definition. -// If the number of tasks running in a service drops below the desiredCount, -// Amazon ECS runs another copy of the task in the specified cluster. To update -// an existing service, see the UpdateService action. -// -// Starting April 15, 2023, Amazon Web Services will not onboard new customers -// to Amazon Elastic Inference (EI), and will help current customers migrate -// their workloads to options that offer better price and performance. After -// April 15, 2023, new customers will not be able to launch instances with Amazon -// EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, -// customers who have used Amazon EI at least once during the past 30-day period -// are considered current customers and will be able to continue using the service. -// -// In addition to maintaining the desired count of tasks in your service, you -// can optionally run your service behind one or more load balancers. The load -// balancers distribute traffic across the tasks that are associated with the -// service. For more information, see Service load balancing (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Tasks for services that don't use a load balancer are considered healthy -// if they're in the RUNNING state. Tasks for services that use a load balancer -// are considered healthy if they're in the RUNNING state and are reported as -// healthy by the load balancer. -// -// There are two service scheduler strategies available: -// -// - REPLICA - The replica scheduling strategy places and maintains your -// desired number of tasks across your cluster. By default, the service scheduler -// spreads tasks across Availability Zones. You can use task placement strategies -// and constraints to customize task placement decisions. For more information, -// see Service scheduler concepts (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// - DAEMON - The daemon scheduling strategy deploys exactly one task on -// each active container instance that meets all of the task placement constraints -// that you specify in your cluster. The service scheduler also evaluates -// the task placement constraints for running tasks. It also stops tasks -// that don't meet the placement constraints. When using this strategy, you -// don't need to specify a desired number of tasks, a task placement strategy, -// or use Service Auto Scaling policies. For more information, see Service -// scheduler concepts (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// You can optionally specify a deployment configuration for your service. The -// deployment is initiated by changing properties. For example, the deployment -// might be initiated by the task definition or by your desired count of a service. -// This is done with an UpdateService operation. The default value for a replica -// service for minimumHealthyPercent is 100%. The default value for a daemon -// service for minimumHealthyPercent is 0%. -// -// If a service uses the ECS deployment controller, the minimum healthy percent -// represents a lower limit on the number of tasks in a service that must remain -// in the RUNNING state during a deployment. Specifically, it represents it -// as a percentage of your desired number of tasks (rounded up to the nearest -// integer). This happens when any of your container instances are in the DRAINING -// state if the service contains tasks using the EC2 launch type. Using this -// parameter, you can deploy without using additional cluster capacity. For -// example, if you set your service to have desired number of four tasks and -// a minimum healthy percent of 50%, the scheduler might stop two existing tasks -// to free up cluster capacity before starting two new tasks. If they're in -// the RUNNING state, tasks for services that don't use a load balancer are -// considered healthy . If they're in the RUNNING state and reported as healthy -// by the load balancer, tasks for services that do use a load balancer are -// considered healthy . The default value for minimum healthy percent is 100%. -// -// If a service uses the ECS deployment controller, the maximum percent parameter -// represents an upper limit on the number of tasks in a service that are allowed -// in the RUNNING or PENDING state during a deployment. Specifically, it represents -// it as a percentage of the desired number of tasks (rounded down to the nearest -// integer). This happens when any of your container instances are in the DRAINING -// state if the service contains tasks using the EC2 launch type. Using this -// parameter, you can define the deployment batch size. For example, if your -// service has a desired number of four tasks and a maximum percent value of -// 200%, the scheduler may start four new tasks before stopping the four older -// tasks (provided that the cluster resources required to do this are available). -// The default value for maximum percent is 200%. -// -// If a service uses either the CODE_DEPLOY or EXTERNAL deployment controller -// types and tasks that use the EC2 launch type, the minimum healthy percent -// and maximum percent values are used only to define the lower and upper limit -// on the number of the tasks in the service that remain in the RUNNING state. -// This is while the container instances are in the DRAINING state. If the tasks -// in the service use the Fargate launch type, the minimum healthy percent and -// maximum percent values aren't used. This is the case even if they're currently -// visible when describing your service. -// -// When creating a service that uses the EXTERNAL deployment controller, you -// can specify only parameters that aren't controlled at the task set level. -// The only required parameter is the service name. You control your services -// using the CreateTaskSet operation. For more information, see Amazon ECS deployment -// types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// When the service scheduler launches new tasks, it determines task placement. -// For information about task placement and task placement strategies, see Amazon -// ECS task placement (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation CreateService for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - NamespaceNotFoundException -// The specified namespace wasn't found. -// -// - PlatformUnknownException -// The specified platform version doesn't exist. -// -// - PlatformTaskDefinitionIncompatibilityException -// The specified platform version doesn't satisfy the required capabilities -// of the task definition. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - UnsupportedFeatureException -// The specified task isn't supported in this Region. -func (c *ECS) CreateService(input *CreateServiceInput) (*CreateServiceOutput, error) { - req, out := c.CreateServiceRequest(input) - return out, req.Send() -} - -// CreateServiceWithContext is the same as CreateService with the addition of -// the ability to pass a context and additional request options. -// -// See CreateService for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) CreateServiceWithContext(ctx aws.Context, input *CreateServiceInput, opts ...request.Option) (*CreateServiceOutput, error) { - req, out := c.CreateServiceRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opCreateTaskSet = "CreateTaskSet" - -// CreateTaskSetRequest generates a "aws/request.Request" representing the -// client's request for the CreateTaskSet operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See CreateTaskSet for more information on using the CreateTaskSet -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the CreateTaskSetRequest method. -// req, resp := client.CreateTaskSetRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) CreateTaskSetRequest(input *CreateTaskSetInput) (req *request.Request, output *CreateTaskSetOutput) { - op := &request.Operation{ - Name: opCreateTaskSet, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &CreateTaskSetInput{} - } - - output = &CreateTaskSetOutput{} - req = c.newRequest(op, input, output) - return -} - -// CreateTaskSet API operation for Amazon Elastic Container Service. -// -// Create a task set in the specified cluster and service. This is used when -// a service uses the EXTERNAL deployment controller type. For more information, -// see Amazon ECS deployment types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation CreateTaskSet for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - LimitExceededException -// The limit for the resource was exceeded. -// -// - NamespaceNotFoundException -// The specified namespace wasn't found. -// -// - PlatformUnknownException -// The specified platform version doesn't exist. -// -// - PlatformTaskDefinitionIncompatibilityException -// The specified platform version doesn't satisfy the required capabilities -// of the task definition. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - ServiceNotFoundException -// The specified service wasn't found. You can view your available services -// with ListServices. Amazon ECS services are cluster specific and Region specific. -// -// - ServiceNotActiveException -// The specified service isn't active. You can't update a service that's inactive. -// If you have previously deleted a service, you can re-create it with CreateService. -// -// - UnsupportedFeatureException -// The specified task isn't supported in this Region. -func (c *ECS) CreateTaskSet(input *CreateTaskSetInput) (*CreateTaskSetOutput, error) { - req, out := c.CreateTaskSetRequest(input) - return out, req.Send() -} - -// CreateTaskSetWithContext is the same as CreateTaskSet with the addition of -// the ability to pass a context and additional request options. -// -// See CreateTaskSet for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) CreateTaskSetWithContext(ctx aws.Context, input *CreateTaskSetInput, opts ...request.Option) (*CreateTaskSetOutput, error) { - req, out := c.CreateTaskSetRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDeleteAccountSetting = "DeleteAccountSetting" - -// DeleteAccountSettingRequest generates a "aws/request.Request" representing the -// client's request for the DeleteAccountSetting operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DeleteAccountSetting for more information on using the DeleteAccountSetting -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DeleteAccountSettingRequest method. -// req, resp := client.DeleteAccountSettingRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DeleteAccountSettingRequest(input *DeleteAccountSettingInput) (req *request.Request, output *DeleteAccountSettingOutput) { - op := &request.Operation{ - Name: opDeleteAccountSetting, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DeleteAccountSettingInput{} - } - - output = &DeleteAccountSettingOutput{} - req = c.newRequest(op, input, output) - return -} - -// DeleteAccountSetting API operation for Amazon Elastic Container Service. -// -// Disables an account setting for a specified user, role, or the root user -// for an account. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DeleteAccountSetting for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) DeleteAccountSetting(input *DeleteAccountSettingInput) (*DeleteAccountSettingOutput, error) { - req, out := c.DeleteAccountSettingRequest(input) - return out, req.Send() -} - -// DeleteAccountSettingWithContext is the same as DeleteAccountSetting with the addition of -// the ability to pass a context and additional request options. -// -// See DeleteAccountSetting for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DeleteAccountSettingWithContext(ctx aws.Context, input *DeleteAccountSettingInput, opts ...request.Option) (*DeleteAccountSettingOutput, error) { - req, out := c.DeleteAccountSettingRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDeleteAttributes = "DeleteAttributes" - -// DeleteAttributesRequest generates a "aws/request.Request" representing the -// client's request for the DeleteAttributes operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DeleteAttributes for more information on using the DeleteAttributes -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DeleteAttributesRequest method. -// req, resp := client.DeleteAttributesRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DeleteAttributesRequest(input *DeleteAttributesInput) (req *request.Request, output *DeleteAttributesOutput) { - op := &request.Operation{ - Name: opDeleteAttributes, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DeleteAttributesInput{} - } - - output = &DeleteAttributesOutput{} - req = c.newRequest(op, input, output) - return -} - -// DeleteAttributes API operation for Amazon Elastic Container Service. -// -// Deletes one or more custom attributes from an Amazon ECS resource. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DeleteAttributes for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - TargetNotFoundException -// The specified target wasn't found. You can view your available container -// instances with ListContainerInstances. Amazon ECS container instances are -// cluster-specific and Region-specific. -func (c *ECS) DeleteAttributes(input *DeleteAttributesInput) (*DeleteAttributesOutput, error) { - req, out := c.DeleteAttributesRequest(input) - return out, req.Send() -} - -// DeleteAttributesWithContext is the same as DeleteAttributes with the addition of -// the ability to pass a context and additional request options. -// -// See DeleteAttributes for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DeleteAttributesWithContext(ctx aws.Context, input *DeleteAttributesInput, opts ...request.Option) (*DeleteAttributesOutput, error) { - req, out := c.DeleteAttributesRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDeleteCapacityProvider = "DeleteCapacityProvider" - -// DeleteCapacityProviderRequest generates a "aws/request.Request" representing the -// client's request for the DeleteCapacityProvider operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DeleteCapacityProvider for more information on using the DeleteCapacityProvider -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DeleteCapacityProviderRequest method. -// req, resp := client.DeleteCapacityProviderRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DeleteCapacityProviderRequest(input *DeleteCapacityProviderInput) (req *request.Request, output *DeleteCapacityProviderOutput) { - op := &request.Operation{ - Name: opDeleteCapacityProvider, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DeleteCapacityProviderInput{} - } - - output = &DeleteCapacityProviderOutput{} - req = c.newRequest(op, input, output) - return -} - -// DeleteCapacityProvider API operation for Amazon Elastic Container Service. -// -// Deletes the specified capacity provider. -// -// The FARGATE and FARGATE_SPOT capacity providers are reserved and can't be -// deleted. You can disassociate them from a cluster using either the PutClusterCapacityProviders -// API or by deleting the cluster. -// -// Prior to a capacity provider being deleted, the capacity provider must be -// removed from the capacity provider strategy from all services. The UpdateService -// API can be used to remove a capacity provider from a service's capacity provider -// strategy. When updating a service, the forceNewDeployment option can be used -// to ensure that any tasks using the Amazon EC2 instance capacity provided -// by the capacity provider are transitioned to use the capacity from the remaining -// capacity providers. Only capacity providers that aren't associated with a -// cluster can be deleted. To remove a capacity provider from a cluster, you -// can either use PutClusterCapacityProviders or delete the cluster. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DeleteCapacityProvider for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - UpdateInProgressException -// There's already a current Amazon ECS container agent update in progress on -// the container instance that's specified. If the container agent becomes disconnected -// while it's in a transitional stage, such as PENDING or STAGING, the update -// process can get stuck in that state. However, when the agent reconnects, -// it resumes where it stopped previously. -func (c *ECS) DeleteCapacityProvider(input *DeleteCapacityProviderInput) (*DeleteCapacityProviderOutput, error) { - req, out := c.DeleteCapacityProviderRequest(input) - return out, req.Send() -} - -// DeleteCapacityProviderWithContext is the same as DeleteCapacityProvider with the addition of -// the ability to pass a context and additional request options. -// -// See DeleteCapacityProvider for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DeleteCapacityProviderWithContext(ctx aws.Context, input *DeleteCapacityProviderInput, opts ...request.Option) (*DeleteCapacityProviderOutput, error) { - req, out := c.DeleteCapacityProviderRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDeleteCluster = "DeleteCluster" - -// DeleteClusterRequest generates a "aws/request.Request" representing the -// client's request for the DeleteCluster operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DeleteCluster for more information on using the DeleteCluster -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DeleteClusterRequest method. -// req, resp := client.DeleteClusterRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DeleteClusterRequest(input *DeleteClusterInput) (req *request.Request, output *DeleteClusterOutput) { - op := &request.Operation{ - Name: opDeleteCluster, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DeleteClusterInput{} - } - - output = &DeleteClusterOutput{} - req = c.newRequest(op, input, output) - return -} - -// DeleteCluster API operation for Amazon Elastic Container Service. -// -// Deletes the specified cluster. The cluster transitions to the INACTIVE state. -// Clusters with an INACTIVE status might remain discoverable in your account -// for a period of time. However, this behavior is subject to change in the -// future. We don't recommend that you rely on INACTIVE clusters persisting. -// -// You must deregister all container instances from this cluster before you -// may delete it. You can list the container instances in a cluster with ListContainerInstances -// and deregister them with DeregisterContainerInstance. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DeleteCluster for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - ClusterContainsContainerInstancesException -// You can't delete a cluster that has registered container instances. First, -// deregister the container instances before you can delete the cluster. For -// more information, see DeregisterContainerInstance. -// -// - ClusterContainsServicesException -// You can't delete a cluster that contains services. First, update the service -// to reduce its desired task count to 0, and then delete the service. For more -// information, see UpdateService and DeleteService. -// -// - ClusterContainsTasksException -// You can't delete a cluster that has active tasks. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - UpdateInProgressException -// There's already a current Amazon ECS container agent update in progress on -// the container instance that's specified. If the container agent becomes disconnected -// while it's in a transitional stage, such as PENDING or STAGING, the update -// process can get stuck in that state. However, when the agent reconnects, -// it resumes where it stopped previously. -func (c *ECS) DeleteCluster(input *DeleteClusterInput) (*DeleteClusterOutput, error) { - req, out := c.DeleteClusterRequest(input) - return out, req.Send() -} - -// DeleteClusterWithContext is the same as DeleteCluster with the addition of -// the ability to pass a context and additional request options. -// -// See DeleteCluster for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DeleteClusterWithContext(ctx aws.Context, input *DeleteClusterInput, opts ...request.Option) (*DeleteClusterOutput, error) { - req, out := c.DeleteClusterRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDeleteService = "DeleteService" - -// DeleteServiceRequest generates a "aws/request.Request" representing the -// client's request for the DeleteService operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DeleteService for more information on using the DeleteService -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DeleteServiceRequest method. -// req, resp := client.DeleteServiceRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DeleteServiceRequest(input *DeleteServiceInput) (req *request.Request, output *DeleteServiceOutput) { - op := &request.Operation{ - Name: opDeleteService, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DeleteServiceInput{} - } - - output = &DeleteServiceOutput{} - req = c.newRequest(op, input, output) - return -} - -// DeleteService API operation for Amazon Elastic Container Service. -// -// Deletes a specified service within a cluster. You can delete a service if -// you have no running tasks in it and the desired task count is zero. If the -// service is actively maintaining tasks, you can't delete it, and you must -// update the service to a desired task count of zero. For more information, -// see UpdateService. -// -// When you delete a service, if there are still running tasks that require -// cleanup, the service status moves from ACTIVE to DRAINING, and the service -// is no longer visible in the console or in the ListServices API operation. -// After all tasks have transitioned to either STOPPING or STOPPED status, the -// service status moves from DRAINING to INACTIVE. Services in the DRAINING -// or INACTIVE status can still be viewed with the DescribeServices API operation. -// However, in the future, INACTIVE services may be cleaned up and purged from -// Amazon ECS record keeping, and DescribeServices calls on those services return -// a ServiceNotFoundException error. -// -// If you attempt to create a new service with the same name as an existing -// service in either ACTIVE or DRAINING status, you receive an error. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DeleteService for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - ServiceNotFoundException -// The specified service wasn't found. You can view your available services -// with ListServices. Amazon ECS services are cluster specific and Region specific. -func (c *ECS) DeleteService(input *DeleteServiceInput) (*DeleteServiceOutput, error) { - req, out := c.DeleteServiceRequest(input) - return out, req.Send() -} - -// DeleteServiceWithContext is the same as DeleteService with the addition of -// the ability to pass a context and additional request options. -// -// See DeleteService for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DeleteServiceWithContext(ctx aws.Context, input *DeleteServiceInput, opts ...request.Option) (*DeleteServiceOutput, error) { - req, out := c.DeleteServiceRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDeleteTaskSet = "DeleteTaskSet" - -// DeleteTaskSetRequest generates a "aws/request.Request" representing the -// client's request for the DeleteTaskSet operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DeleteTaskSet for more information on using the DeleteTaskSet -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DeleteTaskSetRequest method. -// req, resp := client.DeleteTaskSetRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DeleteTaskSetRequest(input *DeleteTaskSetInput) (req *request.Request, output *DeleteTaskSetOutput) { - op := &request.Operation{ - Name: opDeleteTaskSet, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DeleteTaskSetInput{} - } - - output = &DeleteTaskSetOutput{} - req = c.newRequest(op, input, output) - return -} - -// DeleteTaskSet API operation for Amazon Elastic Container Service. -// -// Deletes a specified task set within a service. This is used when a service -// uses the EXTERNAL deployment controller type. For more information, see Amazon -// ECS deployment types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DeleteTaskSet for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - LimitExceededException -// The limit for the resource was exceeded. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - ServiceNotFoundException -// The specified service wasn't found. You can view your available services -// with ListServices. Amazon ECS services are cluster specific and Region specific. -// -// - ServiceNotActiveException -// The specified service isn't active. You can't update a service that's inactive. -// If you have previously deleted a service, you can re-create it with CreateService. -// -// - TaskSetNotFoundException -// The specified task set wasn't found. You can view your available task sets -// with DescribeTaskSets. Task sets are specific to each cluster, service and -// Region. -// -// - UnsupportedFeatureException -// The specified task isn't supported in this Region. -func (c *ECS) DeleteTaskSet(input *DeleteTaskSetInput) (*DeleteTaskSetOutput, error) { - req, out := c.DeleteTaskSetRequest(input) - return out, req.Send() -} - -// DeleteTaskSetWithContext is the same as DeleteTaskSet with the addition of -// the ability to pass a context and additional request options. -// -// See DeleteTaskSet for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DeleteTaskSetWithContext(ctx aws.Context, input *DeleteTaskSetInput, opts ...request.Option) (*DeleteTaskSetOutput, error) { - req, out := c.DeleteTaskSetRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDeregisterContainerInstance = "DeregisterContainerInstance" - -// DeregisterContainerInstanceRequest generates a "aws/request.Request" representing the -// client's request for the DeregisterContainerInstance operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DeregisterContainerInstance for more information on using the DeregisterContainerInstance -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DeregisterContainerInstanceRequest method. -// req, resp := client.DeregisterContainerInstanceRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DeregisterContainerInstanceRequest(input *DeregisterContainerInstanceInput) (req *request.Request, output *DeregisterContainerInstanceOutput) { - op := &request.Operation{ - Name: opDeregisterContainerInstance, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DeregisterContainerInstanceInput{} - } - - output = &DeregisterContainerInstanceOutput{} - req = c.newRequest(op, input, output) - return -} - -// DeregisterContainerInstance API operation for Amazon Elastic Container Service. -// -// Deregisters an Amazon ECS container instance from the specified cluster. -// This instance is no longer available to run tasks. -// -// If you intend to use the container instance for some other purpose after -// deregistration, we recommend that you stop all of the tasks running on the -// container instance before deregistration. That prevents any orphaned tasks -// from consuming resources. -// -// Deregistering a container instance removes the instance from a cluster, but -// it doesn't terminate the EC2 instance. If you are finished using the instance, -// be sure to terminate it in the Amazon EC2 console to stop billing. -// -// If you terminate a running container instance, Amazon ECS automatically deregisters -// the instance from your cluster (stopped container instances or instances -// with disconnected agents aren't automatically deregistered when terminated). -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DeregisterContainerInstance for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) DeregisterContainerInstance(input *DeregisterContainerInstanceInput) (*DeregisterContainerInstanceOutput, error) { - req, out := c.DeregisterContainerInstanceRequest(input) - return out, req.Send() -} - -// DeregisterContainerInstanceWithContext is the same as DeregisterContainerInstance with the addition of -// the ability to pass a context and additional request options. -// -// See DeregisterContainerInstance for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DeregisterContainerInstanceWithContext(ctx aws.Context, input *DeregisterContainerInstanceInput, opts ...request.Option) (*DeregisterContainerInstanceOutput, error) { - req, out := c.DeregisterContainerInstanceRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDeregisterTaskDefinition = "DeregisterTaskDefinition" - -// DeregisterTaskDefinitionRequest generates a "aws/request.Request" representing the -// client's request for the DeregisterTaskDefinition operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DeregisterTaskDefinition for more information on using the DeregisterTaskDefinition -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DeregisterTaskDefinitionRequest method. -// req, resp := client.DeregisterTaskDefinitionRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DeregisterTaskDefinitionRequest(input *DeregisterTaskDefinitionInput) (req *request.Request, output *DeregisterTaskDefinitionOutput) { - op := &request.Operation{ - Name: opDeregisterTaskDefinition, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DeregisterTaskDefinitionInput{} - } - - output = &DeregisterTaskDefinitionOutput{} - req = c.newRequest(op, input, output) - return -} - -// DeregisterTaskDefinition API operation for Amazon Elastic Container Service. -// -// Deregisters the specified task definition by family and revision. Upon deregistration, -// the task definition is marked as INACTIVE. Existing tasks and services that -// reference an INACTIVE task definition continue to run without disruption. -// Existing services that reference an INACTIVE task definition can still scale -// up or down by modifying the service's desired count. If you want to delete -// a task definition revision, you must first deregister the task definition -// revision. -// -// You can't use an INACTIVE task definition to run new tasks or create new -// services, and you can't update an existing service to reference an INACTIVE -// task definition. However, there may be up to a 10-minute window following -// deregistration where these restrictions have not yet taken effect. -// -// At this time, INACTIVE task definitions remain discoverable in your account -// indefinitely. However, this behavior is subject to change in the future. -// We don't recommend that you rely on INACTIVE task definitions persisting -// beyond the lifecycle of any associated tasks and services. -// -// You must deregister a task definition revision before you delete it. For -// more information, see DeleteTaskDefinitions (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DeleteTaskDefinitions.html). -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DeregisterTaskDefinition for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) DeregisterTaskDefinition(input *DeregisterTaskDefinitionInput) (*DeregisterTaskDefinitionOutput, error) { - req, out := c.DeregisterTaskDefinitionRequest(input) - return out, req.Send() -} - -// DeregisterTaskDefinitionWithContext is the same as DeregisterTaskDefinition with the addition of -// the ability to pass a context and additional request options. -// -// See DeregisterTaskDefinition for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DeregisterTaskDefinitionWithContext(ctx aws.Context, input *DeregisterTaskDefinitionInput, opts ...request.Option) (*DeregisterTaskDefinitionOutput, error) { - req, out := c.DeregisterTaskDefinitionRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDescribeCapacityProviders = "DescribeCapacityProviders" - -// DescribeCapacityProvidersRequest generates a "aws/request.Request" representing the -// client's request for the DescribeCapacityProviders operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DescribeCapacityProviders for more information on using the DescribeCapacityProviders -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DescribeCapacityProvidersRequest method. -// req, resp := client.DescribeCapacityProvidersRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DescribeCapacityProvidersRequest(input *DescribeCapacityProvidersInput) (req *request.Request, output *DescribeCapacityProvidersOutput) { - op := &request.Operation{ - Name: opDescribeCapacityProviders, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DescribeCapacityProvidersInput{} - } - - output = &DescribeCapacityProvidersOutput{} - req = c.newRequest(op, input, output) - return -} - -// DescribeCapacityProviders API operation for Amazon Elastic Container Service. -// -// Describes one or more of your capacity providers. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DescribeCapacityProviders for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) DescribeCapacityProviders(input *DescribeCapacityProvidersInput) (*DescribeCapacityProvidersOutput, error) { - req, out := c.DescribeCapacityProvidersRequest(input) - return out, req.Send() -} - -// DescribeCapacityProvidersWithContext is the same as DescribeCapacityProviders with the addition of -// the ability to pass a context and additional request options. -// -// See DescribeCapacityProviders for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DescribeCapacityProvidersWithContext(ctx aws.Context, input *DescribeCapacityProvidersInput, opts ...request.Option) (*DescribeCapacityProvidersOutput, error) { - req, out := c.DescribeCapacityProvidersRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDescribeClusters = "DescribeClusters" - -// DescribeClustersRequest generates a "aws/request.Request" representing the -// client's request for the DescribeClusters operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DescribeClusters for more information on using the DescribeClusters -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DescribeClustersRequest method. -// req, resp := client.DescribeClustersRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DescribeClustersRequest(input *DescribeClustersInput) (req *request.Request, output *DescribeClustersOutput) { - op := &request.Operation{ - Name: opDescribeClusters, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DescribeClustersInput{} - } - - output = &DescribeClustersOutput{} - req = c.newRequest(op, input, output) - return -} - -// DescribeClusters API operation for Amazon Elastic Container Service. -// -// Describes one or more of your clusters. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DescribeClusters for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) DescribeClusters(input *DescribeClustersInput) (*DescribeClustersOutput, error) { - req, out := c.DescribeClustersRequest(input) - return out, req.Send() -} - -// DescribeClustersWithContext is the same as DescribeClusters with the addition of -// the ability to pass a context and additional request options. -// -// See DescribeClusters for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DescribeClustersWithContext(ctx aws.Context, input *DescribeClustersInput, opts ...request.Option) (*DescribeClustersOutput, error) { - req, out := c.DescribeClustersRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDescribeContainerInstances = "DescribeContainerInstances" - -// DescribeContainerInstancesRequest generates a "aws/request.Request" representing the -// client's request for the DescribeContainerInstances operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DescribeContainerInstances for more information on using the DescribeContainerInstances -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DescribeContainerInstancesRequest method. -// req, resp := client.DescribeContainerInstancesRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DescribeContainerInstancesRequest(input *DescribeContainerInstancesInput) (req *request.Request, output *DescribeContainerInstancesOutput) { - op := &request.Operation{ - Name: opDescribeContainerInstances, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DescribeContainerInstancesInput{} - } - - output = &DescribeContainerInstancesOutput{} - req = c.newRequest(op, input, output) - return -} - -// DescribeContainerInstances API operation for Amazon Elastic Container Service. -// -// Describes one or more container instances. Returns metadata about each container -// instance requested. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DescribeContainerInstances for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) DescribeContainerInstances(input *DescribeContainerInstancesInput) (*DescribeContainerInstancesOutput, error) { - req, out := c.DescribeContainerInstancesRequest(input) - return out, req.Send() -} - -// DescribeContainerInstancesWithContext is the same as DescribeContainerInstances with the addition of -// the ability to pass a context and additional request options. -// -// See DescribeContainerInstances for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DescribeContainerInstancesWithContext(ctx aws.Context, input *DescribeContainerInstancesInput, opts ...request.Option) (*DescribeContainerInstancesOutput, error) { - req, out := c.DescribeContainerInstancesRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDescribeServices = "DescribeServices" - -// DescribeServicesRequest generates a "aws/request.Request" representing the -// client's request for the DescribeServices operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DescribeServices for more information on using the DescribeServices -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DescribeServicesRequest method. -// req, resp := client.DescribeServicesRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DescribeServicesRequest(input *DescribeServicesInput) (req *request.Request, output *DescribeServicesOutput) { - op := &request.Operation{ - Name: opDescribeServices, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DescribeServicesInput{} - } - - output = &DescribeServicesOutput{} - req = c.newRequest(op, input, output) - return -} - -// DescribeServices API operation for Amazon Elastic Container Service. -// -// Describes the specified services running in your cluster. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DescribeServices for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) DescribeServices(input *DescribeServicesInput) (*DescribeServicesOutput, error) { - req, out := c.DescribeServicesRequest(input) - return out, req.Send() -} - -// DescribeServicesWithContext is the same as DescribeServices with the addition of -// the ability to pass a context and additional request options. -// -// See DescribeServices for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DescribeServicesWithContext(ctx aws.Context, input *DescribeServicesInput, opts ...request.Option) (*DescribeServicesOutput, error) { - req, out := c.DescribeServicesRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDescribeTaskDefinition = "DescribeTaskDefinition" - -// DescribeTaskDefinitionRequest generates a "aws/request.Request" representing the -// client's request for the DescribeTaskDefinition operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DescribeTaskDefinition for more information on using the DescribeTaskDefinition -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DescribeTaskDefinitionRequest method. -// req, resp := client.DescribeTaskDefinitionRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DescribeTaskDefinitionRequest(input *DescribeTaskDefinitionInput) (req *request.Request, output *DescribeTaskDefinitionOutput) { - op := &request.Operation{ - Name: opDescribeTaskDefinition, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DescribeTaskDefinitionInput{} - } - - output = &DescribeTaskDefinitionOutput{} - req = c.newRequest(op, input, output) - return -} - -// DescribeTaskDefinition API operation for Amazon Elastic Container Service. -// -// Describes a task definition. You can specify a family and revision to find -// information about a specific task definition, or you can simply specify the -// family to find the latest ACTIVE revision in that family. -// -// You can only describe INACTIVE task definitions while an active task or service -// references them. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DescribeTaskDefinition for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) DescribeTaskDefinition(input *DescribeTaskDefinitionInput) (*DescribeTaskDefinitionOutput, error) { - req, out := c.DescribeTaskDefinitionRequest(input) - return out, req.Send() -} - -// DescribeTaskDefinitionWithContext is the same as DescribeTaskDefinition with the addition of -// the ability to pass a context and additional request options. -// -// See DescribeTaskDefinition for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DescribeTaskDefinitionWithContext(ctx aws.Context, input *DescribeTaskDefinitionInput, opts ...request.Option) (*DescribeTaskDefinitionOutput, error) { - req, out := c.DescribeTaskDefinitionRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDescribeTaskSets = "DescribeTaskSets" - -// DescribeTaskSetsRequest generates a "aws/request.Request" representing the -// client's request for the DescribeTaskSets operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DescribeTaskSets for more information on using the DescribeTaskSets -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DescribeTaskSetsRequest method. -// req, resp := client.DescribeTaskSetsRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DescribeTaskSetsRequest(input *DescribeTaskSetsInput) (req *request.Request, output *DescribeTaskSetsOutput) { - op := &request.Operation{ - Name: opDescribeTaskSets, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DescribeTaskSetsInput{} - } - - output = &DescribeTaskSetsOutput{} - req = c.newRequest(op, input, output) - return -} - -// DescribeTaskSets API operation for Amazon Elastic Container Service. -// -// Describes the task sets in the specified cluster and service. This is used -// when a service uses the EXTERNAL deployment controller type. For more information, -// see Amazon ECS Deployment Types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DescribeTaskSets for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - ServiceNotFoundException -// The specified service wasn't found. You can view your available services -// with ListServices. Amazon ECS services are cluster specific and Region specific. -func (c *ECS) DescribeTaskSets(input *DescribeTaskSetsInput) (*DescribeTaskSetsOutput, error) { - req, out := c.DescribeTaskSetsRequest(input) - return out, req.Send() -} - -// DescribeTaskSetsWithContext is the same as DescribeTaskSets with the addition of -// the ability to pass a context and additional request options. -// -// See DescribeTaskSets for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DescribeTaskSetsWithContext(ctx aws.Context, input *DescribeTaskSetsInput, opts ...request.Option) (*DescribeTaskSetsOutput, error) { - req, out := c.DescribeTaskSetsRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDescribeTasks = "DescribeTasks" - -// DescribeTasksRequest generates a "aws/request.Request" representing the -// client's request for the DescribeTasks operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DescribeTasks for more information on using the DescribeTasks -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DescribeTasksRequest method. -// req, resp := client.DescribeTasksRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DescribeTasksRequest(input *DescribeTasksInput) (req *request.Request, output *DescribeTasksOutput) { - op := &request.Operation{ - Name: opDescribeTasks, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DescribeTasksInput{} - } - - output = &DescribeTasksOutput{} - req = c.newRequest(op, input, output) - return -} - -// DescribeTasks API operation for Amazon Elastic Container Service. -// -// Describes a specified task or tasks. -// -// Currently, stopped tasks appear in the returned results for at least one -// hour. -// -// If you have tasks with tags, and then delete the cluster, the tagged tasks -// are returned in the response. If you create a new cluster with the same name -// as the deleted cluster, the tagged tasks are not included in the response. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DescribeTasks for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) DescribeTasks(input *DescribeTasksInput) (*DescribeTasksOutput, error) { - req, out := c.DescribeTasksRequest(input) - return out, req.Send() -} - -// DescribeTasksWithContext is the same as DescribeTasks with the addition of -// the ability to pass a context and additional request options. -// -// See DescribeTasks for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DescribeTasksWithContext(ctx aws.Context, input *DescribeTasksInput, opts ...request.Option) (*DescribeTasksOutput, error) { - req, out := c.DescribeTasksRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opDiscoverPollEndpoint = "DiscoverPollEndpoint" - -// DiscoverPollEndpointRequest generates a "aws/request.Request" representing the -// client's request for the DiscoverPollEndpoint operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See DiscoverPollEndpoint for more information on using the DiscoverPollEndpoint -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the DiscoverPollEndpointRequest method. -// req, resp := client.DiscoverPollEndpointRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) DiscoverPollEndpointRequest(input *DiscoverPollEndpointInput) (req *request.Request, output *DiscoverPollEndpointOutput) { - op := &request.Operation{ - Name: opDiscoverPollEndpoint, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &DiscoverPollEndpointInput{} - } - - output = &DiscoverPollEndpointOutput{} - req = c.newRequest(op, input, output) - return -} - -// DiscoverPollEndpoint API operation for Amazon Elastic Container Service. -// -// This action is only used by the Amazon ECS agent, and it is not intended -// for use outside of the agent. -// -// Returns an endpoint for the Amazon ECS agent to poll for updates. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation DiscoverPollEndpoint for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) DiscoverPollEndpoint(input *DiscoverPollEndpointInput) (*DiscoverPollEndpointOutput, error) { - req, out := c.DiscoverPollEndpointRequest(input) - return out, req.Send() -} - -// DiscoverPollEndpointWithContext is the same as DiscoverPollEndpoint with the addition of -// the ability to pass a context and additional request options. -// -// See DiscoverPollEndpoint for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) DiscoverPollEndpointWithContext(ctx aws.Context, input *DiscoverPollEndpointInput, opts ...request.Option) (*DiscoverPollEndpointOutput, error) { - req, out := c.DiscoverPollEndpointRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opExecuteCommand = "ExecuteCommand" - -// ExecuteCommandRequest generates a "aws/request.Request" representing the -// client's request for the ExecuteCommand operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ExecuteCommand for more information on using the ExecuteCommand -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ExecuteCommandRequest method. -// req, resp := client.ExecuteCommandRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ExecuteCommandRequest(input *ExecuteCommandInput) (req *request.Request, output *ExecuteCommandOutput) { - op := &request.Operation{ - Name: opExecuteCommand, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &ExecuteCommandInput{} - } - - output = &ExecuteCommandOutput{} - req = c.newRequest(op, input, output) - return -} - -// ExecuteCommand API operation for Amazon Elastic Container Service. -// -// Runs a command remotely on a container within a task. -// -// If you use a condition key in your IAM policy to refine the conditions for -// the policy statement, for example limit the actions to a specific cluster, -// you receive an AccessDeniedException when there is a mismatch between the -// condition key value and the corresponding parameter value. -// -// For information about required permissions and considerations, see Using -// Amazon ECS Exec for debugging (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html) -// in the Amazon ECS Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ExecuteCommand for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - TargetNotConnectedException -// The execute command cannot run. This error can be caused by any of the following -// configuration issues: -// -// - Incorrect IAM permissions -// -// - The SSM agent is not installed or is not running -// -// - There is an interface Amazon VPC endpoint for Amazon ECS, but there -// is not one for Systems Manager Session Manager -// -// For information about how to troubleshoot the issues, see Troubleshooting -// issues with ECS Exec (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html) -// in the Amazon Elastic Container Service Developer Guide. -func (c *ECS) ExecuteCommand(input *ExecuteCommandInput) (*ExecuteCommandOutput, error) { - req, out := c.ExecuteCommandRequest(input) - return out, req.Send() -} - -// ExecuteCommandWithContext is the same as ExecuteCommand with the addition of -// the ability to pass a context and additional request options. -// -// See ExecuteCommand for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ExecuteCommandWithContext(ctx aws.Context, input *ExecuteCommandInput, opts ...request.Option) (*ExecuteCommandOutput, error) { - req, out := c.ExecuteCommandRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opGetTaskProtection = "GetTaskProtection" - -// GetTaskProtectionRequest generates a "aws/request.Request" representing the -// client's request for the GetTaskProtection operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See GetTaskProtection for more information on using the GetTaskProtection -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the GetTaskProtectionRequest method. -// req, resp := client.GetTaskProtectionRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) GetTaskProtectionRequest(input *GetTaskProtectionInput) (req *request.Request, output *GetTaskProtectionOutput) { - op := &request.Operation{ - Name: opGetTaskProtection, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &GetTaskProtectionInput{} - } - - output = &GetTaskProtectionOutput{} - req = c.newRequest(op, input, output) - return -} - -// GetTaskProtection API operation for Amazon Elastic Container Service. -// -// Retrieves the protection status of tasks in an Amazon ECS service. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation GetTaskProtection for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ResourceNotFoundException -// The specified resource wasn't found. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - UnsupportedFeatureException -// The specified task isn't supported in this Region. -func (c *ECS) GetTaskProtection(input *GetTaskProtectionInput) (*GetTaskProtectionOutput, error) { - req, out := c.GetTaskProtectionRequest(input) - return out, req.Send() -} - -// GetTaskProtectionWithContext is the same as GetTaskProtection with the addition of -// the ability to pass a context and additional request options. -// -// See GetTaskProtection for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) GetTaskProtectionWithContext(ctx aws.Context, input *GetTaskProtectionInput, opts ...request.Option) (*GetTaskProtectionOutput, error) { - req, out := c.GetTaskProtectionRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opListAccountSettings = "ListAccountSettings" - -// ListAccountSettingsRequest generates a "aws/request.Request" representing the -// client's request for the ListAccountSettings operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ListAccountSettings for more information on using the ListAccountSettings -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ListAccountSettingsRequest method. -// req, resp := client.ListAccountSettingsRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ListAccountSettingsRequest(input *ListAccountSettingsInput) (req *request.Request, output *ListAccountSettingsOutput) { - op := &request.Operation{ - Name: opListAccountSettings, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &ListAccountSettingsInput{} - } - - output = &ListAccountSettingsOutput{} - req = c.newRequest(op, input, output) - return -} - -// ListAccountSettings API operation for Amazon Elastic Container Service. -// -// Lists the account settings for a specified principal. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ListAccountSettings for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) ListAccountSettings(input *ListAccountSettingsInput) (*ListAccountSettingsOutput, error) { - req, out := c.ListAccountSettingsRequest(input) - return out, req.Send() -} - -// ListAccountSettingsWithContext is the same as ListAccountSettings with the addition of -// the ability to pass a context and additional request options. -// -// See ListAccountSettings for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListAccountSettingsWithContext(ctx aws.Context, input *ListAccountSettingsInput, opts ...request.Option) (*ListAccountSettingsOutput, error) { - req, out := c.ListAccountSettingsRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opListAttributes = "ListAttributes" - -// ListAttributesRequest generates a "aws/request.Request" representing the -// client's request for the ListAttributes operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ListAttributes for more information on using the ListAttributes -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ListAttributesRequest method. -// req, resp := client.ListAttributesRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ListAttributesRequest(input *ListAttributesInput) (req *request.Request, output *ListAttributesOutput) { - op := &request.Operation{ - Name: opListAttributes, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &ListAttributesInput{} - } - - output = &ListAttributesOutput{} - req = c.newRequest(op, input, output) - return -} - -// ListAttributes API operation for Amazon Elastic Container Service. -// -// Lists the attributes for Amazon ECS resources within a specified target type -// and cluster. When you specify a target type and cluster, ListAttributes returns -// a list of attribute objects, one for each attribute on each resource. You -// can filter the list of results to a single attribute name to only return -// results that have that name. You can also filter the results by attribute -// name and value. You can do this, for example, to see which container instances -// in a cluster are running a Linux AMI (ecs.os-type=linux). -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ListAttributes for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -func (c *ECS) ListAttributes(input *ListAttributesInput) (*ListAttributesOutput, error) { - req, out := c.ListAttributesRequest(input) - return out, req.Send() -} - -// ListAttributesWithContext is the same as ListAttributes with the addition of -// the ability to pass a context and additional request options. -// -// See ListAttributes for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListAttributesWithContext(ctx aws.Context, input *ListAttributesInput, opts ...request.Option) (*ListAttributesOutput, error) { - req, out := c.ListAttributesRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opListClusters = "ListClusters" - -// ListClustersRequest generates a "aws/request.Request" representing the -// client's request for the ListClusters operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ListClusters for more information on using the ListClusters -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ListClustersRequest method. -// req, resp := client.ListClustersRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ListClustersRequest(input *ListClustersInput) (req *request.Request, output *ListClustersOutput) { - op := &request.Operation{ - Name: opListClusters, - HTTPMethod: "POST", - HTTPPath: "/", - Paginator: &request.Paginator{ - InputTokens: []string{"nextToken"}, - OutputTokens: []string{"nextToken"}, - LimitToken: "maxResults", - TruncationToken: "", - }, - } - - if input == nil { - input = &ListClustersInput{} - } - - output = &ListClustersOutput{} - req = c.newRequest(op, input, output) - return -} - -// ListClusters API operation for Amazon Elastic Container Service. -// -// Returns a list of existing clusters. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ListClusters for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) ListClusters(input *ListClustersInput) (*ListClustersOutput, error) { - req, out := c.ListClustersRequest(input) - return out, req.Send() -} - -// ListClustersWithContext is the same as ListClusters with the addition of -// the ability to pass a context and additional request options. -// -// See ListClusters for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListClustersWithContext(ctx aws.Context, input *ListClustersInput, opts ...request.Option) (*ListClustersOutput, error) { - req, out := c.ListClustersRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -// ListClustersPages iterates over the pages of a ListClusters operation, -// calling the "fn" function with the response data for each page. To stop -// iterating, return false from the fn function. -// -// See ListClusters method for more information on how to use this operation. -// -// Note: This operation can generate multiple requests to a service. -// -// // Example iterating over at most 3 pages of a ListClusters operation. -// pageNum := 0 -// err := client.ListClustersPages(params, -// func(page *ecs.ListClustersOutput, lastPage bool) bool { -// pageNum++ -// fmt.Println(page) -// return pageNum <= 3 -// }) -func (c *ECS) ListClustersPages(input *ListClustersInput, fn func(*ListClustersOutput, bool) bool) error { - return c.ListClustersPagesWithContext(aws.BackgroundContext(), input, fn) -} - -// ListClustersPagesWithContext same as ListClustersPages except -// it takes a Context and allows setting request options on the pages. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListClustersPagesWithContext(ctx aws.Context, input *ListClustersInput, fn func(*ListClustersOutput, bool) bool, opts ...request.Option) error { - p := request.Pagination{ - NewRequest: func() (*request.Request, error) { - var inCpy *ListClustersInput - if input != nil { - tmp := *input - inCpy = &tmp - } - req, _ := c.ListClustersRequest(inCpy) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return req, nil - }, - } - - for p.Next() { - if !fn(p.Page().(*ListClustersOutput), !p.HasNextPage()) { - break - } - } - - return p.Err() -} - -const opListContainerInstances = "ListContainerInstances" - -// ListContainerInstancesRequest generates a "aws/request.Request" representing the -// client's request for the ListContainerInstances operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ListContainerInstances for more information on using the ListContainerInstances -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ListContainerInstancesRequest method. -// req, resp := client.ListContainerInstancesRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ListContainerInstancesRequest(input *ListContainerInstancesInput) (req *request.Request, output *ListContainerInstancesOutput) { - op := &request.Operation{ - Name: opListContainerInstances, - HTTPMethod: "POST", - HTTPPath: "/", - Paginator: &request.Paginator{ - InputTokens: []string{"nextToken"}, - OutputTokens: []string{"nextToken"}, - LimitToken: "maxResults", - TruncationToken: "", - }, - } - - if input == nil { - input = &ListContainerInstancesInput{} - } - - output = &ListContainerInstancesOutput{} - req = c.newRequest(op, input, output) - return -} - -// ListContainerInstances API operation for Amazon Elastic Container Service. -// -// Returns a list of container instances in a specified cluster. You can filter -// the results of a ListContainerInstances operation with cluster query language -// statements inside the filter parameter. For more information, see Cluster -// Query Language (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-query-language.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ListContainerInstances for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) ListContainerInstances(input *ListContainerInstancesInput) (*ListContainerInstancesOutput, error) { - req, out := c.ListContainerInstancesRequest(input) - return out, req.Send() -} - -// ListContainerInstancesWithContext is the same as ListContainerInstances with the addition of -// the ability to pass a context and additional request options. -// -// See ListContainerInstances for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListContainerInstancesWithContext(ctx aws.Context, input *ListContainerInstancesInput, opts ...request.Option) (*ListContainerInstancesOutput, error) { - req, out := c.ListContainerInstancesRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -// ListContainerInstancesPages iterates over the pages of a ListContainerInstances operation, -// calling the "fn" function with the response data for each page. To stop -// iterating, return false from the fn function. -// -// See ListContainerInstances method for more information on how to use this operation. -// -// Note: This operation can generate multiple requests to a service. -// -// // Example iterating over at most 3 pages of a ListContainerInstances operation. -// pageNum := 0 -// err := client.ListContainerInstancesPages(params, -// func(page *ecs.ListContainerInstancesOutput, lastPage bool) bool { -// pageNum++ -// fmt.Println(page) -// return pageNum <= 3 -// }) -func (c *ECS) ListContainerInstancesPages(input *ListContainerInstancesInput, fn func(*ListContainerInstancesOutput, bool) bool) error { - return c.ListContainerInstancesPagesWithContext(aws.BackgroundContext(), input, fn) -} - -// ListContainerInstancesPagesWithContext same as ListContainerInstancesPages except -// it takes a Context and allows setting request options on the pages. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListContainerInstancesPagesWithContext(ctx aws.Context, input *ListContainerInstancesInput, fn func(*ListContainerInstancesOutput, bool) bool, opts ...request.Option) error { - p := request.Pagination{ - NewRequest: func() (*request.Request, error) { - var inCpy *ListContainerInstancesInput - if input != nil { - tmp := *input - inCpy = &tmp - } - req, _ := c.ListContainerInstancesRequest(inCpy) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return req, nil - }, - } - - for p.Next() { - if !fn(p.Page().(*ListContainerInstancesOutput), !p.HasNextPage()) { - break - } - } - - return p.Err() -} - -const opListServices = "ListServices" - -// ListServicesRequest generates a "aws/request.Request" representing the -// client's request for the ListServices operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ListServices for more information on using the ListServices -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ListServicesRequest method. -// req, resp := client.ListServicesRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ListServicesRequest(input *ListServicesInput) (req *request.Request, output *ListServicesOutput) { - op := &request.Operation{ - Name: opListServices, - HTTPMethod: "POST", - HTTPPath: "/", - Paginator: &request.Paginator{ - InputTokens: []string{"nextToken"}, - OutputTokens: []string{"nextToken"}, - LimitToken: "maxResults", - TruncationToken: "", - }, - } - - if input == nil { - input = &ListServicesInput{} - } - - output = &ListServicesOutput{} - req = c.newRequest(op, input, output) - return -} - -// ListServices API operation for Amazon Elastic Container Service. -// -// Returns a list of services. You can filter the results by cluster, launch -// type, and scheduling strategy. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ListServices for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) ListServices(input *ListServicesInput) (*ListServicesOutput, error) { - req, out := c.ListServicesRequest(input) - return out, req.Send() -} - -// ListServicesWithContext is the same as ListServices with the addition of -// the ability to pass a context and additional request options. -// -// See ListServices for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListServicesWithContext(ctx aws.Context, input *ListServicesInput, opts ...request.Option) (*ListServicesOutput, error) { - req, out := c.ListServicesRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -// ListServicesPages iterates over the pages of a ListServices operation, -// calling the "fn" function with the response data for each page. To stop -// iterating, return false from the fn function. -// -// See ListServices method for more information on how to use this operation. -// -// Note: This operation can generate multiple requests to a service. -// -// // Example iterating over at most 3 pages of a ListServices operation. -// pageNum := 0 -// err := client.ListServicesPages(params, -// func(page *ecs.ListServicesOutput, lastPage bool) bool { -// pageNum++ -// fmt.Println(page) -// return pageNum <= 3 -// }) -func (c *ECS) ListServicesPages(input *ListServicesInput, fn func(*ListServicesOutput, bool) bool) error { - return c.ListServicesPagesWithContext(aws.BackgroundContext(), input, fn) -} - -// ListServicesPagesWithContext same as ListServicesPages except -// it takes a Context and allows setting request options on the pages. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListServicesPagesWithContext(ctx aws.Context, input *ListServicesInput, fn func(*ListServicesOutput, bool) bool, opts ...request.Option) error { - p := request.Pagination{ - NewRequest: func() (*request.Request, error) { - var inCpy *ListServicesInput - if input != nil { - tmp := *input - inCpy = &tmp - } - req, _ := c.ListServicesRequest(inCpy) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return req, nil - }, - } - - for p.Next() { - if !fn(p.Page().(*ListServicesOutput), !p.HasNextPage()) { - break - } - } - - return p.Err() -} - -const opListServicesByNamespace = "ListServicesByNamespace" - -// ListServicesByNamespaceRequest generates a "aws/request.Request" representing the -// client's request for the ListServicesByNamespace operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ListServicesByNamespace for more information on using the ListServicesByNamespace -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ListServicesByNamespaceRequest method. -// req, resp := client.ListServicesByNamespaceRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ListServicesByNamespaceRequest(input *ListServicesByNamespaceInput) (req *request.Request, output *ListServicesByNamespaceOutput) { - op := &request.Operation{ - Name: opListServicesByNamespace, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &ListServicesByNamespaceInput{} - } - - output = &ListServicesByNamespaceOutput{} - req = c.newRequest(op, input, output) - return -} - -// ListServicesByNamespace API operation for Amazon Elastic Container Service. -// -// This operation lists all of the services that are associated with a Cloud -// Map namespace. This list might include services in different clusters. In -// contrast, ListServices can only list services in one cluster at a time. If -// you need to filter the list of services in a single cluster by various parameters, -// use ListServices. For more information, see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ListServicesByNamespace for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - NamespaceNotFoundException -// The specified namespace wasn't found. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) ListServicesByNamespace(input *ListServicesByNamespaceInput) (*ListServicesByNamespaceOutput, error) { - req, out := c.ListServicesByNamespaceRequest(input) - return out, req.Send() -} - -// ListServicesByNamespaceWithContext is the same as ListServicesByNamespace with the addition of -// the ability to pass a context and additional request options. -// -// See ListServicesByNamespace for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListServicesByNamespaceWithContext(ctx aws.Context, input *ListServicesByNamespaceInput, opts ...request.Option) (*ListServicesByNamespaceOutput, error) { - req, out := c.ListServicesByNamespaceRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opListTagsForResource = "ListTagsForResource" - -// ListTagsForResourceRequest generates a "aws/request.Request" representing the -// client's request for the ListTagsForResource operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ListTagsForResource for more information on using the ListTagsForResource -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ListTagsForResourceRequest method. -// req, resp := client.ListTagsForResourceRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ListTagsForResourceRequest(input *ListTagsForResourceInput) (req *request.Request, output *ListTagsForResourceOutput) { - op := &request.Operation{ - Name: opListTagsForResource, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &ListTagsForResourceInput{} - } - - output = &ListTagsForResourceOutput{} - req = c.newRequest(op, input, output) - return -} - -// ListTagsForResource API operation for Amazon Elastic Container Service. -// -// List the tags for an Amazon ECS resource. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ListTagsForResource for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error) { - req, out := c.ListTagsForResourceRequest(input) - return out, req.Send() -} - -// ListTagsForResourceWithContext is the same as ListTagsForResource with the addition of -// the ability to pass a context and additional request options. -// -// See ListTagsForResource for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListTagsForResourceWithContext(ctx aws.Context, input *ListTagsForResourceInput, opts ...request.Option) (*ListTagsForResourceOutput, error) { - req, out := c.ListTagsForResourceRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opListTaskDefinitionFamilies = "ListTaskDefinitionFamilies" - -// ListTaskDefinitionFamiliesRequest generates a "aws/request.Request" representing the -// client's request for the ListTaskDefinitionFamilies operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ListTaskDefinitionFamilies for more information on using the ListTaskDefinitionFamilies -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ListTaskDefinitionFamiliesRequest method. -// req, resp := client.ListTaskDefinitionFamiliesRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ListTaskDefinitionFamiliesRequest(input *ListTaskDefinitionFamiliesInput) (req *request.Request, output *ListTaskDefinitionFamiliesOutput) { - op := &request.Operation{ - Name: opListTaskDefinitionFamilies, - HTTPMethod: "POST", - HTTPPath: "/", - Paginator: &request.Paginator{ - InputTokens: []string{"nextToken"}, - OutputTokens: []string{"nextToken"}, - LimitToken: "maxResults", - TruncationToken: "", - }, - } - - if input == nil { - input = &ListTaskDefinitionFamiliesInput{} - } - - output = &ListTaskDefinitionFamiliesOutput{} - req = c.newRequest(op, input, output) - return -} - -// ListTaskDefinitionFamilies API operation for Amazon Elastic Container Service. -// -// Returns a list of task definition families that are registered to your account. -// This list includes task definition families that no longer have any ACTIVE -// task definition revisions. -// -// You can filter out task definition families that don't contain any ACTIVE -// task definition revisions by setting the status parameter to ACTIVE. You -// can also filter the results with the familyPrefix parameter. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ListTaskDefinitionFamilies for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) ListTaskDefinitionFamilies(input *ListTaskDefinitionFamiliesInput) (*ListTaskDefinitionFamiliesOutput, error) { - req, out := c.ListTaskDefinitionFamiliesRequest(input) - return out, req.Send() -} - -// ListTaskDefinitionFamiliesWithContext is the same as ListTaskDefinitionFamilies with the addition of -// the ability to pass a context and additional request options. -// -// See ListTaskDefinitionFamilies for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListTaskDefinitionFamiliesWithContext(ctx aws.Context, input *ListTaskDefinitionFamiliesInput, opts ...request.Option) (*ListTaskDefinitionFamiliesOutput, error) { - req, out := c.ListTaskDefinitionFamiliesRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -// ListTaskDefinitionFamiliesPages iterates over the pages of a ListTaskDefinitionFamilies operation, -// calling the "fn" function with the response data for each page. To stop -// iterating, return false from the fn function. -// -// See ListTaskDefinitionFamilies method for more information on how to use this operation. -// -// Note: This operation can generate multiple requests to a service. -// -// // Example iterating over at most 3 pages of a ListTaskDefinitionFamilies operation. -// pageNum := 0 -// err := client.ListTaskDefinitionFamiliesPages(params, -// func(page *ecs.ListTaskDefinitionFamiliesOutput, lastPage bool) bool { -// pageNum++ -// fmt.Println(page) -// return pageNum <= 3 -// }) -func (c *ECS) ListTaskDefinitionFamiliesPages(input *ListTaskDefinitionFamiliesInput, fn func(*ListTaskDefinitionFamiliesOutput, bool) bool) error { - return c.ListTaskDefinitionFamiliesPagesWithContext(aws.BackgroundContext(), input, fn) -} - -// ListTaskDefinitionFamiliesPagesWithContext same as ListTaskDefinitionFamiliesPages except -// it takes a Context and allows setting request options on the pages. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListTaskDefinitionFamiliesPagesWithContext(ctx aws.Context, input *ListTaskDefinitionFamiliesInput, fn func(*ListTaskDefinitionFamiliesOutput, bool) bool, opts ...request.Option) error { - p := request.Pagination{ - NewRequest: func() (*request.Request, error) { - var inCpy *ListTaskDefinitionFamiliesInput - if input != nil { - tmp := *input - inCpy = &tmp - } - req, _ := c.ListTaskDefinitionFamiliesRequest(inCpy) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return req, nil - }, - } - - for p.Next() { - if !fn(p.Page().(*ListTaskDefinitionFamiliesOutput), !p.HasNextPage()) { - break - } - } - - return p.Err() -} - -const opListTaskDefinitions = "ListTaskDefinitions" - -// ListTaskDefinitionsRequest generates a "aws/request.Request" representing the -// client's request for the ListTaskDefinitions operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ListTaskDefinitions for more information on using the ListTaskDefinitions -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ListTaskDefinitionsRequest method. -// req, resp := client.ListTaskDefinitionsRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ListTaskDefinitionsRequest(input *ListTaskDefinitionsInput) (req *request.Request, output *ListTaskDefinitionsOutput) { - op := &request.Operation{ - Name: opListTaskDefinitions, - HTTPMethod: "POST", - HTTPPath: "/", - Paginator: &request.Paginator{ - InputTokens: []string{"nextToken"}, - OutputTokens: []string{"nextToken"}, - LimitToken: "maxResults", - TruncationToken: "", - }, - } - - if input == nil { - input = &ListTaskDefinitionsInput{} - } - - output = &ListTaskDefinitionsOutput{} - req = c.newRequest(op, input, output) - return -} - -// ListTaskDefinitions API operation for Amazon Elastic Container Service. -// -// Returns a list of task definitions that are registered to your account. You -// can filter the results by family name with the familyPrefix parameter or -// by status with the status parameter. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ListTaskDefinitions for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) ListTaskDefinitions(input *ListTaskDefinitionsInput) (*ListTaskDefinitionsOutput, error) { - req, out := c.ListTaskDefinitionsRequest(input) - return out, req.Send() -} - -// ListTaskDefinitionsWithContext is the same as ListTaskDefinitions with the addition of -// the ability to pass a context and additional request options. -// -// See ListTaskDefinitions for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListTaskDefinitionsWithContext(ctx aws.Context, input *ListTaskDefinitionsInput, opts ...request.Option) (*ListTaskDefinitionsOutput, error) { - req, out := c.ListTaskDefinitionsRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -// ListTaskDefinitionsPages iterates over the pages of a ListTaskDefinitions operation, -// calling the "fn" function with the response data for each page. To stop -// iterating, return false from the fn function. -// -// See ListTaskDefinitions method for more information on how to use this operation. -// -// Note: This operation can generate multiple requests to a service. -// -// // Example iterating over at most 3 pages of a ListTaskDefinitions operation. -// pageNum := 0 -// err := client.ListTaskDefinitionsPages(params, -// func(page *ecs.ListTaskDefinitionsOutput, lastPage bool) bool { -// pageNum++ -// fmt.Println(page) -// return pageNum <= 3 -// }) -func (c *ECS) ListTaskDefinitionsPages(input *ListTaskDefinitionsInput, fn func(*ListTaskDefinitionsOutput, bool) bool) error { - return c.ListTaskDefinitionsPagesWithContext(aws.BackgroundContext(), input, fn) -} - -// ListTaskDefinitionsPagesWithContext same as ListTaskDefinitionsPages except -// it takes a Context and allows setting request options on the pages. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListTaskDefinitionsPagesWithContext(ctx aws.Context, input *ListTaskDefinitionsInput, fn func(*ListTaskDefinitionsOutput, bool) bool, opts ...request.Option) error { - p := request.Pagination{ - NewRequest: func() (*request.Request, error) { - var inCpy *ListTaskDefinitionsInput - if input != nil { - tmp := *input - inCpy = &tmp - } - req, _ := c.ListTaskDefinitionsRequest(inCpy) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return req, nil - }, - } - - for p.Next() { - if !fn(p.Page().(*ListTaskDefinitionsOutput), !p.HasNextPage()) { - break - } - } - - return p.Err() -} - -const opListTasks = "ListTasks" - -// ListTasksRequest generates a "aws/request.Request" representing the -// client's request for the ListTasks operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See ListTasks for more information on using the ListTasks -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the ListTasksRequest method. -// req, resp := client.ListTasksRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) ListTasksRequest(input *ListTasksInput) (req *request.Request, output *ListTasksOutput) { - op := &request.Operation{ - Name: opListTasks, - HTTPMethod: "POST", - HTTPPath: "/", - Paginator: &request.Paginator{ - InputTokens: []string{"nextToken"}, - OutputTokens: []string{"nextToken"}, - LimitToken: "maxResults", - TruncationToken: "", - }, - } - - if input == nil { - input = &ListTasksInput{} - } - - output = &ListTasksOutput{} - req = c.newRequest(op, input, output) - return -} - -// ListTasks API operation for Amazon Elastic Container Service. -// -// Returns a list of tasks. You can filter the results by cluster, task definition -// family, container instance, launch type, what IAM principal started the task, -// or by the desired status of the task. -// -// Recently stopped tasks might appear in the returned results. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation ListTasks for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - ServiceNotFoundException -// The specified service wasn't found. You can view your available services -// with ListServices. Amazon ECS services are cluster specific and Region specific. -func (c *ECS) ListTasks(input *ListTasksInput) (*ListTasksOutput, error) { - req, out := c.ListTasksRequest(input) - return out, req.Send() -} - -// ListTasksWithContext is the same as ListTasks with the addition of -// the ability to pass a context and additional request options. -// -// See ListTasks for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListTasksWithContext(ctx aws.Context, input *ListTasksInput, opts ...request.Option) (*ListTasksOutput, error) { - req, out := c.ListTasksRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -// ListTasksPages iterates over the pages of a ListTasks operation, -// calling the "fn" function with the response data for each page. To stop -// iterating, return false from the fn function. -// -// See ListTasks method for more information on how to use this operation. -// -// Note: This operation can generate multiple requests to a service. -// -// // Example iterating over at most 3 pages of a ListTasks operation. -// pageNum := 0 -// err := client.ListTasksPages(params, -// func(page *ecs.ListTasksOutput, lastPage bool) bool { -// pageNum++ -// fmt.Println(page) -// return pageNum <= 3 -// }) -func (c *ECS) ListTasksPages(input *ListTasksInput, fn func(*ListTasksOutput, bool) bool) error { - return c.ListTasksPagesWithContext(aws.BackgroundContext(), input, fn) -} - -// ListTasksPagesWithContext same as ListTasksPages except -// it takes a Context and allows setting request options on the pages. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) ListTasksPagesWithContext(ctx aws.Context, input *ListTasksInput, fn func(*ListTasksOutput, bool) bool, opts ...request.Option) error { - p := request.Pagination{ - NewRequest: func() (*request.Request, error) { - var inCpy *ListTasksInput - if input != nil { - tmp := *input - inCpy = &tmp - } - req, _ := c.ListTasksRequest(inCpy) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return req, nil - }, - } - - for p.Next() { - if !fn(p.Page().(*ListTasksOutput), !p.HasNextPage()) { - break - } - } - - return p.Err() -} - -const opPutAccountSetting = "PutAccountSetting" - -// PutAccountSettingRequest generates a "aws/request.Request" representing the -// client's request for the PutAccountSetting operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See PutAccountSetting for more information on using the PutAccountSetting -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the PutAccountSettingRequest method. -// req, resp := client.PutAccountSettingRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) PutAccountSettingRequest(input *PutAccountSettingInput) (req *request.Request, output *PutAccountSettingOutput) { - op := &request.Operation{ - Name: opPutAccountSetting, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &PutAccountSettingInput{} - } - - output = &PutAccountSettingOutput{} - req = c.newRequest(op, input, output) - return -} - -// PutAccountSetting API operation for Amazon Elastic Container Service. -// -// Modifies an account setting. Account settings are set on a per-Region basis. -// -// If you change the root user account setting, the default settings are reset -// for users and roles that do not have specified individual account settings. -// For more information, see Account Settings (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// When you specify serviceLongArnFormat, taskLongArnFormat, or containerInstanceLongArnFormat, -// the Amazon Resource Name (ARN) and resource ID format of the resource type -// for a specified user, role, or the root user for an account is affected. -// The opt-in and opt-out account setting must be set for each Amazon ECS resource -// separately. The ARN and resource ID format of a resource is defined by the -// opt-in status of the user or role that created the resource. You must turn -// on this setting to use Amazon ECS features such as resource tagging. -// -// When you specify awsvpcTrunking, the elastic network interface (ENI) limit -// for any new container instances that support the feature is changed. If awsvpcTrunking -// is turned on, any new container instances that support the feature are launched -// have the increased ENI limits available to them. For more information, see -// Elastic Network Interface Trunking (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/container-instance-eni.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// When you specify containerInsights, the default setting indicating whether -// Amazon Web Services CloudWatch Container Insights is turned on for your clusters -// is changed. If containerInsights is turned on, any new clusters that are -// created will have Container Insights turned on unless you disable it during -// cluster creation. For more information, see CloudWatch Container Insights -// (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-container-insights.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Amazon ECS is introducing tagging authorization for resource creation. Users -// must have permissions for actions that create the resource, such as ecsCreateCluster. -// If tags are specified when you create a resource, Amazon Web Services performs -// additional authorization to verify if users or roles have permissions to -// create tags. Therefore, you must grant explicit permissions to use the ecs:TagResource -// action. For more information, see Grant permission to tag resources on creation -// (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/supported-iam-actions-tagging.html) -// in the Amazon ECS Developer Guide. -// -// When Amazon Web Services determines that a security or infrastructure update -// is needed for an Amazon ECS task hosted on Fargate, the tasks need to be -// stopped and new tasks launched to replace them. Use fargateTaskRetirementWaitPeriod -// to configure the wait time to retire a Fargate task. For information about -// the Fargate tasks maintenance, see Amazon Web Services Fargate task maintenance -// (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-maintenance.html) -// in the Amazon ECS Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation PutAccountSetting for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) PutAccountSetting(input *PutAccountSettingInput) (*PutAccountSettingOutput, error) { - req, out := c.PutAccountSettingRequest(input) - return out, req.Send() -} - -// PutAccountSettingWithContext is the same as PutAccountSetting with the addition of -// the ability to pass a context and additional request options. -// -// See PutAccountSetting for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) PutAccountSettingWithContext(ctx aws.Context, input *PutAccountSettingInput, opts ...request.Option) (*PutAccountSettingOutput, error) { - req, out := c.PutAccountSettingRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opPutAccountSettingDefault = "PutAccountSettingDefault" - -// PutAccountSettingDefaultRequest generates a "aws/request.Request" representing the -// client's request for the PutAccountSettingDefault operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See PutAccountSettingDefault for more information on using the PutAccountSettingDefault -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the PutAccountSettingDefaultRequest method. -// req, resp := client.PutAccountSettingDefaultRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) PutAccountSettingDefaultRequest(input *PutAccountSettingDefaultInput) (req *request.Request, output *PutAccountSettingDefaultOutput) { - op := &request.Operation{ - Name: opPutAccountSettingDefault, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &PutAccountSettingDefaultInput{} - } - - output = &PutAccountSettingDefaultOutput{} - req = c.newRequest(op, input, output) - return -} - -// PutAccountSettingDefault API operation for Amazon Elastic Container Service. -// -// Modifies an account setting for all users on an account for whom no individual -// account setting has been specified. Account settings are set on a per-Region -// basis. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation PutAccountSettingDefault for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) PutAccountSettingDefault(input *PutAccountSettingDefaultInput) (*PutAccountSettingDefaultOutput, error) { - req, out := c.PutAccountSettingDefaultRequest(input) - return out, req.Send() -} - -// PutAccountSettingDefaultWithContext is the same as PutAccountSettingDefault with the addition of -// the ability to pass a context and additional request options. -// -// See PutAccountSettingDefault for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) PutAccountSettingDefaultWithContext(ctx aws.Context, input *PutAccountSettingDefaultInput, opts ...request.Option) (*PutAccountSettingDefaultOutput, error) { - req, out := c.PutAccountSettingDefaultRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opPutAttributes = "PutAttributes" - -// PutAttributesRequest generates a "aws/request.Request" representing the -// client's request for the PutAttributes operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See PutAttributes for more information on using the PutAttributes -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the PutAttributesRequest method. -// req, resp := client.PutAttributesRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) PutAttributesRequest(input *PutAttributesInput) (req *request.Request, output *PutAttributesOutput) { - op := &request.Operation{ - Name: opPutAttributes, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &PutAttributesInput{} - } - - output = &PutAttributesOutput{} - req = c.newRequest(op, input, output) - return -} - -// PutAttributes API operation for Amazon Elastic Container Service. -// -// Create or update an attribute on an Amazon ECS resource. If the attribute -// doesn't exist, it's created. If the attribute exists, its value is replaced -// with the specified value. To delete an attribute, use DeleteAttributes. For -// more information, see Attributes (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html#attributes) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation PutAttributes for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - AttributeLimitExceededException -// You can apply up to 10 custom attributes for each resource. You can view -// the attributes of a resource with ListAttributes. You can remove existing -// attributes on a resource with DeleteAttributes. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - TargetNotFoundException -// The specified target wasn't found. You can view your available container -// instances with ListContainerInstances. Amazon ECS container instances are -// cluster-specific and Region-specific. -func (c *ECS) PutAttributes(input *PutAttributesInput) (*PutAttributesOutput, error) { - req, out := c.PutAttributesRequest(input) - return out, req.Send() -} - -// PutAttributesWithContext is the same as PutAttributes with the addition of -// the ability to pass a context and additional request options. -// -// See PutAttributes for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) PutAttributesWithContext(ctx aws.Context, input *PutAttributesInput, opts ...request.Option) (*PutAttributesOutput, error) { - req, out := c.PutAttributesRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opPutClusterCapacityProviders = "PutClusterCapacityProviders" - -// PutClusterCapacityProvidersRequest generates a "aws/request.Request" representing the -// client's request for the PutClusterCapacityProviders operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See PutClusterCapacityProviders for more information on using the PutClusterCapacityProviders -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the PutClusterCapacityProvidersRequest method. -// req, resp := client.PutClusterCapacityProvidersRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) PutClusterCapacityProvidersRequest(input *PutClusterCapacityProvidersInput) (req *request.Request, output *PutClusterCapacityProvidersOutput) { - op := &request.Operation{ - Name: opPutClusterCapacityProviders, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &PutClusterCapacityProvidersInput{} - } - - output = &PutClusterCapacityProvidersOutput{} - req = c.newRequest(op, input, output) - return -} - -// PutClusterCapacityProviders API operation for Amazon Elastic Container Service. -// -// Modifies the available capacity providers and the default capacity provider -// strategy for a cluster. -// -// You must specify both the available capacity providers and a default capacity -// provider strategy for the cluster. If the specified cluster has existing -// capacity providers associated with it, you must specify all existing capacity -// providers in addition to any new ones you want to add. Any existing capacity -// providers that are associated with a cluster that are omitted from a PutClusterCapacityProviders -// API call will be disassociated with the cluster. You can only disassociate -// an existing capacity provider from a cluster if it's not being used by any -// existing tasks. -// -// When creating a service or running a task on a cluster, if no capacity provider -// or launch type is specified, then the cluster's default capacity provider -// strategy is used. We recommend that you define a default capacity provider -// strategy for your cluster. However, you must specify an empty array ([]) -// to bypass defining a default strategy. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation PutClusterCapacityProviders for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ResourceInUseException -// The specified resource is in-use and can't be removed. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - UpdateInProgressException -// There's already a current Amazon ECS container agent update in progress on -// the container instance that's specified. If the container agent becomes disconnected -// while it's in a transitional stage, such as PENDING or STAGING, the update -// process can get stuck in that state. However, when the agent reconnects, -// it resumes where it stopped previously. -func (c *ECS) PutClusterCapacityProviders(input *PutClusterCapacityProvidersInput) (*PutClusterCapacityProvidersOutput, error) { - req, out := c.PutClusterCapacityProvidersRequest(input) - return out, req.Send() -} - -// PutClusterCapacityProvidersWithContext is the same as PutClusterCapacityProviders with the addition of -// the ability to pass a context and additional request options. -// -// See PutClusterCapacityProviders for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) PutClusterCapacityProvidersWithContext(ctx aws.Context, input *PutClusterCapacityProvidersInput, opts ...request.Option) (*PutClusterCapacityProvidersOutput, error) { - req, out := c.PutClusterCapacityProvidersRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opRegisterContainerInstance = "RegisterContainerInstance" - -// RegisterContainerInstanceRequest generates a "aws/request.Request" representing the -// client's request for the RegisterContainerInstance operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See RegisterContainerInstance for more information on using the RegisterContainerInstance -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the RegisterContainerInstanceRequest method. -// req, resp := client.RegisterContainerInstanceRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) RegisterContainerInstanceRequest(input *RegisterContainerInstanceInput) (req *request.Request, output *RegisterContainerInstanceOutput) { - op := &request.Operation{ - Name: opRegisterContainerInstance, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &RegisterContainerInstanceInput{} - } - - output = &RegisterContainerInstanceOutput{} - req = c.newRequest(op, input, output) - return -} - -// RegisterContainerInstance API operation for Amazon Elastic Container Service. -// -// This action is only used by the Amazon ECS agent, and it is not intended -// for use outside of the agent. -// -// Registers an EC2 instance into the specified cluster. This instance becomes -// available to place containers on. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation RegisterContainerInstance for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) RegisterContainerInstance(input *RegisterContainerInstanceInput) (*RegisterContainerInstanceOutput, error) { - req, out := c.RegisterContainerInstanceRequest(input) - return out, req.Send() -} - -// RegisterContainerInstanceWithContext is the same as RegisterContainerInstance with the addition of -// the ability to pass a context and additional request options. -// -// See RegisterContainerInstance for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) RegisterContainerInstanceWithContext(ctx aws.Context, input *RegisterContainerInstanceInput, opts ...request.Option) (*RegisterContainerInstanceOutput, error) { - req, out := c.RegisterContainerInstanceRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opRegisterTaskDefinition = "RegisterTaskDefinition" - -// RegisterTaskDefinitionRequest generates a "aws/request.Request" representing the -// client's request for the RegisterTaskDefinition operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See RegisterTaskDefinition for more information on using the RegisterTaskDefinition -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the RegisterTaskDefinitionRequest method. -// req, resp := client.RegisterTaskDefinitionRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) RegisterTaskDefinitionRequest(input *RegisterTaskDefinitionInput) (req *request.Request, output *RegisterTaskDefinitionOutput) { - op := &request.Operation{ - Name: opRegisterTaskDefinition, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &RegisterTaskDefinitionInput{} - } - - output = &RegisterTaskDefinitionOutput{} - req = c.newRequest(op, input, output) - return -} - -// RegisterTaskDefinition API operation for Amazon Elastic Container Service. -// -// Registers a new task definition from the supplied family and containerDefinitions. -// Optionally, you can add data volumes to your containers with the volumes -// parameter. For more information about task definition parameters and defaults, -// see Amazon ECS Task Definitions (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// You can specify a role for your task with the taskRoleArn parameter. When -// you specify a role for a task, its containers can then use the latest versions -// of the CLI or SDKs to make API requests to the Amazon Web Services services -// that are specified in the policy that's associated with the role. For more -// information, see IAM Roles for Tasks (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// You can specify a Docker networking mode for the containers in your task -// definition with the networkMode parameter. The available network modes correspond -// to those described in Network settings (https://docs.docker.com/engine/reference/run/#/network-settings) -// in the Docker run reference. If you specify the awsvpc network mode, the -// task is allocated an elastic network interface, and you must specify a NetworkConfiguration -// when you create a service or run a task with the task definition. For more -// information, see Task Networking (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation RegisterTaskDefinition for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - LimitExceededException -// The limit for the resource was exceeded. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) RegisterTaskDefinition(input *RegisterTaskDefinitionInput) (*RegisterTaskDefinitionOutput, error) { - req, out := c.RegisterTaskDefinitionRequest(input) - return out, req.Send() -} - -// RegisterTaskDefinitionWithContext is the same as RegisterTaskDefinition with the addition of -// the ability to pass a context and additional request options. -// -// See RegisterTaskDefinition for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) RegisterTaskDefinitionWithContext(ctx aws.Context, input *RegisterTaskDefinitionInput, opts ...request.Option) (*RegisterTaskDefinitionOutput, error) { - req, out := c.RegisterTaskDefinitionRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opRunTask = "RunTask" - -// RunTaskRequest generates a "aws/request.Request" representing the -// client's request for the RunTask operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See RunTask for more information on using the RunTask -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the RunTaskRequest method. -// req, resp := client.RunTaskRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) RunTaskRequest(input *RunTaskInput) (req *request.Request, output *RunTaskOutput) { - op := &request.Operation{ - Name: opRunTask, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &RunTaskInput{} - } - - output = &RunTaskOutput{} - req = c.newRequest(op, input, output) - return -} - -// RunTask API operation for Amazon Elastic Container Service. -// -// Starts a new task using the specified task definition. -// -// You can allow Amazon ECS to place tasks for you, or you can customize how -// Amazon ECS places tasks using placement constraints and placement strategies. -// For more information, see Scheduling Tasks (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Alternatively, you can use StartTask to use your own scheduler or place tasks -// manually on specific container instances. -// -// Starting April 15, 2023, Amazon Web Services will not onboard new customers -// to Amazon Elastic Inference (EI), and will help current customers migrate -// their workloads to options that offer better price and performance. After -// April 15, 2023, new customers will not be able to launch instances with Amazon -// EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, -// customers who have used Amazon EI at least once during the past 30-day period -// are considered current customers and will be able to continue using the service. -// -// The Amazon ECS API follows an eventual consistency model. This is because -// of the distributed nature of the system supporting the API. This means that -// the result of an API command you run that affects your Amazon ECS resources -// might not be immediately visible to all subsequent commands you run. Keep -// this in mind when you carry out an API command that immediately follows a -// previous API command. -// -// To manage eventual consistency, you can do the following: -// -// - Confirm the state of the resource before you run a command to modify -// it. Run the DescribeTasks command using an exponential backoff algorithm -// to ensure that you allow enough time for the previous command to propagate -// through the system. To do this, run the DescribeTasks command repeatedly, -// starting with a couple of seconds of wait time and increasing gradually -// up to five minutes of wait time. -// -// - Add wait time between subsequent commands, even if the DescribeTasks -// command returns an accurate response. Apply an exponential backoff algorithm -// starting with a couple of seconds of wait time, and increase gradually -// up to about five minutes of wait time. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation RunTask for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - BlockedException -// Your Amazon Web Services account was blocked. For more information, contact -// Amazon Web Services Support (http://aws.amazon.com/contact-us/). -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - ConflictException -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - PlatformUnknownException -// The specified platform version doesn't exist. -// -// - PlatformTaskDefinitionIncompatibilityException -// The specified platform version doesn't satisfy the required capabilities -// of the task definition. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - UnsupportedFeatureException -// The specified task isn't supported in this Region. -func (c *ECS) RunTask(input *RunTaskInput) (*RunTaskOutput, error) { - req, out := c.RunTaskRequest(input) - return out, req.Send() -} - -// RunTaskWithContext is the same as RunTask with the addition of -// the ability to pass a context and additional request options. -// -// See RunTask for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) RunTaskWithContext(ctx aws.Context, input *RunTaskInput, opts ...request.Option) (*RunTaskOutput, error) { - req, out := c.RunTaskRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opStartTask = "StartTask" - -// StartTaskRequest generates a "aws/request.Request" representing the -// client's request for the StartTask operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See StartTask for more information on using the StartTask -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the StartTaskRequest method. -// req, resp := client.StartTaskRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) StartTaskRequest(input *StartTaskInput) (req *request.Request, output *StartTaskOutput) { - op := &request.Operation{ - Name: opStartTask, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &StartTaskInput{} - } - - output = &StartTaskOutput{} - req = c.newRequest(op, input, output) - return -} - -// StartTask API operation for Amazon Elastic Container Service. -// -// Starts a new task from the specified task definition on the specified container -// instance or instances. -// -// Starting April 15, 2023, Amazon Web Services will not onboard new customers -// to Amazon Elastic Inference (EI), and will help current customers migrate -// their workloads to options that offer better price and performance. After -// April 15, 2023, new customers will not be able to launch instances with Amazon -// EI accelerators in Amazon SageMaker, Amazon ECS, or Amazon EC2. However, -// customers who have used Amazon EI at least once during the past 30-day period -// are considered current customers and will be able to continue using the service. -// -// Alternatively, you can use RunTask to place tasks for you. For more information, -// see Scheduling Tasks (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/scheduling_tasks.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation StartTask for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - NamespaceNotFoundException -// The specified namespace wasn't found. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) StartTask(input *StartTaskInput) (*StartTaskOutput, error) { - req, out := c.StartTaskRequest(input) - return out, req.Send() -} - -// StartTaskWithContext is the same as StartTask with the addition of -// the ability to pass a context and additional request options. -// -// See StartTask for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) StartTaskWithContext(ctx aws.Context, input *StartTaskInput, opts ...request.Option) (*StartTaskOutput, error) { - req, out := c.StartTaskRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opStopTask = "StopTask" - -// StopTaskRequest generates a "aws/request.Request" representing the -// client's request for the StopTask operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See StopTask for more information on using the StopTask -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the StopTaskRequest method. -// req, resp := client.StopTaskRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) StopTaskRequest(input *StopTaskInput) (req *request.Request, output *StopTaskOutput) { - op := &request.Operation{ - Name: opStopTask, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &StopTaskInput{} - } - - output = &StopTaskOutput{} - req = c.newRequest(op, input, output) - return -} - -// StopTask API operation for Amazon Elastic Container Service. -// -// Stops a running task. Any tags associated with the task will be deleted. -// -// When StopTask is called on a task, the equivalent of docker stop is issued -// to the containers running in the task. This results in a SIGTERM value and -// a default 30-second timeout, after which the SIGKILL value is sent and the -// containers are forcibly stopped. If the container handles the SIGTERM value -// gracefully and exits within 30 seconds from receiving it, no SIGKILL value -// is sent. -// -// The default 30-second timeout can be configured on the Amazon ECS container -// agent with the ECS_CONTAINER_STOP_TIMEOUT variable. For more information, -// see Amazon ECS Container Agent Configuration (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation StopTask for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) StopTask(input *StopTaskInput) (*StopTaskOutput, error) { - req, out := c.StopTaskRequest(input) - return out, req.Send() -} - -// StopTaskWithContext is the same as StopTask with the addition of -// the ability to pass a context and additional request options. -// -// See StopTask for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) StopTaskWithContext(ctx aws.Context, input *StopTaskInput, opts ...request.Option) (*StopTaskOutput, error) { - req, out := c.StopTaskRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opSubmitAttachmentStateChanges = "SubmitAttachmentStateChanges" - -// SubmitAttachmentStateChangesRequest generates a "aws/request.Request" representing the -// client's request for the SubmitAttachmentStateChanges operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See SubmitAttachmentStateChanges for more information on using the SubmitAttachmentStateChanges -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the SubmitAttachmentStateChangesRequest method. -// req, resp := client.SubmitAttachmentStateChangesRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) SubmitAttachmentStateChangesRequest(input *SubmitAttachmentStateChangesInput) (req *request.Request, output *SubmitAttachmentStateChangesOutput) { - op := &request.Operation{ - Name: opSubmitAttachmentStateChanges, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &SubmitAttachmentStateChangesInput{} - } - - output = &SubmitAttachmentStateChangesOutput{} - req = c.newRequest(op, input, output) - return -} - -// SubmitAttachmentStateChanges API operation for Amazon Elastic Container Service. -// -// This action is only used by the Amazon ECS agent, and it is not intended -// for use outside of the agent. -// -// Sent to acknowledge that an attachment changed states. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation SubmitAttachmentStateChanges for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) SubmitAttachmentStateChanges(input *SubmitAttachmentStateChangesInput) (*SubmitAttachmentStateChangesOutput, error) { - req, out := c.SubmitAttachmentStateChangesRequest(input) - return out, req.Send() -} - -// SubmitAttachmentStateChangesWithContext is the same as SubmitAttachmentStateChanges with the addition of -// the ability to pass a context and additional request options. -// -// See SubmitAttachmentStateChanges for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) SubmitAttachmentStateChangesWithContext(ctx aws.Context, input *SubmitAttachmentStateChangesInput, opts ...request.Option) (*SubmitAttachmentStateChangesOutput, error) { - req, out := c.SubmitAttachmentStateChangesRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opSubmitContainerStateChange = "SubmitContainerStateChange" - -// SubmitContainerStateChangeRequest generates a "aws/request.Request" representing the -// client's request for the SubmitContainerStateChange operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See SubmitContainerStateChange for more information on using the SubmitContainerStateChange -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the SubmitContainerStateChangeRequest method. -// req, resp := client.SubmitContainerStateChangeRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) SubmitContainerStateChangeRequest(input *SubmitContainerStateChangeInput) (req *request.Request, output *SubmitContainerStateChangeOutput) { - op := &request.Operation{ - Name: opSubmitContainerStateChange, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &SubmitContainerStateChangeInput{} - } - - output = &SubmitContainerStateChangeOutput{} - req = c.newRequest(op, input, output) - return -} - -// SubmitContainerStateChange API operation for Amazon Elastic Container Service. -// -// This action is only used by the Amazon ECS agent, and it is not intended -// for use outside of the agent. -// -// Sent to acknowledge that a container changed states. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation SubmitContainerStateChange for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) SubmitContainerStateChange(input *SubmitContainerStateChangeInput) (*SubmitContainerStateChangeOutput, error) { - req, out := c.SubmitContainerStateChangeRequest(input) - return out, req.Send() -} - -// SubmitContainerStateChangeWithContext is the same as SubmitContainerStateChange with the addition of -// the ability to pass a context and additional request options. -// -// See SubmitContainerStateChange for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) SubmitContainerStateChangeWithContext(ctx aws.Context, input *SubmitContainerStateChangeInput, opts ...request.Option) (*SubmitContainerStateChangeOutput, error) { - req, out := c.SubmitContainerStateChangeRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opSubmitTaskStateChange = "SubmitTaskStateChange" - -// SubmitTaskStateChangeRequest generates a "aws/request.Request" representing the -// client's request for the SubmitTaskStateChange operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See SubmitTaskStateChange for more information on using the SubmitTaskStateChange -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the SubmitTaskStateChangeRequest method. -// req, resp := client.SubmitTaskStateChangeRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) SubmitTaskStateChangeRequest(input *SubmitTaskStateChangeInput) (req *request.Request, output *SubmitTaskStateChangeOutput) { - op := &request.Operation{ - Name: opSubmitTaskStateChange, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &SubmitTaskStateChangeInput{} - } - - output = &SubmitTaskStateChangeOutput{} - req = c.newRequest(op, input, output) - return -} - -// SubmitTaskStateChange API operation for Amazon Elastic Container Service. -// -// This action is only used by the Amazon ECS agent, and it is not intended -// for use outside of the agent. -// -// Sent to acknowledge that a task changed states. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation SubmitTaskStateChange for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) SubmitTaskStateChange(input *SubmitTaskStateChangeInput) (*SubmitTaskStateChangeOutput, error) { - req, out := c.SubmitTaskStateChangeRequest(input) - return out, req.Send() -} - -// SubmitTaskStateChangeWithContext is the same as SubmitTaskStateChange with the addition of -// the ability to pass a context and additional request options. -// -// See SubmitTaskStateChange for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) SubmitTaskStateChangeWithContext(ctx aws.Context, input *SubmitTaskStateChangeInput, opts ...request.Option) (*SubmitTaskStateChangeOutput, error) { - req, out := c.SubmitTaskStateChangeRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opTagResource = "TagResource" - -// TagResourceRequest generates a "aws/request.Request" representing the -// client's request for the TagResource operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See TagResource for more information on using the TagResource -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the TagResourceRequest method. -// req, resp := client.TagResourceRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) TagResourceRequest(input *TagResourceInput) (req *request.Request, output *TagResourceOutput) { - op := &request.Operation{ - Name: opTagResource, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &TagResourceInput{} - } - - output = &TagResourceOutput{} - req = c.newRequest(op, input, output) - req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) - return -} - -// TagResource API operation for Amazon Elastic Container Service. -// -// Associates the specified tags to a resource with the specified resourceArn. -// If existing tags on a resource aren't specified in the request parameters, -// they aren't changed. When a resource is deleted, the tags that are associated -// with that resource are deleted as well. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation TagResource for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - LimitExceededException -// The limit for the resource was exceeded. -// -// - ResourceNotFoundException -// The specified resource wasn't found. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) TagResource(input *TagResourceInput) (*TagResourceOutput, error) { - req, out := c.TagResourceRequest(input) - return out, req.Send() -} - -// TagResourceWithContext is the same as TagResource with the addition of -// the ability to pass a context and additional request options. -// -// See TagResource for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) TagResourceWithContext(ctx aws.Context, input *TagResourceInput, opts ...request.Option) (*TagResourceOutput, error) { - req, out := c.TagResourceRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opUntagResource = "UntagResource" - -// UntagResourceRequest generates a "aws/request.Request" representing the -// client's request for the UntagResource operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See UntagResource for more information on using the UntagResource -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the UntagResourceRequest method. -// req, resp := client.UntagResourceRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) UntagResourceRequest(input *UntagResourceInput) (req *request.Request, output *UntagResourceOutput) { - op := &request.Operation{ - Name: opUntagResource, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &UntagResourceInput{} - } - - output = &UntagResourceOutput{} - req = c.newRequest(op, input, output) - req.Handlers.Unmarshal.Swap(jsonrpc.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) - return -} - -// UntagResource API operation for Amazon Elastic Container Service. -// -// Deletes specified tags from a resource. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation UntagResource for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ResourceNotFoundException -// The specified resource wasn't found. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error) { - req, out := c.UntagResourceRequest(input) - return out, req.Send() -} - -// UntagResourceWithContext is the same as UntagResource with the addition of -// the ability to pass a context and additional request options. -// -// See UntagResource for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) UntagResourceWithContext(ctx aws.Context, input *UntagResourceInput, opts ...request.Option) (*UntagResourceOutput, error) { - req, out := c.UntagResourceRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opUpdateCapacityProvider = "UpdateCapacityProvider" - -// UpdateCapacityProviderRequest generates a "aws/request.Request" representing the -// client's request for the UpdateCapacityProvider operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See UpdateCapacityProvider for more information on using the UpdateCapacityProvider -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the UpdateCapacityProviderRequest method. -// req, resp := client.UpdateCapacityProviderRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) UpdateCapacityProviderRequest(input *UpdateCapacityProviderInput) (req *request.Request, output *UpdateCapacityProviderOutput) { - op := &request.Operation{ - Name: opUpdateCapacityProvider, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &UpdateCapacityProviderInput{} - } - - output = &UpdateCapacityProviderOutput{} - req = c.newRequest(op, input, output) - return -} - -// UpdateCapacityProvider API operation for Amazon Elastic Container Service. -// -// Modifies the parameters for a capacity provider. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation UpdateCapacityProvider for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) UpdateCapacityProvider(input *UpdateCapacityProviderInput) (*UpdateCapacityProviderOutput, error) { - req, out := c.UpdateCapacityProviderRequest(input) - return out, req.Send() -} - -// UpdateCapacityProviderWithContext is the same as UpdateCapacityProvider with the addition of -// the ability to pass a context and additional request options. -// -// See UpdateCapacityProvider for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) UpdateCapacityProviderWithContext(ctx aws.Context, input *UpdateCapacityProviderInput, opts ...request.Option) (*UpdateCapacityProviderOutput, error) { - req, out := c.UpdateCapacityProviderRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opUpdateCluster = "UpdateCluster" - -// UpdateClusterRequest generates a "aws/request.Request" representing the -// client's request for the UpdateCluster operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See UpdateCluster for more information on using the UpdateCluster -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the UpdateClusterRequest method. -// req, resp := client.UpdateClusterRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) UpdateClusterRequest(input *UpdateClusterInput) (req *request.Request, output *UpdateClusterOutput) { - op := &request.Operation{ - Name: opUpdateCluster, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &UpdateClusterInput{} - } - - output = &UpdateClusterOutput{} - req = c.newRequest(op, input, output) - return -} - -// UpdateCluster API operation for Amazon Elastic Container Service. -// -// Updates the cluster. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation UpdateCluster for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - NamespaceNotFoundException -// The specified namespace wasn't found. -func (c *ECS) UpdateCluster(input *UpdateClusterInput) (*UpdateClusterOutput, error) { - req, out := c.UpdateClusterRequest(input) - return out, req.Send() -} - -// UpdateClusterWithContext is the same as UpdateCluster with the addition of -// the ability to pass a context and additional request options. -// -// See UpdateCluster for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) UpdateClusterWithContext(ctx aws.Context, input *UpdateClusterInput, opts ...request.Option) (*UpdateClusterOutput, error) { - req, out := c.UpdateClusterRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opUpdateClusterSettings = "UpdateClusterSettings" - -// UpdateClusterSettingsRequest generates a "aws/request.Request" representing the -// client's request for the UpdateClusterSettings operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See UpdateClusterSettings for more information on using the UpdateClusterSettings -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the UpdateClusterSettingsRequest method. -// req, resp := client.UpdateClusterSettingsRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) UpdateClusterSettingsRequest(input *UpdateClusterSettingsInput) (req *request.Request, output *UpdateClusterSettingsOutput) { - op := &request.Operation{ - Name: opUpdateClusterSettings, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &UpdateClusterSettingsInput{} - } - - output = &UpdateClusterSettingsOutput{} - req = c.newRequest(op, input, output) - return -} - -// UpdateClusterSettings API operation for Amazon Elastic Container Service. -// -// Modifies the settings to use for a cluster. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation UpdateClusterSettings for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) UpdateClusterSettings(input *UpdateClusterSettingsInput) (*UpdateClusterSettingsOutput, error) { - req, out := c.UpdateClusterSettingsRequest(input) - return out, req.Send() -} - -// UpdateClusterSettingsWithContext is the same as UpdateClusterSettings with the addition of -// the ability to pass a context and additional request options. -// -// See UpdateClusterSettings for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) UpdateClusterSettingsWithContext(ctx aws.Context, input *UpdateClusterSettingsInput, opts ...request.Option) (*UpdateClusterSettingsOutput, error) { - req, out := c.UpdateClusterSettingsRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opUpdateContainerAgent = "UpdateContainerAgent" - -// UpdateContainerAgentRequest generates a "aws/request.Request" representing the -// client's request for the UpdateContainerAgent operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See UpdateContainerAgent for more information on using the UpdateContainerAgent -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the UpdateContainerAgentRequest method. -// req, resp := client.UpdateContainerAgentRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) UpdateContainerAgentRequest(input *UpdateContainerAgentInput) (req *request.Request, output *UpdateContainerAgentOutput) { - op := &request.Operation{ - Name: opUpdateContainerAgent, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &UpdateContainerAgentInput{} - } - - output = &UpdateContainerAgentOutput{} - req = c.newRequest(op, input, output) - return -} - -// UpdateContainerAgent API operation for Amazon Elastic Container Service. -// -// Updates the Amazon ECS container agent on a specified container instance. -// Updating the Amazon ECS container agent doesn't interrupt running tasks or -// services on the container instance. The process for updating the agent differs -// depending on whether your container instance was launched with the Amazon -// ECS-optimized AMI or another operating system. -// -// The UpdateContainerAgent API isn't supported for container instances using -// the Amazon ECS-optimized Amazon Linux 2 (arm64) AMI. To update the container -// agent, you can update the ecs-init package. This updates the agent. For more -// information, see Updating the Amazon ECS container agent (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/agent-update-ecs-ami.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Agent updates with the UpdateContainerAgent API operation do not apply to -// Windows container instances. We recommend that you launch new container instances -// to update the agent version in your Windows clusters. -// -// The UpdateContainerAgent API requires an Amazon ECS-optimized AMI or Amazon -// Linux AMI with the ecs-init service installed and running. For help updating -// the Amazon ECS container agent on other operating systems, see Manually updating -// the Amazon ECS container agent (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html#manually_update_agent) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation UpdateContainerAgent for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - MissingVersionException -// Amazon ECS can't determine the current version of the Amazon ECS container -// agent on the container instance and doesn't have enough information to proceed -// with an update. This could be because the agent running on the container -// instance is a previous or custom version that doesn't use our version information. -// -// - NoUpdateAvailableException -// There's no update available for this Amazon ECS container agent. This might -// be because the agent is already running the latest version or because it's -// so old that there's no update path to the current version. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - UpdateInProgressException -// There's already a current Amazon ECS container agent update in progress on -// the container instance that's specified. If the container agent becomes disconnected -// while it's in a transitional stage, such as PENDING or STAGING, the update -// process can get stuck in that state. However, when the agent reconnects, -// it resumes where it stopped previously. -func (c *ECS) UpdateContainerAgent(input *UpdateContainerAgentInput) (*UpdateContainerAgentOutput, error) { - req, out := c.UpdateContainerAgentRequest(input) - return out, req.Send() -} - -// UpdateContainerAgentWithContext is the same as UpdateContainerAgent with the addition of -// the ability to pass a context and additional request options. -// -// See UpdateContainerAgent for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) UpdateContainerAgentWithContext(ctx aws.Context, input *UpdateContainerAgentInput, opts ...request.Option) (*UpdateContainerAgentOutput, error) { - req, out := c.UpdateContainerAgentRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opUpdateContainerInstancesState = "UpdateContainerInstancesState" - -// UpdateContainerInstancesStateRequest generates a "aws/request.Request" representing the -// client's request for the UpdateContainerInstancesState operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See UpdateContainerInstancesState for more information on using the UpdateContainerInstancesState -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the UpdateContainerInstancesStateRequest method. -// req, resp := client.UpdateContainerInstancesStateRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) UpdateContainerInstancesStateRequest(input *UpdateContainerInstancesStateInput) (req *request.Request, output *UpdateContainerInstancesStateOutput) { - op := &request.Operation{ - Name: opUpdateContainerInstancesState, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &UpdateContainerInstancesStateInput{} - } - - output = &UpdateContainerInstancesStateOutput{} - req = c.newRequest(op, input, output) - return -} - -// UpdateContainerInstancesState API operation for Amazon Elastic Container Service. -// -// Modifies the status of an Amazon ECS container instance. -// -// Once a container instance has reached an ACTIVE state, you can change the -// status of a container instance to DRAINING to manually remove an instance -// from a cluster, for example to perform system updates, update the Docker -// daemon, or scale down the cluster size. -// -// A container instance can't be changed to DRAINING until it has reached an -// ACTIVE status. If the instance is in any other status, an error will be received. -// -// When you set a container instance to DRAINING, Amazon ECS prevents new tasks -// from being scheduled for placement on the container instance and replacement -// service tasks are started on other container instances in the cluster if -// the resources are available. Service tasks on the container instance that -// are in the PENDING state are stopped immediately. -// -// Service tasks on the container instance that are in the RUNNING state are -// stopped and replaced according to the service's deployment configuration -// parameters, minimumHealthyPercent and maximumPercent. You can change the -// deployment configuration of your service using UpdateService. -// -// - If minimumHealthyPercent is below 100%, the scheduler can ignore desiredCount -// temporarily during task replacement. For example, desiredCount is four -// tasks, a minimum of 50% allows the scheduler to stop two existing tasks -// before starting two new tasks. If the minimum is 100%, the service scheduler -// can't remove existing tasks until the replacement tasks are considered -// healthy. Tasks for services that do not use a load balancer are considered -// healthy if they're in the RUNNING state. Tasks for services that use a -// load balancer are considered healthy if they're in the RUNNING state and -// are reported as healthy by the load balancer. -// -// - The maximumPercent parameter represents an upper limit on the number -// of running tasks during task replacement. You can use this to define the -// replacement batch size. For example, if desiredCount is four tasks, a -// maximum of 200% starts four new tasks before stopping the four tasks to -// be drained, provided that the cluster resources required to do this are -// available. If the maximum is 100%, then replacement tasks can't start -// until the draining tasks have stopped. -// -// Any PENDING or RUNNING tasks that do not belong to a service aren't affected. -// You must wait for them to finish or stop them manually. -// -// A container instance has completed draining when it has no more RUNNING tasks. -// You can verify this using ListTasks. -// -// When a container instance has been drained, you can set a container instance -// to ACTIVE status and once it has reached that status the Amazon ECS scheduler -// can begin scheduling tasks on the instance again. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation UpdateContainerInstancesState for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -func (c *ECS) UpdateContainerInstancesState(input *UpdateContainerInstancesStateInput) (*UpdateContainerInstancesStateOutput, error) { - req, out := c.UpdateContainerInstancesStateRequest(input) - return out, req.Send() -} - -// UpdateContainerInstancesStateWithContext is the same as UpdateContainerInstancesState with the addition of -// the ability to pass a context and additional request options. -// -// See UpdateContainerInstancesState for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) UpdateContainerInstancesStateWithContext(ctx aws.Context, input *UpdateContainerInstancesStateInput, opts ...request.Option) (*UpdateContainerInstancesStateOutput, error) { - req, out := c.UpdateContainerInstancesStateRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opUpdateService = "UpdateService" - -// UpdateServiceRequest generates a "aws/request.Request" representing the -// client's request for the UpdateService operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See UpdateService for more information on using the UpdateService -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the UpdateServiceRequest method. -// req, resp := client.UpdateServiceRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) UpdateServiceRequest(input *UpdateServiceInput) (req *request.Request, output *UpdateServiceOutput) { - op := &request.Operation{ - Name: opUpdateService, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &UpdateServiceInput{} - } - - output = &UpdateServiceOutput{} - req = c.newRequest(op, input, output) - return -} - -// UpdateService API operation for Amazon Elastic Container Service. -// -// Modifies the parameters of a service. -// -// For services using the rolling update (ECS) you can update the desired count, -// deployment configuration, network configuration, load balancers, service -// registries, enable ECS managed tags option, propagate tags option, task placement -// constraints and strategies, and task definition. When you update any of these -// parameters, Amazon ECS starts new tasks with the new configuration. -// -// For services using the blue/green (CODE_DEPLOY) deployment controller, only -// the desired count, deployment configuration, health check grace period, task -// placement constraints and strategies, enable ECS managed tags option, and -// propagate tags can be updated using this API. If the network configuration, -// platform version, task definition, or load balancer need to be updated, create -// a new CodeDeploy deployment. For more information, see CreateDeployment (https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html) -// in the CodeDeploy API Reference. -// -// For services using an external deployment controller, you can update only -// the desired count, task placement constraints and strategies, health check -// grace period, enable ECS managed tags option, and propagate tags option, -// using this API. If the launch type, load balancer, network configuration, -// platform version, or task definition need to be updated, create a new task -// set For more information, see CreateTaskSet. -// -// You can add to or subtract from the number of instantiations of a task definition -// in a service by specifying the cluster that the service is running in and -// a new desiredCount parameter. -// -// If you have updated the Docker image of your application, you can create -// a new task definition with that image and deploy it to your service. The -// service scheduler uses the minimum healthy percent and maximum percent parameters -// (in the service's deployment configuration) to determine the deployment strategy. -// -// If your updated Docker image uses the same tag as what is in the existing -// task definition for your service (for example, my_image:latest), you don't -// need to create a new revision of your task definition. You can update the -// service using the forceNewDeployment option. The new tasks launched by the -// deployment pull the current image/tag combination from your repository when -// they start. -// -// You can also update the deployment configuration of a service. When a deployment -// is triggered by updating the task definition of a service, the service scheduler -// uses the deployment configuration parameters, minimumHealthyPercent and maximumPercent, -// to determine the deployment strategy. -// -// - If minimumHealthyPercent is below 100%, the scheduler can ignore desiredCount -// temporarily during a deployment. For example, if desiredCount is four -// tasks, a minimum of 50% allows the scheduler to stop two existing tasks -// before starting two new tasks. Tasks for services that don't use a load -// balancer are considered healthy if they're in the RUNNING state. Tasks -// for services that use a load balancer are considered healthy if they're -// in the RUNNING state and are reported as healthy by the load balancer. -// -// - The maximumPercent parameter represents an upper limit on the number -// of running tasks during a deployment. You can use it to define the deployment -// batch size. For example, if desiredCount is four tasks, a maximum of 200% -// starts four new tasks before stopping the four older tasks (provided that -// the cluster resources required to do this are available). -// -// When UpdateService stops a task during a deployment, the equivalent of docker -// stop is issued to the containers running in the task. This results in a SIGTERM -// and a 30-second timeout. After this, SIGKILL is sent and the containers are -// forcibly stopped. If the container handles the SIGTERM gracefully and exits -// within 30 seconds from receiving it, no SIGKILL is sent. -// -// When the service scheduler launches new tasks, it determines task placement -// in your cluster with the following logic. -// -// - Determine which of the container instances in your cluster can support -// your service's task definition. For example, they have the required CPU, -// memory, ports, and container instance attributes. -// -// - By default, the service scheduler attempts to balance tasks across Availability -// Zones in this manner even though you can choose a different placement -// strategy. Sort the valid container instances by the fewest number of running -// tasks for this service in the same Availability Zone as the instance. -// For example, if zone A has one running service task and zones B and C -// each have zero, valid container instances in either zone B or C are considered -// optimal for placement. Place the new service task on a valid container -// instance in an optimal Availability Zone (based on the previous steps), -// favoring container instances with the fewest number of running tasks for -// this service. -// -// When the service scheduler stops running tasks, it attempts to maintain balance -// across the Availability Zones in your cluster using the following logic: -// -// - Sort the container instances by the largest number of running tasks -// for this service in the same Availability Zone as the instance. For example, -// if zone A has one running service task and zones B and C each have two, -// container instances in either zone B or C are considered optimal for termination. -// -// - Stop the task on a container instance in an optimal Availability Zone -// (based on the previous steps), favoring container instances with the largest -// number of running tasks for this service. -// -// You must have a service-linked role when you update any of the following -// service properties: -// -// - loadBalancers, -// -// - serviceRegistries -// -// For more information about the role see the CreateService request parameter -// role (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html#ECS-CreateService-request-role). -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation UpdateService for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - NamespaceNotFoundException -// The specified namespace wasn't found. -// -// - PlatformTaskDefinitionIncompatibilityException -// The specified platform version doesn't satisfy the required capabilities -// of the task definition. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - ServiceNotFoundException -// The specified service wasn't found. You can view your available services -// with ListServices. Amazon ECS services are cluster specific and Region specific. -// -// - ServiceNotActiveException -// The specified service isn't active. You can't update a service that's inactive. -// If you have previously deleted a service, you can re-create it with CreateService. -// -// - PlatformUnknownException -// The specified platform version doesn't exist. -func (c *ECS) UpdateService(input *UpdateServiceInput) (*UpdateServiceOutput, error) { - req, out := c.UpdateServiceRequest(input) - return out, req.Send() -} - -// UpdateServiceWithContext is the same as UpdateService with the addition of -// the ability to pass a context and additional request options. -// -// See UpdateService for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) UpdateServiceWithContext(ctx aws.Context, input *UpdateServiceInput, opts ...request.Option) (*UpdateServiceOutput, error) { - req, out := c.UpdateServiceRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opUpdateServicePrimaryTaskSet = "UpdateServicePrimaryTaskSet" - -// UpdateServicePrimaryTaskSetRequest generates a "aws/request.Request" representing the -// client's request for the UpdateServicePrimaryTaskSet operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See UpdateServicePrimaryTaskSet for more information on using the UpdateServicePrimaryTaskSet -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the UpdateServicePrimaryTaskSetRequest method. -// req, resp := client.UpdateServicePrimaryTaskSetRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) UpdateServicePrimaryTaskSetRequest(input *UpdateServicePrimaryTaskSetInput) (req *request.Request, output *UpdateServicePrimaryTaskSetOutput) { - op := &request.Operation{ - Name: opUpdateServicePrimaryTaskSet, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &UpdateServicePrimaryTaskSetInput{} - } - - output = &UpdateServicePrimaryTaskSetOutput{} - req = c.newRequest(op, input, output) - return -} - -// UpdateServicePrimaryTaskSet API operation for Amazon Elastic Container Service. -// -// Modifies which task set in a service is the primary task set. Any parameters -// that are updated on the primary task set in a service will transition to -// the service. This is used when a service uses the EXTERNAL deployment controller -// type. For more information, see Amazon ECS Deployment Types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation UpdateServicePrimaryTaskSet for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - ServiceNotFoundException -// The specified service wasn't found. You can view your available services -// with ListServices. Amazon ECS services are cluster specific and Region specific. -// -// - ServiceNotActiveException -// The specified service isn't active. You can't update a service that's inactive. -// If you have previously deleted a service, you can re-create it with CreateService. -// -// - TaskSetNotFoundException -// The specified task set wasn't found. You can view your available task sets -// with DescribeTaskSets. Task sets are specific to each cluster, service and -// Region. -func (c *ECS) UpdateServicePrimaryTaskSet(input *UpdateServicePrimaryTaskSetInput) (*UpdateServicePrimaryTaskSetOutput, error) { - req, out := c.UpdateServicePrimaryTaskSetRequest(input) - return out, req.Send() -} - -// UpdateServicePrimaryTaskSetWithContext is the same as UpdateServicePrimaryTaskSet with the addition of -// the ability to pass a context and additional request options. -// -// See UpdateServicePrimaryTaskSet for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) UpdateServicePrimaryTaskSetWithContext(ctx aws.Context, input *UpdateServicePrimaryTaskSetInput, opts ...request.Option) (*UpdateServicePrimaryTaskSetOutput, error) { - req, out := c.UpdateServicePrimaryTaskSetRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opUpdateTaskProtection = "UpdateTaskProtection" - -// UpdateTaskProtectionRequest generates a "aws/request.Request" representing the -// client's request for the UpdateTaskProtection operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See UpdateTaskProtection for more information on using the UpdateTaskProtection -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the UpdateTaskProtectionRequest method. -// req, resp := client.UpdateTaskProtectionRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) UpdateTaskProtectionRequest(input *UpdateTaskProtectionInput) (req *request.Request, output *UpdateTaskProtectionOutput) { - op := &request.Operation{ - Name: opUpdateTaskProtection, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &UpdateTaskProtectionInput{} - } - - output = &UpdateTaskProtectionOutput{} - req = c.newRequest(op, input, output) - return -} - -// UpdateTaskProtection API operation for Amazon Elastic Container Service. -// -// Updates the protection status of a task. You can set protectionEnabled to -// true to protect your task from termination during scale-in events from Service -// Autoscaling (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-auto-scaling.html) -// or deployments (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html). -// -// Task-protection, by default, expires after 2 hours at which point Amazon -// ECS clears the protectionEnabled property making the task eligible for termination -// by a subsequent scale-in event. -// -// You can specify a custom expiration period for task protection from 1 minute -// to up to 2,880 minutes (48 hours). To specify the custom expiration period, -// set the expiresInMinutes property. The expiresInMinutes property is always -// reset when you invoke this operation for a task that already has protectionEnabled -// set to true. You can keep extending the protection expiration period of a -// task by invoking this operation repeatedly. -// -// To learn more about Amazon ECS task protection, see Task scale-in protection -// (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-scale-in-protection.html) -// in the Amazon Elastic Container Service Developer Guide . -// -// This operation is only supported for tasks belonging to an Amazon ECS service. -// Invoking this operation for a standalone task will result in an TASK_NOT_VALID -// failure. For more information, see API failure reasons (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/api_failures_messages.html). -// -// If you prefer to set task protection from within the container, we recommend -// using the Task scale-in protection endpoint (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-scale-in-protection-endpoint.html). -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation UpdateTaskProtection for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - ResourceNotFoundException -// The specified resource wasn't found. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - UnsupportedFeatureException -// The specified task isn't supported in this Region. -func (c *ECS) UpdateTaskProtection(input *UpdateTaskProtectionInput) (*UpdateTaskProtectionOutput, error) { - req, out := c.UpdateTaskProtectionRequest(input) - return out, req.Send() -} - -// UpdateTaskProtectionWithContext is the same as UpdateTaskProtection with the addition of -// the ability to pass a context and additional request options. -// -// See UpdateTaskProtection for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) UpdateTaskProtectionWithContext(ctx aws.Context, input *UpdateTaskProtectionInput, opts ...request.Option) (*UpdateTaskProtectionOutput, error) { - req, out := c.UpdateTaskProtectionRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -const opUpdateTaskSet = "UpdateTaskSet" - -// UpdateTaskSetRequest generates a "aws/request.Request" representing the -// client's request for the UpdateTaskSet operation. The "output" return -// value will be populated with the request's response once the request completes -// successfully. -// -// Use "Send" method on the returned Request to send the API call to the service. -// the "output" return value is not valid until after Send returns without error. -// -// See UpdateTaskSet for more information on using the UpdateTaskSet -// API call, and error handling. -// -// This method is useful when you want to inject custom logic or configuration -// into the SDK's request lifecycle. Such as custom headers, or retry logic. -// -// // Example sending a request using the UpdateTaskSetRequest method. -// req, resp := client.UpdateTaskSetRequest(params) -// -// err := req.Send() -// if err == nil { // resp is now filled -// fmt.Println(resp) -// } -func (c *ECS) UpdateTaskSetRequest(input *UpdateTaskSetInput) (req *request.Request, output *UpdateTaskSetOutput) { - op := &request.Operation{ - Name: opUpdateTaskSet, - HTTPMethod: "POST", - HTTPPath: "/", - } - - if input == nil { - input = &UpdateTaskSetInput{} - } - - output = &UpdateTaskSetOutput{} - req = c.newRequest(op, input, output) - return -} - -// UpdateTaskSet API operation for Amazon Elastic Container Service. -// -// Modifies a task set. This is used when a service uses the EXTERNAL deployment -// controller type. For more information, see Amazon ECS Deployment Types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Returns awserr.Error for service API and SDK errors. Use runtime type assertions -// with awserr.Error's Code and Message methods to get detailed information about -// the error. -// -// See the AWS API reference guide for Amazon Elastic Container Service's -// API operation UpdateTaskSet for usage and error information. -// -// Returned Error Types: -// -// - AccessDeniedException -// You don't have authorization to perform the requested action. -// -// - ClientException -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -// -// - ClusterNotFoundException -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -// -// - InvalidParameterException -// The specified parameter isn't valid. Review the available parameters for -// the API request. -// -// - LimitExceededException -// The limit for the resource was exceeded. -// -// - ServerException -// These errors are usually caused by a server issue. -// -// - ServiceNotFoundException -// The specified service wasn't found. You can view your available services -// with ListServices. Amazon ECS services are cluster specific and Region specific. -// -// - ServiceNotActiveException -// The specified service isn't active. You can't update a service that's inactive. -// If you have previously deleted a service, you can re-create it with CreateService. -// -// - TaskSetNotFoundException -// The specified task set wasn't found. You can view your available task sets -// with DescribeTaskSets. Task sets are specific to each cluster, service and -// Region. -// -// - UnsupportedFeatureException -// The specified task isn't supported in this Region. -func (c *ECS) UpdateTaskSet(input *UpdateTaskSetInput) (*UpdateTaskSetOutput, error) { - req, out := c.UpdateTaskSetRequest(input) - return out, req.Send() -} - -// UpdateTaskSetWithContext is the same as UpdateTaskSet with the addition of -// the ability to pass a context and additional request options. -// -// See UpdateTaskSet for details on how to use this API operation. -// -// The context must be non-nil and will be used for request cancellation. If -// the context is nil a panic will occur. In the future the SDK may create -// sub-contexts for http.Requests. See https://golang.org/pkg/context/ -// for more information on using Contexts. -func (c *ECS) UpdateTaskSetWithContext(ctx aws.Context, input *UpdateTaskSetInput, opts ...request.Option) (*UpdateTaskSetOutput, error) { - req, out := c.UpdateTaskSetRequest(input) - req.SetContext(ctx) - req.ApplyOptions(opts...) - return out, req.Send() -} - -// You don't have authorization to perform the requested action. -type AccessDeniedException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AccessDeniedException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AccessDeniedException) GoString() string { - return s.String() -} - -func newErrorAccessDeniedException(v protocol.ResponseMetadata) error { - return &AccessDeniedException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *AccessDeniedException) Code() string { - return "AccessDeniedException" -} - -// Message returns the exception's message. -func (s *AccessDeniedException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *AccessDeniedException) OrigErr() error { - return nil -} - -func (s *AccessDeniedException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *AccessDeniedException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *AccessDeniedException) RequestID() string { - return s.RespMetadata.RequestID -} - -type AccountDetail struct { - _ struct{} `type:"structure"` - - AccountId *string `locationName:"accountId" type:"string"` - - CredentialProvider *string `locationName:"credentialProvider" type:"string"` - - // CredentialToken is a sensitive parameter and its value will be - // replaced with "sensitive" in string returned by AccountDetail's - // String and GoString methods. - CredentialToken *string `locationName:"credentialToken" type:"string" sensitive:"true"` - - Token *string `locationName:"token" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AccountDetail) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AccountDetail) GoString() string { - return s.String() -} - -// SetAccountId sets the AccountId field's value. -func (s *AccountDetail) SetAccountId(v string) *AccountDetail { - s.AccountId = &v - return s -} - -// SetCredentialProvider sets the CredentialProvider field's value. -func (s *AccountDetail) SetCredentialProvider(v string) *AccountDetail { - s.CredentialProvider = &v - return s -} - -// SetCredentialToken sets the CredentialToken field's value. -func (s *AccountDetail) SetCredentialToken(v string) *AccountDetail { - s.CredentialToken = &v - return s -} - -// SetToken sets the Token field's value. -func (s *AccountDetail) SetToken(v string) *AccountDetail { - s.Token = &v - return s -} - -// An object representing a container instance or task attachment. -type Attachment struct { - _ struct{} `type:"structure"` - - // Details of the attachment. For elastic network interfaces, this includes - // the network interface ID, the MAC address, the subnet ID, and the private - // IPv4 address. - Details []*KeyValuePair `locationName:"details" type:"list"` - - // The unique identifier for the attachment. - Id *string `locationName:"id" type:"string"` - - // The status of the attachment. Valid values are PRECREATED, CREATED, ATTACHING, - // ATTACHED, DETACHING, DETACHED, DELETED, and FAILED. - Status *string `locationName:"status" type:"string"` - - // The type of the attachment, such as ElasticNetworkInterface. - Type *string `locationName:"type" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Attachment) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Attachment) GoString() string { - return s.String() -} - -// SetDetails sets the Details field's value. -func (s *Attachment) SetDetails(v []*KeyValuePair) *Attachment { - s.Details = v - return s -} - -// SetId sets the Id field's value. -func (s *Attachment) SetId(v string) *Attachment { - s.Id = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *Attachment) SetStatus(v string) *Attachment { - s.Status = &v - return s -} - -// SetType sets the Type field's value. -func (s *Attachment) SetType(v string) *Attachment { - s.Type = &v - return s -} - -// An object representing a change in state for a task attachment. -type AttachmentStateChange struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) of the attachment. - // - // AttachmentArn is a required field - AttachmentArn *string `locationName:"attachmentArn" type:"string" required:"true"` - - // The status of the attachment. - // - // Status is a required field - Status *string `locationName:"status" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AttachmentStateChange) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AttachmentStateChange) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *AttachmentStateChange) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "AttachmentStateChange"} - if s.AttachmentArn == nil { - invalidParams.Add(request.NewErrParamRequired("AttachmentArn")) - } - if s.Status == nil { - invalidParams.Add(request.NewErrParamRequired("Status")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAttachmentArn sets the AttachmentArn field's value. -func (s *AttachmentStateChange) SetAttachmentArn(v string) *AttachmentStateChange { - s.AttachmentArn = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *AttachmentStateChange) SetStatus(v string) *AttachmentStateChange { - s.Status = &v - return s -} - -// An attribute is a name-value pair that's associated with an Amazon ECS object. -// Use attributes to extend the Amazon ECS data model by adding custom metadata -// to your resources. For more information, see Attributes (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html#attributes) -// in the Amazon Elastic Container Service Developer Guide. -type Attribute struct { - _ struct{} `type:"structure"` - - // The name of the attribute. The name must contain between 1 and 128 characters. - // The name may contain letters (uppercase and lowercase), numbers, hyphens - // (-), underscores (_), forward slashes (/), back slashes (\), or periods (.). - // - // Name is a required field - Name *string `locationName:"name" type:"string" required:"true"` - - // The ID of the target. You can specify the short form ID for a resource or - // the full Amazon Resource Name (ARN). - TargetId *string `locationName:"targetId" type:"string"` - - // The type of the target to attach the attribute with. This parameter is required - // if you use the short form ID for a resource instead of the full ARN. - TargetType *string `locationName:"targetType" type:"string" enum:"TargetType"` - - // The value of the attribute. The value must contain between 1 and 128 characters. - // It can contain letters (uppercase and lowercase), numbers, hyphens (-), underscores - // (_), periods (.), at signs (@), forward slashes (/), back slashes (\), colons - // (:), or spaces. The value can't start or end with a space. - Value *string `locationName:"value" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Attribute) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Attribute) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *Attribute) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "Attribute"} - if s.Name == nil { - invalidParams.Add(request.NewErrParamRequired("Name")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetName sets the Name field's value. -func (s *Attribute) SetName(v string) *Attribute { - s.Name = &v - return s -} - -// SetTargetId sets the TargetId field's value. -func (s *Attribute) SetTargetId(v string) *Attribute { - s.TargetId = &v - return s -} - -// SetTargetType sets the TargetType field's value. -func (s *Attribute) SetTargetType(v string) *Attribute { - s.TargetType = &v - return s -} - -// SetValue sets the Value field's value. -func (s *Attribute) SetValue(v string) *Attribute { - s.Value = &v - return s -} - -// You can apply up to 10 custom attributes for each resource. You can view -// the attributes of a resource with ListAttributes. You can remove existing -// attributes on a resource with DeleteAttributes. -type AttributeLimitExceededException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AttributeLimitExceededException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AttributeLimitExceededException) GoString() string { - return s.String() -} - -func newErrorAttributeLimitExceededException(v protocol.ResponseMetadata) error { - return &AttributeLimitExceededException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *AttributeLimitExceededException) Code() string { - return "AttributeLimitExceededException" -} - -// Message returns the exception's message. -func (s *AttributeLimitExceededException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *AttributeLimitExceededException) OrigErr() error { - return nil -} - -func (s *AttributeLimitExceededException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *AttributeLimitExceededException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *AttributeLimitExceededException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The details of the Auto Scaling group for the capacity provider. -type AutoScalingGroupProvider struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or - // the Auto Scaling group name. - // - // AutoScalingGroupArn is a required field - AutoScalingGroupArn *string `locationName:"autoScalingGroupArn" type:"string" required:"true"` - - // The managed scaling settings for the Auto Scaling group capacity provider. - ManagedScaling *ManagedScaling `locationName:"managedScaling" type:"structure"` - - // The managed termination protection setting to use for the Auto Scaling group - // capacity provider. This determines whether the Auto Scaling group has managed - // termination protection. The default is off. - // - // When using managed termination protection, managed scaling must also be used - // otherwise managed termination protection doesn't work. - // - // When managed termination protection is on, Amazon ECS prevents the Amazon - // EC2 instances in an Auto Scaling group that contain tasks from being terminated - // during a scale-in action. The Auto Scaling group and each instance in the - // Auto Scaling group must have instance protection from scale-in actions on - // as well. For more information, see Instance Protection (https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection) - // in the Auto Scaling User Guide. - // - // When managed termination protection is off, your Amazon EC2 instances aren't - // protected from termination when the Auto Scaling group scales in. - ManagedTerminationProtection *string `locationName:"managedTerminationProtection" type:"string" enum:"ManagedTerminationProtection"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AutoScalingGroupProvider) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AutoScalingGroupProvider) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *AutoScalingGroupProvider) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "AutoScalingGroupProvider"} - if s.AutoScalingGroupArn == nil { - invalidParams.Add(request.NewErrParamRequired("AutoScalingGroupArn")) - } - if s.ManagedScaling != nil { - if err := s.ManagedScaling.Validate(); err != nil { - invalidParams.AddNested("ManagedScaling", err.(request.ErrInvalidParams)) - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAutoScalingGroupArn sets the AutoScalingGroupArn field's value. -func (s *AutoScalingGroupProvider) SetAutoScalingGroupArn(v string) *AutoScalingGroupProvider { - s.AutoScalingGroupArn = &v - return s -} - -// SetManagedScaling sets the ManagedScaling field's value. -func (s *AutoScalingGroupProvider) SetManagedScaling(v *ManagedScaling) *AutoScalingGroupProvider { - s.ManagedScaling = v - return s -} - -// SetManagedTerminationProtection sets the ManagedTerminationProtection field's value. -func (s *AutoScalingGroupProvider) SetManagedTerminationProtection(v string) *AutoScalingGroupProvider { - s.ManagedTerminationProtection = &v - return s -} - -// The details of the Auto Scaling group capacity provider to update. -type AutoScalingGroupProviderUpdate struct { - _ struct{} `type:"structure"` - - // The managed scaling settings for the Auto Scaling group capacity provider. - ManagedScaling *ManagedScaling `locationName:"managedScaling" type:"structure"` - - // The managed termination protection setting to use for the Auto Scaling group - // capacity provider. This determines whether the Auto Scaling group has managed - // termination protection. - // - // When using managed termination protection, managed scaling must also be used - // otherwise managed termination protection doesn't work. - // - // When managed termination protection is on, Amazon ECS prevents the Amazon - // EC2 instances in an Auto Scaling group that contain tasks from being terminated - // during a scale-in action. The Auto Scaling group and each instance in the - // Auto Scaling group must have instance protection from scale-in actions on. - // For more information, see Instance Protection (https://docs.aws.amazon.com/autoscaling/ec2/userguide/as-instance-termination.html#instance-protection) - // in the Auto Scaling User Guide. - // - // When managed termination protection is off, your Amazon EC2 instances aren't - // protected from termination when the Auto Scaling group scales in. - ManagedTerminationProtection *string `locationName:"managedTerminationProtection" type:"string" enum:"ManagedTerminationProtection"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AutoScalingGroupProviderUpdate) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AutoScalingGroupProviderUpdate) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *AutoScalingGroupProviderUpdate) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "AutoScalingGroupProviderUpdate"} - if s.ManagedScaling != nil { - if err := s.ManagedScaling.Validate(); err != nil { - invalidParams.AddNested("ManagedScaling", err.(request.ErrInvalidParams)) - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetManagedScaling sets the ManagedScaling field's value. -func (s *AutoScalingGroupProviderUpdate) SetManagedScaling(v *ManagedScaling) *AutoScalingGroupProviderUpdate { - s.ManagedScaling = v - return s -} - -// SetManagedTerminationProtection sets the ManagedTerminationProtection field's value. -func (s *AutoScalingGroupProviderUpdate) SetManagedTerminationProtection(v string) *AutoScalingGroupProviderUpdate { - s.ManagedTerminationProtection = &v - return s -} - -// An object representing the networking details for a task or service. -type AwsVpcConfiguration struct { - _ struct{} `type:"structure"` - - // Whether the task's elastic network interface receives a public IP address. - // The default value is DISABLED. - AssignPublicIp *string `locationName:"assignPublicIp" type:"string" enum:"AssignPublicIp"` - - // The IDs of the security groups associated with the task or service. If you - // don't specify a security group, the default security group for the VPC is - // used. There's a limit of 5 security groups that can be specified per AwsVpcConfiguration. - // - // All specified security groups must be from the same VPC. - SecurityGroups []*string `locationName:"securityGroups" type:"list"` - - // The IDs of the subnets associated with the task or service. There's a limit - // of 16 subnets that can be specified per AwsVpcConfiguration. - // - // All specified subnets must be from the same VPC. - Subnets []*string `locationName:"subnets" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AwsVpcConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s AwsVpcConfiguration) GoString() string { - return s.String() -} - -// SetAssignPublicIp sets the AssignPublicIp field's value. -func (s *AwsVpcConfiguration) SetAssignPublicIp(v string) *AwsVpcConfiguration { - s.AssignPublicIp = &v - return s -} - -// SetSecurityGroups sets the SecurityGroups field's value. -func (s *AwsVpcConfiguration) SetSecurityGroups(v []*string) *AwsVpcConfiguration { - s.SecurityGroups = v - return s -} - -// SetSubnets sets the Subnets field's value. -func (s *AwsVpcConfiguration) SetSubnets(v []*string) *AwsVpcConfiguration { - s.Subnets = v - return s -} - -// Your Amazon Web Services account was blocked. For more information, contact -// Amazon Web Services Support (http://aws.amazon.com/contact-us/). -type BlockedException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s BlockedException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s BlockedException) GoString() string { - return s.String() -} - -func newErrorBlockedException(v protocol.ResponseMetadata) error { - return &BlockedException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *BlockedException) Code() string { - return "BlockedException" -} - -// Message returns the exception's message. -func (s *BlockedException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *BlockedException) OrigErr() error { - return nil -} - -func (s *BlockedException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *BlockedException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *BlockedException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The details for a capacity provider. -type CapacityProvider struct { - _ struct{} `type:"structure"` - - // The Auto Scaling group settings for the capacity provider. - AutoScalingGroupProvider *AutoScalingGroupProvider `locationName:"autoScalingGroupProvider" type:"structure"` - - // The Amazon Resource Name (ARN) that identifies the capacity provider. - CapacityProviderArn *string `locationName:"capacityProviderArn" type:"string"` - - // The name of the capacity provider. - Name *string `locationName:"name" type:"string"` - - // The current status of the capacity provider. Only capacity providers in an - // ACTIVE state can be used in a cluster. When a capacity provider is successfully - // deleted, it has an INACTIVE status. - Status *string `locationName:"status" type:"string" enum:"CapacityProviderStatus"` - - // The metadata that you apply to the capacity provider to help you categorize - // and organize it. Each tag consists of a key and an optional value. You define - // both. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The update status of the capacity provider. The following are the possible - // states that is returned. - // - // DELETE_IN_PROGRESS - // - // The capacity provider is in the process of being deleted. - // - // DELETE_COMPLETE - // - // The capacity provider was successfully deleted and has an INACTIVE status. - // - // DELETE_FAILED - // - // The capacity provider can't be deleted. The update status reason provides - // further details about why the delete failed. - UpdateStatus *string `locationName:"updateStatus" type:"string" enum:"CapacityProviderUpdateStatus"` - - // The update status reason. This provides further details about the update - // status for the capacity provider. - UpdateStatusReason *string `locationName:"updateStatusReason" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CapacityProvider) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CapacityProvider) GoString() string { - return s.String() -} - -// SetAutoScalingGroupProvider sets the AutoScalingGroupProvider field's value. -func (s *CapacityProvider) SetAutoScalingGroupProvider(v *AutoScalingGroupProvider) *CapacityProvider { - s.AutoScalingGroupProvider = v - return s -} - -// SetCapacityProviderArn sets the CapacityProviderArn field's value. -func (s *CapacityProvider) SetCapacityProviderArn(v string) *CapacityProvider { - s.CapacityProviderArn = &v - return s -} - -// SetName sets the Name field's value. -func (s *CapacityProvider) SetName(v string) *CapacityProvider { - s.Name = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *CapacityProvider) SetStatus(v string) *CapacityProvider { - s.Status = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *CapacityProvider) SetTags(v []*Tag) *CapacityProvider { - s.Tags = v - return s -} - -// SetUpdateStatus sets the UpdateStatus field's value. -func (s *CapacityProvider) SetUpdateStatus(v string) *CapacityProvider { - s.UpdateStatus = &v - return s -} - -// SetUpdateStatusReason sets the UpdateStatusReason field's value. -func (s *CapacityProvider) SetUpdateStatusReason(v string) *CapacityProvider { - s.UpdateStatusReason = &v - return s -} - -// The details of a capacity provider strategy. A capacity provider strategy -// can be set when using the RunTask or CreateCluster APIs or as the default -// capacity provider strategy for a cluster with the CreateCluster API. -// -// Only capacity providers that are already associated with a cluster and have -// an ACTIVE or UPDATING status can be used in a capacity provider strategy. -// The PutClusterCapacityProviders API is used to associate a capacity provider -// with a cluster. -// -// If specifying a capacity provider that uses an Auto Scaling group, the capacity -// provider must already be created. New Auto Scaling group capacity providers -// can be created with the CreateCapacityProvider API operation. -// -// To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT -// capacity providers. The Fargate capacity providers are available to all accounts -// and only need to be associated with a cluster to be used in a capacity provider -// strategy. -// -// A capacity provider strategy may contain a maximum of 6 capacity providers. -type CapacityProviderStrategyItem struct { - _ struct{} `type:"structure"` - - // The base value designates how many tasks, at a minimum, to run on the specified - // capacity provider. Only one capacity provider in a capacity provider strategy - // can have a base defined. If no value is specified, the default value of 0 - // is used. - Base *int64 `locationName:"base" type:"integer"` - - // The short name of the capacity provider. - // - // CapacityProvider is a required field - CapacityProvider *string `locationName:"capacityProvider" type:"string" required:"true"` - - // The weight value designates the relative percentage of the total number of - // tasks launched that should use the specified capacity provider. The weight - // value is taken into consideration after the base value, if defined, is satisfied. - // - // If no weight value is specified, the default value of 0 is used. When multiple - // capacity providers are specified within a capacity provider strategy, at - // least one of the capacity providers must have a weight value greater than - // zero and any capacity providers with a weight of 0 can't be used to place - // tasks. If you specify multiple capacity providers in a strategy that all - // have a weight of 0, any RunTask or CreateService actions using the capacity - // provider strategy will fail. - // - // An example scenario for using weights is defining a strategy that contains - // two capacity providers and both have a weight of 1, then when the base is - // satisfied, the tasks will be split evenly across the two capacity providers. - // Using that same logic, if you specify a weight of 1 for capacityProviderA - // and a weight of 4 for capacityProviderB, then for every one task that's run - // using capacityProviderA, four tasks would use capacityProviderB. - Weight *int64 `locationName:"weight" type:"integer"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CapacityProviderStrategyItem) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CapacityProviderStrategyItem) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *CapacityProviderStrategyItem) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "CapacityProviderStrategyItem"} - if s.CapacityProvider == nil { - invalidParams.Add(request.NewErrParamRequired("CapacityProvider")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetBase sets the Base field's value. -func (s *CapacityProviderStrategyItem) SetBase(v int64) *CapacityProviderStrategyItem { - s.Base = &v - return s -} - -// SetCapacityProvider sets the CapacityProvider field's value. -func (s *CapacityProviderStrategyItem) SetCapacityProvider(v string) *CapacityProviderStrategyItem { - s.CapacityProvider = &v - return s -} - -// SetWeight sets the Weight field's value. -func (s *CapacityProviderStrategyItem) SetWeight(v int64) *CapacityProviderStrategyItem { - s.Weight = &v - return s -} - -// These errors are usually caused by a client action. This client action might -// be using an action or resource on behalf of a user that doesn't have permissions -// to use the action or resource,. Or, it might be specifying an identifier -// that isn't valid. -type ClientException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClientException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClientException) GoString() string { - return s.String() -} - -func newErrorClientException(v protocol.ResponseMetadata) error { - return &ClientException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ClientException) Code() string { - return "ClientException" -} - -// Message returns the exception's message. -func (s *ClientException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ClientException) OrigErr() error { - return nil -} - -func (s *ClientException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ClientException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ClientException) RequestID() string { - return s.RespMetadata.RequestID -} - -// A regional grouping of one or more container instances where you can run -// task requests. Each account receives a default cluster the first time you -// use the Amazon ECS service, but you may also create other clusters. Clusters -// may contain more than one instance type simultaneously. -type Cluster struct { - _ struct{} `type:"structure"` - - // The number of services that are running on the cluster in an ACTIVE state. - // You can view these services with ListServices. - ActiveServicesCount *int64 `locationName:"activeServicesCount" type:"integer"` - - // The resources attached to a cluster. When using a capacity provider with - // a cluster, the capacity provider and associated resources are returned as - // cluster attachments. - Attachments []*Attachment `locationName:"attachments" type:"list"` - - // The status of the capacity providers associated with the cluster. The following - // are the states that are returned. - // - // UPDATE_IN_PROGRESS - // - // The available capacity providers for the cluster are updating. - // - // UPDATE_COMPLETE - // - // The capacity providers have successfully updated. - // - // UPDATE_FAILED - // - // The capacity provider updates failed. - AttachmentsStatus *string `locationName:"attachmentsStatus" type:"string"` - - // The capacity providers associated with the cluster. - CapacityProviders []*string `locationName:"capacityProviders" type:"list"` - - // The Amazon Resource Name (ARN) that identifies the cluster. For more information - // about the ARN format, see Amazon Resource Name (ARN) (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids) - // in the Amazon ECS Developer Guide. - ClusterArn *string `locationName:"clusterArn" type:"string"` - - // A user-generated string that you use to identify your cluster. - ClusterName *string `locationName:"clusterName" type:"string"` - - // The execute command configuration for the cluster. - Configuration *ClusterConfiguration `locationName:"configuration" type:"structure"` - - // The default capacity provider strategy for the cluster. When services or - // tasks are run in the cluster with no launch type or capacity provider strategy - // specified, the default capacity provider strategy is used. - DefaultCapacityProviderStrategy []*CapacityProviderStrategyItem `locationName:"defaultCapacityProviderStrategy" type:"list"` - - // The number of tasks in the cluster that are in the PENDING state. - PendingTasksCount *int64 `locationName:"pendingTasksCount" type:"integer"` - - // The number of container instances registered into the cluster. This includes - // container instances in both ACTIVE and DRAINING status. - RegisteredContainerInstancesCount *int64 `locationName:"registeredContainerInstancesCount" type:"integer"` - - // The number of tasks in the cluster that are in the RUNNING state. - RunningTasksCount *int64 `locationName:"runningTasksCount" type:"integer"` - - // Use this parameter to set a default Service Connect namespace. After you - // set a default Service Connect namespace, any new services with Service Connect - // turned on that are created in the cluster are added as client services in - // the namespace. This setting only applies to new services that set the enabled - // parameter to true in the ServiceConnectConfiguration. You can set the namespace - // of each service individually in the ServiceConnectConfiguration to override - // this default parameter. - // - // Tasks that run in a namespace can use short names to connect to services - // in the namespace. Tasks can connect to services across all of the clusters - // in the namespace. Tasks connect through a managed proxy container that collects - // logs and metrics for increased visibility. Only the tasks that Amazon ECS - // services create are supported with Service Connect. For more information, - // see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - ServiceConnectDefaults *ClusterServiceConnectDefaults `locationName:"serviceConnectDefaults" type:"structure"` - - // The settings for the cluster. This parameter indicates whether CloudWatch - // Container Insights is on or off for a cluster. - Settings []*ClusterSetting `locationName:"settings" type:"list"` - - // Additional information about your clusters that are separated by launch type. - // They include the following: - // - // * runningEC2TasksCount - // - // * RunningFargateTasksCount - // - // * pendingEC2TasksCount - // - // * pendingFargateTasksCount - // - // * activeEC2ServiceCount - // - // * activeFargateServiceCount - // - // * drainingEC2ServiceCount - // - // * drainingFargateServiceCount - Statistics []*KeyValuePair `locationName:"statistics" type:"list"` - - // The status of the cluster. The following are the possible states that are - // returned. - // - // ACTIVE - // - // The cluster is ready to accept tasks and if applicable you can register container - // instances with the cluster. - // - // PROVISIONING - // - // The cluster has capacity providers that are associated with it and the resources - // needed for the capacity provider are being created. - // - // DEPROVISIONING - // - // The cluster has capacity providers that are associated with it and the resources - // needed for the capacity provider are being deleted. - // - // FAILED - // - // The cluster has capacity providers that are associated with it and the resources - // needed for the capacity provider have failed to create. - // - // INACTIVE - // - // The cluster has been deleted. Clusters with an INACTIVE status may remain - // discoverable in your account for a period of time. However, this behavior - // is subject to change in the future. We don't recommend that you rely on INACTIVE - // clusters persisting. - Status *string `locationName:"status" type:"string"` - - // The metadata that you apply to the cluster to help you categorize and organize - // them. Each tag consists of a key and an optional value. You define both. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Cluster) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Cluster) GoString() string { - return s.String() -} - -// SetActiveServicesCount sets the ActiveServicesCount field's value. -func (s *Cluster) SetActiveServicesCount(v int64) *Cluster { - s.ActiveServicesCount = &v - return s -} - -// SetAttachments sets the Attachments field's value. -func (s *Cluster) SetAttachments(v []*Attachment) *Cluster { - s.Attachments = v - return s -} - -// SetAttachmentsStatus sets the AttachmentsStatus field's value. -func (s *Cluster) SetAttachmentsStatus(v string) *Cluster { - s.AttachmentsStatus = &v - return s -} - -// SetCapacityProviders sets the CapacityProviders field's value. -func (s *Cluster) SetCapacityProviders(v []*string) *Cluster { - s.CapacityProviders = v - return s -} - -// SetClusterArn sets the ClusterArn field's value. -func (s *Cluster) SetClusterArn(v string) *Cluster { - s.ClusterArn = &v - return s -} - -// SetClusterName sets the ClusterName field's value. -func (s *Cluster) SetClusterName(v string) *Cluster { - s.ClusterName = &v - return s -} - -// SetConfiguration sets the Configuration field's value. -func (s *Cluster) SetConfiguration(v *ClusterConfiguration) *Cluster { - s.Configuration = v - return s -} - -// SetDefaultCapacityProviderStrategy sets the DefaultCapacityProviderStrategy field's value. -func (s *Cluster) SetDefaultCapacityProviderStrategy(v []*CapacityProviderStrategyItem) *Cluster { - s.DefaultCapacityProviderStrategy = v - return s -} - -// SetPendingTasksCount sets the PendingTasksCount field's value. -func (s *Cluster) SetPendingTasksCount(v int64) *Cluster { - s.PendingTasksCount = &v - return s -} - -// SetRegisteredContainerInstancesCount sets the RegisteredContainerInstancesCount field's value. -func (s *Cluster) SetRegisteredContainerInstancesCount(v int64) *Cluster { - s.RegisteredContainerInstancesCount = &v - return s -} - -// SetRunningTasksCount sets the RunningTasksCount field's value. -func (s *Cluster) SetRunningTasksCount(v int64) *Cluster { - s.RunningTasksCount = &v - return s -} - -// SetServiceConnectDefaults sets the ServiceConnectDefaults field's value. -func (s *Cluster) SetServiceConnectDefaults(v *ClusterServiceConnectDefaults) *Cluster { - s.ServiceConnectDefaults = v - return s -} - -// SetSettings sets the Settings field's value. -func (s *Cluster) SetSettings(v []*ClusterSetting) *Cluster { - s.Settings = v - return s -} - -// SetStatistics sets the Statistics field's value. -func (s *Cluster) SetStatistics(v []*KeyValuePair) *Cluster { - s.Statistics = v - return s -} - -// SetStatus sets the Status field's value. -func (s *Cluster) SetStatus(v string) *Cluster { - s.Status = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *Cluster) SetTags(v []*Tag) *Cluster { - s.Tags = v - return s -} - -// The execute command configuration for the cluster. -type ClusterConfiguration struct { - _ struct{} `type:"structure"` - - // The details of the execute command configuration. - ExecuteCommandConfiguration *ExecuteCommandConfiguration `locationName:"executeCommandConfiguration" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterConfiguration) GoString() string { - return s.String() -} - -// SetExecuteCommandConfiguration sets the ExecuteCommandConfiguration field's value. -func (s *ClusterConfiguration) SetExecuteCommandConfiguration(v *ExecuteCommandConfiguration) *ClusterConfiguration { - s.ExecuteCommandConfiguration = v - return s -} - -// You can't delete a cluster that has registered container instances. First, -// deregister the container instances before you can delete the cluster. For -// more information, see DeregisterContainerInstance. -type ClusterContainsContainerInstancesException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterContainsContainerInstancesException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterContainsContainerInstancesException) GoString() string { - return s.String() -} - -func newErrorClusterContainsContainerInstancesException(v protocol.ResponseMetadata) error { - return &ClusterContainsContainerInstancesException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ClusterContainsContainerInstancesException) Code() string { - return "ClusterContainsContainerInstancesException" -} - -// Message returns the exception's message. -func (s *ClusterContainsContainerInstancesException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ClusterContainsContainerInstancesException) OrigErr() error { - return nil -} - -func (s *ClusterContainsContainerInstancesException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ClusterContainsContainerInstancesException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ClusterContainsContainerInstancesException) RequestID() string { - return s.RespMetadata.RequestID -} - -// You can't delete a cluster that contains services. First, update the service -// to reduce its desired task count to 0, and then delete the service. For more -// information, see UpdateService and DeleteService. -type ClusterContainsServicesException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterContainsServicesException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterContainsServicesException) GoString() string { - return s.String() -} - -func newErrorClusterContainsServicesException(v protocol.ResponseMetadata) error { - return &ClusterContainsServicesException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ClusterContainsServicesException) Code() string { - return "ClusterContainsServicesException" -} - -// Message returns the exception's message. -func (s *ClusterContainsServicesException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ClusterContainsServicesException) OrigErr() error { - return nil -} - -func (s *ClusterContainsServicesException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ClusterContainsServicesException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ClusterContainsServicesException) RequestID() string { - return s.RespMetadata.RequestID -} - -// You can't delete a cluster that has active tasks. -type ClusterContainsTasksException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterContainsTasksException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterContainsTasksException) GoString() string { - return s.String() -} - -func newErrorClusterContainsTasksException(v protocol.ResponseMetadata) error { - return &ClusterContainsTasksException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ClusterContainsTasksException) Code() string { - return "ClusterContainsTasksException" -} - -// Message returns the exception's message. -func (s *ClusterContainsTasksException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ClusterContainsTasksException) OrigErr() error { - return nil -} - -func (s *ClusterContainsTasksException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ClusterContainsTasksException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ClusterContainsTasksException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The specified cluster wasn't found. You can view your available clusters -// with ListClusters. Amazon ECS clusters are Region specific. -type ClusterNotFoundException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterNotFoundException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterNotFoundException) GoString() string { - return s.String() -} - -func newErrorClusterNotFoundException(v protocol.ResponseMetadata) error { - return &ClusterNotFoundException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ClusterNotFoundException) Code() string { - return "ClusterNotFoundException" -} - -// Message returns the exception's message. -func (s *ClusterNotFoundException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ClusterNotFoundException) OrigErr() error { - return nil -} - -func (s *ClusterNotFoundException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ClusterNotFoundException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ClusterNotFoundException) RequestID() string { - return s.RespMetadata.RequestID -} - -// Use this parameter to set a default Service Connect namespace. After you -// set a default Service Connect namespace, any new services with Service Connect -// turned on that are created in the cluster are added as client services in -// the namespace. This setting only applies to new services that set the enabled -// parameter to true in the ServiceConnectConfiguration. You can set the namespace -// of each service individually in the ServiceConnectConfiguration to override -// this default parameter. -// -// Tasks that run in a namespace can use short names to connect to services -// in the namespace. Tasks can connect to services across all of the clusters -// in the namespace. Tasks connect through a managed proxy container that collects -// logs and metrics for increased visibility. Only the tasks that Amazon ECS -// services create are supported with Service Connect. For more information, -// see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) -// in the Amazon Elastic Container Service Developer Guide. -type ClusterServiceConnectDefaults struct { - _ struct{} `type:"structure"` - - // The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace. - // When you create a service and don't specify a Service Connect configuration, - // this namespace is used. - Namespace *string `locationName:"namespace" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterServiceConnectDefaults) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterServiceConnectDefaults) GoString() string { - return s.String() -} - -// SetNamespace sets the Namespace field's value. -func (s *ClusterServiceConnectDefaults) SetNamespace(v string) *ClusterServiceConnectDefaults { - s.Namespace = &v - return s -} - -// Use this parameter to set a default Service Connect namespace. After you -// set a default Service Connect namespace, any new services with Service Connect -// turned on that are created in the cluster are added as client services in -// the namespace. This setting only applies to new services that set the enabled -// parameter to true in the ServiceConnectConfiguration. You can set the namespace -// of each service individually in the ServiceConnectConfiguration to override -// this default parameter. -// -// Tasks that run in a namespace can use short names to connect to services -// in the namespace. Tasks can connect to services across all of the clusters -// in the namespace. Tasks connect through a managed proxy container that collects -// logs and metrics for increased visibility. Only the tasks that Amazon ECS -// services create are supported with Service Connect. For more information, -// see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) -// in the Amazon Elastic Container Service Developer Guide. -type ClusterServiceConnectDefaultsRequest struct { - _ struct{} `type:"structure"` - - // The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace - // that's used when you create a service and don't specify a Service Connect - // configuration. The namespace name can include up to 1024 characters. The - // name is case-sensitive. The name can't include hyphens (-), tilde (~), greater - // than (>), less than (<), or slash (/). - // - // If you enter an existing namespace name or ARN, then that namespace will - // be used. Any namespace type is supported. The namespace must be in this account - // and this Amazon Web Services Region. - // - // If you enter a new name, a Cloud Map namespace will be created. Amazon ECS - // creates a Cloud Map namespace with the "API calls" method of instance discovery - // only. This instance discovery method is the "HTTP" namespace type in the - // Command Line Interface. Other types of instance discovery aren't used by - // Service Connect. - // - // If you update the cluster with an empty string "" for the namespace name, - // the cluster configuration for Service Connect is removed. Note that the namespace - // will remain in Cloud Map and must be deleted separately. - // - // For more information about Cloud Map, see Working with Services (https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) - // in the Cloud Map Developer Guide. - Namespace *string `locationName:"namespace" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterServiceConnectDefaultsRequest) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterServiceConnectDefaultsRequest) GoString() string { - return s.String() -} - -// SetNamespace sets the Namespace field's value. -func (s *ClusterServiceConnectDefaultsRequest) SetNamespace(v string) *ClusterServiceConnectDefaultsRequest { - s.Namespace = &v - return s -} - -// The settings to use when creating a cluster. This parameter is used to turn -// on CloudWatch Container Insights for a cluster. -type ClusterSetting struct { - _ struct{} `type:"structure"` - - // The name of the cluster setting. The value is containerInsights . - Name *string `locationName:"name" type:"string" enum:"ClusterSettingName"` - - // The value to set for the cluster setting. The supported values are enabled - // and disabled. - // - // If you set name to containerInsights and value to enabled, CloudWatch Container - // Insights will be on for the cluster, otherwise it will be off unless the - // containerInsights account setting is turned on. If a cluster value is specified, - // it will override the containerInsights value set with PutAccountSetting (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAccountSetting.html) - // or PutAccountSettingDefault (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutAccountSettingDefault.html). - Value *string `locationName:"value" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterSetting) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ClusterSetting) GoString() string { - return s.String() -} - -// SetName sets the Name field's value. -func (s *ClusterSetting) SetName(v string) *ClusterSetting { - s.Name = &v - return s -} - -// SetValue sets the Value field's value. -func (s *ClusterSetting) SetValue(v string) *ClusterSetting { - s.Value = &v - return s -} - -type ConflictException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` - - ResourceIds []*string `locationName:"resourceIds" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ConflictException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ConflictException) GoString() string { - return s.String() -} - -func newErrorConflictException(v protocol.ResponseMetadata) error { - return &ConflictException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ConflictException) Code() string { - return "ConflictException" -} - -// Message returns the exception's message. -func (s *ConflictException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ConflictException) OrigErr() error { - return nil -} - -func (s *ConflictException) Error() string { - return fmt.Sprintf("%s: %s\n%s", s.Code(), s.Message(), s.String()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ConflictException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ConflictException) RequestID() string { - return s.RespMetadata.RequestID -} - -// A Docker container that's part of a task. -type Container struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) of the container. - ContainerArn *string `locationName:"containerArn" type:"string"` - - // The number of CPU units set for the container. The value is 0 if no value - // was specified in the container definition when the task definition was registered. - Cpu *string `locationName:"cpu" type:"string"` - - // The exit code returned from the container. - ExitCode *int64 `locationName:"exitCode" type:"integer"` - - // The IDs of each GPU assigned to the container. - GpuIds []*string `locationName:"gpuIds" type:"list"` - - // The health status of the container. If health checks aren't configured for - // this container in its task definition, then it reports the health status - // as UNKNOWN. - HealthStatus *string `locationName:"healthStatus" type:"string" enum:"HealthStatus"` - - // The image used for the container. - Image *string `locationName:"image" type:"string"` - - // The container image manifest digest. - ImageDigest *string `locationName:"imageDigest" type:"string"` - - // The last known status of the container. - LastStatus *string `locationName:"lastStatus" type:"string"` - - // The details of any Amazon ECS managed agents associated with the container. - ManagedAgents []*ManagedAgent `locationName:"managedAgents" type:"list"` - - // The hard limit (in MiB) of memory set for the container. - Memory *string `locationName:"memory" type:"string"` - - // The soft limit (in MiB) of memory set for the container. - MemoryReservation *string `locationName:"memoryReservation" type:"string"` - - // The name of the container. - Name *string `locationName:"name" type:"string"` - - // The network bindings associated with the container. - NetworkBindings []*NetworkBinding `locationName:"networkBindings" type:"list"` - - // The network interfaces associated with the container. - NetworkInterfaces []*NetworkInterface `locationName:"networkInterfaces" type:"list"` - - // A short (255 max characters) human-readable string to provide additional - // details about a running or stopped container. - Reason *string `locationName:"reason" type:"string"` - - // The ID of the Docker container. - RuntimeId *string `locationName:"runtimeId" type:"string"` - - // The ARN of the task. - TaskArn *string `locationName:"taskArn" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Container) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Container) GoString() string { - return s.String() -} - -// SetContainerArn sets the ContainerArn field's value. -func (s *Container) SetContainerArn(v string) *Container { - s.ContainerArn = &v - return s -} - -// SetCpu sets the Cpu field's value. -func (s *Container) SetCpu(v string) *Container { - s.Cpu = &v - return s -} - -// SetExitCode sets the ExitCode field's value. -func (s *Container) SetExitCode(v int64) *Container { - s.ExitCode = &v - return s -} - -// SetGpuIds sets the GpuIds field's value. -func (s *Container) SetGpuIds(v []*string) *Container { - s.GpuIds = v - return s -} - -// SetHealthStatus sets the HealthStatus field's value. -func (s *Container) SetHealthStatus(v string) *Container { - s.HealthStatus = &v - return s -} - -// SetImage sets the Image field's value. -func (s *Container) SetImage(v string) *Container { - s.Image = &v - return s -} - -// SetImageDigest sets the ImageDigest field's value. -func (s *Container) SetImageDigest(v string) *Container { - s.ImageDigest = &v - return s -} - -// SetLastStatus sets the LastStatus field's value. -func (s *Container) SetLastStatus(v string) *Container { - s.LastStatus = &v - return s -} - -// SetManagedAgents sets the ManagedAgents field's value. -func (s *Container) SetManagedAgents(v []*ManagedAgent) *Container { - s.ManagedAgents = v - return s -} - -// SetMemory sets the Memory field's value. -func (s *Container) SetMemory(v string) *Container { - s.Memory = &v - return s -} - -// SetMemoryReservation sets the MemoryReservation field's value. -func (s *Container) SetMemoryReservation(v string) *Container { - s.MemoryReservation = &v - return s -} - -// SetName sets the Name field's value. -func (s *Container) SetName(v string) *Container { - s.Name = &v - return s -} - -// SetNetworkBindings sets the NetworkBindings field's value. -func (s *Container) SetNetworkBindings(v []*NetworkBinding) *Container { - s.NetworkBindings = v - return s -} - -// SetNetworkInterfaces sets the NetworkInterfaces field's value. -func (s *Container) SetNetworkInterfaces(v []*NetworkInterface) *Container { - s.NetworkInterfaces = v - return s -} - -// SetReason sets the Reason field's value. -func (s *Container) SetReason(v string) *Container { - s.Reason = &v - return s -} - -// SetRuntimeId sets the RuntimeId field's value. -func (s *Container) SetRuntimeId(v string) *Container { - s.RuntimeId = &v - return s -} - -// SetTaskArn sets the TaskArn field's value. -func (s *Container) SetTaskArn(v string) *Container { - s.TaskArn = &v - return s -} - -// Container definitions are used in task definitions to describe the different -// containers that are launched as part of a task. -type ContainerDefinition struct { - _ struct{} `type:"structure"` - - // The command that's passed to the container. This parameter maps to Cmd in - // the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the COMMAND parameter to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // For more information, see https://docs.docker.com/engine/reference/builder/#cmd - // (https://docs.docker.com/engine/reference/builder/#cmd). If there are multiple - // arguments, each argument is a separated string in the array. - Command []*string `locationName:"command" type:"list"` - - // The number of cpu units reserved for the container. This parameter maps to - // CpuShares in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --cpu-shares option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // This field is optional for tasks using the Fargate launch type, and the only - // requirement is that the total amount of CPU reserved for all containers within - // a task be lower than the task-level cpu value. - // - // You can determine the number of CPU units that are available per EC2 instance - // type by multiplying the vCPUs listed for that instance type on the Amazon - // EC2 Instances (http://aws.amazon.com/ec2/instance-types/) detail page by - // 1,024. - // - // Linux containers share unallocated CPU units with other containers on the - // container instance with the same ratio as their allocated amount. For example, - // if you run a single-container task on a single-core instance type with 512 - // CPU units specified for that container, and that's the only task running - // on the container instance, that container could use the full 1,024 CPU unit - // share at any given time. However, if you launched another copy of the same - // task on that container instance, each task is guaranteed a minimum of 512 - // CPU units when needed. Moreover, each container could float to higher CPU - // usage if the other container was not using it. If both tasks were 100% active - // all of the time, they would be limited to 512 CPU units. - // - // On Linux container instances, the Docker daemon on the container instance - // uses the CPU value to calculate the relative CPU share ratios for running - // containers. For more information, see CPU share constraint (https://docs.docker.com/engine/reference/run/#cpu-share-constraint) - // in the Docker documentation. The minimum valid CPU share value that the Linux - // kernel allows is 2. However, the CPU parameter isn't required, and you can - // use CPU values below 2 in your container definitions. For CPU values below - // 2 (including null), the behavior varies based on your Amazon ECS container - // agent version: - // - // * Agent versions less than or equal to 1.1.0: Null and zero CPU values - // are passed to Docker as 0, which Docker then converts to 1,024 CPU shares. - // CPU values of 1 are passed to Docker as 1, which the Linux kernel converts - // to two CPU shares. - // - // * Agent versions greater than or equal to 1.2.0: Null, zero, and CPU values - // of 1 are passed to Docker as 2. - // - // On Windows container instances, the CPU limit is enforced as an absolute - // limit, or a quota. Windows containers only have access to the specified amount - // of CPU that's described in the task definition. A null or zero CPU value - // is passed to Docker as 0, which Windows interprets as 1% of one CPU. - Cpu *int64 `locationName:"cpu" type:"integer"` - - // A list of ARNs in SSM or Amazon S3 to a credential spec (CredSpec) file that - // configures the container for Active Directory authentication. We recommend - // that you use this parameter instead of the dockerSecurityOptions. The maximum - // number of ARNs is 1. - // - // There are two formats for each ARN. - // - // credentialspecdomainless:MyARN - // - // You use credentialspecdomainless:MyARN to provide a CredSpec with an additional - // section for a secret in Secrets Manager. You provide the login credentials - // to the domain in the secret. - // - // Each task that runs on any container instance can join different domains. - // - // You can use this format without joining the container instance to a domain. - // - // credentialspec:MyARN - // - // You use credentialspec:MyARN to provide a CredSpec for a single domain. - // - // You must join the container instance to the domain before you start any tasks - // that use this task definition. - // - // In both formats, replace MyARN with the ARN in SSM or Amazon S3. - // - // If you provide a credentialspecdomainless:MyARN, the credspec must provide - // a ARN in Secrets Manager for a secret containing the username, password, - // and the domain to connect to. For better security, the instance isn't joined - // to the domain for domainless authentication. Other applications on the instance - // can't use the domainless credentials. You can use this parameter to run tasks - // on the same instance, even it the tasks need to join different domains. For - // more information, see Using gMSAs for Windows Containers (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/windows-gmsa.html) - // and Using gMSAs for Linux Containers (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/linux-gmsa.html). - CredentialSpecs []*string `locationName:"credentialSpecs" type:"list"` - - // The dependencies defined for container startup and shutdown. A container - // can contain multiple dependencies on other containers in a task definition. - // When a dependency is defined for container startup, for container shutdown - // it is reversed. - // - // For tasks using the EC2 launch type, the container instances require at least - // version 1.26.0 of the container agent to turn on container dependencies. - // However, we recommend using the latest container agent version. For information - // about checking your agent version and updating to the latest version, see - // Updating the Amazon ECS Container Agent (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html) - // in the Amazon Elastic Container Service Developer Guide. If you're using - // an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 - // of the ecs-init package. If your container instances are launched from version - // 20190301 or later, then they contain the required versions of the container - // agent and ecs-init. For more information, see Amazon ECS-optimized Linux - // AMI (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // For tasks using the Fargate launch type, the task or service requires the - // following platforms: - // - // * Linux platform version 1.3.0 or later. - // - // * Windows platform version 1.0.0 or later. - DependsOn []*ContainerDependency `locationName:"dependsOn" type:"list"` - - // When this parameter is true, networking is off within the container. This - // parameter maps to NetworkDisabled in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/). - // - // This parameter is not supported for Windows containers. - DisableNetworking *bool `locationName:"disableNetworking" type:"boolean"` - - // A list of DNS search domains that are presented to the container. This parameter - // maps to DnsSearch in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --dns-search option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // This parameter is not supported for Windows containers. - DnsSearchDomains []*string `locationName:"dnsSearchDomains" type:"list"` - - // A list of DNS servers that are presented to the container. This parameter - // maps to Dns in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --dns option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // This parameter is not supported for Windows containers. - DnsServers []*string `locationName:"dnsServers" type:"list"` - - // A key/value map of labels to add to the container. This parameter maps to - // Labels in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --label option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // This parameter requires version 1.18 of the Docker Remote API or greater - // on your container instance. To check the Docker Remote API version on your - // container instance, log in to your container instance and run the following - // command: sudo docker version --format '{{.Server.APIVersion}}' - DockerLabels map[string]*string `locationName:"dockerLabels" type:"map"` - - // A list of strings to provide custom configuration for multiple security systems. - // For more information about valid values, see Docker Run Security Configuration - // (https://docs.docker.com/engine/reference/run/#security-configuration). This - // field isn't valid for containers in tasks using the Fargate launch type. - // - // For Linux tasks on EC2, this parameter can be used to reference custom labels - // for SELinux and AppArmor multi-level security systems. - // - // For any tasks on EC2, this parameter can be used to reference a credential - // spec file that configures a container for Active Directory authentication. - // For more information, see Using gMSAs for Windows Containers (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/windows-gmsa.html) - // and Using gMSAs for Linux Containers (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/linux-gmsa.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // This parameter maps to SecurityOpt in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --security-opt option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // The Amazon ECS container agent running on a container instance must register - // with the ECS_SELINUX_CAPABLE=true or ECS_APPARMOR_CAPABLE=true environment - // variables before containers placed on that instance can use these security - // options. For more information, see Amazon ECS Container Agent Configuration - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // For more information about valid values, see Docker Run Security Configuration - // (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // Valid values: "no-new-privileges" | "apparmor:PROFILE" | "label:value" | - // "credentialspec:CredentialSpecFilePath" - DockerSecurityOptions []*string `locationName:"dockerSecurityOptions" type:"list"` - - // - // Early versions of the Amazon ECS container agent don't properly handle entryPoint - // parameters. If you have problems using entryPoint, update your container - // agent or enter your commands and arguments as command array items instead. - // - // The entry point that's passed to the container. This parameter maps to Entrypoint - // in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --entrypoint option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // For more information, see https://docs.docker.com/engine/reference/builder/#entrypoint - // (https://docs.docker.com/engine/reference/builder/#entrypoint). - EntryPoint []*string `locationName:"entryPoint" type:"list"` - - // The environment variables to pass to a container. This parameter maps to - // Env in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --env option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // We don't recommend that you use plaintext environment variables for sensitive - // information, such as credential data. - // - // Environment is a sensitive parameter and its value will be - // replaced with "sensitive" in string returned by ContainerDefinition's - // String and GoString methods. - Environment []*KeyValuePair `locationName:"environment" type:"list" sensitive:"true"` - - // If the essential parameter of a container is marked as true, and that container - // fails or stops for any reason, all other containers that are part of the - // task are stopped. If the essential parameter of a container is marked as - // false, its failure doesn't affect the rest of the containers in a task. If - // this parameter is omitted, a container is assumed to be essential. - // - // All tasks must have at least one essential container. If you have an application - // that's composed of multiple containers, group containers that are used for - // a common purpose into components, and separate the different components into - // multiple task definitions. For more information, see Application Architecture - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/application_architecture.html) - // in the Amazon Elastic Container Service Developer Guide. - Essential *bool `locationName:"essential" type:"boolean"` - - // A list of hostnames and IP address mappings to append to the /etc/hosts file - // on the container. This parameter maps to ExtraHosts in the Create a container - // (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) section - // of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) and - // the --add-host option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // This parameter isn't supported for Windows containers or tasks that use the - // awsvpc network mode. - ExtraHosts []*HostEntry `locationName:"extraHosts" type:"list"` - - // The FireLens configuration for the container. This is used to specify and - // configure a log router for container logs. For more information, see Custom - // Log Routing (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_firelens.html) - // in the Amazon Elastic Container Service Developer Guide. - FirelensConfiguration *FirelensConfiguration `locationName:"firelensConfiguration" type:"structure"` - - // The container health check command and associated configuration parameters - // for the container. This parameter maps to HealthCheck in the Create a container - // (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) section - // of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) and - // the HEALTHCHECK parameter of docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - HealthCheck *HealthCheck `locationName:"healthCheck" type:"structure"` - - // The hostname to use for your container. This parameter maps to Hostname in - // the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --hostname option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // The hostname parameter is not supported if you're using the awsvpc network - // mode. - Hostname *string `locationName:"hostname" type:"string"` - - // The image used to start a container. This string is passed directly to the - // Docker daemon. By default, images in the Docker Hub registry are available. - // Other repositories are specified with either repository-url/image:tag or - // repository-url/image@digest . Up to 255 letters (uppercase and lowercase), - // numbers, hyphens, underscores, colons, periods, forward slashes, and number - // signs are allowed. This parameter maps to Image in the Create a container - // (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) section - // of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) and - // the IMAGE parameter of docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // * When a new task starts, the Amazon ECS container agent pulls the latest - // version of the specified image and tag for the container to use. However, - // subsequent updates to a repository image aren't propagated to already - // running tasks. - // - // * Images in Amazon ECR repositories can be specified by either using the - // full registry/repository:tag or registry/repository@digest. For example, - // 012345678910.dkr.ecr..amazonaws.com/:latest - // or 012345678910.dkr.ecr..amazonaws.com/@sha256:94afd1f2e64d908bc90dbca0035a5b567EXAMPLE. - // - // * Images in official repositories on Docker Hub use a single name (for - // example, ubuntu or mongo). - // - // * Images in other repositories on Docker Hub are qualified with an organization - // name (for example, amazon/amazon-ecs-agent). - // - // * Images in other online repositories are qualified further by a domain - // name (for example, quay.io/assemblyline/ubuntu). - // - // Image is a required field - Image *string `locationName:"image" type:"string" required:"true"` - - // When this parameter is true, you can deploy containerized applications that - // require stdin or a tty to be allocated. This parameter maps to OpenStdin - // in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --interactive option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - Interactive *bool `locationName:"interactive" type:"boolean"` - - // The links parameter allows containers to communicate with each other without - // the need for port mappings. This parameter is only supported if the network - // mode of a task definition is bridge. The name:internalName construct is analogous - // to name:alias in Docker links. Up to 255 letters (uppercase and lowercase), - // numbers, underscores, and hyphens are allowed. For more information about - // linking Docker containers, go to Legacy container links (https://docs.docker.com/network/links/) - // in the Docker documentation. This parameter maps to Links in the Create a - // container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --link option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // This parameter is not supported for Windows containers. - // - // Containers that are collocated on a single container instance may be able - // to communicate with each other without requiring links or host port mappings. - // Network isolation is achieved on the container instance using security groups - // and VPC settings. - Links []*string `locationName:"links" type:"list"` - - // Linux-specific modifications that are applied to the container, such as Linux - // kernel capabilities. For more information see KernelCapabilities. - // - // This parameter is not supported for Windows containers. - LinuxParameters *LinuxParameters `locationName:"linuxParameters" type:"structure"` - - // The log configuration specification for the container. - // - // This parameter maps to LogConfig in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --log-driver option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // By default, containers use the same logging driver that the Docker daemon - // uses. However the container can use a different logging driver than the Docker - // daemon by specifying a log driver with this parameter in the container definition. - // To use a different logging driver for a container, the log system must be - // configured properly on the container instance (or on a different log server - // for remote logging options). For more information about the options for different - // supported log drivers, see Configure logging drivers (https://docs.docker.com/engine/admin/logging/overview/) - // in the Docker documentation. - // - // Amazon ECS currently supports a subset of the logging drivers available to - // the Docker daemon (shown in the LogConfiguration data type). Additional log - // drivers may be available in future releases of the Amazon ECS container agent. - // - // This parameter requires version 1.18 of the Docker Remote API or greater - // on your container instance. To check the Docker Remote API version on your - // container instance, log in to your container instance and run the following - // command: sudo docker version --format '{{.Server.APIVersion}}' - // - // The Amazon ECS container agent running on a container instance must register - // the logging drivers available on that instance with the ECS_AVAILABLE_LOGGING_DRIVERS - // environment variable before containers placed on that instance can use these - // log configuration options. For more information, see Amazon ECS Container - // Agent Configuration (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html) - // in the Amazon Elastic Container Service Developer Guide. - LogConfiguration *LogConfiguration `locationName:"logConfiguration" type:"structure"` - - // The amount (in MiB) of memory to present to the container. If your container - // attempts to exceed the memory specified here, the container is killed. The - // total amount of memory reserved for all containers within a task must be - // lower than the task memory value, if one is specified. This parameter maps - // to Memory in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --memory option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // If using the Fargate launch type, this parameter is optional. - // - // If using the EC2 launch type, you must specify either a task-level memory - // value or a container-level memory value. If you specify both a container-level - // memory and memoryReservation value, memory must be greater than memoryReservation. - // If you specify memoryReservation, then that value is subtracted from the - // available memory resources for the container instance where the container - // is placed. Otherwise, the value of memory is used. - // - // The Docker 20.10.0 or later daemon reserves a minimum of 6 MiB of memory - // for a container. So, don't specify less than 6 MiB of memory for your containers. - // - // The Docker 19.03.13-ce or earlier daemon reserves a minimum of 4 MiB of memory - // for a container. So, don't specify less than 4 MiB of memory for your containers. - Memory *int64 `locationName:"memory" type:"integer"` - - // The soft limit (in MiB) of memory to reserve for the container. When system - // memory is under heavy contention, Docker attempts to keep the container memory - // to this soft limit. However, your container can consume more memory when - // it needs to, up to either the hard limit specified with the memory parameter - // (if applicable), or all of the available memory on the container instance, - // whichever comes first. This parameter maps to MemoryReservation in the Create - // a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --memory-reservation option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // If a task-level memory value is not specified, you must specify a non-zero - // integer for one or both of memory or memoryReservation in a container definition. - // If you specify both, memory must be greater than memoryReservation. If you - // specify memoryReservation, then that value is subtracted from the available - // memory resources for the container instance where the container is placed. - // Otherwise, the value of memory is used. - // - // For example, if your container normally uses 128 MiB of memory, but occasionally - // bursts to 256 MiB of memory for short periods of time, you can set a memoryReservation - // of 128 MiB, and a memory hard limit of 300 MiB. This configuration would - // allow the container to only reserve 128 MiB of memory from the remaining - // resources on the container instance, but also allow the container to consume - // more memory resources when needed. - // - // The Docker 20.10.0 or later daemon reserves a minimum of 6 MiB of memory - // for a container. So, don't specify less than 6 MiB of memory for your containers. - // - // The Docker 19.03.13-ce or earlier daemon reserves a minimum of 4 MiB of memory - // for a container. So, don't specify less than 4 MiB of memory for your containers. - MemoryReservation *int64 `locationName:"memoryReservation" type:"integer"` - - // The mount points for data volumes in your container. - // - // This parameter maps to Volumes in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --volume option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // Windows containers can mount whole directories on the same drive as $env:ProgramData. - // Windows containers can't mount directories on a different drive, and mount - // point can't be across drives. - MountPoints []*MountPoint `locationName:"mountPoints" type:"list"` - - // The name of a container. If you're linking multiple containers together in - // a task definition, the name of one container can be entered in the links - // of another container to connect the containers. Up to 255 letters (uppercase - // and lowercase), numbers, underscores, and hyphens are allowed. This parameter - // maps to name in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --name option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // Name is a required field - Name *string `locationName:"name" type:"string" required:"true"` - - // The list of port mappings for the container. Port mappings allow containers - // to access ports on the host container instance to send or receive traffic. - // - // For task definitions that use the awsvpc network mode, only specify the containerPort. - // The hostPort can be left blank or it must be the same value as the containerPort. - // - // Port mappings on Windows use the NetNAT gateway address rather than localhost. - // There's no loopback for port mappings on Windows, so you can't access a container's - // mapped port from the host itself. - // - // This parameter maps to PortBindings in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --publish option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // If the network mode of a task definition is set to none, then you can't specify - // port mappings. If the network mode of a task definition is set to host, then - // host ports must either be undefined or they must match the container port - // in the port mapping. - // - // After a task reaches the RUNNING status, manual and automatic host and container - // port assignments are visible in the Network Bindings section of a container - // description for a selected task in the Amazon ECS console. The assignments - // are also visible in the networkBindings section DescribeTasks responses. - PortMappings []*PortMapping `locationName:"portMappings" type:"list"` - - // When this parameter is true, the container is given elevated privileges on - // the host container instance (similar to the root user). This parameter maps - // to Privileged in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --privileged option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // This parameter is not supported for Windows containers or tasks run on Fargate. - Privileged *bool `locationName:"privileged" type:"boolean"` - - // When this parameter is true, a TTY is allocated. This parameter maps to Tty - // in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --tty option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - PseudoTerminal *bool `locationName:"pseudoTerminal" type:"boolean"` - - // When this parameter is true, the container is given read-only access to its - // root file system. This parameter maps to ReadonlyRootfs in the Create a container - // (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) section - // of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) and - // the --read-only option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // This parameter is not supported for Windows containers. - ReadonlyRootFilesystem *bool `locationName:"readonlyRootFilesystem" type:"boolean"` - - // The private repository authentication credentials to use. - RepositoryCredentials *RepositoryCredentials `locationName:"repositoryCredentials" type:"structure"` - - // The type and amount of a resource to assign to a container. The only supported - // resource is a GPU. - ResourceRequirements []*ResourceRequirement `locationName:"resourceRequirements" type:"list"` - - // The secrets to pass to the container. For more information, see Specifying - // Sensitive Data (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data.html) - // in the Amazon Elastic Container Service Developer Guide. - Secrets []*Secret `locationName:"secrets" type:"list"` - - // Time duration (in seconds) to wait before giving up on resolving dependencies - // for a container. For example, you specify two containers in a task definition - // with containerA having a dependency on containerB reaching a COMPLETE, SUCCESS, - // or HEALTHY status. If a startTimeout value is specified for containerB and - // it doesn't reach the desired status within that time then containerA gives - // up and not start. This results in the task transitioning to a STOPPED state. - // - // When the ECS_CONTAINER_START_TIMEOUT container agent configuration variable - // is used, it's enforced independently from this start timeout value. - // - // For tasks using the Fargate launch type, the task or service requires the - // following platforms: - // - // * Linux platform version 1.3.0 or later. - // - // * Windows platform version 1.0.0 or later. - // - // For tasks using the EC2 launch type, your container instances require at - // least version 1.26.0 of the container agent to use a container start timeout - // value. However, we recommend using the latest container agent version. For - // information about checking your agent version and updating to the latest - // version, see Updating the Amazon ECS Container Agent (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html) - // in the Amazon Elastic Container Service Developer Guide. If you're using - // an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 - // of the ecs-init package. If your container instances are launched from version - // 20190301 or later, then they contain the required versions of the container - // agent and ecs-init. For more information, see Amazon ECS-optimized Linux - // AMI (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // The valid values are 2-120 seconds. - StartTimeout *int64 `locationName:"startTimeout" type:"integer"` - - // Time duration (in seconds) to wait before the container is forcefully killed - // if it doesn't exit normally on its own. - // - // For tasks using the Fargate launch type, the task or service requires the - // following platforms: - // - // * Linux platform version 1.3.0 or later. - // - // * Windows platform version 1.0.0 or later. - // - // The max stop timeout value is 120 seconds and if the parameter is not specified, - // the default value of 30 seconds is used. - // - // For tasks that use the EC2 launch type, if the stopTimeout parameter isn't - // specified, the value set for the Amazon ECS container agent configuration - // variable ECS_CONTAINER_STOP_TIMEOUT is used. If neither the stopTimeout parameter - // or the ECS_CONTAINER_STOP_TIMEOUT agent configuration variable are set, then - // the default values of 30 seconds for Linux containers and 30 seconds on Windows - // containers are used. Your container instances require at least version 1.26.0 - // of the container agent to use a container stop timeout value. However, we - // recommend using the latest container agent version. For information about - // checking your agent version and updating to the latest version, see Updating - // the Amazon ECS Container Agent (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html) - // in the Amazon Elastic Container Service Developer Guide. If you're using - // an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 - // of the ecs-init package. If your container instances are launched from version - // 20190301 or later, then they contain the required versions of the container - // agent and ecs-init. For more information, see Amazon ECS-optimized Linux - // AMI (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // The valid values are 2-120 seconds. - StopTimeout *int64 `locationName:"stopTimeout" type:"integer"` - - // A list of namespaced kernel parameters to set in the container. This parameter - // maps to Sysctls in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --sysctl option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // For example, you can configure net.ipv4.tcp_keepalive_time setting to maintain - // longer lived connections. - // - // We don't recommended that you specify network-related systemControls parameters - // for multiple containers in a single task that also uses either the awsvpc - // or host network modes. For tasks that use the awsvpc network mode, the container - // that's started last determines which systemControls parameters take effect. - // For tasks that use the host network mode, it changes the container instance's - // namespaced kernel parameters as well as the containers. - // - // This parameter is not supported for Windows containers. - // - // This parameter is only supported for tasks that are hosted on Fargate if - // the tasks are using platform version 1.4.0 or later (Linux). This isn't supported - // for Windows containers on Fargate. - SystemControls []*SystemControl `locationName:"systemControls" type:"list"` - - // A list of ulimits to set in the container. If a ulimit value is specified - // in a task definition, it overrides the default values set by Docker. This - // parameter maps to Ulimits in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --ulimit option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // Valid naming values are displayed in the Ulimit data type. - // - // Amazon ECS tasks hosted on Fargate use the default resource limit values - // set by the operating system with the exception of the nofile resource limit - // parameter which Fargate overrides. The nofile resource limit sets a restriction - // on the number of open files that a container can use. The default nofile - // soft limit is 1024 and the default hard limit is 4096. - // - // This parameter requires version 1.18 of the Docker Remote API or greater - // on your container instance. To check the Docker Remote API version on your - // container instance, log in to your container instance and run the following - // command: sudo docker version --format '{{.Server.APIVersion}}' - // - // This parameter is not supported for Windows containers. - Ulimits []*Ulimit `locationName:"ulimits" type:"list"` - - // The user to use inside the container. This parameter maps to User in the - // Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --user option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // When running tasks using the host network mode, don't run containers using - // the root user (UID 0). We recommend using a non-root user for better security. - // - // You can specify the user using the following formats. If specifying a UID - // or GID, you must specify it as a positive integer. - // - // * user - // - // * user:group - // - // * uid - // - // * uid:gid - // - // * user:gid - // - // * uid:group - // - // This parameter is not supported for Windows containers. - User *string `locationName:"user" type:"string"` - - // Data volumes to mount from another container. This parameter maps to VolumesFrom - // in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --volumes-from option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - VolumesFrom []*VolumeFrom `locationName:"volumesFrom" type:"list"` - - // The working directory to run commands inside the container in. This parameter - // maps to WorkingDir in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --workdir option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - WorkingDirectory *string `locationName:"workingDirectory" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ContainerDefinition) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ContainerDefinition) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ContainerDefinition) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ContainerDefinition"} - if s.Image == nil { - invalidParams.Add(request.NewErrParamRequired("Image")) - } - if s.Name == nil { - invalidParams.Add(request.NewErrParamRequired("Name")) - } - if s.DependsOn != nil { - for i, v := range s.DependsOn { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "DependsOn", i), err.(request.ErrInvalidParams)) - } - } - } - if s.ExtraHosts != nil { - for i, v := range s.ExtraHosts { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "ExtraHosts", i), err.(request.ErrInvalidParams)) - } - } - } - if s.FirelensConfiguration != nil { - if err := s.FirelensConfiguration.Validate(); err != nil { - invalidParams.AddNested("FirelensConfiguration", err.(request.ErrInvalidParams)) - } - } - if s.HealthCheck != nil { - if err := s.HealthCheck.Validate(); err != nil { - invalidParams.AddNested("HealthCheck", err.(request.ErrInvalidParams)) - } - } - if s.LinuxParameters != nil { - if err := s.LinuxParameters.Validate(); err != nil { - invalidParams.AddNested("LinuxParameters", err.(request.ErrInvalidParams)) - } - } - if s.LogConfiguration != nil { - if err := s.LogConfiguration.Validate(); err != nil { - invalidParams.AddNested("LogConfiguration", err.(request.ErrInvalidParams)) - } - } - if s.RepositoryCredentials != nil { - if err := s.RepositoryCredentials.Validate(); err != nil { - invalidParams.AddNested("RepositoryCredentials", err.(request.ErrInvalidParams)) - } - } - if s.ResourceRequirements != nil { - for i, v := range s.ResourceRequirements { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "ResourceRequirements", i), err.(request.ErrInvalidParams)) - } - } - } - if s.Secrets != nil { - for i, v := range s.Secrets { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Secrets", i), err.(request.ErrInvalidParams)) - } - } - } - if s.Ulimits != nil { - for i, v := range s.Ulimits { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Ulimits", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCommand sets the Command field's value. -func (s *ContainerDefinition) SetCommand(v []*string) *ContainerDefinition { - s.Command = v - return s -} - -// SetCpu sets the Cpu field's value. -func (s *ContainerDefinition) SetCpu(v int64) *ContainerDefinition { - s.Cpu = &v - return s -} - -// SetCredentialSpecs sets the CredentialSpecs field's value. -func (s *ContainerDefinition) SetCredentialSpecs(v []*string) *ContainerDefinition { - s.CredentialSpecs = v - return s -} - -// SetDependsOn sets the DependsOn field's value. -func (s *ContainerDefinition) SetDependsOn(v []*ContainerDependency) *ContainerDefinition { - s.DependsOn = v - return s -} - -// SetDisableNetworking sets the DisableNetworking field's value. -func (s *ContainerDefinition) SetDisableNetworking(v bool) *ContainerDefinition { - s.DisableNetworking = &v - return s -} - -// SetDnsSearchDomains sets the DnsSearchDomains field's value. -func (s *ContainerDefinition) SetDnsSearchDomains(v []*string) *ContainerDefinition { - s.DnsSearchDomains = v - return s -} - -// SetDnsServers sets the DnsServers field's value. -func (s *ContainerDefinition) SetDnsServers(v []*string) *ContainerDefinition { - s.DnsServers = v - return s -} - -// SetDockerLabels sets the DockerLabels field's value. -func (s *ContainerDefinition) SetDockerLabels(v map[string]*string) *ContainerDefinition { - s.DockerLabels = v - return s -} - -// SetDockerSecurityOptions sets the DockerSecurityOptions field's value. -func (s *ContainerDefinition) SetDockerSecurityOptions(v []*string) *ContainerDefinition { - s.DockerSecurityOptions = v - return s -} - -// SetEntryPoint sets the EntryPoint field's value. -func (s *ContainerDefinition) SetEntryPoint(v []*string) *ContainerDefinition { - s.EntryPoint = v - return s -} - -// SetEnvironment sets the Environment field's value. -func (s *ContainerDefinition) SetEnvironment(v []*KeyValuePair) *ContainerDefinition { - s.Environment = v - return s -} - -// SetEssential sets the Essential field's value. -func (s *ContainerDefinition) SetEssential(v bool) *ContainerDefinition { - s.Essential = &v - return s -} - -// SetExtraHosts sets the ExtraHosts field's value. -func (s *ContainerDefinition) SetExtraHosts(v []*HostEntry) *ContainerDefinition { - s.ExtraHosts = v - return s -} - -// SetFirelensConfiguration sets the FirelensConfiguration field's value. -func (s *ContainerDefinition) SetFirelensConfiguration(v *FirelensConfiguration) *ContainerDefinition { - s.FirelensConfiguration = v - return s -} - -// SetHealthCheck sets the HealthCheck field's value. -func (s *ContainerDefinition) SetHealthCheck(v *HealthCheck) *ContainerDefinition { - s.HealthCheck = v - return s -} - -// SetHostname sets the Hostname field's value. -func (s *ContainerDefinition) SetHostname(v string) *ContainerDefinition { - s.Hostname = &v - return s -} - -// SetImage sets the Image field's value. -func (s *ContainerDefinition) SetImage(v string) *ContainerDefinition { - s.Image = &v - return s -} - -// SetInteractive sets the Interactive field's value. -func (s *ContainerDefinition) SetInteractive(v bool) *ContainerDefinition { - s.Interactive = &v - return s -} - -// SetLinks sets the Links field's value. -func (s *ContainerDefinition) SetLinks(v []*string) *ContainerDefinition { - s.Links = v - return s -} - -// SetLinuxParameters sets the LinuxParameters field's value. -func (s *ContainerDefinition) SetLinuxParameters(v *LinuxParameters) *ContainerDefinition { - s.LinuxParameters = v - return s -} - -// SetLogConfiguration sets the LogConfiguration field's value. -func (s *ContainerDefinition) SetLogConfiguration(v *LogConfiguration) *ContainerDefinition { - s.LogConfiguration = v - return s -} - -// SetMemory sets the Memory field's value. -func (s *ContainerDefinition) SetMemory(v int64) *ContainerDefinition { - s.Memory = &v - return s -} - -// SetMemoryReservation sets the MemoryReservation field's value. -func (s *ContainerDefinition) SetMemoryReservation(v int64) *ContainerDefinition { - s.MemoryReservation = &v - return s -} - -// SetMountPoints sets the MountPoints field's value. -func (s *ContainerDefinition) SetMountPoints(v []*MountPoint) *ContainerDefinition { - s.MountPoints = v - return s -} - -// SetName sets the Name field's value. -func (s *ContainerDefinition) SetName(v string) *ContainerDefinition { - s.Name = &v - return s -} - -// SetPortMappings sets the PortMappings field's value. -func (s *ContainerDefinition) SetPortMappings(v []*PortMapping) *ContainerDefinition { - s.PortMappings = v - return s -} - -// SetPrivileged sets the Privileged field's value. -func (s *ContainerDefinition) SetPrivileged(v bool) *ContainerDefinition { - s.Privileged = &v - return s -} - -// SetPseudoTerminal sets the PseudoTerminal field's value. -func (s *ContainerDefinition) SetPseudoTerminal(v bool) *ContainerDefinition { - s.PseudoTerminal = &v - return s -} - -// SetReadonlyRootFilesystem sets the ReadonlyRootFilesystem field's value. -func (s *ContainerDefinition) SetReadonlyRootFilesystem(v bool) *ContainerDefinition { - s.ReadonlyRootFilesystem = &v - return s -} - -// SetRepositoryCredentials sets the RepositoryCredentials field's value. -func (s *ContainerDefinition) SetRepositoryCredentials(v *RepositoryCredentials) *ContainerDefinition { - s.RepositoryCredentials = v - return s -} - -// SetResourceRequirements sets the ResourceRequirements field's value. -func (s *ContainerDefinition) SetResourceRequirements(v []*ResourceRequirement) *ContainerDefinition { - s.ResourceRequirements = v - return s -} - -// SetSecrets sets the Secrets field's value. -func (s *ContainerDefinition) SetSecrets(v []*Secret) *ContainerDefinition { - s.Secrets = v - return s -} - -// SetStartTimeout sets the StartTimeout field's value. -func (s *ContainerDefinition) SetStartTimeout(v int64) *ContainerDefinition { - s.StartTimeout = &v - return s -} - -// SetStopTimeout sets the StopTimeout field's value. -func (s *ContainerDefinition) SetStopTimeout(v int64) *ContainerDefinition { - s.StopTimeout = &v - return s -} - -// SetSystemControls sets the SystemControls field's value. -func (s *ContainerDefinition) SetSystemControls(v []*SystemControl) *ContainerDefinition { - s.SystemControls = v - return s -} - -// SetUlimits sets the Ulimits field's value. -func (s *ContainerDefinition) SetUlimits(v []*Ulimit) *ContainerDefinition { - s.Ulimits = v - return s -} - -// SetUser sets the User field's value. -func (s *ContainerDefinition) SetUser(v string) *ContainerDefinition { - s.User = &v - return s -} - -// SetVolumesFrom sets the VolumesFrom field's value. -func (s *ContainerDefinition) SetVolumesFrom(v []*VolumeFrom) *ContainerDefinition { - s.VolumesFrom = v - return s -} - -// SetWorkingDirectory sets the WorkingDirectory field's value. -func (s *ContainerDefinition) SetWorkingDirectory(v string) *ContainerDefinition { - s.WorkingDirectory = &v - return s -} - -// The dependencies defined for container startup and shutdown. A container -// can contain multiple dependencies. When a dependency is defined for container -// startup, for container shutdown it is reversed. -// -// Your Amazon ECS container instances require at least version 1.26.0 of the -// container agent to use container dependencies. However, we recommend using -// the latest container agent version. For information about checking your agent -// version and updating to the latest version, see Updating the Amazon ECS Container -// Agent (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html) -// in the Amazon Elastic Container Service Developer Guide. If you're using -// an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 -// of the ecs-init package. If your container instances are launched from version -// 20190301 or later, then they contain the required versions of the container -// agent and ecs-init. For more information, see Amazon ECS-optimized Linux -// AMI (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// For tasks that use the Fargate launch type, the task or service requires -// the following platforms: -// -// - Linux platform version 1.3.0 or later. -// -// - Windows platform version 1.0.0 or later. -type ContainerDependency struct { - _ struct{} `type:"structure"` - - // The dependency condition of the container. The following are the available - // conditions and their behavior: - // - // * START - This condition emulates the behavior of links and volumes today. - // It validates that a dependent container is started before permitting other - // containers to start. - // - // * COMPLETE - This condition validates that a dependent container runs - // to completion (exits) before permitting other containers to start. This - // can be useful for nonessential containers that run a script and then exit. - // This condition can't be set on an essential container. - // - // * SUCCESS - This condition is the same as COMPLETE, but it also requires - // that the container exits with a zero status. This condition can't be set - // on an essential container. - // - // * HEALTHY - This condition validates that the dependent container passes - // its Docker health check before permitting other containers to start. This - // requires that the dependent container has health checks configured. This - // condition is confirmed only at task startup. - // - // Condition is a required field - Condition *string `locationName:"condition" type:"string" required:"true" enum:"ContainerCondition"` - - // The name of a container. - // - // ContainerName is a required field - ContainerName *string `locationName:"containerName" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ContainerDependency) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ContainerDependency) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ContainerDependency) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ContainerDependency"} - if s.Condition == nil { - invalidParams.Add(request.NewErrParamRequired("Condition")) - } - if s.ContainerName == nil { - invalidParams.Add(request.NewErrParamRequired("ContainerName")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCondition sets the Condition field's value. -func (s *ContainerDependency) SetCondition(v string) *ContainerDependency { - s.Condition = &v - return s -} - -// SetContainerName sets the ContainerName field's value. -func (s *ContainerDependency) SetContainerName(v string) *ContainerDependency { - s.ContainerName = &v - return s -} - -// An Amazon EC2 or External instance that's running the Amazon ECS agent and -// has been registered with a cluster. -type ContainerInstance struct { - _ struct{} `type:"structure"` - - // This parameter returns true if the agent is connected to Amazon ECS. An instance - // with an agent that may be unhealthy or stopped return false. Only instances - // connected to an agent can accept task placement requests. - AgentConnected *bool `locationName:"agentConnected" type:"boolean"` - - // The status of the most recent agent update. If an update wasn't ever requested, - // this value is NULL. - AgentUpdateStatus *string `locationName:"agentUpdateStatus" type:"string" enum:"AgentUpdateStatus"` - - // The resources attached to a container instance, such as an elastic network - // interface. - Attachments []*Attachment `locationName:"attachments" type:"list"` - - // The attributes set for the container instance, either by the Amazon ECS container - // agent at instance registration or manually with the PutAttributes operation. - Attributes []*Attribute `locationName:"attributes" type:"list"` - - // The capacity provider that's associated with the container instance. - CapacityProviderName *string `locationName:"capacityProviderName" type:"string"` - - // The Amazon Resource Name (ARN) of the container instance. For more information - // about the ARN format, see Amazon Resource Name (ARN) (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids) - // in the Amazon ECS Developer Guide. - ContainerInstanceArn *string `locationName:"containerInstanceArn" type:"string"` - - // The ID of the container instance. For Amazon EC2 instances, this value is - // the Amazon EC2 instance ID. For external instances, this value is the Amazon - // Web Services Systems Manager managed instance ID. - Ec2InstanceId *string `locationName:"ec2InstanceId" type:"string"` - - // The number of tasks on the container instance that are in the PENDING status. - PendingTasksCount *int64 `locationName:"pendingTasksCount" type:"integer"` - - // The Unix timestamp for the time when the container instance was registered. - RegisteredAt *time.Time `locationName:"registeredAt" type:"timestamp"` - - // For CPU and memory resource types, this parameter describes the amount of - // each resource that was available on the container instance when the container - // agent registered it with Amazon ECS. This value represents the total amount - // of CPU and memory that can be allocated on this container instance to tasks. - // For port resource types, this parameter describes the ports that were reserved - // by the Amazon ECS container agent when it registered the container instance - // with Amazon ECS. - RegisteredResources []*Resource `locationName:"registeredResources" type:"list"` - - // For CPU and memory resource types, this parameter describes the remaining - // CPU and memory that wasn't already allocated to tasks and is therefore available - // for new tasks. For port resource types, this parameter describes the ports - // that were reserved by the Amazon ECS container agent (at instance registration - // time) and any task containers that have reserved port mappings on the host - // (with the host or bridge network mode). Any port that's not specified here - // is available for new tasks. - RemainingResources []*Resource `locationName:"remainingResources" type:"list"` - - // The number of tasks on the container instance that have a desired status - // (desiredStatus) of RUNNING. - RunningTasksCount *int64 `locationName:"runningTasksCount" type:"integer"` - - // The status of the container instance. The valid values are REGISTERING, REGISTRATION_FAILED, - // ACTIVE, INACTIVE, DEREGISTERING, or DRAINING. - // - // If your account has opted in to the awsvpcTrunking account setting, then - // any newly registered container instance will transition to a REGISTERING - // status while the trunk elastic network interface is provisioned for the instance. - // If the registration fails, the instance will transition to a REGISTRATION_FAILED - // status. You can describe the container instance and see the reason for failure - // in the statusReason parameter. Once the container instance is terminated, - // the instance transitions to a DEREGISTERING status while the trunk elastic - // network interface is deprovisioned. The instance then transitions to an INACTIVE - // status. - // - // The ACTIVE status indicates that the container instance can accept tasks. - // The DRAINING indicates that new tasks aren't placed on the container instance - // and any service tasks running on the container instance are removed if possible. - // For more information, see Container instance draining (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/container-instance-draining.html) - // in the Amazon Elastic Container Service Developer Guide. - Status *string `locationName:"status" type:"string"` - - // The reason that the container instance reached its current status. - StatusReason *string `locationName:"statusReason" type:"string"` - - // The metadata that you apply to the container instance to help you categorize - // and organize them. Each tag consists of a key and an optional value. You - // define both. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The version counter for the container instance. Every time a container instance - // experiences a change that triggers a CloudWatch event, the version counter - // is incremented. If you're replicating your Amazon ECS container instance - // state with CloudWatch Events, you can compare the version of a container - // instance reported by the Amazon ECS APIs with the version reported in CloudWatch - // Events for the container instance (inside the detail object) to verify that - // the version in your event stream is current. - Version *int64 `locationName:"version" type:"long"` - - // The version information for the Amazon ECS container agent and Docker daemon - // running on the container instance. - VersionInfo *VersionInfo `locationName:"versionInfo" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ContainerInstance) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ContainerInstance) GoString() string { - return s.String() -} - -// SetAgentConnected sets the AgentConnected field's value. -func (s *ContainerInstance) SetAgentConnected(v bool) *ContainerInstance { - s.AgentConnected = &v - return s -} - -// SetAgentUpdateStatus sets the AgentUpdateStatus field's value. -func (s *ContainerInstance) SetAgentUpdateStatus(v string) *ContainerInstance { - s.AgentUpdateStatus = &v - return s -} - -// SetAttachments sets the Attachments field's value. -func (s *ContainerInstance) SetAttachments(v []*Attachment) *ContainerInstance { - s.Attachments = v - return s -} - -// SetAttributes sets the Attributes field's value. -func (s *ContainerInstance) SetAttributes(v []*Attribute) *ContainerInstance { - s.Attributes = v - return s -} - -// SetCapacityProviderName sets the CapacityProviderName field's value. -func (s *ContainerInstance) SetCapacityProviderName(v string) *ContainerInstance { - s.CapacityProviderName = &v - return s -} - -// SetContainerInstanceArn sets the ContainerInstanceArn field's value. -func (s *ContainerInstance) SetContainerInstanceArn(v string) *ContainerInstance { - s.ContainerInstanceArn = &v - return s -} - -// SetEc2InstanceId sets the Ec2InstanceId field's value. -func (s *ContainerInstance) SetEc2InstanceId(v string) *ContainerInstance { - s.Ec2InstanceId = &v - return s -} - -// SetPendingTasksCount sets the PendingTasksCount field's value. -func (s *ContainerInstance) SetPendingTasksCount(v int64) *ContainerInstance { - s.PendingTasksCount = &v - return s -} - -// SetRegisteredAt sets the RegisteredAt field's value. -func (s *ContainerInstance) SetRegisteredAt(v time.Time) *ContainerInstance { - s.RegisteredAt = &v - return s -} - -// SetRegisteredResources sets the RegisteredResources field's value. -func (s *ContainerInstance) SetRegisteredResources(v []*Resource) *ContainerInstance { - s.RegisteredResources = v - return s -} - -// SetRemainingResources sets the RemainingResources field's value. -func (s *ContainerInstance) SetRemainingResources(v []*Resource) *ContainerInstance { - s.RemainingResources = v - return s -} - -// SetRunningTasksCount sets the RunningTasksCount field's value. -func (s *ContainerInstance) SetRunningTasksCount(v int64) *ContainerInstance { - s.RunningTasksCount = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *ContainerInstance) SetStatus(v string) *ContainerInstance { - s.Status = &v - return s -} - -// SetStatusReason sets the StatusReason field's value. -func (s *ContainerInstance) SetStatusReason(v string) *ContainerInstance { - s.StatusReason = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *ContainerInstance) SetTags(v []*Tag) *ContainerInstance { - s.Tags = v - return s -} - -// SetVersion sets the Version field's value. -func (s *ContainerInstance) SetVersion(v int64) *ContainerInstance { - s.Version = &v - return s -} - -// SetVersionInfo sets the VersionInfo field's value. -func (s *ContainerInstance) SetVersionInfo(v *VersionInfo) *ContainerInstance { - s.VersionInfo = v - return s -} - -// The overrides that are sent to a container. An empty container override can -// be passed in. An example of an empty container override is {"containerOverrides": -// [ ] }. If a non-empty container override is specified, the name parameter -// must be included. -// -// You can use Secrets Manager or Amazon Web Services Systems Manager Parameter -// Store to store the sensitive data. For more information, see Retrieve secrets -// through environment variables (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/secrets-envvar.html) -// in the Amazon ECS Developer Guide. -type ContainerOverride struct { - _ struct{} `type:"structure"` - - // The command to send to the container that overrides the default command from - // the Docker image or the task definition. You must also specify a container - // name. - Command []*string `locationName:"command" type:"list"` - - // The number of cpu units reserved for the container, instead of the default - // value from the task definition. You must also specify a container name. - Cpu *int64 `locationName:"cpu" type:"integer"` - - // The environment variables to send to the container. You can add new environment - // variables, which are added to the container at launch, or you can override - // the existing environment variables from the Docker image or the task definition. - // You must also specify a container name. - // - // Environment is a sensitive parameter and its value will be - // replaced with "sensitive" in string returned by ContainerOverride's - // String and GoString methods. - Environment []*KeyValuePair `locationName:"environment" type:"list" sensitive:"true"` - - // The hard limit (in MiB) of memory to present to the container, instead of - // the default value from the task definition. If your container attempts to - // exceed the memory specified here, the container is killed. You must also - // specify a container name. - Memory *int64 `locationName:"memory" type:"integer"` - - // The soft limit (in MiB) of memory to reserve for the container, instead of - // the default value from the task definition. You must also specify a container - // name. - MemoryReservation *int64 `locationName:"memoryReservation" type:"integer"` - - // The name of the container that receives the override. This parameter is required - // if any override is specified. - Name *string `locationName:"name" type:"string"` - - // The type and amount of a resource to assign to a container, instead of the - // default value from the task definition. The only supported resource is a - // GPU. - ResourceRequirements []*ResourceRequirement `locationName:"resourceRequirements" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ContainerOverride) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ContainerOverride) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ContainerOverride) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ContainerOverride"} - if s.ResourceRequirements != nil { - for i, v := range s.ResourceRequirements { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "ResourceRequirements", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCommand sets the Command field's value. -func (s *ContainerOverride) SetCommand(v []*string) *ContainerOverride { - s.Command = v - return s -} - -// SetCpu sets the Cpu field's value. -func (s *ContainerOverride) SetCpu(v int64) *ContainerOverride { - s.Cpu = &v - return s -} - -// SetEnvironment sets the Environment field's value. -func (s *ContainerOverride) SetEnvironment(v []*KeyValuePair) *ContainerOverride { - s.Environment = v - return s -} - -// SetMemory sets the Memory field's value. -func (s *ContainerOverride) SetMemory(v int64) *ContainerOverride { - s.Memory = &v - return s -} - -// SetMemoryReservation sets the MemoryReservation field's value. -func (s *ContainerOverride) SetMemoryReservation(v int64) *ContainerOverride { - s.MemoryReservation = &v - return s -} - -// SetName sets the Name field's value. -func (s *ContainerOverride) SetName(v string) *ContainerOverride { - s.Name = &v - return s -} - -// SetResourceRequirements sets the ResourceRequirements field's value. -func (s *ContainerOverride) SetResourceRequirements(v []*ResourceRequirement) *ContainerOverride { - s.ResourceRequirements = v - return s -} - -// An object that represents a change in state for a container. -type ContainerStateChange struct { - _ struct{} `type:"structure"` - - // The name of the container. - ContainerName *string `locationName:"containerName" type:"string"` - - // The exit code for the container, if the state change is a result of the container - // exiting. - ExitCode *int64 `locationName:"exitCode" type:"integer"` - - // The container image SHA 256 digest. - ImageDigest *string `locationName:"imageDigest" type:"string"` - - // Any network bindings that are associated with the container. - NetworkBindings []*NetworkBinding `locationName:"networkBindings" type:"list"` - - // The reason for the state change. - Reason *string `locationName:"reason" type:"string"` - - // The ID of the Docker container. - RuntimeId *string `locationName:"runtimeId" type:"string"` - - // The status of the container. - Status *string `locationName:"status" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ContainerStateChange) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ContainerStateChange) GoString() string { - return s.String() -} - -// SetContainerName sets the ContainerName field's value. -func (s *ContainerStateChange) SetContainerName(v string) *ContainerStateChange { - s.ContainerName = &v - return s -} - -// SetExitCode sets the ExitCode field's value. -func (s *ContainerStateChange) SetExitCode(v int64) *ContainerStateChange { - s.ExitCode = &v - return s -} - -// SetImageDigest sets the ImageDigest field's value. -func (s *ContainerStateChange) SetImageDigest(v string) *ContainerStateChange { - s.ImageDigest = &v - return s -} - -// SetNetworkBindings sets the NetworkBindings field's value. -func (s *ContainerStateChange) SetNetworkBindings(v []*NetworkBinding) *ContainerStateChange { - s.NetworkBindings = v - return s -} - -// SetReason sets the Reason field's value. -func (s *ContainerStateChange) SetReason(v string) *ContainerStateChange { - s.Reason = &v - return s -} - -// SetRuntimeId sets the RuntimeId field's value. -func (s *ContainerStateChange) SetRuntimeId(v string) *ContainerStateChange { - s.RuntimeId = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *ContainerStateChange) SetStatus(v string) *ContainerStateChange { - s.Status = &v - return s -} - -type CreateCapacityProviderInput struct { - _ struct{} `type:"structure"` - - // The details of the Auto Scaling group for the capacity provider. - // - // AutoScalingGroupProvider is a required field - AutoScalingGroupProvider *AutoScalingGroupProvider `locationName:"autoScalingGroupProvider" type:"structure" required:"true"` - - // The name of the capacity provider. Up to 255 characters are allowed. They - // include letters (both upper and lowercase letters), numbers, underscores - // (_), and hyphens (-). The name can't be prefixed with "aws", "ecs", or "fargate". - // - // Name is a required field - Name *string `locationName:"name" type:"string" required:"true"` - - // The metadata that you apply to the capacity provider to categorize and organize - // them more conveniently. Each tag consists of a key and an optional value. - // You define both of them. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateCapacityProviderInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateCapacityProviderInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *CreateCapacityProviderInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "CreateCapacityProviderInput"} - if s.AutoScalingGroupProvider == nil { - invalidParams.Add(request.NewErrParamRequired("AutoScalingGroupProvider")) - } - if s.Name == nil { - invalidParams.Add(request.NewErrParamRequired("Name")) - } - if s.AutoScalingGroupProvider != nil { - if err := s.AutoScalingGroupProvider.Validate(); err != nil { - invalidParams.AddNested("AutoScalingGroupProvider", err.(request.ErrInvalidParams)) - } - } - if s.Tags != nil { - for i, v := range s.Tags { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAutoScalingGroupProvider sets the AutoScalingGroupProvider field's value. -func (s *CreateCapacityProviderInput) SetAutoScalingGroupProvider(v *AutoScalingGroupProvider) *CreateCapacityProviderInput { - s.AutoScalingGroupProvider = v - return s -} - -// SetName sets the Name field's value. -func (s *CreateCapacityProviderInput) SetName(v string) *CreateCapacityProviderInput { - s.Name = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *CreateCapacityProviderInput) SetTags(v []*Tag) *CreateCapacityProviderInput { - s.Tags = v - return s -} - -type CreateCapacityProviderOutput struct { - _ struct{} `type:"structure"` - - // The full description of the new capacity provider. - CapacityProvider *CapacityProvider `locationName:"capacityProvider" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateCapacityProviderOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateCapacityProviderOutput) GoString() string { - return s.String() -} - -// SetCapacityProvider sets the CapacityProvider field's value. -func (s *CreateCapacityProviderOutput) SetCapacityProvider(v *CapacityProvider) *CreateCapacityProviderOutput { - s.CapacityProvider = v - return s -} - -type CreateClusterInput struct { - _ struct{} `type:"structure"` - - // The short name of one or more capacity providers to associate with the cluster. - // A capacity provider must be associated with a cluster before it can be included - // as part of the default capacity provider strategy of the cluster or used - // in a capacity provider strategy when calling the CreateService (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) - // or RunTask (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) - // actions. - // - // If specifying a capacity provider that uses an Auto Scaling group, the capacity - // provider must be created but not associated with another cluster. New Auto - // Scaling group capacity providers can be created with the CreateCapacityProvider - // (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html) - // API operation. - // - // To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT - // capacity providers. The Fargate capacity providers are available to all accounts - // and only need to be associated with a cluster to be used. - // - // The PutCapacityProvider (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProvider.html) - // API operation is used to update the list of available capacity providers - // for a cluster after the cluster is created. - CapacityProviders []*string `locationName:"capacityProviders" type:"list"` - - // The name of your cluster. If you don't specify a name for your cluster, you - // create a cluster that's named default. Up to 255 letters (uppercase and lowercase), - // numbers, underscores, and hyphens are allowed. - ClusterName *string `locationName:"clusterName" type:"string"` - - // The execute command configuration for the cluster. - Configuration *ClusterConfiguration `locationName:"configuration" type:"structure"` - - // The capacity provider strategy to set as the default for the cluster. After - // a default capacity provider strategy is set for a cluster, when you call - // the CreateService (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) - // or RunTask (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) - // APIs with no capacity provider strategy or launch type specified, the default - // capacity provider strategy for the cluster is used. - // - // If a default capacity provider strategy isn't defined for a cluster when - // it was created, it can be defined later with the PutClusterCapacityProviders - // API operation. - DefaultCapacityProviderStrategy []*CapacityProviderStrategyItem `locationName:"defaultCapacityProviderStrategy" type:"list"` - - // Use this parameter to set a default Service Connect namespace. After you - // set a default Service Connect namespace, any new services with Service Connect - // turned on that are created in the cluster are added as client services in - // the namespace. This setting only applies to new services that set the enabled - // parameter to true in the ServiceConnectConfiguration. You can set the namespace - // of each service individually in the ServiceConnectConfiguration to override - // this default parameter. - // - // Tasks that run in a namespace can use short names to connect to services - // in the namespace. Tasks can connect to services across all of the clusters - // in the namespace. Tasks connect through a managed proxy container that collects - // logs and metrics for increased visibility. Only the tasks that Amazon ECS - // services create are supported with Service Connect. For more information, - // see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - ServiceConnectDefaults *ClusterServiceConnectDefaultsRequest `locationName:"serviceConnectDefaults" type:"structure"` - - // The setting to use when creating a cluster. This parameter is used to turn - // on CloudWatch Container Insights for a cluster. If this value is specified, - // it overrides the containerInsights value set with PutAccountSetting or PutAccountSettingDefault. - Settings []*ClusterSetting `locationName:"settings" type:"list"` - - // The metadata that you apply to the cluster to help you categorize and organize - // them. Each tag consists of a key and an optional value. You define both. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateClusterInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateClusterInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *CreateClusterInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "CreateClusterInput"} - if s.DefaultCapacityProviderStrategy != nil { - for i, v := range s.DefaultCapacityProviderStrategy { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "DefaultCapacityProviderStrategy", i), err.(request.ErrInvalidParams)) - } - } - } - if s.Tags != nil { - for i, v := range s.Tags { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCapacityProviders sets the CapacityProviders field's value. -func (s *CreateClusterInput) SetCapacityProviders(v []*string) *CreateClusterInput { - s.CapacityProviders = v - return s -} - -// SetClusterName sets the ClusterName field's value. -func (s *CreateClusterInput) SetClusterName(v string) *CreateClusterInput { - s.ClusterName = &v - return s -} - -// SetConfiguration sets the Configuration field's value. -func (s *CreateClusterInput) SetConfiguration(v *ClusterConfiguration) *CreateClusterInput { - s.Configuration = v - return s -} - -// SetDefaultCapacityProviderStrategy sets the DefaultCapacityProviderStrategy field's value. -func (s *CreateClusterInput) SetDefaultCapacityProviderStrategy(v []*CapacityProviderStrategyItem) *CreateClusterInput { - s.DefaultCapacityProviderStrategy = v - return s -} - -// SetServiceConnectDefaults sets the ServiceConnectDefaults field's value. -func (s *CreateClusterInput) SetServiceConnectDefaults(v *ClusterServiceConnectDefaultsRequest) *CreateClusterInput { - s.ServiceConnectDefaults = v - return s -} - -// SetSettings sets the Settings field's value. -func (s *CreateClusterInput) SetSettings(v []*ClusterSetting) *CreateClusterInput { - s.Settings = v - return s -} - -// SetTags sets the Tags field's value. -func (s *CreateClusterInput) SetTags(v []*Tag) *CreateClusterInput { - s.Tags = v - return s -} - -type CreateClusterOutput struct { - _ struct{} `type:"structure"` - - // The full description of your new cluster. - Cluster *Cluster `locationName:"cluster" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateClusterOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateClusterOutput) GoString() string { - return s.String() -} - -// SetCluster sets the Cluster field's value. -func (s *CreateClusterOutput) SetCluster(v *Cluster) *CreateClusterOutput { - s.Cluster = v - return s -} - -type CreateServiceInput struct { - _ struct{} `type:"structure"` - - // The capacity provider strategy to use for the service. - // - // If a capacityProviderStrategy is specified, the launchType parameter must - // be omitted. If no capacityProviderStrategy or launchType is specified, the - // defaultCapacityProviderStrategy for the cluster is used. - // - // A capacity provider strategy may contain a maximum of 6 capacity providers. - CapacityProviderStrategy []*CapacityProviderStrategyItem `locationName:"capacityProviderStrategy" type:"list"` - - // An identifier that you provide to ensure the idempotency of the request. - // It must be unique and is case sensitive. Up to 32 ASCII characters are allowed. - ClientToken *string `locationName:"clientToken" type:"string"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that you - // run your service on. If you do not specify a cluster, the default cluster - // is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // Optional deployment parameters that control how many tasks run during the - // deployment and the ordering of stopping and starting tasks. - DeploymentConfiguration *DeploymentConfiguration `locationName:"deploymentConfiguration" type:"structure"` - - // The deployment controller to use for the service. If no deployment controller - // is specified, the default value of ECS is used. - DeploymentController *DeploymentController `locationName:"deploymentController" type:"structure"` - - // The number of instantiations of the specified task definition to place and - // keep running in your service. - // - // This is required if schedulingStrategy is REPLICA or isn't specified. If - // schedulingStrategy is DAEMON then this isn't required. - DesiredCount *int64 `locationName:"desiredCount" type:"integer"` - - // Specifies whether to turn on Amazon ECS managed tags for the tasks within - // the service. For more information, see Tagging your Amazon ECS resources - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // When you use Amazon ECS managed tags, you need to set the propagateTags request - // parameter. - EnableECSManagedTags *bool `locationName:"enableECSManagedTags" type:"boolean"` - - // Determines whether the execute command functionality is turned on for the - // service. If true, this enables execute command functionality on all containers - // in the service tasks. - EnableExecuteCommand *bool `locationName:"enableExecuteCommand" type:"boolean"` - - // The period of time, in seconds, that the Amazon ECS service scheduler ignores - // unhealthy Elastic Load Balancing target health checks after a task has first - // started. This is only used when your service is configured to use a load - // balancer. If your service has a load balancer defined and you don't specify - // a health check grace period value, the default value of 0 is used. - // - // If you do not use an Elastic Load Balancing, we recommend that you use the - // startPeriod in the task definition health check parameters. For more information, - // see Health check (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_HealthCheck.html). - // - // If your service's tasks take a while to start and respond to Elastic Load - // Balancing health checks, you can specify a health check grace period of up - // to 2,147,483,647 seconds (about 69 years). During that time, the Amazon ECS - // service scheduler ignores health check status. This grace period can prevent - // the service scheduler from marking tasks as unhealthy and stopping them before - // they have time to come up. - HealthCheckGracePeriodSeconds *int64 `locationName:"healthCheckGracePeriodSeconds" type:"integer"` - - // The infrastructure that you run your service on. For more information, see - // Amazon ECS launch types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // The FARGATE launch type runs your tasks on Fargate On-Demand infrastructure. - // - // Fargate Spot infrastructure is available for use but a capacity provider - // strategy must be used. For more information, see Fargate capacity providers - // (https://docs.aws.amazon.com/AmazonECS/latest/userguide/fargate-capacity-providers.html) - // in the Amazon ECS User Guide for Fargate. - // - // The EC2 launch type runs your tasks on Amazon EC2 instances registered to - // your cluster. - // - // The EXTERNAL launch type runs your tasks on your on-premises server or virtual - // machine (VM) capacity registered to your cluster. - // - // A service can use either a launch type or a capacity provider strategy. If - // a launchType is specified, the capacityProviderStrategy parameter must be - // omitted. - LaunchType *string `locationName:"launchType" type:"string" enum:"LaunchType"` - - // A load balancer object representing the load balancers to use with your service. - // For more information, see Service load balancing (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // If the service uses the rolling update (ECS) deployment controller and using - // either an Application Load Balancer or Network Load Balancer, you must specify - // one or more target group ARNs to attach to the service. The service-linked - // role is required for services that use multiple target groups. For more information, - // see Using service-linked roles for Amazon ECS (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // If the service uses the CODE_DEPLOY deployment controller, the service is - // required to use either an Application Load Balancer or Network Load Balancer. - // When creating an CodeDeploy deployment group, you specify two target groups - // (referred to as a targetGroupPair). During a deployment, CodeDeploy determines - // which task set in your service has the status PRIMARY, and it associates - // one target group with it. Then, it also associates the other target group - // with the replacement task set. The load balancer can also have up to two - // listeners: a required listener for production traffic and an optional listener - // that you can use to perform validation tests with Lambda functions before - // routing production traffic to it. - // - // If you use the CODE_DEPLOY deployment controller, these values can be changed - // when updating the service. - // - // For Application Load Balancers and Network Load Balancers, this object must - // contain the load balancer target group ARN, the container name, and the container - // port to access from the load balancer. The container name must be as it appears - // in a container definition. The load balancer name parameter must be omitted. - // When a task from this service is placed on a container instance, the container - // instance and port combination is registered as a target in the target group - // that's specified here. - // - // For Classic Load Balancers, this object must contain the load balancer name, - // the container name , and the container port to access from the load balancer. - // The container name must be as it appears in a container definition. The target - // group ARN parameter must be omitted. When a task from this service is placed - // on a container instance, the container instance is registered with the load - // balancer that's specified here. - // - // Services with tasks that use the awsvpc network mode (for example, those - // with the Fargate launch type) only support Application Load Balancers and - // Network Load Balancers. Classic Load Balancers aren't supported. Also, when - // you create any target groups for these services, you must choose ip as the - // target type, not instance. This is because tasks that use the awsvpc network - // mode are associated with an elastic network interface, not an Amazon EC2 - // instance. - LoadBalancers []*LoadBalancer `locationName:"loadBalancers" type:"list"` - - // The network configuration for the service. This parameter is required for - // task definitions that use the awsvpc network mode to receive their own elastic - // network interface, and it isn't supported for other network modes. For more - // information, see Task networking (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html) - // in the Amazon Elastic Container Service Developer Guide. - NetworkConfiguration *NetworkConfiguration `locationName:"networkConfiguration" type:"structure"` - - // An array of placement constraint objects to use for tasks in your service. - // You can specify a maximum of 10 constraints for each task. This limit includes - // constraints in the task definition and those specified at runtime. - PlacementConstraints []*PlacementConstraint `locationName:"placementConstraints" type:"list"` - - // The placement strategy objects to use for tasks in your service. You can - // specify a maximum of 5 strategy rules for each service. - PlacementStrategy []*PlacementStrategy `locationName:"placementStrategy" type:"list"` - - // The platform version that your tasks in the service are running on. A platform - // version is specified only for tasks using the Fargate launch type. If one - // isn't specified, the LATEST platform version is used. For more information, - // see Fargate platform versions (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html) - // in the Amazon Elastic Container Service Developer Guide. - PlatformVersion *string `locationName:"platformVersion" type:"string"` - - // Specifies whether to propagate the tags from the task definition to the task. - // If no value is specified, the tags aren't propagated. Tags can only be propagated - // to the task during task creation. To add tags to a task after task creation, - // use the TagResource (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html) - // API action. - // - // The default is NONE. - PropagateTags *string `locationName:"propagateTags" type:"string" enum:"PropagateTags"` - - // The name or full Amazon Resource Name (ARN) of the IAM role that allows Amazon - // ECS to make calls to your load balancer on your behalf. This parameter is - // only permitted if you are using a load balancer with your service and your - // task definition doesn't use the awsvpc network mode. If you specify the role - // parameter, you must also specify a load balancer object with the loadBalancers - // parameter. - // - // If your account has already created the Amazon ECS service-linked role, that - // role is used for your service unless you specify a role here. The service-linked - // role is required if your task definition uses the awsvpc network mode or - // if the service is configured to use service discovery, an external deployment - // controller, multiple target groups, or Elastic Inference accelerators in - // which case you don't specify a role here. For more information, see Using - // service-linked roles for Amazon ECS (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // If your specified role has a path other than /, then you must either specify - // the full role ARN (this is recommended) or prefix the role name with the - // path. For example, if a role with the name bar has a path of /foo/ then you - // would specify /foo/bar as the role name. For more information, see Friendly - // names and paths (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names) - // in the IAM User Guide. - Role *string `locationName:"role" type:"string"` - - // The scheduling strategy to use for the service. For more information, see - // Services (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html). - // - // There are two service scheduler strategies available: - // - // * REPLICA-The replica scheduling strategy places and maintains the desired - // number of tasks across your cluster. By default, the service scheduler - // spreads tasks across Availability Zones. You can use task placement strategies - // and constraints to customize task placement decisions. This scheduler - // strategy is required if the service uses the CODE_DEPLOY or EXTERNAL deployment - // controller types. - // - // * DAEMON-The daemon scheduling strategy deploys exactly one task on each - // active container instance that meets all of the task placement constraints - // that you specify in your cluster. The service scheduler also evaluates - // the task placement constraints for running tasks and will stop tasks that - // don't meet the placement constraints. When you're using this strategy, - // you don't need to specify a desired number of tasks, a task placement - // strategy, or use Service Auto Scaling policies. Tasks using the Fargate - // launch type or the CODE_DEPLOY or EXTERNAL deployment controller types - // don't support the DAEMON scheduling strategy. - SchedulingStrategy *string `locationName:"schedulingStrategy" type:"string" enum:"SchedulingStrategy"` - - // The configuration for this service to discover and connect to services, and - // be discovered by, and connected from, other services within a namespace. - // - // Tasks that run in a namespace can use short names to connect to services - // in the namespace. Tasks can connect to services across all of the clusters - // in the namespace. Tasks connect through a managed proxy container that collects - // logs and metrics for increased visibility. Only the tasks that Amazon ECS - // services create are supported with Service Connect. For more information, - // see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - ServiceConnectConfiguration *ServiceConnectConfiguration `locationName:"serviceConnectConfiguration" type:"structure"` - - // The name of your service. Up to 255 letters (uppercase and lowercase), numbers, - // underscores, and hyphens are allowed. Service names must be unique within - // a cluster, but you can have similarly named services in multiple clusters - // within a Region or across multiple Regions. - // - // ServiceName is a required field - ServiceName *string `locationName:"serviceName" type:"string" required:"true"` - - // The details of the service discovery registry to associate with this service. - // For more information, see Service discovery (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html). - // - // Each service may be associated with one service registry. Multiple service - // registries for each service isn't supported. - ServiceRegistries []*ServiceRegistry `locationName:"serviceRegistries" type:"list"` - - // The metadata that you apply to the service to help you categorize and organize - // them. Each tag consists of a key and an optional value, both of which you - // define. When a service is deleted, the tags are deleted as well. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The family and revision (family:revision) or full ARN of the task definition - // to run in your service. If a revision isn't specified, the latest ACTIVE - // revision is used. - // - // A task definition must be specified if the service uses either the ECS or - // CODE_DEPLOY deployment controllers. - // - // For more information about deployment types, see Amazon ECS deployment types - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html). - TaskDefinition *string `locationName:"taskDefinition" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateServiceInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateServiceInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *CreateServiceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "CreateServiceInput"} - if s.ServiceName == nil { - invalidParams.Add(request.NewErrParamRequired("ServiceName")) - } - if s.CapacityProviderStrategy != nil { - for i, v := range s.CapacityProviderStrategy { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "CapacityProviderStrategy", i), err.(request.ErrInvalidParams)) - } - } - } - if s.DeploymentConfiguration != nil { - if err := s.DeploymentConfiguration.Validate(); err != nil { - invalidParams.AddNested("DeploymentConfiguration", err.(request.ErrInvalidParams)) - } - } - if s.DeploymentController != nil { - if err := s.DeploymentController.Validate(); err != nil { - invalidParams.AddNested("DeploymentController", err.(request.ErrInvalidParams)) - } - } - if s.ServiceConnectConfiguration != nil { - if err := s.ServiceConnectConfiguration.Validate(); err != nil { - invalidParams.AddNested("ServiceConnectConfiguration", err.(request.ErrInvalidParams)) - } - } - if s.Tags != nil { - for i, v := range s.Tags { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCapacityProviderStrategy sets the CapacityProviderStrategy field's value. -func (s *CreateServiceInput) SetCapacityProviderStrategy(v []*CapacityProviderStrategyItem) *CreateServiceInput { - s.CapacityProviderStrategy = v - return s -} - -// SetClientToken sets the ClientToken field's value. -func (s *CreateServiceInput) SetClientToken(v string) *CreateServiceInput { - s.ClientToken = &v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *CreateServiceInput) SetCluster(v string) *CreateServiceInput { - s.Cluster = &v - return s -} - -// SetDeploymentConfiguration sets the DeploymentConfiguration field's value. -func (s *CreateServiceInput) SetDeploymentConfiguration(v *DeploymentConfiguration) *CreateServiceInput { - s.DeploymentConfiguration = v - return s -} - -// SetDeploymentController sets the DeploymentController field's value. -func (s *CreateServiceInput) SetDeploymentController(v *DeploymentController) *CreateServiceInput { - s.DeploymentController = v - return s -} - -// SetDesiredCount sets the DesiredCount field's value. -func (s *CreateServiceInput) SetDesiredCount(v int64) *CreateServiceInput { - s.DesiredCount = &v - return s -} - -// SetEnableECSManagedTags sets the EnableECSManagedTags field's value. -func (s *CreateServiceInput) SetEnableECSManagedTags(v bool) *CreateServiceInput { - s.EnableECSManagedTags = &v - return s -} - -// SetEnableExecuteCommand sets the EnableExecuteCommand field's value. -func (s *CreateServiceInput) SetEnableExecuteCommand(v bool) *CreateServiceInput { - s.EnableExecuteCommand = &v - return s -} - -// SetHealthCheckGracePeriodSeconds sets the HealthCheckGracePeriodSeconds field's value. -func (s *CreateServiceInput) SetHealthCheckGracePeriodSeconds(v int64) *CreateServiceInput { - s.HealthCheckGracePeriodSeconds = &v - return s -} - -// SetLaunchType sets the LaunchType field's value. -func (s *CreateServiceInput) SetLaunchType(v string) *CreateServiceInput { - s.LaunchType = &v - return s -} - -// SetLoadBalancers sets the LoadBalancers field's value. -func (s *CreateServiceInput) SetLoadBalancers(v []*LoadBalancer) *CreateServiceInput { - s.LoadBalancers = v - return s -} - -// SetNetworkConfiguration sets the NetworkConfiguration field's value. -func (s *CreateServiceInput) SetNetworkConfiguration(v *NetworkConfiguration) *CreateServiceInput { - s.NetworkConfiguration = v - return s -} - -// SetPlacementConstraints sets the PlacementConstraints field's value. -func (s *CreateServiceInput) SetPlacementConstraints(v []*PlacementConstraint) *CreateServiceInput { - s.PlacementConstraints = v - return s -} - -// SetPlacementStrategy sets the PlacementStrategy field's value. -func (s *CreateServiceInput) SetPlacementStrategy(v []*PlacementStrategy) *CreateServiceInput { - s.PlacementStrategy = v - return s -} - -// SetPlatformVersion sets the PlatformVersion field's value. -func (s *CreateServiceInput) SetPlatformVersion(v string) *CreateServiceInput { - s.PlatformVersion = &v - return s -} - -// SetPropagateTags sets the PropagateTags field's value. -func (s *CreateServiceInput) SetPropagateTags(v string) *CreateServiceInput { - s.PropagateTags = &v - return s -} - -// SetRole sets the Role field's value. -func (s *CreateServiceInput) SetRole(v string) *CreateServiceInput { - s.Role = &v - return s -} - -// SetSchedulingStrategy sets the SchedulingStrategy field's value. -func (s *CreateServiceInput) SetSchedulingStrategy(v string) *CreateServiceInput { - s.SchedulingStrategy = &v - return s -} - -// SetServiceConnectConfiguration sets the ServiceConnectConfiguration field's value. -func (s *CreateServiceInput) SetServiceConnectConfiguration(v *ServiceConnectConfiguration) *CreateServiceInput { - s.ServiceConnectConfiguration = v - return s -} - -// SetServiceName sets the ServiceName field's value. -func (s *CreateServiceInput) SetServiceName(v string) *CreateServiceInput { - s.ServiceName = &v - return s -} - -// SetServiceRegistries sets the ServiceRegistries field's value. -func (s *CreateServiceInput) SetServiceRegistries(v []*ServiceRegistry) *CreateServiceInput { - s.ServiceRegistries = v - return s -} - -// SetTags sets the Tags field's value. -func (s *CreateServiceInput) SetTags(v []*Tag) *CreateServiceInput { - s.Tags = v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *CreateServiceInput) SetTaskDefinition(v string) *CreateServiceInput { - s.TaskDefinition = &v - return s -} - -type CreateServiceOutput struct { - _ struct{} `type:"structure"` - - // The full description of your service following the create call. - // - // A service will return either a capacityProviderStrategy or launchType parameter, - // but not both, depending where one was specified when it was created. - // - // If a service is using the ECS deployment controller, the deploymentController - // and taskSets parameters will not be returned. - // - // if the service uses the CODE_DEPLOY deployment controller, the deploymentController, - // taskSets and deployments parameters will be returned, however the deployments - // parameter will be an empty list. - Service *Service `locationName:"service" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateServiceOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateServiceOutput) GoString() string { - return s.String() -} - -// SetService sets the Service field's value. -func (s *CreateServiceOutput) SetService(v *Service) *CreateServiceOutput { - s.Service = v - return s -} - -type CreateTaskSetInput struct { - _ struct{} `type:"structure"` - - // The capacity provider strategy to use for the task set. - // - // A capacity provider strategy consists of one or more capacity providers along - // with the base and weight to assign to them. A capacity provider must be associated - // with the cluster to be used in a capacity provider strategy. The PutClusterCapacityProviders - // API is used to associate a capacity provider with a cluster. Only capacity - // providers with an ACTIVE or UPDATING status can be used. - // - // If a capacityProviderStrategy is specified, the launchType parameter must - // be omitted. If no capacityProviderStrategy or launchType is specified, the - // defaultCapacityProviderStrategy for the cluster is used. - // - // If specifying a capacity provider that uses an Auto Scaling group, the capacity - // provider must already be created. New capacity providers can be created with - // the CreateCapacityProvider API operation. - // - // To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT - // capacity providers. The Fargate capacity providers are available to all accounts - // and only need to be associated with a cluster to be used. - // - // The PutClusterCapacityProviders API operation is used to update the list - // of available capacity providers for a cluster after the cluster is created. - CapacityProviderStrategy []*CapacityProviderStrategyItem `locationName:"capacityProviderStrategy" type:"list"` - - // The identifier that you provide to ensure the idempotency of the request. - // It's case sensitive and must be unique. It can be up to 32 ASCII characters - // are allowed. - ClientToken *string `locationName:"clientToken" type:"string"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the service to create the task set in. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` - - // An optional non-unique tag that identifies this task set in external systems. - // If the task set is associated with a service discovery registry, the tasks - // in this task set will have the ECS_TASK_SET_EXTERNAL_ID Cloud Map attribute - // set to the provided value. - ExternalId *string `locationName:"externalId" type:"string"` - - // The launch type that new tasks in the task set uses. For more information, - // see Amazon ECS launch types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // If a launchType is specified, the capacityProviderStrategy parameter must - // be omitted. - LaunchType *string `locationName:"launchType" type:"string" enum:"LaunchType"` - - // A load balancer object representing the load balancer to use with the task - // set. The supported load balancer types are either an Application Load Balancer - // or a Network Load Balancer. - LoadBalancers []*LoadBalancer `locationName:"loadBalancers" type:"list"` - - // An object representing the network configuration for a task set. - NetworkConfiguration *NetworkConfiguration `locationName:"networkConfiguration" type:"structure"` - - // The platform version that the tasks in the task set uses. A platform version - // is specified only for tasks using the Fargate launch type. If one isn't specified, - // the LATEST platform version is used. - PlatformVersion *string `locationName:"platformVersion" type:"string"` - - // A floating-point percentage of the desired number of tasks to place and keep - // running in the task set. - Scale *Scale `locationName:"scale" type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the service to create - // the task set in. - // - // Service is a required field - Service *string `locationName:"service" type:"string" required:"true"` - - // The details of the service discovery registries to assign to this task set. - // For more information, see Service discovery (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html). - ServiceRegistries []*ServiceRegistry `locationName:"serviceRegistries" type:"list"` - - StartedBy *string `locationName:"startedBy" type:"string"` - - // The metadata that you apply to the task set to help you categorize and organize - // them. Each tag consists of a key and an optional value. You define both. - // When a service is deleted, the tags are deleted. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The task definition for the tasks in the task set to use. If a revision isn't - // specified, the latest ACTIVE revision is used. - // - // TaskDefinition is a required field - TaskDefinition *string `locationName:"taskDefinition" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateTaskSetInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateTaskSetInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *CreateTaskSetInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "CreateTaskSetInput"} - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - if s.Service == nil { - invalidParams.Add(request.NewErrParamRequired("Service")) - } - if s.TaskDefinition == nil { - invalidParams.Add(request.NewErrParamRequired("TaskDefinition")) - } - if s.CapacityProviderStrategy != nil { - for i, v := range s.CapacityProviderStrategy { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "CapacityProviderStrategy", i), err.(request.ErrInvalidParams)) - } - } - } - if s.Tags != nil { - for i, v := range s.Tags { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCapacityProviderStrategy sets the CapacityProviderStrategy field's value. -func (s *CreateTaskSetInput) SetCapacityProviderStrategy(v []*CapacityProviderStrategyItem) *CreateTaskSetInput { - s.CapacityProviderStrategy = v - return s -} - -// SetClientToken sets the ClientToken field's value. -func (s *CreateTaskSetInput) SetClientToken(v string) *CreateTaskSetInput { - s.ClientToken = &v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *CreateTaskSetInput) SetCluster(v string) *CreateTaskSetInput { - s.Cluster = &v - return s -} - -// SetExternalId sets the ExternalId field's value. -func (s *CreateTaskSetInput) SetExternalId(v string) *CreateTaskSetInput { - s.ExternalId = &v - return s -} - -// SetLaunchType sets the LaunchType field's value. -func (s *CreateTaskSetInput) SetLaunchType(v string) *CreateTaskSetInput { - s.LaunchType = &v - return s -} - -// SetLoadBalancers sets the LoadBalancers field's value. -func (s *CreateTaskSetInput) SetLoadBalancers(v []*LoadBalancer) *CreateTaskSetInput { - s.LoadBalancers = v - return s -} - -// SetNetworkConfiguration sets the NetworkConfiguration field's value. -func (s *CreateTaskSetInput) SetNetworkConfiguration(v *NetworkConfiguration) *CreateTaskSetInput { - s.NetworkConfiguration = v - return s -} - -// SetPlatformVersion sets the PlatformVersion field's value. -func (s *CreateTaskSetInput) SetPlatformVersion(v string) *CreateTaskSetInput { - s.PlatformVersion = &v - return s -} - -// SetScale sets the Scale field's value. -func (s *CreateTaskSetInput) SetScale(v *Scale) *CreateTaskSetInput { - s.Scale = v - return s -} - -// SetService sets the Service field's value. -func (s *CreateTaskSetInput) SetService(v string) *CreateTaskSetInput { - s.Service = &v - return s -} - -// SetServiceRegistries sets the ServiceRegistries field's value. -func (s *CreateTaskSetInput) SetServiceRegistries(v []*ServiceRegistry) *CreateTaskSetInput { - s.ServiceRegistries = v - return s -} - -// SetStartedBy sets the StartedBy field's value. -func (s *CreateTaskSetInput) SetStartedBy(v string) *CreateTaskSetInput { - s.StartedBy = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *CreateTaskSetInput) SetTags(v []*Tag) *CreateTaskSetInput { - s.Tags = v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *CreateTaskSetInput) SetTaskDefinition(v string) *CreateTaskSetInput { - s.TaskDefinition = &v - return s -} - -type CreateTaskSetOutput struct { - _ struct{} `type:"structure"` - - // Information about a set of Amazon ECS tasks in either an CodeDeploy or an - // EXTERNAL deployment. A task set includes details such as the desired number - // of tasks, how many tasks are running, and whether the task set serves production - // traffic. - TaskSet *TaskSet `locationName:"taskSet" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateTaskSetOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s CreateTaskSetOutput) GoString() string { - return s.String() -} - -// SetTaskSet sets the TaskSet field's value. -func (s *CreateTaskSetOutput) SetTaskSet(v *TaskSet) *CreateTaskSetOutput { - s.TaskSet = v - return s -} - -type DeleteAccountSettingInput struct { - _ struct{} `type:"structure"` - - // The resource name to disable the account setting for. If serviceLongArnFormat - // is specified, the ARN for your Amazon ECS services is affected. If taskLongArnFormat - // is specified, the ARN and resource ID for your Amazon ECS tasks is affected. - // If containerInstanceLongArnFormat is specified, the ARN and resource ID for - // your Amazon ECS container instances is affected. If awsvpcTrunking is specified, - // the ENI limit for your Amazon ECS container instances is affected. - // - // Name is a required field - Name *string `locationName:"name" type:"string" required:"true" enum:"SettingName"` - - // The Amazon Resource Name (ARN) of the principal. It can be an user, role, - // or the root user. If you specify the root user, it disables the account setting - // for all users, roles, and the root user of the account unless a user or role - // explicitly overrides these settings. If this field is omitted, the setting - // is changed only for the authenticated user. - PrincipalArn *string `locationName:"principalArn" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteAccountSettingInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteAccountSettingInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeleteAccountSettingInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeleteAccountSettingInput"} - if s.Name == nil { - invalidParams.Add(request.NewErrParamRequired("Name")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetName sets the Name field's value. -func (s *DeleteAccountSettingInput) SetName(v string) *DeleteAccountSettingInput { - s.Name = &v - return s -} - -// SetPrincipalArn sets the PrincipalArn field's value. -func (s *DeleteAccountSettingInput) SetPrincipalArn(v string) *DeleteAccountSettingInput { - s.PrincipalArn = &v - return s -} - -type DeleteAccountSettingOutput struct { - _ struct{} `type:"structure"` - - // The account setting for the specified principal ARN. - Setting *Setting `locationName:"setting" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteAccountSettingOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteAccountSettingOutput) GoString() string { - return s.String() -} - -// SetSetting sets the Setting field's value. -func (s *DeleteAccountSettingOutput) SetSetting(v *Setting) *DeleteAccountSettingOutput { - s.Setting = v - return s -} - -type DeleteAttributesInput struct { - _ struct{} `type:"structure"` - - // The attributes to delete from your resource. You can specify up to 10 attributes - // for each request. For custom attributes, specify the attribute name and target - // ID, but don't specify the value. If you specify the target ID using the short - // form, you must also specify the target type. - // - // Attributes is a required field - Attributes []*Attribute `locationName:"attributes" type:"list" required:"true"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that contains - // the resource to delete attributes. If you do not specify a cluster, the default - // cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteAttributesInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteAttributesInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeleteAttributesInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeleteAttributesInput"} - if s.Attributes == nil { - invalidParams.Add(request.NewErrParamRequired("Attributes")) - } - if s.Attributes != nil { - for i, v := range s.Attributes { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Attributes", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAttributes sets the Attributes field's value. -func (s *DeleteAttributesInput) SetAttributes(v []*Attribute) *DeleteAttributesInput { - s.Attributes = v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *DeleteAttributesInput) SetCluster(v string) *DeleteAttributesInput { - s.Cluster = &v - return s -} - -type DeleteAttributesOutput struct { - _ struct{} `type:"structure"` - - // A list of attribute objects that were successfully deleted from your resource. - Attributes []*Attribute `locationName:"attributes" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteAttributesOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteAttributesOutput) GoString() string { - return s.String() -} - -// SetAttributes sets the Attributes field's value. -func (s *DeleteAttributesOutput) SetAttributes(v []*Attribute) *DeleteAttributesOutput { - s.Attributes = v - return s -} - -type DeleteCapacityProviderInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the capacity provider - // to delete. - // - // CapacityProvider is a required field - CapacityProvider *string `locationName:"capacityProvider" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteCapacityProviderInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteCapacityProviderInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeleteCapacityProviderInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeleteCapacityProviderInput"} - if s.CapacityProvider == nil { - invalidParams.Add(request.NewErrParamRequired("CapacityProvider")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCapacityProvider sets the CapacityProvider field's value. -func (s *DeleteCapacityProviderInput) SetCapacityProvider(v string) *DeleteCapacityProviderInput { - s.CapacityProvider = &v - return s -} - -type DeleteCapacityProviderOutput struct { - _ struct{} `type:"structure"` - - // The details of the capacity provider. - CapacityProvider *CapacityProvider `locationName:"capacityProvider" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteCapacityProviderOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteCapacityProviderOutput) GoString() string { - return s.String() -} - -// SetCapacityProvider sets the CapacityProvider field's value. -func (s *DeleteCapacityProviderOutput) SetCapacityProvider(v *CapacityProvider) *DeleteCapacityProviderOutput { - s.CapacityProvider = v - return s -} - -type DeleteClusterInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster to delete. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteClusterInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteClusterInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeleteClusterInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeleteClusterInput"} - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *DeleteClusterInput) SetCluster(v string) *DeleteClusterInput { - s.Cluster = &v - return s -} - -type DeleteClusterOutput struct { - _ struct{} `type:"structure"` - - // The full description of the deleted cluster. - Cluster *Cluster `locationName:"cluster" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteClusterOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteClusterOutput) GoString() string { - return s.String() -} - -// SetCluster sets the Cluster field's value. -func (s *DeleteClusterOutput) SetCluster(v *Cluster) *DeleteClusterOutput { - s.Cluster = v - return s -} - -type DeleteServiceInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the service to delete. If you do not specify a cluster, the default cluster - // is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // If true, allows you to delete a service even if it wasn't scaled down to - // zero tasks. It's only necessary to use this if the service uses the REPLICA - // scheduling strategy. - Force *bool `locationName:"force" type:"boolean"` - - // The name of the service to delete. - // - // Service is a required field - Service *string `locationName:"service" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteServiceInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteServiceInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeleteServiceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeleteServiceInput"} - if s.Service == nil { - invalidParams.Add(request.NewErrParamRequired("Service")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *DeleteServiceInput) SetCluster(v string) *DeleteServiceInput { - s.Cluster = &v - return s -} - -// SetForce sets the Force field's value. -func (s *DeleteServiceInput) SetForce(v bool) *DeleteServiceInput { - s.Force = &v - return s -} - -// SetService sets the Service field's value. -func (s *DeleteServiceInput) SetService(v string) *DeleteServiceInput { - s.Service = &v - return s -} - -type DeleteServiceOutput struct { - _ struct{} `type:"structure"` - - // The full description of the deleted service. - Service *Service `locationName:"service" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteServiceOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteServiceOutput) GoString() string { - return s.String() -} - -// SetService sets the Service field's value. -func (s *DeleteServiceOutput) SetService(v *Service) *DeleteServiceOutput { - s.Service = v - return s -} - -type DeleteTaskSetInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the service that the task set found in to delete. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` - - // If true, you can delete a task set even if it hasn't been scaled down to - // zero. - Force *bool `locationName:"force" type:"boolean"` - - // The short name or full Amazon Resource Name (ARN) of the service that hosts - // the task set to delete. - // - // Service is a required field - Service *string `locationName:"service" type:"string" required:"true"` - - // The task set ID or full Amazon Resource Name (ARN) of the task set to delete. - // - // TaskSet is a required field - TaskSet *string `locationName:"taskSet" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteTaskSetInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteTaskSetInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeleteTaskSetInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeleteTaskSetInput"} - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - if s.Service == nil { - invalidParams.Add(request.NewErrParamRequired("Service")) - } - if s.TaskSet == nil { - invalidParams.Add(request.NewErrParamRequired("TaskSet")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *DeleteTaskSetInput) SetCluster(v string) *DeleteTaskSetInput { - s.Cluster = &v - return s -} - -// SetForce sets the Force field's value. -func (s *DeleteTaskSetInput) SetForce(v bool) *DeleteTaskSetInput { - s.Force = &v - return s -} - -// SetService sets the Service field's value. -func (s *DeleteTaskSetInput) SetService(v string) *DeleteTaskSetInput { - s.Service = &v - return s -} - -// SetTaskSet sets the TaskSet field's value. -func (s *DeleteTaskSetInput) SetTaskSet(v string) *DeleteTaskSetInput { - s.TaskSet = &v - return s -} - -type DeleteTaskSetOutput struct { - _ struct{} `type:"structure"` - - // Details about the task set. - TaskSet *TaskSet `locationName:"taskSet" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteTaskSetOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeleteTaskSetOutput) GoString() string { - return s.String() -} - -// SetTaskSet sets the TaskSet field's value. -func (s *DeleteTaskSetOutput) SetTaskSet(v *TaskSet) *DeleteTaskSetOutput { - s.TaskSet = v - return s -} - -// The details of an Amazon ECS service deployment. This is used only when a -// service uses the ECS deployment controller type. -type Deployment struct { - _ struct{} `type:"structure"` - - // The capacity provider strategy that the deployment is using. - CapacityProviderStrategy []*CapacityProviderStrategyItem `locationName:"capacityProviderStrategy" type:"list"` - - // The Unix timestamp for the time when the service deployment was created. - CreatedAt *time.Time `locationName:"createdAt" type:"timestamp"` - - // The most recent desired count of tasks that was specified for the service - // to deploy or maintain. - DesiredCount *int64 `locationName:"desiredCount" type:"integer"` - - // The ID of the deployment. - Id *string `locationName:"id" type:"string"` - - // The launch type the tasks in the service are using. For more information, - // see Amazon ECS Launch Types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) - // in the Amazon Elastic Container Service Developer Guide. - LaunchType *string `locationName:"launchType" type:"string" enum:"LaunchType"` - - // The VPC subnet and security group configuration for tasks that receive their - // own elastic network interface by using the awsvpc networking mode. - NetworkConfiguration *NetworkConfiguration `locationName:"networkConfiguration" type:"structure"` - - // The number of tasks in the deployment that are in the PENDING status. - PendingCount *int64 `locationName:"pendingCount" type:"integer"` - - // The platform version that your tasks in the service run on. A platform version - // is only specified for tasks using the Fargate launch type. If one isn't specified, - // the LATEST platform version is used. For more information, see Fargate Platform - // Versions (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html) - // in the Amazon Elastic Container Service Developer Guide. - PlatformVersion *string `locationName:"platformVersion" type:"string"` - - // The number of tasks in the deployment that are in the RUNNING status. - RunningCount *int64 `locationName:"runningCount" type:"integer"` - - // The details of the Service Connect configuration that's used by this deployment. - // Compare the configuration between multiple deployments when troubleshooting - // issues with new deployments. - // - // The configuration for this service to discover and connect to services, and - // be discovered by, and connected from, other services within a namespace. - // - // Tasks that run in a namespace can use short names to connect to services - // in the namespace. Tasks can connect to services across all of the clusters - // in the namespace. Tasks connect through a managed proxy container that collects - // logs and metrics for increased visibility. Only the tasks that Amazon ECS - // services create are supported with Service Connect. For more information, - // see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - ServiceConnectConfiguration *ServiceConnectConfiguration `locationName:"serviceConnectConfiguration" type:"structure"` - - // The list of Service Connect resources that are associated with this deployment. - // Each list entry maps a discovery name to a Cloud Map service name. - ServiceConnectResources []*ServiceConnectServiceResource `locationName:"serviceConnectResources" type:"list"` - - // The status of the deployment. The following describes each state. - // - // PRIMARY - // - // The most recent deployment of a service. - // - // ACTIVE - // - // A service deployment that still has running tasks, but are in the process - // of being replaced with a new PRIMARY deployment. - // - // INACTIVE - // - // A deployment that has been completely replaced. - Status *string `locationName:"status" type:"string"` - - // The most recent task definition that was specified for the tasks in the service - // to use. - TaskDefinition *string `locationName:"taskDefinition" type:"string"` - - // The Unix timestamp for the time when the service deployment was last updated. - UpdatedAt *time.Time `locationName:"updatedAt" type:"timestamp"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Deployment) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Deployment) GoString() string { - return s.String() -} - -// SetCapacityProviderStrategy sets the CapacityProviderStrategy field's value. -func (s *Deployment) SetCapacityProviderStrategy(v []*CapacityProviderStrategyItem) *Deployment { - s.CapacityProviderStrategy = v - return s -} - -// SetCreatedAt sets the CreatedAt field's value. -func (s *Deployment) SetCreatedAt(v time.Time) *Deployment { - s.CreatedAt = &v - return s -} - -// SetDesiredCount sets the DesiredCount field's value. -func (s *Deployment) SetDesiredCount(v int64) *Deployment { - s.DesiredCount = &v - return s -} - -// SetId sets the Id field's value. -func (s *Deployment) SetId(v string) *Deployment { - s.Id = &v - return s -} - -// SetLaunchType sets the LaunchType field's value. -func (s *Deployment) SetLaunchType(v string) *Deployment { - s.LaunchType = &v - return s -} - -// SetNetworkConfiguration sets the NetworkConfiguration field's value. -func (s *Deployment) SetNetworkConfiguration(v *NetworkConfiguration) *Deployment { - s.NetworkConfiguration = v - return s -} - -// SetPendingCount sets the PendingCount field's value. -func (s *Deployment) SetPendingCount(v int64) *Deployment { - s.PendingCount = &v - return s -} - -// SetPlatformVersion sets the PlatformVersion field's value. -func (s *Deployment) SetPlatformVersion(v string) *Deployment { - s.PlatformVersion = &v - return s -} - -// SetRunningCount sets the RunningCount field's value. -func (s *Deployment) SetRunningCount(v int64) *Deployment { - s.RunningCount = &v - return s -} - -// SetServiceConnectConfiguration sets the ServiceConnectConfiguration field's value. -func (s *Deployment) SetServiceConnectConfiguration(v *ServiceConnectConfiguration) *Deployment { - s.ServiceConnectConfiguration = v - return s -} - -// SetServiceConnectResources sets the ServiceConnectResources field's value. -func (s *Deployment) SetServiceConnectResources(v []*ServiceConnectServiceResource) *Deployment { - s.ServiceConnectResources = v - return s -} - -// SetStatus sets the Status field's value. -func (s *Deployment) SetStatus(v string) *Deployment { - s.Status = &v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *Deployment) SetTaskDefinition(v string) *Deployment { - s.TaskDefinition = &v - return s -} - -// SetUpdatedAt sets the UpdatedAt field's value. -func (s *Deployment) SetUpdatedAt(v time.Time) *Deployment { - s.UpdatedAt = &v - return s -} - -// One of the methods which provide a way for you to quickly identify when a -// deployment has failed, and then to optionally roll back the failure to the -// last working deployment. -// -// When the alarms are generated, Amazon ECS sets the service deployment to -// failed. Set the rollback parameter to have Amazon ECS to roll back your service -// to the last completed deployment after a failure. -// -// You can only use the DeploymentAlarms method to detect failures when the -// DeploymentController is set to ECS (rolling update). -// -// For more information, see Rolling update (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html) -// in the Amazon Elastic Container Service Developer Guide . -type DeploymentAlarms struct { - _ struct{} `type:"structure"` - - // One or more CloudWatch alarm names. Use a "," to separate the alarms. - // - // AlarmNames is a required field - AlarmNames []*string `locationName:"alarmNames" type:"list" required:"true"` - - // Determines whether to use the CloudWatch alarm option in the service deployment - // process. - // - // Enable is a required field - Enable *bool `locationName:"enable" type:"boolean" required:"true"` - - // Determines whether to configure Amazon ECS to roll back the service if a - // service deployment fails. If rollback is used, when a service deployment - // fails, the service is rolled back to the last deployment that completed successfully. - // - // Rollback is a required field - Rollback *bool `locationName:"rollback" type:"boolean" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeploymentAlarms) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeploymentAlarms) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeploymentAlarms) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeploymentAlarms"} - if s.AlarmNames == nil { - invalidParams.Add(request.NewErrParamRequired("AlarmNames")) - } - if s.Enable == nil { - invalidParams.Add(request.NewErrParamRequired("Enable")) - } - if s.Rollback == nil { - invalidParams.Add(request.NewErrParamRequired("Rollback")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAlarmNames sets the AlarmNames field's value. -func (s *DeploymentAlarms) SetAlarmNames(v []*string) *DeploymentAlarms { - s.AlarmNames = v - return s -} - -// SetEnable sets the Enable field's value. -func (s *DeploymentAlarms) SetEnable(v bool) *DeploymentAlarms { - s.Enable = &v - return s -} - -// SetRollback sets the Rollback field's value. -func (s *DeploymentAlarms) SetRollback(v bool) *DeploymentAlarms { - s.Rollback = &v - return s -} - -// The deployment circuit breaker can only be used for services using the rolling -// update (ECS) deployment type. -// -// The deployment circuit breaker determines whether a service deployment will -// fail if the service can't reach a steady state. If it is turned on, a service -// deployment will transition to a failed state and stop launching new tasks. -// You can also configure Amazon ECS to roll back your service to the last completed -// deployment after a failure. For more information, see Rolling update (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// For more information about API failure reasons, see API failure reasons (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/api_failures_messages.html) -// in the Amazon Elastic Container Service Developer Guide. -type DeploymentCircuitBreaker struct { - _ struct{} `type:"structure"` - - // Determines whether to use the deployment circuit breaker logic for the service. - // - // Enable is a required field - Enable *bool `locationName:"enable" type:"boolean" required:"true"` - - // Determines whether to configure Amazon ECS to roll back the service if a - // service deployment fails. If rollback is on, when a service deployment fails, - // the service is rolled back to the last deployment that completed successfully. - // - // Rollback is a required field - Rollback *bool `locationName:"rollback" type:"boolean" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeploymentCircuitBreaker) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeploymentCircuitBreaker) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeploymentCircuitBreaker) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeploymentCircuitBreaker"} - if s.Enable == nil { - invalidParams.Add(request.NewErrParamRequired("Enable")) - } - if s.Rollback == nil { - invalidParams.Add(request.NewErrParamRequired("Rollback")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetEnable sets the Enable field's value. -func (s *DeploymentCircuitBreaker) SetEnable(v bool) *DeploymentCircuitBreaker { - s.Enable = &v - return s -} - -// SetRollback sets the Rollback field's value. -func (s *DeploymentCircuitBreaker) SetRollback(v bool) *DeploymentCircuitBreaker { - s.Rollback = &v - return s -} - -// Optional deployment parameters that control how many tasks run during a deployment -// and the ordering of stopping and starting tasks. -type DeploymentConfiguration struct { - _ struct{} `type:"structure"` - - // Information about the CloudWatch alarms. - Alarms *DeploymentAlarms `locationName:"alarms" type:"structure"` - - // - // The deployment circuit breaker can only be used for services using the rolling - // update (ECS) deployment type. - // - // The deployment circuit breaker determines whether a service deployment will - // fail if the service can't reach a steady state. If you use the deployment - // circuit breaker, a service deployment will transition to a failed state and - // stop launching new tasks. If you use the rollback option, when a service - // deployment fails, the service is rolled back to the last deployment that - // completed successfully. For more information, see Rolling update (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-ecs.html) - // in the Amazon Elastic Container Service Developer Guide - DeploymentCircuitBreaker *DeploymentCircuitBreaker `locationName:"deploymentCircuitBreaker" type:"structure"` - - // If a service is using the rolling update (ECS) deployment type, the maximumPercent - // parameter represents an upper limit on the number of your service's tasks - // that are allowed in the RUNNING or PENDING state during a deployment, as - // a percentage of the desiredCount (rounded down to the nearest integer). This - // parameter enables you to define the deployment batch size. For example, if - // your service is using the REPLICA service scheduler and has a desiredCount - // of four tasks and a maximumPercent value of 200%, the scheduler may start - // four new tasks before stopping the four older tasks (provided that the cluster - // resources required to do this are available). The default maximumPercent - // value for a service using the REPLICA service scheduler is 200%. - // - // If a service is using either the blue/green (CODE_DEPLOY) or EXTERNAL deployment - // types and tasks that use the EC2 launch type, the maximum percent value is - // set to the default value and is used to define the upper limit on the number - // of the tasks in the service that remain in the RUNNING state while the container - // instances are in the DRAINING state. If the tasks in the service use the - // Fargate launch type, the maximum percent value is not used, although it is - // returned when describing your service. - MaximumPercent *int64 `locationName:"maximumPercent" type:"integer"` - - // If a service is using the rolling update (ECS) deployment type, the minimumHealthyPercent - // represents a lower limit on the number of your service's tasks that must - // remain in the RUNNING state during a deployment, as a percentage of the desiredCount - // (rounded up to the nearest integer). This parameter enables you to deploy - // without using additional cluster capacity. For example, if your service has - // a desiredCount of four tasks and a minimumHealthyPercent of 50%, the service - // scheduler may stop two existing tasks to free up cluster capacity before - // starting two new tasks. - // - // For services that do not use a load balancer, the following should be noted: - // - // * A service is considered healthy if all essential containers within the - // tasks in the service pass their health checks. - // - // * If a task has no essential containers with a health check defined, the - // service scheduler will wait for 40 seconds after a task reaches a RUNNING - // state before the task is counted towards the minimum healthy percent total. - // - // * If a task has one or more essential containers with a health check defined, - // the service scheduler will wait for the task to reach a healthy status - // before counting it towards the minimum healthy percent total. A task is - // considered healthy when all essential containers within the task have - // passed their health checks. The amount of time the service scheduler can - // wait for is determined by the container health check settings. - // - // For services are that do use a load balancer, the following should be noted: - // - // * If a task has no essential containers with a health check defined, the - // service scheduler will wait for the load balancer target group health - // check to return a healthy status before counting the task towards the - // minimum healthy percent total. - // - // * If a task has an essential container with a health check defined, the - // service scheduler will wait for both the task to reach a healthy status - // and the load balancer target group health check to return a healthy status - // before counting the task towards the minimum healthy percent total. - // - // If a service is using either the blue/green (CODE_DEPLOY) or EXTERNAL deployment - // types and is running tasks that use the EC2 launch type, the minimum healthy - // percent value is set to the default value and is used to define the lower - // limit on the number of the tasks in the service that remain in the RUNNING - // state while the container instances are in the DRAINING state. If a service - // is using either the blue/green (CODE_DEPLOY) or EXTERNAL deployment types - // and is running tasks that use the Fargate launch type, the minimum healthy - // percent value is not used, although it is returned when describing your service. - MinimumHealthyPercent *int64 `locationName:"minimumHealthyPercent" type:"integer"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeploymentConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeploymentConfiguration) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeploymentConfiguration) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeploymentConfiguration"} - if s.Alarms != nil { - if err := s.Alarms.Validate(); err != nil { - invalidParams.AddNested("Alarms", err.(request.ErrInvalidParams)) - } - } - if s.DeploymentCircuitBreaker != nil { - if err := s.DeploymentCircuitBreaker.Validate(); err != nil { - invalidParams.AddNested("DeploymentCircuitBreaker", err.(request.ErrInvalidParams)) - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAlarms sets the Alarms field's value. -func (s *DeploymentConfiguration) SetAlarms(v *DeploymentAlarms) *DeploymentConfiguration { - s.Alarms = v - return s -} - -// SetDeploymentCircuitBreaker sets the DeploymentCircuitBreaker field's value. -func (s *DeploymentConfiguration) SetDeploymentCircuitBreaker(v *DeploymentCircuitBreaker) *DeploymentConfiguration { - s.DeploymentCircuitBreaker = v - return s -} - -// SetMaximumPercent sets the MaximumPercent field's value. -func (s *DeploymentConfiguration) SetMaximumPercent(v int64) *DeploymentConfiguration { - s.MaximumPercent = &v - return s -} - -// SetMinimumHealthyPercent sets the MinimumHealthyPercent field's value. -func (s *DeploymentConfiguration) SetMinimumHealthyPercent(v int64) *DeploymentConfiguration { - s.MinimumHealthyPercent = &v - return s -} - -// The deployment controller to use for the service. For more information, see -// Amazon ECS deployment types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html) -// in the Amazon Elastic Container Service Developer Guide. -type DeploymentController struct { - _ struct{} `type:"structure"` - - // The deployment controller type to use. - // - // There are three deployment controller types available: - // - // ECS - // - // The rolling update (ECS) deployment type involves replacing the current running - // version of the container with the latest version. The number of containers - // Amazon ECS adds or removes from the service during a rolling update is controlled - // by adjusting the minimum and maximum number of healthy tasks allowed during - // a service deployment, as specified in the DeploymentConfiguration. - // - // CODE_DEPLOY - // - // The blue/green (CODE_DEPLOY) deployment type uses the blue/green deployment - // model powered by CodeDeploy, which allows you to verify a new deployment - // of a service before sending production traffic to it. - // - // EXTERNAL - // - // The external (EXTERNAL) deployment type enables you to use any third-party - // deployment controller for full control over the deployment process for an - // Amazon ECS service. - // - // Type is a required field - Type *string `locationName:"type" type:"string" required:"true" enum:"DeploymentControllerType"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeploymentController) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeploymentController) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeploymentController) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeploymentController"} - if s.Type == nil { - invalidParams.Add(request.NewErrParamRequired("Type")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetType sets the Type field's value. -func (s *DeploymentController) SetType(v string) *DeploymentController { - s.Type = &v - return s -} - -type DeregisterContainerInstanceInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the container instance to deregister. If you do not specify a cluster, the - // default cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // The container instance ID or full ARN of the container instance to deregister. - // For more information about the ARN format, see Amazon Resource Name (ARN) - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids) - // in the Amazon ECS Developer Guide. - // - // ContainerInstance is a required field - ContainerInstance *string `locationName:"containerInstance" type:"string" required:"true"` - - // Forces the container instance to be deregistered. If you have tasks running - // on the container instance when you deregister it with the force option, these - // tasks remain running until you terminate the instance or the tasks stop through - // some other means, but they're orphaned (no longer monitored or accounted - // for by Amazon ECS). If an orphaned task on your container instance is part - // of an Amazon ECS service, then the service scheduler starts another copy - // of that task, on a different container instance if possible. - // - // Any containers in orphaned service tasks that are registered with a Classic - // Load Balancer or an Application Load Balancer target group are deregistered. - // They begin connection draining according to the settings on the load balancer - // or target group. - Force *bool `locationName:"force" type:"boolean"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeregisterContainerInstanceInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeregisterContainerInstanceInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeregisterContainerInstanceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeregisterContainerInstanceInput"} - if s.ContainerInstance == nil { - invalidParams.Add(request.NewErrParamRequired("ContainerInstance")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *DeregisterContainerInstanceInput) SetCluster(v string) *DeregisterContainerInstanceInput { - s.Cluster = &v - return s -} - -// SetContainerInstance sets the ContainerInstance field's value. -func (s *DeregisterContainerInstanceInput) SetContainerInstance(v string) *DeregisterContainerInstanceInput { - s.ContainerInstance = &v - return s -} - -// SetForce sets the Force field's value. -func (s *DeregisterContainerInstanceInput) SetForce(v bool) *DeregisterContainerInstanceInput { - s.Force = &v - return s -} - -type DeregisterContainerInstanceOutput struct { - _ struct{} `type:"structure"` - - // The container instance that was deregistered. - ContainerInstance *ContainerInstance `locationName:"containerInstance" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeregisterContainerInstanceOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeregisterContainerInstanceOutput) GoString() string { - return s.String() -} - -// SetContainerInstance sets the ContainerInstance field's value. -func (s *DeregisterContainerInstanceOutput) SetContainerInstance(v *ContainerInstance) *DeregisterContainerInstanceOutput { - s.ContainerInstance = v - return s -} - -type DeregisterTaskDefinitionInput struct { - _ struct{} `type:"structure"` - - // The family and revision (family:revision) or full Amazon Resource Name (ARN) - // of the task definition to deregister. You must specify a revision. - // - // TaskDefinition is a required field - TaskDefinition *string `locationName:"taskDefinition" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeregisterTaskDefinitionInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeregisterTaskDefinitionInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DeregisterTaskDefinitionInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DeregisterTaskDefinitionInput"} - if s.TaskDefinition == nil { - invalidParams.Add(request.NewErrParamRequired("TaskDefinition")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *DeregisterTaskDefinitionInput) SetTaskDefinition(v string) *DeregisterTaskDefinitionInput { - s.TaskDefinition = &v - return s -} - -type DeregisterTaskDefinitionOutput struct { - _ struct{} `type:"structure"` - - // The full description of the deregistered task. - TaskDefinition *TaskDefinition `locationName:"taskDefinition" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeregisterTaskDefinitionOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DeregisterTaskDefinitionOutput) GoString() string { - return s.String() -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *DeregisterTaskDefinitionOutput) SetTaskDefinition(v *TaskDefinition) *DeregisterTaskDefinitionOutput { - s.TaskDefinition = v - return s -} - -type DescribeCapacityProvidersInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of one or more capacity - // providers. Up to 100 capacity providers can be described in an action. - CapacityProviders []*string `locationName:"capacityProviders" type:"list"` - - // Specifies whether or not you want to see the resource tags for the capacity - // provider. If TAGS is specified, the tags are included in the response. If - // this field is omitted, tags aren't included in the response. - Include []*string `locationName:"include" type:"list" enum:"CapacityProviderField"` - - // The maximum number of account setting results returned by DescribeCapacityProviders - // in paginated output. When this parameter is used, DescribeCapacityProviders - // only returns maxResults results in a single page along with a nextToken response - // element. The remaining results of the initial request can be seen by sending - // another DescribeCapacityProviders request with the returned nextToken value. - // This value can be between 1 and 10. If this parameter is not used, then DescribeCapacityProviders - // returns up to 10 results and a nextToken value if applicable. - MaxResults *int64 `locationName:"maxResults" type:"integer"` - - // The nextToken value returned from a previous paginated DescribeCapacityProviders - // request where maxResults was used and the results exceeded the value of that - // parameter. Pagination continues from the end of the previous results that - // returned the nextToken value. - // - // This token should be treated as an opaque identifier that is only used to - // retrieve the next items in a list and not for other programmatic purposes. - NextToken *string `locationName:"nextToken" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeCapacityProvidersInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeCapacityProvidersInput) GoString() string { - return s.String() -} - -// SetCapacityProviders sets the CapacityProviders field's value. -func (s *DescribeCapacityProvidersInput) SetCapacityProviders(v []*string) *DescribeCapacityProvidersInput { - s.CapacityProviders = v - return s -} - -// SetInclude sets the Include field's value. -func (s *DescribeCapacityProvidersInput) SetInclude(v []*string) *DescribeCapacityProvidersInput { - s.Include = v - return s -} - -// SetMaxResults sets the MaxResults field's value. -func (s *DescribeCapacityProvidersInput) SetMaxResults(v int64) *DescribeCapacityProvidersInput { - s.MaxResults = &v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *DescribeCapacityProvidersInput) SetNextToken(v string) *DescribeCapacityProvidersInput { - s.NextToken = &v - return s -} - -type DescribeCapacityProvidersOutput struct { - _ struct{} `type:"structure"` - - // The list of capacity providers. - CapacityProviders []*CapacityProvider `locationName:"capacityProviders" type:"list"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` - - // The nextToken value to include in a future DescribeCapacityProviders request. - // When the results of a DescribeCapacityProviders request exceed maxResults, - // this value can be used to retrieve the next page of results. This value is - // null when there are no more results to return. - NextToken *string `locationName:"nextToken" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeCapacityProvidersOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeCapacityProvidersOutput) GoString() string { - return s.String() -} - -// SetCapacityProviders sets the CapacityProviders field's value. -func (s *DescribeCapacityProvidersOutput) SetCapacityProviders(v []*CapacityProvider) *DescribeCapacityProvidersOutput { - s.CapacityProviders = v - return s -} - -// SetFailures sets the Failures field's value. -func (s *DescribeCapacityProvidersOutput) SetFailures(v []*Failure) *DescribeCapacityProvidersOutput { - s.Failures = v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *DescribeCapacityProvidersOutput) SetNextToken(v string) *DescribeCapacityProvidersOutput { - s.NextToken = &v - return s -} - -type DescribeClustersInput struct { - _ struct{} `type:"structure"` - - // A list of up to 100 cluster names or full cluster Amazon Resource Name (ARN) - // entries. If you do not specify a cluster, the default cluster is assumed. - Clusters []*string `locationName:"clusters" type:"list"` - - // Determines whether to include additional information about the clusters in - // the response. If this field is omitted, this information isn't included. - // - // If ATTACHMENTS is specified, the attachments for the container instances - // or tasks within the cluster are included, for example the capacity providers. - // - // If SETTINGS is specified, the settings for the cluster are included. - // - // If CONFIGURATIONS is specified, the configuration for the cluster is included. - // - // If STATISTICS is specified, the task and service count is included, separated - // by launch type. - // - // If TAGS is specified, the metadata tags associated with the cluster are included. - Include []*string `locationName:"include" type:"list" enum:"ClusterField"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeClustersInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeClustersInput) GoString() string { - return s.String() -} - -// SetClusters sets the Clusters field's value. -func (s *DescribeClustersInput) SetClusters(v []*string) *DescribeClustersInput { - s.Clusters = v - return s -} - -// SetInclude sets the Include field's value. -func (s *DescribeClustersInput) SetInclude(v []*string) *DescribeClustersInput { - s.Include = v - return s -} - -type DescribeClustersOutput struct { - _ struct{} `type:"structure"` - - // The list of clusters. - Clusters []*Cluster `locationName:"clusters" type:"list"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeClustersOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeClustersOutput) GoString() string { - return s.String() -} - -// SetClusters sets the Clusters field's value. -func (s *DescribeClustersOutput) SetClusters(v []*Cluster) *DescribeClustersOutput { - s.Clusters = v - return s -} - -// SetFailures sets the Failures field's value. -func (s *DescribeClustersOutput) SetFailures(v []*Failure) *DescribeClustersOutput { - s.Failures = v - return s -} - -type DescribeContainerInstancesInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the container instances to describe. If you do not specify a cluster, the - // default cluster is assumed. This parameter is required if the container instance - // or container instances you are describing were launched in any cluster other - // than the default cluster. - Cluster *string `locationName:"cluster" type:"string"` - - // A list of up to 100 container instance IDs or full Amazon Resource Name (ARN) - // entries. - // - // ContainerInstances is a required field - ContainerInstances []*string `locationName:"containerInstances" type:"list" required:"true"` - - // Specifies whether you want to see the resource tags for the container instance. - // If TAGS is specified, the tags are included in the response. If CONTAINER_INSTANCE_HEALTH - // is specified, the container instance health is included in the response. - // If this field is omitted, tags and container instance health status aren't - // included in the response. - Include []*string `locationName:"include" type:"list" enum:"ContainerInstanceField"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeContainerInstancesInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeContainerInstancesInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DescribeContainerInstancesInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DescribeContainerInstancesInput"} - if s.ContainerInstances == nil { - invalidParams.Add(request.NewErrParamRequired("ContainerInstances")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *DescribeContainerInstancesInput) SetCluster(v string) *DescribeContainerInstancesInput { - s.Cluster = &v - return s -} - -// SetContainerInstances sets the ContainerInstances field's value. -func (s *DescribeContainerInstancesInput) SetContainerInstances(v []*string) *DescribeContainerInstancesInput { - s.ContainerInstances = v - return s -} - -// SetInclude sets the Include field's value. -func (s *DescribeContainerInstancesInput) SetInclude(v []*string) *DescribeContainerInstancesInput { - s.Include = v - return s -} - -type DescribeContainerInstancesOutput struct { - _ struct{} `type:"structure"` - - // The list of container instances. - ContainerInstances []*ContainerInstance `locationName:"containerInstances" type:"list"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeContainerInstancesOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeContainerInstancesOutput) GoString() string { - return s.String() -} - -// SetContainerInstances sets the ContainerInstances field's value. -func (s *DescribeContainerInstancesOutput) SetContainerInstances(v []*ContainerInstance) *DescribeContainerInstancesOutput { - s.ContainerInstances = v - return s -} - -// SetFailures sets the Failures field's value. -func (s *DescribeContainerInstancesOutput) SetFailures(v []*Failure) *DescribeContainerInstancesOutput { - s.Failures = v - return s -} - -type DescribeServicesInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN)the cluster that hosts the - // service to describe. If you do not specify a cluster, the default cluster - // is assumed. This parameter is required if the service or services you are - // describing were launched in any cluster other than the default cluster. - Cluster *string `locationName:"cluster" type:"string"` - - // Determines whether you want to see the resource tags for the service. If - // TAGS is specified, the tags are included in the response. If this field is - // omitted, tags aren't included in the response. - Include []*string `locationName:"include" type:"list" enum:"ServiceField"` - - // A list of services to describe. You may specify up to 10 services to describe - // in a single operation. - // - // Services is a required field - Services []*string `locationName:"services" type:"list" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeServicesInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeServicesInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DescribeServicesInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DescribeServicesInput"} - if s.Services == nil { - invalidParams.Add(request.NewErrParamRequired("Services")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *DescribeServicesInput) SetCluster(v string) *DescribeServicesInput { - s.Cluster = &v - return s -} - -// SetInclude sets the Include field's value. -func (s *DescribeServicesInput) SetInclude(v []*string) *DescribeServicesInput { - s.Include = v - return s -} - -// SetServices sets the Services field's value. -func (s *DescribeServicesInput) SetServices(v []*string) *DescribeServicesInput { - s.Services = v - return s -} - -type DescribeServicesOutput struct { - _ struct{} `type:"structure"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` - - // The list of services described. - Services []*Service `locationName:"services" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeServicesOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeServicesOutput) GoString() string { - return s.String() -} - -// SetFailures sets the Failures field's value. -func (s *DescribeServicesOutput) SetFailures(v []*Failure) *DescribeServicesOutput { - s.Failures = v - return s -} - -// SetServices sets the Services field's value. -func (s *DescribeServicesOutput) SetServices(v []*Service) *DescribeServicesOutput { - s.Services = v - return s -} - -type DescribeTaskDefinitionInput struct { - _ struct{} `type:"structure"` - - // Determines whether to see the resource tags for the task definition. If TAGS - // is specified, the tags are included in the response. If this field is omitted, - // tags aren't included in the response. - Include []*string `locationName:"include" type:"list" enum:"TaskDefinitionField"` - - // The family for the latest ACTIVE revision, family and revision (family:revision) - // for a specific revision in the family, or full Amazon Resource Name (ARN) - // of the task definition to describe. - // - // TaskDefinition is a required field - TaskDefinition *string `locationName:"taskDefinition" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTaskDefinitionInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTaskDefinitionInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DescribeTaskDefinitionInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DescribeTaskDefinitionInput"} - if s.TaskDefinition == nil { - invalidParams.Add(request.NewErrParamRequired("TaskDefinition")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetInclude sets the Include field's value. -func (s *DescribeTaskDefinitionInput) SetInclude(v []*string) *DescribeTaskDefinitionInput { - s.Include = v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *DescribeTaskDefinitionInput) SetTaskDefinition(v string) *DescribeTaskDefinitionInput { - s.TaskDefinition = &v - return s -} - -type DescribeTaskDefinitionOutput struct { - _ struct{} `type:"structure"` - - // The metadata that's applied to the task definition to help you categorize - // and organize them. Each tag consists of a key and an optional value. You - // define both. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The full task definition description. - TaskDefinition *TaskDefinition `locationName:"taskDefinition" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTaskDefinitionOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTaskDefinitionOutput) GoString() string { - return s.String() -} - -// SetTags sets the Tags field's value. -func (s *DescribeTaskDefinitionOutput) SetTags(v []*Tag) *DescribeTaskDefinitionOutput { - s.Tags = v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *DescribeTaskDefinitionOutput) SetTaskDefinition(v *TaskDefinition) *DescribeTaskDefinitionOutput { - s.TaskDefinition = v - return s -} - -type DescribeTaskSetsInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the service that the task sets exist in. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` - - // Specifies whether to see the resource tags for the task set. If TAGS is specified, - // the tags are included in the response. If this field is omitted, tags aren't - // included in the response. - Include []*string `locationName:"include" type:"list" enum:"TaskSetField"` - - // The short name or full Amazon Resource Name (ARN) of the service that the - // task sets exist in. - // - // Service is a required field - Service *string `locationName:"service" type:"string" required:"true"` - - // The ID or full Amazon Resource Name (ARN) of task sets to describe. - // - // TaskSets is a required field - TaskSets []*string `locationName:"taskSets" type:"list" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTaskSetsInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTaskSetsInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DescribeTaskSetsInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DescribeTaskSetsInput"} - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - if s.Service == nil { - invalidParams.Add(request.NewErrParamRequired("Service")) - } - if s.TaskSets == nil { - invalidParams.Add(request.NewErrParamRequired("TaskSets")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *DescribeTaskSetsInput) SetCluster(v string) *DescribeTaskSetsInput { - s.Cluster = &v - return s -} - -// SetInclude sets the Include field's value. -func (s *DescribeTaskSetsInput) SetInclude(v []*string) *DescribeTaskSetsInput { - s.Include = v - return s -} - -// SetService sets the Service field's value. -func (s *DescribeTaskSetsInput) SetService(v string) *DescribeTaskSetsInput { - s.Service = &v - return s -} - -// SetTaskSets sets the TaskSets field's value. -func (s *DescribeTaskSetsInput) SetTaskSets(v []*string) *DescribeTaskSetsInput { - s.TaskSets = v - return s -} - -type DescribeTaskSetsOutput struct { - _ struct{} `type:"structure"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` - - // The list of task sets described. - TaskSets []*TaskSet `locationName:"taskSets" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTaskSetsOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTaskSetsOutput) GoString() string { - return s.String() -} - -// SetFailures sets the Failures field's value. -func (s *DescribeTaskSetsOutput) SetFailures(v []*Failure) *DescribeTaskSetsOutput { - s.Failures = v - return s -} - -// SetTaskSets sets the TaskSets field's value. -func (s *DescribeTaskSetsOutput) SetTaskSets(v []*TaskSet) *DescribeTaskSetsOutput { - s.TaskSets = v - return s -} - -type DescribeTasksInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the task or tasks to describe. If you do not specify a cluster, the default - // cluster is assumed. This parameter is required if the task or tasks you are - // describing were launched in any cluster other than the default cluster. - Cluster *string `locationName:"cluster" type:"string"` - - // Specifies whether you want to see the resource tags for the task. If TAGS - // is specified, the tags are included in the response. If this field is omitted, - // tags aren't included in the response. - Include []*string `locationName:"include" type:"list" enum:"TaskField"` - - // A list of up to 100 task IDs or full ARN entries. - // - // Tasks is a required field - Tasks []*string `locationName:"tasks" type:"list" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTasksInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTasksInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *DescribeTasksInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "DescribeTasksInput"} - if s.Tasks == nil { - invalidParams.Add(request.NewErrParamRequired("Tasks")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *DescribeTasksInput) SetCluster(v string) *DescribeTasksInput { - s.Cluster = &v - return s -} - -// SetInclude sets the Include field's value. -func (s *DescribeTasksInput) SetInclude(v []*string) *DescribeTasksInput { - s.Include = v - return s -} - -// SetTasks sets the Tasks field's value. -func (s *DescribeTasksInput) SetTasks(v []*string) *DescribeTasksInput { - s.Tasks = v - return s -} - -type DescribeTasksOutput struct { - _ struct{} `type:"structure"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` - - // The list of tasks. - Tasks []*Task `locationName:"tasks" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTasksOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DescribeTasksOutput) GoString() string { - return s.String() -} - -// SetFailures sets the Failures field's value. -func (s *DescribeTasksOutput) SetFailures(v []*Failure) *DescribeTasksOutput { - s.Failures = v - return s -} - -// SetTasks sets the Tasks field's value. -func (s *DescribeTasksOutput) SetTasks(v []*Task) *DescribeTasksOutput { - s.Tasks = v - return s -} - -// An object representing a container instance host device. -type Device struct { - _ struct{} `type:"structure"` - - // The path inside the container at which to expose the host device. - ContainerPath *string `locationName:"containerPath" type:"string"` - - // The path for the device on the host container instance. - // - // HostPath is a required field - HostPath *string `locationName:"hostPath" type:"string" required:"true"` - - // The explicit permissions to provide to the container for the device. By default, - // the container has permissions for read, write, and mknod for the device. - Permissions []*string `locationName:"permissions" type:"list" enum:"DeviceCgroupPermission"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Device) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Device) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *Device) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "Device"} - if s.HostPath == nil { - invalidParams.Add(request.NewErrParamRequired("HostPath")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetContainerPath sets the ContainerPath field's value. -func (s *Device) SetContainerPath(v string) *Device { - s.ContainerPath = &v - return s -} - -// SetHostPath sets the HostPath field's value. -func (s *Device) SetHostPath(v string) *Device { - s.HostPath = &v - return s -} - -// SetPermissions sets the Permissions field's value. -func (s *Device) SetPermissions(v []*string) *Device { - s.Permissions = v - return s -} - -type DiscoverPollEndpointInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that the - // container instance belongs to. - Cluster *string `locationName:"cluster" type:"string"` - - // The container instance ID or full ARN of the container instance. For more - // information about the ARN format, see Amazon Resource Name (ARN) (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids) - // in the Amazon ECS Developer Guide. - ContainerInstance *string `locationName:"containerInstance" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DiscoverPollEndpointInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DiscoverPollEndpointInput) GoString() string { - return s.String() -} - -// SetCluster sets the Cluster field's value. -func (s *DiscoverPollEndpointInput) SetCluster(v string) *DiscoverPollEndpointInput { - s.Cluster = &v - return s -} - -// SetContainerInstance sets the ContainerInstance field's value. -func (s *DiscoverPollEndpointInput) SetContainerInstance(v string) *DiscoverPollEndpointInput { - s.ContainerInstance = &v - return s -} - -type DiscoverPollEndpointOutput struct { - _ struct{} `type:"structure"` - - // The endpoint for the Amazon ECS agent to poll. - Endpoint *string `locationName:"endpoint" type:"string"` - - // The endpoint for the Amazon ECS agent to poll for Service Connect configuration. - // For more information, see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - ServiceConnectEndpoint *string `locationName:"serviceConnectEndpoint" type:"string"` - - // The telemetry endpoint for the Amazon ECS agent. - TelemetryEndpoint *string `locationName:"telemetryEndpoint" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DiscoverPollEndpointOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DiscoverPollEndpointOutput) GoString() string { - return s.String() -} - -// SetEndpoint sets the Endpoint field's value. -func (s *DiscoverPollEndpointOutput) SetEndpoint(v string) *DiscoverPollEndpointOutput { - s.Endpoint = &v - return s -} - -// SetServiceConnectEndpoint sets the ServiceConnectEndpoint field's value. -func (s *DiscoverPollEndpointOutput) SetServiceConnectEndpoint(v string) *DiscoverPollEndpointOutput { - s.ServiceConnectEndpoint = &v - return s -} - -// SetTelemetryEndpoint sets the TelemetryEndpoint field's value. -func (s *DiscoverPollEndpointOutput) SetTelemetryEndpoint(v string) *DiscoverPollEndpointOutput { - s.TelemetryEndpoint = &v - return s -} - -// This parameter is specified when you're using Docker volumes. Docker volumes -// are only supported when you're using the EC2 launch type. Windows containers -// only support the use of the local driver. To use bind mounts, specify a host -// instead. -type DockerVolumeConfiguration struct { - _ struct{} `type:"structure"` - - // If this value is true, the Docker volume is created if it doesn't already - // exist. - // - // This field is only used if the scope is shared. - Autoprovision *bool `locationName:"autoprovision" type:"boolean"` - - // The Docker volume driver to use. The driver value must match the driver name - // provided by Docker because it is used for task placement. If the driver was - // installed using the Docker plugin CLI, use docker plugin ls to retrieve the - // driver name from your container instance. If the driver was installed using - // another method, use Docker plugin discovery to retrieve the driver name. - // For more information, see Docker plugin discovery (https://docs.docker.com/engine/extend/plugin_api/#plugin-discovery). - // This parameter maps to Driver in the Create a volume (https://docs.docker.com/engine/api/v1.35/#operation/VolumeCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the xxdriver option to docker volume create (https://docs.docker.com/engine/reference/commandline/volume_create/). - Driver *string `locationName:"driver" type:"string"` - - // A map of Docker driver-specific options passed through. This parameter maps - // to DriverOpts in the Create a volume (https://docs.docker.com/engine/api/v1.35/#operation/VolumeCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the xxopt option to docker volume create (https://docs.docker.com/engine/reference/commandline/volume_create/). - DriverOpts map[string]*string `locationName:"driverOpts" type:"map"` - - // Custom metadata to add to your Docker volume. This parameter maps to Labels - // in the Create a volume (https://docs.docker.com/engine/api/v1.35/#operation/VolumeCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the xxlabel option to docker volume create (https://docs.docker.com/engine/reference/commandline/volume_create/). - Labels map[string]*string `locationName:"labels" type:"map"` - - // The scope for the Docker volume that determines its lifecycle. Docker volumes - // that are scoped to a task are automatically provisioned when the task starts - // and destroyed when the task stops. Docker volumes that are scoped as shared - // persist after the task stops. - Scope *string `locationName:"scope" type:"string" enum:"Scope"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DockerVolumeConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s DockerVolumeConfiguration) GoString() string { - return s.String() -} - -// SetAutoprovision sets the Autoprovision field's value. -func (s *DockerVolumeConfiguration) SetAutoprovision(v bool) *DockerVolumeConfiguration { - s.Autoprovision = &v - return s -} - -// SetDriver sets the Driver field's value. -func (s *DockerVolumeConfiguration) SetDriver(v string) *DockerVolumeConfiguration { - s.Driver = &v - return s -} - -// SetDriverOpts sets the DriverOpts field's value. -func (s *DockerVolumeConfiguration) SetDriverOpts(v map[string]*string) *DockerVolumeConfiguration { - s.DriverOpts = v - return s -} - -// SetLabels sets the Labels field's value. -func (s *DockerVolumeConfiguration) SetLabels(v map[string]*string) *DockerVolumeConfiguration { - s.Labels = v - return s -} - -// SetScope sets the Scope field's value. -func (s *DockerVolumeConfiguration) SetScope(v string) *DockerVolumeConfiguration { - s.Scope = &v - return s -} - -// The details of the execute command configuration. -type ExecuteCommandConfiguration struct { - _ struct{} `type:"structure"` - - // Specify an Key Management Service key ID to encrypt the data between the - // local client and the container. - KmsKeyId *string `locationName:"kmsKeyId" type:"string"` - - // The log configuration for the results of the execute command actions. The - // logs can be sent to CloudWatch Logs or an Amazon S3 bucket. When logging=OVERRIDE - // is specified, a logConfiguration must be provided. - LogConfiguration *ExecuteCommandLogConfiguration `locationName:"logConfiguration" type:"structure"` - - // The log setting to use for redirecting logs for your execute command results. - // The following log settings are available. - // - // * NONE: The execute command session is not logged. - // - // * DEFAULT: The awslogs configuration in the task definition is used. If - // no logging parameter is specified, it defaults to this value. If no awslogs - // log driver is configured in the task definition, the output won't be logged. - // - // * OVERRIDE: Specify the logging details as a part of logConfiguration. - // If the OVERRIDE logging option is specified, the logConfiguration is required. - Logging *string `locationName:"logging" type:"string" enum:"ExecuteCommandLogging"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ExecuteCommandConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ExecuteCommandConfiguration) GoString() string { - return s.String() -} - -// SetKmsKeyId sets the KmsKeyId field's value. -func (s *ExecuteCommandConfiguration) SetKmsKeyId(v string) *ExecuteCommandConfiguration { - s.KmsKeyId = &v - return s -} - -// SetLogConfiguration sets the LogConfiguration field's value. -func (s *ExecuteCommandConfiguration) SetLogConfiguration(v *ExecuteCommandLogConfiguration) *ExecuteCommandConfiguration { - s.LogConfiguration = v - return s -} - -// SetLogging sets the Logging field's value. -func (s *ExecuteCommandConfiguration) SetLogging(v string) *ExecuteCommandConfiguration { - s.Logging = &v - return s -} - -type ExecuteCommandInput struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) or short name of the cluster the task is running - // in. If you do not specify a cluster, the default cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // The command to run on the container. - // - // Command is a required field - Command *string `locationName:"command" type:"string" required:"true"` - - // The name of the container to execute the command on. A container name only - // needs to be specified for tasks containing multiple containers. - Container *string `locationName:"container" type:"string"` - - // Use this flag to run your command in interactive mode. - // - // Interactive is a required field - Interactive *bool `locationName:"interactive" type:"boolean" required:"true"` - - // The Amazon Resource Name (ARN) or ID of the task the container is part of. - // - // Task is a required field - Task *string `locationName:"task" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ExecuteCommandInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ExecuteCommandInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ExecuteCommandInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ExecuteCommandInput"} - if s.Command == nil { - invalidParams.Add(request.NewErrParamRequired("Command")) - } - if s.Interactive == nil { - invalidParams.Add(request.NewErrParamRequired("Interactive")) - } - if s.Task == nil { - invalidParams.Add(request.NewErrParamRequired("Task")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *ExecuteCommandInput) SetCluster(v string) *ExecuteCommandInput { - s.Cluster = &v - return s -} - -// SetCommand sets the Command field's value. -func (s *ExecuteCommandInput) SetCommand(v string) *ExecuteCommandInput { - s.Command = &v - return s -} - -// SetContainer sets the Container field's value. -func (s *ExecuteCommandInput) SetContainer(v string) *ExecuteCommandInput { - s.Container = &v - return s -} - -// SetInteractive sets the Interactive field's value. -func (s *ExecuteCommandInput) SetInteractive(v bool) *ExecuteCommandInput { - s.Interactive = &v - return s -} - -// SetTask sets the Task field's value. -func (s *ExecuteCommandInput) SetTask(v string) *ExecuteCommandInput { - s.Task = &v - return s -} - -// The log configuration for the results of the execute command actions. The -// logs can be sent to CloudWatch Logs or an Amazon S3 bucket. -type ExecuteCommandLogConfiguration struct { - _ struct{} `type:"structure"` - - // Determines whether to use encryption on the CloudWatch logs. If not specified, - // encryption will be off. - CloudWatchEncryptionEnabled *bool `locationName:"cloudWatchEncryptionEnabled" type:"boolean"` - - // The name of the CloudWatch log group to send logs to. - // - // The CloudWatch log group must already be created. - CloudWatchLogGroupName *string `locationName:"cloudWatchLogGroupName" type:"string"` - - // The name of the S3 bucket to send logs to. - // - // The S3 bucket must already be created. - S3BucketName *string `locationName:"s3BucketName" type:"string"` - - // Determines whether to use encryption on the S3 logs. If not specified, encryption - // is not used. - S3EncryptionEnabled *bool `locationName:"s3EncryptionEnabled" type:"boolean"` - - // An optional folder in the S3 bucket to place logs in. - S3KeyPrefix *string `locationName:"s3KeyPrefix" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ExecuteCommandLogConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ExecuteCommandLogConfiguration) GoString() string { - return s.String() -} - -// SetCloudWatchEncryptionEnabled sets the CloudWatchEncryptionEnabled field's value. -func (s *ExecuteCommandLogConfiguration) SetCloudWatchEncryptionEnabled(v bool) *ExecuteCommandLogConfiguration { - s.CloudWatchEncryptionEnabled = &v - return s -} - -// SetCloudWatchLogGroupName sets the CloudWatchLogGroupName field's value. -func (s *ExecuteCommandLogConfiguration) SetCloudWatchLogGroupName(v string) *ExecuteCommandLogConfiguration { - s.CloudWatchLogGroupName = &v - return s -} - -// SetS3BucketName sets the S3BucketName field's value. -func (s *ExecuteCommandLogConfiguration) SetS3BucketName(v string) *ExecuteCommandLogConfiguration { - s.S3BucketName = &v - return s -} - -// SetS3EncryptionEnabled sets the S3EncryptionEnabled field's value. -func (s *ExecuteCommandLogConfiguration) SetS3EncryptionEnabled(v bool) *ExecuteCommandLogConfiguration { - s.S3EncryptionEnabled = &v - return s -} - -// SetS3KeyPrefix sets the S3KeyPrefix field's value. -func (s *ExecuteCommandLogConfiguration) SetS3KeyPrefix(v string) *ExecuteCommandLogConfiguration { - s.S3KeyPrefix = &v - return s -} - -type ExecuteCommandOutput struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) of the cluster. - ClusterArn *string `locationName:"clusterArn" type:"string"` - - // The Amazon Resource Name (ARN) of the container. - ContainerArn *string `locationName:"containerArn" type:"string"` - - // The name of the container. - ContainerName *string `locationName:"containerName" type:"string"` - - // Determines whether the execute command session is running in interactive - // mode. Amazon ECS only supports initiating interactive sessions, so you must - // specify true for this value. - Interactive *bool `locationName:"interactive" type:"boolean"` - - // The details of the SSM session that was created for this instance of execute-command. - Session *Session `locationName:"session" type:"structure"` - - // The Amazon Resource Name (ARN) of the task. - TaskArn *string `locationName:"taskArn" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ExecuteCommandOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ExecuteCommandOutput) GoString() string { - return s.String() -} - -// SetClusterArn sets the ClusterArn field's value. -func (s *ExecuteCommandOutput) SetClusterArn(v string) *ExecuteCommandOutput { - s.ClusterArn = &v - return s -} - -// SetContainerArn sets the ContainerArn field's value. -func (s *ExecuteCommandOutput) SetContainerArn(v string) *ExecuteCommandOutput { - s.ContainerArn = &v - return s -} - -// SetContainerName sets the ContainerName field's value. -func (s *ExecuteCommandOutput) SetContainerName(v string) *ExecuteCommandOutput { - s.ContainerName = &v - return s -} - -// SetInteractive sets the Interactive field's value. -func (s *ExecuteCommandOutput) SetInteractive(v bool) *ExecuteCommandOutput { - s.Interactive = &v - return s -} - -// SetSession sets the Session field's value. -func (s *ExecuteCommandOutput) SetSession(v *Session) *ExecuteCommandOutput { - s.Session = v - return s -} - -// SetTaskArn sets the TaskArn field's value. -func (s *ExecuteCommandOutput) SetTaskArn(v string) *ExecuteCommandOutput { - s.TaskArn = &v - return s -} - -// A failed resource. For a list of common causes, see API failure reasons (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/api_failures_messages.html) -// in the Amazon Elastic Container Service Developer Guide. -type Failure struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) of the failed resource. - Arn *string `locationName:"arn" type:"string"` - - // The details of the failure. - Detail *string `locationName:"detail" type:"string"` - - // The reason for the failure. - Reason *string `locationName:"reason" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Failure) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Failure) GoString() string { - return s.String() -} - -// SetArn sets the Arn field's value. -func (s *Failure) SetArn(v string) *Failure { - s.Arn = &v - return s -} - -// SetDetail sets the Detail field's value. -func (s *Failure) SetDetail(v string) *Failure { - s.Detail = &v - return s -} - -// SetReason sets the Reason field's value. -func (s *Failure) SetReason(v string) *Failure { - s.Reason = &v - return s -} - -// The FireLens configuration for the container. This is used to specify and -// configure a log router for container logs. For more information, see Custom -// log routing (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_firelens.html) -// in the Amazon Elastic Container Service Developer Guide. -type FirelensConfiguration struct { - _ struct{} `type:"structure"` - - // The options to use when configuring the log router. This field is optional - // and can be used to specify a custom configuration file or to add additional - // metadata, such as the task, task definition, cluster, and container instance - // details to the log event. If specified, the syntax to use is "options":{"enable-ecs-log-metadata":"true|false","config-file-type:"s3|file","config-file-value":"arn:aws:s3:::mybucket/fluent.conf|filepath"}. - // For more information, see Creating a task definition that uses a FireLens - // configuration (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_firelens.html#firelens-taskdef) - // in the Amazon Elastic Container Service Developer Guide. - // - // Tasks hosted on Fargate only support the file configuration file type. - Options map[string]*string `locationName:"options" type:"map"` - - // The log router to use. The valid values are fluentd or fluentbit. - // - // Type is a required field - Type *string `locationName:"type" type:"string" required:"true" enum:"FirelensConfigurationType"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s FirelensConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s FirelensConfiguration) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *FirelensConfiguration) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "FirelensConfiguration"} - if s.Type == nil { - invalidParams.Add(request.NewErrParamRequired("Type")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetOptions sets the Options field's value. -func (s *FirelensConfiguration) SetOptions(v map[string]*string) *FirelensConfiguration { - s.Options = v - return s -} - -// SetType sets the Type field's value. -func (s *FirelensConfiguration) SetType(v string) *FirelensConfiguration { - s.Type = &v - return s -} - -type GetTaskProtectionInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the service that the task sets exist in. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` - - // A list of up to 100 task IDs or full ARN entries. - Tasks []*string `locationName:"tasks" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s GetTaskProtectionInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s GetTaskProtectionInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *GetTaskProtectionInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "GetTaskProtectionInput"} - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *GetTaskProtectionInput) SetCluster(v string) *GetTaskProtectionInput { - s.Cluster = &v - return s -} - -// SetTasks sets the Tasks field's value. -func (s *GetTaskProtectionInput) SetTasks(v []*string) *GetTaskProtectionInput { - s.Tasks = v - return s -} - -type GetTaskProtectionOutput struct { - _ struct{} `type:"structure"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` - - // A list of tasks with the following information. - // - // * taskArn: The task ARN. - // - // * protectionEnabled: The protection status of the task. If scale-in protection - // is turned on for a task, the value is true. Otherwise, it is false. - // - // * expirationDate: The epoch time when protection for the task will expire. - ProtectedTasks []*ProtectedTask `locationName:"protectedTasks" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s GetTaskProtectionOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s GetTaskProtectionOutput) GoString() string { - return s.String() -} - -// SetFailures sets the Failures field's value. -func (s *GetTaskProtectionOutput) SetFailures(v []*Failure) *GetTaskProtectionOutput { - s.Failures = v - return s -} - -// SetProtectedTasks sets the ProtectedTasks field's value. -func (s *GetTaskProtectionOutput) SetProtectedTasks(v []*ProtectedTask) *GetTaskProtectionOutput { - s.ProtectedTasks = v - return s -} - -// An object representing a container health check. Health check parameters -// that are specified in a container definition override any Docker health checks -// that exist in the container image (such as those specified in a parent image -// or from the image's Dockerfile). This configuration maps to the HEALTHCHECK -// parameter of docker run (https://docs.docker.com/engine/reference/run/). -// -// The Amazon ECS container agent only monitors and reports on the health checks -// specified in the task definition. Amazon ECS does not monitor Docker health -// checks that are embedded in a container image and not specified in the container -// definition. Health check parameters that are specified in a container definition -// override any Docker health checks that exist in the container image. -// -// You can view the health status of both individual containers and a task with -// the DescribeTasks API operation or when viewing the task details in the console. -// -// The health check is designed to make sure that your containers survive agent -// restarts, upgrades, or temporary unavailability. -// -// The following describes the possible healthStatus values for a container: -// -// - HEALTHY-The container health check has passed successfully. -// -// - UNHEALTHY-The container health check has failed. -// -// - UNKNOWN-The container health check is being evaluated or there's no -// container health check defined. -// -// The following describes the possible healthStatus values for a task. The -// container health check status of non-essential containers don't have an effect -// on the health status of a task. -// -// - HEALTHY-All essential containers within the task have passed their health -// checks. -// -// - UNHEALTHY-One or more essential containers have failed their health -// check. -// -// - UNKNOWN-The essential containers within the task are still having their -// health checks evaluated, there are only nonessential containers with health -// checks defined, or there are no container health checks defined. -// -// If a task is run manually, and not as part of a service, the task will continue -// its lifecycle regardless of its health status. For tasks that are part of -// a service, if the task reports as unhealthy then the task will be stopped -// and the service scheduler will replace it. -// -// The following are notes about container health check support: -// -// - When the Amazon ECS agent cannot connect to the Amazon ECS service, -// the service reports the container as UNHEALTHY. -// -// - The health check statuses are the "last heard from" response from the -// Amazon ECS agent. There are no assumptions made about the status of the -// container health checks. -// -// - Container health checks require version 1.17.0 or greater of the Amazon -// ECS container agent. For more information, see Updating the Amazon ECS -// container agent (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html). -// -// - Container health checks are supported for Fargate tasks if you're using -// platform version 1.1.0 or greater. For more information, see Fargate platform -// versions (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html). -// -// - Container health checks aren't supported for tasks that are part of -// a service that's configured to use a Classic Load Balancer. -type HealthCheck struct { - _ struct{} `type:"structure"` - - // A string array representing the command that the container runs to determine - // if it is healthy. The string array must start with CMD to run the command - // arguments directly, or CMD-SHELL to run the command with the container's - // default shell. - // - // When you use the Amazon Web Services Management Console JSON panel, the Command - // Line Interface, or the APIs, enclose the list of commands in double quotes - // and brackets. - // - // [ "CMD-SHELL", "curl -f http://localhost/ || exit 1" ] - // - // You don't include the double quotes and brackets when you use the Amazon - // Web Services Management Console. - // - // CMD-SHELL, curl -f http://localhost/ || exit 1 - // - // An exit code of 0 indicates success, and non-zero exit code indicates failure. - // For more information, see HealthCheck in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/). - // - // Command is a required field - Command []*string `locationName:"command" type:"list" required:"true"` - - // The time period in seconds between each health check execution. You may specify - // between 5 and 300 seconds. The default value is 30 seconds. - Interval *int64 `locationName:"interval" type:"integer"` - - // The number of times to retry a failed health check before the container is - // considered unhealthy. You may specify between 1 and 10 retries. The default - // value is 3. - Retries *int64 `locationName:"retries" type:"integer"` - - // The optional grace period to provide containers time to bootstrap before - // failed health checks count towards the maximum number of retries. You can - // specify between 0 and 300 seconds. By default, the startPeriod is off. - // - // If a health check succeeds within the startPeriod, then the container is - // considered healthy and any subsequent failures count toward the maximum number - // of retries. - StartPeriod *int64 `locationName:"startPeriod" type:"integer"` - - // The time period in seconds to wait for a health check to succeed before it - // is considered a failure. You may specify between 2 and 60 seconds. The default - // value is 5. - Timeout *int64 `locationName:"timeout" type:"integer"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s HealthCheck) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s HealthCheck) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *HealthCheck) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "HealthCheck"} - if s.Command == nil { - invalidParams.Add(request.NewErrParamRequired("Command")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCommand sets the Command field's value. -func (s *HealthCheck) SetCommand(v []*string) *HealthCheck { - s.Command = v - return s -} - -// SetInterval sets the Interval field's value. -func (s *HealthCheck) SetInterval(v int64) *HealthCheck { - s.Interval = &v - return s -} - -// SetRetries sets the Retries field's value. -func (s *HealthCheck) SetRetries(v int64) *HealthCheck { - s.Retries = &v - return s -} - -// SetStartPeriod sets the StartPeriod field's value. -func (s *HealthCheck) SetStartPeriod(v int64) *HealthCheck { - s.StartPeriod = &v - return s -} - -// SetTimeout sets the Timeout field's value. -func (s *HealthCheck) SetTimeout(v int64) *HealthCheck { - s.Timeout = &v - return s -} - -// Hostnames and IP address entries that are added to the /etc/hosts file of -// a container via the extraHosts parameter of its ContainerDefinition. -type HostEntry struct { - _ struct{} `type:"structure"` - - // The hostname to use in the /etc/hosts entry. - // - // Hostname is a required field - Hostname *string `locationName:"hostname" type:"string" required:"true"` - - // The IP address to use in the /etc/hosts entry. - // - // IpAddress is a required field - IpAddress *string `locationName:"ipAddress" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s HostEntry) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s HostEntry) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *HostEntry) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "HostEntry"} - if s.Hostname == nil { - invalidParams.Add(request.NewErrParamRequired("Hostname")) - } - if s.IpAddress == nil { - invalidParams.Add(request.NewErrParamRequired("IpAddress")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetHostname sets the Hostname field's value. -func (s *HostEntry) SetHostname(v string) *HostEntry { - s.Hostname = &v - return s -} - -// SetIpAddress sets the IpAddress field's value. -func (s *HostEntry) SetIpAddress(v string) *HostEntry { - s.IpAddress = &v - return s -} - -// Details on a container instance bind mount host volume. -type HostVolumeProperties struct { - _ struct{} `type:"structure"` - - // When the host parameter is used, specify a sourcePath to declare the path - // on the host container instance that's presented to the container. If this - // parameter is empty, then the Docker daemon has assigned a host path for you. - // If the host parameter contains a sourcePath file location, then the data - // volume persists at the specified location on the host container instance - // until you delete it manually. If the sourcePath value doesn't exist on the - // host container instance, the Docker daemon creates it. If the location does - // exist, the contents of the source path folder are exported. - // - // If you're using the Fargate launch type, the sourcePath parameter is not - // supported. - SourcePath *string `locationName:"sourcePath" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s HostVolumeProperties) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s HostVolumeProperties) GoString() string { - return s.String() -} - -// SetSourcePath sets the SourcePath field's value. -func (s *HostVolumeProperties) SetSourcePath(v string) *HostVolumeProperties { - s.SourcePath = &v - return s -} - -// Details on an Elastic Inference accelerator. For more information, see Working -// with Amazon Elastic Inference on Amazon ECS (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-inference.html) -// in the Amazon Elastic Container Service Developer Guide. -type InferenceAccelerator struct { - _ struct{} `type:"structure"` - - // The Elastic Inference accelerator device name. The deviceName must also be - // referenced in a container definition as a ResourceRequirement (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ResourceRequirement.html). - // - // DeviceName is a required field - DeviceName *string `locationName:"deviceName" type:"string" required:"true"` - - // The Elastic Inference accelerator type to use. - // - // DeviceType is a required field - DeviceType *string `locationName:"deviceType" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s InferenceAccelerator) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s InferenceAccelerator) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *InferenceAccelerator) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "InferenceAccelerator"} - if s.DeviceName == nil { - invalidParams.Add(request.NewErrParamRequired("DeviceName")) - } - if s.DeviceType == nil { - invalidParams.Add(request.NewErrParamRequired("DeviceType")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetDeviceName sets the DeviceName field's value. -func (s *InferenceAccelerator) SetDeviceName(v string) *InferenceAccelerator { - s.DeviceName = &v - return s -} - -// SetDeviceType sets the DeviceType field's value. -func (s *InferenceAccelerator) SetDeviceType(v string) *InferenceAccelerator { - s.DeviceType = &v - return s -} - -// Details on an Elastic Inference accelerator task override. This parameter -// is used to override the Elastic Inference accelerator specified in the task -// definition. For more information, see Working with Amazon Elastic Inference -// on Amazon ECS (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-inference.html) -// in the Amazon Elastic Container Service Developer Guide. -type InferenceAcceleratorOverride struct { - _ struct{} `type:"structure"` - - // The Elastic Inference accelerator device name to override for the task. This - // parameter must match a deviceName specified in the task definition. - DeviceName *string `locationName:"deviceName" type:"string"` - - // The Elastic Inference accelerator type to use. - DeviceType *string `locationName:"deviceType" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s InferenceAcceleratorOverride) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s InferenceAcceleratorOverride) GoString() string { - return s.String() -} - -// SetDeviceName sets the DeviceName field's value. -func (s *InferenceAcceleratorOverride) SetDeviceName(v string) *InferenceAcceleratorOverride { - s.DeviceName = &v - return s -} - -// SetDeviceType sets the DeviceType field's value. -func (s *InferenceAcceleratorOverride) SetDeviceType(v string) *InferenceAcceleratorOverride { - s.DeviceType = &v - return s -} - -// The specified parameter isn't valid. Review the available parameters for -// the API request. -type InvalidParameterException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s InvalidParameterException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s InvalidParameterException) GoString() string { - return s.String() -} - -func newErrorInvalidParameterException(v protocol.ResponseMetadata) error { - return &InvalidParameterException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *InvalidParameterException) Code() string { - return "InvalidParameterException" -} - -// Message returns the exception's message. -func (s *InvalidParameterException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *InvalidParameterException) OrigErr() error { - return nil -} - -func (s *InvalidParameterException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *InvalidParameterException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *InvalidParameterException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The Linux capabilities for the container that are added to or dropped from -// the default configuration provided by Docker. For more information about -// the default capabilities and the non-default available capabilities, see -// Runtime privilege and Linux capabilities (https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities) -// in the Docker run reference. For more detailed information about these Linux -// capabilities, see the capabilities(7) (http://man7.org/linux/man-pages/man7/capabilities.7.html) -// Linux manual page. -type KernelCapabilities struct { - _ struct{} `type:"structure"` - - // The Linux capabilities for the container that have been added to the default - // configuration provided by Docker. This parameter maps to CapAdd in the Create - // a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --cap-add option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // Tasks launched on Fargate only support adding the SYS_PTRACE kernel capability. - // - // Valid values: "ALL" | "AUDIT_CONTROL" | "AUDIT_WRITE" | "BLOCK_SUSPEND" | - // "CHOWN" | "DAC_OVERRIDE" | "DAC_READ_SEARCH" | "FOWNER" | "FSETID" | "IPC_LOCK" - // | "IPC_OWNER" | "KILL" | "LEASE" | "LINUX_IMMUTABLE" | "MAC_ADMIN" | "MAC_OVERRIDE" - // | "MKNOD" | "NET_ADMIN" | "NET_BIND_SERVICE" | "NET_BROADCAST" | "NET_RAW" - // | "SETFCAP" | "SETGID" | "SETPCAP" | "SETUID" | "SYS_ADMIN" | "SYS_BOOT" - // | "SYS_CHROOT" | "SYS_MODULE" | "SYS_NICE" | "SYS_PACCT" | "SYS_PTRACE" | - // "SYS_RAWIO" | "SYS_RESOURCE" | "SYS_TIME" | "SYS_TTY_CONFIG" | "SYSLOG" | - // "WAKE_ALARM" - Add []*string `locationName:"add" type:"list"` - - // The Linux capabilities for the container that have been removed from the - // default configuration provided by Docker. This parameter maps to CapDrop - // in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --cap-drop option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // Valid values: "ALL" | "AUDIT_CONTROL" | "AUDIT_WRITE" | "BLOCK_SUSPEND" | - // "CHOWN" | "DAC_OVERRIDE" | "DAC_READ_SEARCH" | "FOWNER" | "FSETID" | "IPC_LOCK" - // | "IPC_OWNER" | "KILL" | "LEASE" | "LINUX_IMMUTABLE" | "MAC_ADMIN" | "MAC_OVERRIDE" - // | "MKNOD" | "NET_ADMIN" | "NET_BIND_SERVICE" | "NET_BROADCAST" | "NET_RAW" - // | "SETFCAP" | "SETGID" | "SETPCAP" | "SETUID" | "SYS_ADMIN" | "SYS_BOOT" - // | "SYS_CHROOT" | "SYS_MODULE" | "SYS_NICE" | "SYS_PACCT" | "SYS_PTRACE" | - // "SYS_RAWIO" | "SYS_RESOURCE" | "SYS_TIME" | "SYS_TTY_CONFIG" | "SYSLOG" | - // "WAKE_ALARM" - Drop []*string `locationName:"drop" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s KernelCapabilities) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s KernelCapabilities) GoString() string { - return s.String() -} - -// SetAdd sets the Add field's value. -func (s *KernelCapabilities) SetAdd(v []*string) *KernelCapabilities { - s.Add = v - return s -} - -// SetDrop sets the Drop field's value. -func (s *KernelCapabilities) SetDrop(v []*string) *KernelCapabilities { - s.Drop = v - return s -} - -// A key-value pair object. -type KeyValuePair struct { - _ struct{} `type:"structure"` - - // The name of the key-value pair. For environment variables, this is the name - // of the environment variable. - Name *string `locationName:"name" type:"string"` - - // The value of the key-value pair. For environment variables, this is the value - // of the environment variable. - Value *string `locationName:"value" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s KeyValuePair) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s KeyValuePair) GoString() string { - return s.String() -} - -// SetName sets the Name field's value. -func (s *KeyValuePair) SetName(v string) *KeyValuePair { - s.Name = &v - return s -} - -// SetValue sets the Value field's value. -func (s *KeyValuePair) SetValue(v string) *KeyValuePair { - s.Value = &v - return s -} - -// The limit for the resource was exceeded. -type LimitExceededException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s LimitExceededException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s LimitExceededException) GoString() string { - return s.String() -} - -func newErrorLimitExceededException(v protocol.ResponseMetadata) error { - return &LimitExceededException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *LimitExceededException) Code() string { - return "LimitExceededException" -} - -// Message returns the exception's message. -func (s *LimitExceededException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *LimitExceededException) OrigErr() error { - return nil -} - -func (s *LimitExceededException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *LimitExceededException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *LimitExceededException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The Linux-specific options that are applied to the container, such as Linux -// KernelCapabilities (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_KernelCapabilities.html). -type LinuxParameters struct { - _ struct{} `type:"structure"` - - // The Linux capabilities for the container that are added to or dropped from - // the default configuration provided by Docker. - // - // For tasks that use the Fargate launch type, capabilities is supported for - // all platform versions but the add parameter is only supported if using platform - // version 1.4.0 or later. - Capabilities *KernelCapabilities `locationName:"capabilities" type:"structure"` - - // Any host devices to expose to the container. This parameter maps to Devices - // in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --device option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // If you're using tasks that use the Fargate launch type, the devices parameter - // isn't supported. - Devices []*Device `locationName:"devices" type:"list"` - - // Run an init process inside the container that forwards signals and reaps - // processes. This parameter maps to the --init option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // This parameter requires version 1.25 of the Docker Remote API or greater - // on your container instance. To check the Docker Remote API version on your - // container instance, log in to your container instance and run the following - // command: sudo docker version --format '{{.Server.APIVersion}}' - InitProcessEnabled *bool `locationName:"initProcessEnabled" type:"boolean"` - - // The total amount of swap memory (in MiB) a container can use. This parameter - // will be translated to the --memory-swap option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration) - // where the value would be the sum of the container memory plus the maxSwap - // value. - // - // If a maxSwap value of 0 is specified, the container will not use swap. Accepted - // values are 0 or any positive integer. If the maxSwap parameter is omitted, - // the container will use the swap configuration for the container instance - // it is running on. A maxSwap value must be set for the swappiness parameter - // to be used. - // - // If you're using tasks that use the Fargate launch type, the maxSwap parameter - // isn't supported. - // - // If you're using tasks on Amazon Linux 2023 the swappiness parameter isn't - // supported. - MaxSwap *int64 `locationName:"maxSwap" type:"integer"` - - // The value for the size (in MiB) of the /dev/shm volume. This parameter maps - // to the --shm-size option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // If you are using tasks that use the Fargate launch type, the sharedMemorySize - // parameter is not supported. - SharedMemorySize *int64 `locationName:"sharedMemorySize" type:"integer"` - - // This allows you to tune a container's memory swappiness behavior. A swappiness - // value of 0 will cause swapping to not happen unless absolutely necessary. - // A swappiness value of 100 will cause pages to be swapped very aggressively. - // Accepted values are whole numbers between 0 and 100. If the swappiness parameter - // is not specified, a default value of 60 is used. If a value is not specified - // for maxSwap then this parameter is ignored. This parameter maps to the --memory-swappiness - // option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // If you're using tasks that use the Fargate launch type, the swappiness parameter - // isn't supported. - // - // If you're using tasks on Amazon Linux 2023 the swappiness parameter isn't - // supported. - Swappiness *int64 `locationName:"swappiness" type:"integer"` - - // The container path, mount options, and size (in MiB) of the tmpfs mount. - // This parameter maps to the --tmpfs option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). - // - // If you're using tasks that use the Fargate launch type, the tmpfs parameter - // isn't supported. - Tmpfs []*Tmpfs `locationName:"tmpfs" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s LinuxParameters) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s LinuxParameters) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *LinuxParameters) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "LinuxParameters"} - if s.Devices != nil { - for i, v := range s.Devices { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Devices", i), err.(request.ErrInvalidParams)) - } - } - } - if s.Tmpfs != nil { - for i, v := range s.Tmpfs { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tmpfs", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCapabilities sets the Capabilities field's value. -func (s *LinuxParameters) SetCapabilities(v *KernelCapabilities) *LinuxParameters { - s.Capabilities = v - return s -} - -// SetDevices sets the Devices field's value. -func (s *LinuxParameters) SetDevices(v []*Device) *LinuxParameters { - s.Devices = v - return s -} - -// SetInitProcessEnabled sets the InitProcessEnabled field's value. -func (s *LinuxParameters) SetInitProcessEnabled(v bool) *LinuxParameters { - s.InitProcessEnabled = &v - return s -} - -// SetMaxSwap sets the MaxSwap field's value. -func (s *LinuxParameters) SetMaxSwap(v int64) *LinuxParameters { - s.MaxSwap = &v - return s -} - -// SetSharedMemorySize sets the SharedMemorySize field's value. -func (s *LinuxParameters) SetSharedMemorySize(v int64) *LinuxParameters { - s.SharedMemorySize = &v - return s -} - -// SetSwappiness sets the Swappiness field's value. -func (s *LinuxParameters) SetSwappiness(v int64) *LinuxParameters { - s.Swappiness = &v - return s -} - -// SetTmpfs sets the Tmpfs field's value. -func (s *LinuxParameters) SetTmpfs(v []*Tmpfs) *LinuxParameters { - s.Tmpfs = v - return s -} - -type ListAccountSettingsInput struct { - _ struct{} `type:"structure"` - - // Determines whether to return the effective settings. If true, the account - // settings for the root user or the default setting for the principalArn are - // returned. If false, the account settings for the principalArn are returned - // if they're set. Otherwise, no account settings are returned. - EffectiveSettings *bool `locationName:"effectiveSettings" type:"boolean"` - - // The maximum number of account setting results returned by ListAccountSettings - // in paginated output. When this parameter is used, ListAccountSettings only - // returns maxResults results in a single page along with a nextToken response - // element. The remaining results of the initial request can be seen by sending - // another ListAccountSettings request with the returned nextToken value. This - // value can be between 1 and 10. If this parameter isn't used, then ListAccountSettings - // returns up to 10 results and a nextToken value if applicable. - MaxResults *int64 `locationName:"maxResults" type:"integer"` - - // The name of the account setting you want to list the settings for. - Name *string `locationName:"name" type:"string" enum:"SettingName"` - - // The nextToken value returned from a ListAccountSettings request indicating - // that more results are available to fulfill the request and further calls - // will be needed. If maxResults was provided, it's possible the number of results - // to be fewer than maxResults. - // - // This token should be treated as an opaque identifier that is only used to - // retrieve the next items in a list and not for other programmatic purposes. - NextToken *string `locationName:"nextToken" type:"string"` - - // The ARN of the principal, which can be a user, role, or the root user. If - // this field is omitted, the account settings are listed only for the authenticated - // user. - // - // Federated users assume the account setting of the root user and can't have - // explicit account settings set for them. - PrincipalArn *string `locationName:"principalArn" type:"string"` - - // The value of the account settings to filter results with. You must also specify - // an account setting name to use this parameter. - Value *string `locationName:"value" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListAccountSettingsInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListAccountSettingsInput) GoString() string { - return s.String() -} - -// SetEffectiveSettings sets the EffectiveSettings field's value. -func (s *ListAccountSettingsInput) SetEffectiveSettings(v bool) *ListAccountSettingsInput { - s.EffectiveSettings = &v - return s -} - -// SetMaxResults sets the MaxResults field's value. -func (s *ListAccountSettingsInput) SetMaxResults(v int64) *ListAccountSettingsInput { - s.MaxResults = &v - return s -} - -// SetName sets the Name field's value. -func (s *ListAccountSettingsInput) SetName(v string) *ListAccountSettingsInput { - s.Name = &v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListAccountSettingsInput) SetNextToken(v string) *ListAccountSettingsInput { - s.NextToken = &v - return s -} - -// SetPrincipalArn sets the PrincipalArn field's value. -func (s *ListAccountSettingsInput) SetPrincipalArn(v string) *ListAccountSettingsInput { - s.PrincipalArn = &v - return s -} - -// SetValue sets the Value field's value. -func (s *ListAccountSettingsInput) SetValue(v string) *ListAccountSettingsInput { - s.Value = &v - return s -} - -type ListAccountSettingsOutput struct { - _ struct{} `type:"structure"` - - // The nextToken value to include in a future ListAccountSettings request. When - // the results of a ListAccountSettings request exceed maxResults, this value - // can be used to retrieve the next page of results. This value is null when - // there are no more results to return. - NextToken *string `locationName:"nextToken" type:"string"` - - // The account settings for the resource. - Settings []*Setting `locationName:"settings" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListAccountSettingsOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListAccountSettingsOutput) GoString() string { - return s.String() -} - -// SetNextToken sets the NextToken field's value. -func (s *ListAccountSettingsOutput) SetNextToken(v string) *ListAccountSettingsOutput { - s.NextToken = &v - return s -} - -// SetSettings sets the Settings field's value. -func (s *ListAccountSettingsOutput) SetSettings(v []*Setting) *ListAccountSettingsOutput { - s.Settings = v - return s -} - -type ListAttributesInput struct { - _ struct{} `type:"structure"` - - // The name of the attribute to filter the results with. - AttributeName *string `locationName:"attributeName" type:"string"` - - // The value of the attribute to filter results with. You must also specify - // an attribute name to use this parameter. - AttributeValue *string `locationName:"attributeValue" type:"string"` - - // The short name or full Amazon Resource Name (ARN) of the cluster to list - // attributes. If you do not specify a cluster, the default cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // The maximum number of cluster results that ListAttributes returned in paginated - // output. When this parameter is used, ListAttributes only returns maxResults - // results in a single page along with a nextToken response element. The remaining - // results of the initial request can be seen by sending another ListAttributes - // request with the returned nextToken value. This value can be between 1 and - // 100. If this parameter isn't used, then ListAttributes returns up to 100 - // results and a nextToken value if applicable. - MaxResults *int64 `locationName:"maxResults" type:"integer"` - - // The nextToken value returned from a ListAttributes request indicating that - // more results are available to fulfill the request and further calls are needed. - // If maxResults was provided, it's possible the number of results to be fewer - // than maxResults. - // - // This token should be treated as an opaque identifier that is only used to - // retrieve the next items in a list and not for other programmatic purposes. - NextToken *string `locationName:"nextToken" type:"string"` - - // The type of the target to list attributes with. - // - // TargetType is a required field - TargetType *string `locationName:"targetType" type:"string" required:"true" enum:"TargetType"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListAttributesInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListAttributesInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ListAttributesInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ListAttributesInput"} - if s.TargetType == nil { - invalidParams.Add(request.NewErrParamRequired("TargetType")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAttributeName sets the AttributeName field's value. -func (s *ListAttributesInput) SetAttributeName(v string) *ListAttributesInput { - s.AttributeName = &v - return s -} - -// SetAttributeValue sets the AttributeValue field's value. -func (s *ListAttributesInput) SetAttributeValue(v string) *ListAttributesInput { - s.AttributeValue = &v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *ListAttributesInput) SetCluster(v string) *ListAttributesInput { - s.Cluster = &v - return s -} - -// SetMaxResults sets the MaxResults field's value. -func (s *ListAttributesInput) SetMaxResults(v int64) *ListAttributesInput { - s.MaxResults = &v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListAttributesInput) SetNextToken(v string) *ListAttributesInput { - s.NextToken = &v - return s -} - -// SetTargetType sets the TargetType field's value. -func (s *ListAttributesInput) SetTargetType(v string) *ListAttributesInput { - s.TargetType = &v - return s -} - -type ListAttributesOutput struct { - _ struct{} `type:"structure"` - - // A list of attribute objects that meet the criteria of the request. - Attributes []*Attribute `locationName:"attributes" type:"list"` - - // The nextToken value to include in a future ListAttributes request. When the - // results of a ListAttributes request exceed maxResults, this value can be - // used to retrieve the next page of results. This value is null when there - // are no more results to return. - NextToken *string `locationName:"nextToken" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListAttributesOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListAttributesOutput) GoString() string { - return s.String() -} - -// SetAttributes sets the Attributes field's value. -func (s *ListAttributesOutput) SetAttributes(v []*Attribute) *ListAttributesOutput { - s.Attributes = v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListAttributesOutput) SetNextToken(v string) *ListAttributesOutput { - s.NextToken = &v - return s -} - -type ListClustersInput struct { - _ struct{} `type:"structure"` - - // The maximum number of cluster results that ListClusters returned in paginated - // output. When this parameter is used, ListClusters only returns maxResults - // results in a single page along with a nextToken response element. The remaining - // results of the initial request can be seen by sending another ListClusters - // request with the returned nextToken value. This value can be between 1 and - // 100. If this parameter isn't used, then ListClusters returns up to 100 results - // and a nextToken value if applicable. - MaxResults *int64 `locationName:"maxResults" type:"integer"` - - // The nextToken value returned from a ListClusters request indicating that - // more results are available to fulfill the request and further calls are needed. - // If maxResults was provided, it's possible the number of results to be fewer - // than maxResults. - // - // This token should be treated as an opaque identifier that is only used to - // retrieve the next items in a list and not for other programmatic purposes. - NextToken *string `locationName:"nextToken" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListClustersInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListClustersInput) GoString() string { - return s.String() -} - -// SetMaxResults sets the MaxResults field's value. -func (s *ListClustersInput) SetMaxResults(v int64) *ListClustersInput { - s.MaxResults = &v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListClustersInput) SetNextToken(v string) *ListClustersInput { - s.NextToken = &v - return s -} - -type ListClustersOutput struct { - _ struct{} `type:"structure"` - - // The list of full Amazon Resource Name (ARN) entries for each cluster that's - // associated with your account. - ClusterArns []*string `locationName:"clusterArns" type:"list"` - - // The nextToken value to include in a future ListClusters request. When the - // results of a ListClusters request exceed maxResults, this value can be used - // to retrieve the next page of results. This value is null when there are no - // more results to return. - NextToken *string `locationName:"nextToken" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListClustersOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListClustersOutput) GoString() string { - return s.String() -} - -// SetClusterArns sets the ClusterArns field's value. -func (s *ListClustersOutput) SetClusterArns(v []*string) *ListClustersOutput { - s.ClusterArns = v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListClustersOutput) SetNextToken(v string) *ListClustersOutput { - s.NextToken = &v - return s -} - -type ListContainerInstancesInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the container instances to list. If you do not specify a cluster, the default - // cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // You can filter the results of a ListContainerInstances operation with cluster - // query language statements. For more information, see Cluster Query Language - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-query-language.html) - // in the Amazon Elastic Container Service Developer Guide. - Filter *string `locationName:"filter" type:"string"` - - // The maximum number of container instance results that ListContainerInstances - // returned in paginated output. When this parameter is used, ListContainerInstances - // only returns maxResults results in a single page along with a nextToken response - // element. The remaining results of the initial request can be seen by sending - // another ListContainerInstances request with the returned nextToken value. - // This value can be between 1 and 100. If this parameter isn't used, then ListContainerInstances - // returns up to 100 results and a nextToken value if applicable. - MaxResults *int64 `locationName:"maxResults" type:"integer"` - - // The nextToken value returned from a ListContainerInstances request indicating - // that more results are available to fulfill the request and further calls - // are needed. If maxResults was provided, it's possible the number of results - // to be fewer than maxResults. - // - // This token should be treated as an opaque identifier that is only used to - // retrieve the next items in a list and not for other programmatic purposes. - NextToken *string `locationName:"nextToken" type:"string"` - - // Filters the container instances by status. For example, if you specify the - // DRAINING status, the results include only container instances that have been - // set to DRAINING using UpdateContainerInstancesState. If you don't specify - // this parameter, the default is to include container instances set to all - // states other than INACTIVE. - Status *string `locationName:"status" type:"string" enum:"ContainerInstanceStatus"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListContainerInstancesInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListContainerInstancesInput) GoString() string { - return s.String() -} - -// SetCluster sets the Cluster field's value. -func (s *ListContainerInstancesInput) SetCluster(v string) *ListContainerInstancesInput { - s.Cluster = &v - return s -} - -// SetFilter sets the Filter field's value. -func (s *ListContainerInstancesInput) SetFilter(v string) *ListContainerInstancesInput { - s.Filter = &v - return s -} - -// SetMaxResults sets the MaxResults field's value. -func (s *ListContainerInstancesInput) SetMaxResults(v int64) *ListContainerInstancesInput { - s.MaxResults = &v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListContainerInstancesInput) SetNextToken(v string) *ListContainerInstancesInput { - s.NextToken = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *ListContainerInstancesInput) SetStatus(v string) *ListContainerInstancesInput { - s.Status = &v - return s -} - -type ListContainerInstancesOutput struct { - _ struct{} `type:"structure"` - - // The list of container instances with full ARN entries for each container - // instance associated with the specified cluster. - ContainerInstanceArns []*string `locationName:"containerInstanceArns" type:"list"` - - // The nextToken value to include in a future ListContainerInstances request. - // When the results of a ListContainerInstances request exceed maxResults, this - // value can be used to retrieve the next page of results. This value is null - // when there are no more results to return. - NextToken *string `locationName:"nextToken" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListContainerInstancesOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListContainerInstancesOutput) GoString() string { - return s.String() -} - -// SetContainerInstanceArns sets the ContainerInstanceArns field's value. -func (s *ListContainerInstancesOutput) SetContainerInstanceArns(v []*string) *ListContainerInstancesOutput { - s.ContainerInstanceArns = v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListContainerInstancesOutput) SetNextToken(v string) *ListContainerInstancesOutput { - s.NextToken = &v - return s -} - -type ListServicesByNamespaceInput struct { - _ struct{} `type:"structure"` - - // The maximum number of service results that ListServicesByNamespace returns - // in paginated output. When this parameter is used, ListServicesByNamespace - // only returns maxResults results in a single page along with a nextToken response - // element. The remaining results of the initial request can be seen by sending - // another ListServicesByNamespace request with the returned nextToken value. - // This value can be between 1 and 100. If this parameter isn't used, then ListServicesByNamespace - // returns up to 10 results and a nextToken value if applicable. - MaxResults *int64 `locationName:"maxResults" type:"integer"` - - // The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace - // to list the services in. - // - // Tasks that run in a namespace can use short names to connect to services - // in the namespace. Tasks can connect to services across all of the clusters - // in the namespace. Tasks connect through a managed proxy container that collects - // logs and metrics for increased visibility. Only the tasks that Amazon ECS - // services create are supported with Service Connect. For more information, - // see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // Namespace is a required field - Namespace *string `locationName:"namespace" type:"string" required:"true"` - - // The nextToken value that's returned from a ListServicesByNamespace request. - // It indicates that more results are available to fulfill the request and further - // calls are needed. If maxResults is returned, it is possible the number of - // results is less than maxResults. - NextToken *string `locationName:"nextToken" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListServicesByNamespaceInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListServicesByNamespaceInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ListServicesByNamespaceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ListServicesByNamespaceInput"} - if s.Namespace == nil { - invalidParams.Add(request.NewErrParamRequired("Namespace")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetMaxResults sets the MaxResults field's value. -func (s *ListServicesByNamespaceInput) SetMaxResults(v int64) *ListServicesByNamespaceInput { - s.MaxResults = &v - return s -} - -// SetNamespace sets the Namespace field's value. -func (s *ListServicesByNamespaceInput) SetNamespace(v string) *ListServicesByNamespaceInput { - s.Namespace = &v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListServicesByNamespaceInput) SetNextToken(v string) *ListServicesByNamespaceInput { - s.NextToken = &v - return s -} - -type ListServicesByNamespaceOutput struct { - _ struct{} `type:"structure"` - - // The nextToken value to include in a future ListServicesByNamespace request. - // When the results of a ListServicesByNamespace request exceed maxResults, - // this value can be used to retrieve the next page of results. When there are - // no more results to return, this value is null. - NextToken *string `locationName:"nextToken" type:"string"` - - // The list of full ARN entries for each service that's associated with the - // specified namespace. - ServiceArns []*string `locationName:"serviceArns" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListServicesByNamespaceOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListServicesByNamespaceOutput) GoString() string { - return s.String() -} - -// SetNextToken sets the NextToken field's value. -func (s *ListServicesByNamespaceOutput) SetNextToken(v string) *ListServicesByNamespaceOutput { - s.NextToken = &v - return s -} - -// SetServiceArns sets the ServiceArns field's value. -func (s *ListServicesByNamespaceOutput) SetServiceArns(v []*string) *ListServicesByNamespaceOutput { - s.ServiceArns = v - return s -} - -type ListServicesInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster to use when - // filtering the ListServices results. If you do not specify a cluster, the - // default cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // The launch type to use when filtering the ListServices results. - LaunchType *string `locationName:"launchType" type:"string" enum:"LaunchType"` - - // The maximum number of service results that ListServices returned in paginated - // output. When this parameter is used, ListServices only returns maxResults - // results in a single page along with a nextToken response element. The remaining - // results of the initial request can be seen by sending another ListServices - // request with the returned nextToken value. This value can be between 1 and - // 100. If this parameter isn't used, then ListServices returns up to 10 results - // and a nextToken value if applicable. - MaxResults *int64 `locationName:"maxResults" type:"integer"` - - // The nextToken value returned from a ListServices request indicating that - // more results are available to fulfill the request and further calls will - // be needed. If maxResults was provided, it is possible the number of results - // to be fewer than maxResults. - // - // This token should be treated as an opaque identifier that is only used to - // retrieve the next items in a list and not for other programmatic purposes. - NextToken *string `locationName:"nextToken" type:"string"` - - // The scheduling strategy to use when filtering the ListServices results. - SchedulingStrategy *string `locationName:"schedulingStrategy" type:"string" enum:"SchedulingStrategy"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListServicesInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListServicesInput) GoString() string { - return s.String() -} - -// SetCluster sets the Cluster field's value. -func (s *ListServicesInput) SetCluster(v string) *ListServicesInput { - s.Cluster = &v - return s -} - -// SetLaunchType sets the LaunchType field's value. -func (s *ListServicesInput) SetLaunchType(v string) *ListServicesInput { - s.LaunchType = &v - return s -} - -// SetMaxResults sets the MaxResults field's value. -func (s *ListServicesInput) SetMaxResults(v int64) *ListServicesInput { - s.MaxResults = &v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListServicesInput) SetNextToken(v string) *ListServicesInput { - s.NextToken = &v - return s -} - -// SetSchedulingStrategy sets the SchedulingStrategy field's value. -func (s *ListServicesInput) SetSchedulingStrategy(v string) *ListServicesInput { - s.SchedulingStrategy = &v - return s -} - -type ListServicesOutput struct { - _ struct{} `type:"structure"` - - // The nextToken value to include in a future ListServices request. When the - // results of a ListServices request exceed maxResults, this value can be used - // to retrieve the next page of results. This value is null when there are no - // more results to return. - NextToken *string `locationName:"nextToken" type:"string"` - - // The list of full ARN entries for each service that's associated with the - // specified cluster. - ServiceArns []*string `locationName:"serviceArns" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListServicesOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListServicesOutput) GoString() string { - return s.String() -} - -// SetNextToken sets the NextToken field's value. -func (s *ListServicesOutput) SetNextToken(v string) *ListServicesOutput { - s.NextToken = &v - return s -} - -// SetServiceArns sets the ServiceArns field's value. -func (s *ListServicesOutput) SetServiceArns(v []*string) *ListServicesOutput { - s.ServiceArns = v - return s -} - -type ListTagsForResourceInput struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) that identifies the resource to list the tags - // for. Currently, the supported resources are Amazon ECS tasks, services, task - // definitions, clusters, and container instances. - // - // ResourceArn is a required field - ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTagsForResourceInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTagsForResourceInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ListTagsForResourceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ListTagsForResourceInput"} - if s.ResourceArn == nil { - invalidParams.Add(request.NewErrParamRequired("ResourceArn")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetResourceArn sets the ResourceArn field's value. -func (s *ListTagsForResourceInput) SetResourceArn(v string) *ListTagsForResourceInput { - s.ResourceArn = &v - return s -} - -type ListTagsForResourceOutput struct { - _ struct{} `type:"structure"` - - // The tags for the resource. - Tags []*Tag `locationName:"tags" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTagsForResourceOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTagsForResourceOutput) GoString() string { - return s.String() -} - -// SetTags sets the Tags field's value. -func (s *ListTagsForResourceOutput) SetTags(v []*Tag) *ListTagsForResourceOutput { - s.Tags = v - return s -} - -type ListTaskDefinitionFamiliesInput struct { - _ struct{} `type:"structure"` - - // The familyPrefix is a string that's used to filter the results of ListTaskDefinitionFamilies. - // If you specify a familyPrefix, only task definition family names that begin - // with the familyPrefix string are returned. - FamilyPrefix *string `locationName:"familyPrefix" type:"string"` - - // The maximum number of task definition family results that ListTaskDefinitionFamilies - // returned in paginated output. When this parameter is used, ListTaskDefinitions - // only returns maxResults results in a single page along with a nextToken response - // element. The remaining results of the initial request can be seen by sending - // another ListTaskDefinitionFamilies request with the returned nextToken value. - // This value can be between 1 and 100. If this parameter isn't used, then ListTaskDefinitionFamilies - // returns up to 100 results and a nextToken value if applicable. - MaxResults *int64 `locationName:"maxResults" type:"integer"` - - // The nextToken value returned from a ListTaskDefinitionFamilies request indicating - // that more results are available to fulfill the request and further calls - // will be needed. If maxResults was provided, it is possible the number of - // results to be fewer than maxResults. - // - // This token should be treated as an opaque identifier that is only used to - // retrieve the next items in a list and not for other programmatic purposes. - NextToken *string `locationName:"nextToken" type:"string"` - - // The task definition family status to filter the ListTaskDefinitionFamilies - // results with. By default, both ACTIVE and INACTIVE task definition families - // are listed. If this parameter is set to ACTIVE, only task definition families - // that have an ACTIVE task definition revision are returned. If this parameter - // is set to INACTIVE, only task definition families that do not have any ACTIVE - // task definition revisions are returned. If you paginate the resulting output, - // be sure to keep the status value constant in each subsequent request. - Status *string `locationName:"status" type:"string" enum:"TaskDefinitionFamilyStatus"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTaskDefinitionFamiliesInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTaskDefinitionFamiliesInput) GoString() string { - return s.String() -} - -// SetFamilyPrefix sets the FamilyPrefix field's value. -func (s *ListTaskDefinitionFamiliesInput) SetFamilyPrefix(v string) *ListTaskDefinitionFamiliesInput { - s.FamilyPrefix = &v - return s -} - -// SetMaxResults sets the MaxResults field's value. -func (s *ListTaskDefinitionFamiliesInput) SetMaxResults(v int64) *ListTaskDefinitionFamiliesInput { - s.MaxResults = &v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListTaskDefinitionFamiliesInput) SetNextToken(v string) *ListTaskDefinitionFamiliesInput { - s.NextToken = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *ListTaskDefinitionFamiliesInput) SetStatus(v string) *ListTaskDefinitionFamiliesInput { - s.Status = &v - return s -} - -type ListTaskDefinitionFamiliesOutput struct { - _ struct{} `type:"structure"` - - // The list of task definition family names that match the ListTaskDefinitionFamilies - // request. - Families []*string `locationName:"families" type:"list"` - - // The nextToken value to include in a future ListTaskDefinitionFamilies request. - // When the results of a ListTaskDefinitionFamilies request exceed maxResults, - // this value can be used to retrieve the next page of results. This value is - // null when there are no more results to return. - NextToken *string `locationName:"nextToken" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTaskDefinitionFamiliesOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTaskDefinitionFamiliesOutput) GoString() string { - return s.String() -} - -// SetFamilies sets the Families field's value. -func (s *ListTaskDefinitionFamiliesOutput) SetFamilies(v []*string) *ListTaskDefinitionFamiliesOutput { - s.Families = v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListTaskDefinitionFamiliesOutput) SetNextToken(v string) *ListTaskDefinitionFamiliesOutput { - s.NextToken = &v - return s -} - -type ListTaskDefinitionsInput struct { - _ struct{} `type:"structure"` - - // The full family name to filter the ListTaskDefinitions results with. Specifying - // a familyPrefix limits the listed task definitions to task definition revisions - // that belong to that family. - FamilyPrefix *string `locationName:"familyPrefix" type:"string"` - - // The maximum number of task definition results that ListTaskDefinitions returned - // in paginated output. When this parameter is used, ListTaskDefinitions only - // returns maxResults results in a single page along with a nextToken response - // element. The remaining results of the initial request can be seen by sending - // another ListTaskDefinitions request with the returned nextToken value. This - // value can be between 1 and 100. If this parameter isn't used, then ListTaskDefinitions - // returns up to 100 results and a nextToken value if applicable. - MaxResults *int64 `locationName:"maxResults" type:"integer"` - - // The nextToken value returned from a ListTaskDefinitions request indicating - // that more results are available to fulfill the request and further calls - // will be needed. If maxResults was provided, it is possible the number of - // results to be fewer than maxResults. - // - // This token should be treated as an opaque identifier that is only used to - // retrieve the next items in a list and not for other programmatic purposes. - NextToken *string `locationName:"nextToken" type:"string"` - - // The order to sort the results in. Valid values are ASC and DESC. By default, - // (ASC) task definitions are listed lexicographically by family name and in - // ascending numerical order by revision so that the newest task definitions - // in a family are listed last. Setting this parameter to DESC reverses the - // sort order on family name and revision. This is so that the newest task definitions - // in a family are listed first. - Sort *string `locationName:"sort" type:"string" enum:"SortOrder"` - - // The task definition status to filter the ListTaskDefinitions results with. - // By default, only ACTIVE task definitions are listed. By setting this parameter - // to INACTIVE, you can view task definitions that are INACTIVE as long as an - // active task or service still references them. If you paginate the resulting - // output, be sure to keep the status value constant in each subsequent request. - Status *string `locationName:"status" type:"string" enum:"TaskDefinitionStatus"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTaskDefinitionsInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTaskDefinitionsInput) GoString() string { - return s.String() -} - -// SetFamilyPrefix sets the FamilyPrefix field's value. -func (s *ListTaskDefinitionsInput) SetFamilyPrefix(v string) *ListTaskDefinitionsInput { - s.FamilyPrefix = &v - return s -} - -// SetMaxResults sets the MaxResults field's value. -func (s *ListTaskDefinitionsInput) SetMaxResults(v int64) *ListTaskDefinitionsInput { - s.MaxResults = &v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListTaskDefinitionsInput) SetNextToken(v string) *ListTaskDefinitionsInput { - s.NextToken = &v - return s -} - -// SetSort sets the Sort field's value. -func (s *ListTaskDefinitionsInput) SetSort(v string) *ListTaskDefinitionsInput { - s.Sort = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *ListTaskDefinitionsInput) SetStatus(v string) *ListTaskDefinitionsInput { - s.Status = &v - return s -} - -type ListTaskDefinitionsOutput struct { - _ struct{} `type:"structure"` - - // The nextToken value to include in a future ListTaskDefinitions request. When - // the results of a ListTaskDefinitions request exceed maxResults, this value - // can be used to retrieve the next page of results. This value is null when - // there are no more results to return. - NextToken *string `locationName:"nextToken" type:"string"` - - // The list of task definition Amazon Resource Name (ARN) entries for the ListTaskDefinitions - // request. - TaskDefinitionArns []*string `locationName:"taskDefinitionArns" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTaskDefinitionsOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTaskDefinitionsOutput) GoString() string { - return s.String() -} - -// SetNextToken sets the NextToken field's value. -func (s *ListTaskDefinitionsOutput) SetNextToken(v string) *ListTaskDefinitionsOutput { - s.NextToken = &v - return s -} - -// SetTaskDefinitionArns sets the TaskDefinitionArns field's value. -func (s *ListTaskDefinitionsOutput) SetTaskDefinitionArns(v []*string) *ListTaskDefinitionsOutput { - s.TaskDefinitionArns = v - return s -} - -type ListTasksInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster to use when - // filtering the ListTasks results. If you do not specify a cluster, the default - // cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // The container instance ID or full ARN of the container instance to use when - // filtering the ListTasks results. Specifying a containerInstance limits the - // results to tasks that belong to that container instance. - ContainerInstance *string `locationName:"containerInstance" type:"string"` - - // The task desired status to use when filtering the ListTasks results. Specifying - // a desiredStatus of STOPPED limits the results to tasks that Amazon ECS has - // set the desired status to STOPPED. This can be useful for debugging tasks - // that aren't starting properly or have died or finished. The default status - // filter is RUNNING, which shows tasks that Amazon ECS has set the desired - // status to RUNNING. - // - // Although you can filter results based on a desired status of PENDING, this - // doesn't return any results. Amazon ECS never sets the desired status of a - // task to that value (only a task's lastStatus may have a value of PENDING). - DesiredStatus *string `locationName:"desiredStatus" type:"string" enum:"DesiredStatus"` - - // The name of the task definition family to use when filtering the ListTasks - // results. Specifying a family limits the results to tasks that belong to that - // family. - Family *string `locationName:"family" type:"string"` - - // The launch type to use when filtering the ListTasks results. - LaunchType *string `locationName:"launchType" type:"string" enum:"LaunchType"` - - // The maximum number of task results that ListTasks returned in paginated output. - // When this parameter is used, ListTasks only returns maxResults results in - // a single page along with a nextToken response element. The remaining results - // of the initial request can be seen by sending another ListTasks request with - // the returned nextToken value. This value can be between 1 and 100. If this - // parameter isn't used, then ListTasks returns up to 100 results and a nextToken - // value if applicable. - MaxResults *int64 `locationName:"maxResults" type:"integer"` - - // The nextToken value returned from a ListTasks request indicating that more - // results are available to fulfill the request and further calls will be needed. - // If maxResults was provided, it's possible the number of results to be fewer - // than maxResults. - // - // This token should be treated as an opaque identifier that is only used to - // retrieve the next items in a list and not for other programmatic purposes. - NextToken *string `locationName:"nextToken" type:"string"` - - // The name of the service to use when filtering the ListTasks results. Specifying - // a serviceName limits the results to tasks that belong to that service. - ServiceName *string `locationName:"serviceName" type:"string"` - - // The startedBy value to filter the task results with. Specifying a startedBy - // value limits the results to tasks that were started with that value. - // - // When you specify startedBy as the filter, it must be the only filter that - // you use. - StartedBy *string `locationName:"startedBy" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTasksInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTasksInput) GoString() string { - return s.String() -} - -// SetCluster sets the Cluster field's value. -func (s *ListTasksInput) SetCluster(v string) *ListTasksInput { - s.Cluster = &v - return s -} - -// SetContainerInstance sets the ContainerInstance field's value. -func (s *ListTasksInput) SetContainerInstance(v string) *ListTasksInput { - s.ContainerInstance = &v - return s -} - -// SetDesiredStatus sets the DesiredStatus field's value. -func (s *ListTasksInput) SetDesiredStatus(v string) *ListTasksInput { - s.DesiredStatus = &v - return s -} - -// SetFamily sets the Family field's value. -func (s *ListTasksInput) SetFamily(v string) *ListTasksInput { - s.Family = &v - return s -} - -// SetLaunchType sets the LaunchType field's value. -func (s *ListTasksInput) SetLaunchType(v string) *ListTasksInput { - s.LaunchType = &v - return s -} - -// SetMaxResults sets the MaxResults field's value. -func (s *ListTasksInput) SetMaxResults(v int64) *ListTasksInput { - s.MaxResults = &v - return s -} - -// SetNextToken sets the NextToken field's value. -func (s *ListTasksInput) SetNextToken(v string) *ListTasksInput { - s.NextToken = &v - return s -} - -// SetServiceName sets the ServiceName field's value. -func (s *ListTasksInput) SetServiceName(v string) *ListTasksInput { - s.ServiceName = &v - return s -} - -// SetStartedBy sets the StartedBy field's value. -func (s *ListTasksInput) SetStartedBy(v string) *ListTasksInput { - s.StartedBy = &v - return s -} - -type ListTasksOutput struct { - _ struct{} `type:"structure"` - - // The nextToken value to include in a future ListTasks request. When the results - // of a ListTasks request exceed maxResults, this value can be used to retrieve - // the next page of results. This value is null when there are no more results - // to return. - NextToken *string `locationName:"nextToken" type:"string"` - - // The list of task ARN entries for the ListTasks request. - TaskArns []*string `locationName:"taskArns" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTasksOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ListTasksOutput) GoString() string { - return s.String() -} - -// SetNextToken sets the NextToken field's value. -func (s *ListTasksOutput) SetNextToken(v string) *ListTasksOutput { - s.NextToken = &v - return s -} - -// SetTaskArns sets the TaskArns field's value. -func (s *ListTasksOutput) SetTaskArns(v []*string) *ListTasksOutput { - s.TaskArns = v - return s -} - -// The load balancer configuration to use with a service or task set. -// -// When you add, update, or remove a load balancer configuration, Amazon ECS -// starts a new deployment with the updated Elastic Load Balancing configuration. -// This causes tasks to register to and deregister from load balancers. -// -// We recommend that you verify this on a test environment before you update -// the Elastic Load Balancing configuration. -// -// A service-linked role is required for services that use multiple target groups. -// For more information, see Using service-linked roles (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using-service-linked-roles.html) -// in the Amazon Elastic Container Service Developer Guide. -type LoadBalancer struct { - _ struct{} `type:"structure"` - - // The name of the container (as it appears in a container definition) to associate - // with the load balancer. - ContainerName *string `locationName:"containerName" type:"string"` - - // The port on the container to associate with the load balancer. This port - // must correspond to a containerPort in the task definition the tasks in the - // service are using. For tasks that use the EC2 launch type, the container - // instance they're launched on must allow ingress traffic on the hostPort of - // the port mapping. - ContainerPort *int64 `locationName:"containerPort" type:"integer"` - - // The name of the load balancer to associate with the Amazon ECS service or - // task set. - // - // If you are using an Application Load Balancer or a Network Load Balancer - // the load balancer name parameter should be omitted. - LoadBalancerName *string `locationName:"loadBalancerName" type:"string"` - - // The full Amazon Resource Name (ARN) of the Elastic Load Balancing target - // group or groups associated with a service or task set. - // - // A target group ARN is only specified when using an Application Load Balancer - // or Network Load Balancer. - // - // For services using the ECS deployment controller, you can specify one or - // multiple target groups. For more information, see Registering multiple target - // groups with a service (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/register-multiple-targetgroups.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // For services using the CODE_DEPLOY deployment controller, you're required - // to define two target groups for the load balancer. For more information, - // see Blue/green deployment with CodeDeploy (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-type-bluegreen.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // If your service's task definition uses the awsvpc network mode, you must - // choose ip as the target type, not instance. Do this when creating your target - // groups because tasks that use the awsvpc network mode are associated with - // an elastic network interface, not an Amazon EC2 instance. This network mode - // is required for the Fargate launch type. - TargetGroupArn *string `locationName:"targetGroupArn" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s LoadBalancer) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s LoadBalancer) GoString() string { - return s.String() -} - -// SetContainerName sets the ContainerName field's value. -func (s *LoadBalancer) SetContainerName(v string) *LoadBalancer { - s.ContainerName = &v - return s -} - -// SetContainerPort sets the ContainerPort field's value. -func (s *LoadBalancer) SetContainerPort(v int64) *LoadBalancer { - s.ContainerPort = &v - return s -} - -// SetLoadBalancerName sets the LoadBalancerName field's value. -func (s *LoadBalancer) SetLoadBalancerName(v string) *LoadBalancer { - s.LoadBalancerName = &v - return s -} - -// SetTargetGroupArn sets the TargetGroupArn field's value. -func (s *LoadBalancer) SetTargetGroupArn(v string) *LoadBalancer { - s.TargetGroupArn = &v - return s -} - -// The log configuration for the container. This parameter maps to LogConfig -// in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) -// section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) -// and the --log-driver option to docker run (https://docs.docker.com/engine/reference/commandline/run/). -// -// By default, containers use the same logging driver that the Docker daemon -// uses. However, the container might use a different logging driver than the -// Docker daemon by specifying a log driver configuration in the container definition. -// For more information about the options for different supported log drivers, -// see Configure logging drivers (https://docs.docker.com/engine/admin/logging/overview/) -// in the Docker documentation. -// -// Understand the following when specifying a log configuration for your containers. -// -// - Amazon ECS currently supports a subset of the logging drivers available -// to the Docker daemon. Additional log drivers may be available in future -// releases of the Amazon ECS container agent. For tasks on Fargate, the -// supported log drivers are awslogs, splunk, and awsfirelens. For tasks -// hosted on Amazon EC2 instances, the supported log drivers are awslogs, -// fluentd, gelf, json-file, journald, logentries,syslog, splunk, and awsfirelens. -// -// - This parameter requires version 1.18 of the Docker Remote API or greater -// on your container instance. -// -// - For tasks that are hosted on Amazon EC2 instances, the Amazon ECS container -// agent must register the available logging drivers with the ECS_AVAILABLE_LOGGING_DRIVERS -// environment variable before containers placed on that instance can use -// these log configuration options. For more information, see Amazon ECS -// container agent configuration (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// - For tasks that are on Fargate, because you don't have access to the -// underlying infrastructure your tasks are hosted on, any additional software -// needed must be installed outside of the task. For example, the Fluentd -// output aggregators or a remote host running Logstash to send Gelf logs -// to. -type LogConfiguration struct { - _ struct{} `type:"structure"` - - // The log driver to use for the container. - // - // For tasks on Fargate, the supported log drivers are awslogs, splunk, and - // awsfirelens. - // - // For tasks hosted on Amazon EC2 instances, the supported log drivers are awslogs, - // fluentd, gelf, json-file, journald, logentries,syslog, splunk, and awsfirelens. - // - // For more information about using the awslogs log driver, see Using the awslogs - // log driver (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // For more information about using the awsfirelens log driver, see Custom log - // routing (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_firelens.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // If you have a custom driver that isn't listed, you can fork the Amazon ECS - // container agent project that's available on GitHub (https://github.com/aws/amazon-ecs-agent) - // and customize it to work with that driver. We encourage you to submit pull - // requests for changes that you would like to have included. However, we don't - // currently provide support for running modified copies of this software. - // - // LogDriver is a required field - LogDriver *string `locationName:"logDriver" type:"string" required:"true" enum:"LogDriver"` - - // The configuration options to send to the log driver. This parameter requires - // version 1.19 of the Docker Remote API or greater on your container instance. - // To check the Docker Remote API version on your container instance, log in - // to your container instance and run the following command: sudo docker version - // --format '{{.Server.APIVersion}}' - Options map[string]*string `locationName:"options" type:"map"` - - // The secrets to pass to the log configuration. For more information, see Specifying - // sensitive data (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data.html) - // in the Amazon Elastic Container Service Developer Guide. - SecretOptions []*Secret `locationName:"secretOptions" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s LogConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s LogConfiguration) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *LogConfiguration) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "LogConfiguration"} - if s.LogDriver == nil { - invalidParams.Add(request.NewErrParamRequired("LogDriver")) - } - if s.SecretOptions != nil { - for i, v := range s.SecretOptions { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "SecretOptions", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetLogDriver sets the LogDriver field's value. -func (s *LogConfiguration) SetLogDriver(v string) *LogConfiguration { - s.LogDriver = &v - return s -} - -// SetOptions sets the Options field's value. -func (s *LogConfiguration) SetOptions(v map[string]*string) *LogConfiguration { - s.Options = v - return s -} - -// SetSecretOptions sets the SecretOptions field's value. -func (s *LogConfiguration) SetSecretOptions(v []*Secret) *LogConfiguration { - s.SecretOptions = v - return s -} - -// Details about the managed agent status for the container. -type ManagedAgent struct { - _ struct{} `type:"structure"` - - // The Unix timestamp for the time when the managed agent was last started. - LastStartedAt *time.Time `locationName:"lastStartedAt" type:"timestamp"` - - // The last known status of the managed agent. - LastStatus *string `locationName:"lastStatus" type:"string"` - - // The name of the managed agent. When the execute command feature is turned - // on, the managed agent name is ExecuteCommandAgent. - Name *string `locationName:"name" type:"string" enum:"ManagedAgentName"` - - // The reason for why the managed agent is in the state it is in. - Reason *string `locationName:"reason" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ManagedAgent) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ManagedAgent) GoString() string { - return s.String() -} - -// SetLastStartedAt sets the LastStartedAt field's value. -func (s *ManagedAgent) SetLastStartedAt(v time.Time) *ManagedAgent { - s.LastStartedAt = &v - return s -} - -// SetLastStatus sets the LastStatus field's value. -func (s *ManagedAgent) SetLastStatus(v string) *ManagedAgent { - s.LastStatus = &v - return s -} - -// SetName sets the Name field's value. -func (s *ManagedAgent) SetName(v string) *ManagedAgent { - s.Name = &v - return s -} - -// SetReason sets the Reason field's value. -func (s *ManagedAgent) SetReason(v string) *ManagedAgent { - s.Reason = &v - return s -} - -// An object representing a change in state for a managed agent. -type ManagedAgentStateChange struct { - _ struct{} `type:"structure"` - - // The name of the container that's associated with the managed agent. - // - // ContainerName is a required field - ContainerName *string `locationName:"containerName" type:"string" required:"true"` - - // The name of the managed agent. - // - // ManagedAgentName is a required field - ManagedAgentName *string `locationName:"managedAgentName" type:"string" required:"true" enum:"ManagedAgentName"` - - // The reason for the status of the managed agent. - Reason *string `locationName:"reason" type:"string"` - - // The status of the managed agent. - // - // Status is a required field - Status *string `locationName:"status" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ManagedAgentStateChange) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ManagedAgentStateChange) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ManagedAgentStateChange) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ManagedAgentStateChange"} - if s.ContainerName == nil { - invalidParams.Add(request.NewErrParamRequired("ContainerName")) - } - if s.ManagedAgentName == nil { - invalidParams.Add(request.NewErrParamRequired("ManagedAgentName")) - } - if s.Status == nil { - invalidParams.Add(request.NewErrParamRequired("Status")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetContainerName sets the ContainerName field's value. -func (s *ManagedAgentStateChange) SetContainerName(v string) *ManagedAgentStateChange { - s.ContainerName = &v - return s -} - -// SetManagedAgentName sets the ManagedAgentName field's value. -func (s *ManagedAgentStateChange) SetManagedAgentName(v string) *ManagedAgentStateChange { - s.ManagedAgentName = &v - return s -} - -// SetReason sets the Reason field's value. -func (s *ManagedAgentStateChange) SetReason(v string) *ManagedAgentStateChange { - s.Reason = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *ManagedAgentStateChange) SetStatus(v string) *ManagedAgentStateChange { - s.Status = &v - return s -} - -// The managed scaling settings for the Auto Scaling group capacity provider. -// -// When managed scaling is turned on, Amazon ECS manages the scale-in and scale-out -// actions of the Auto Scaling group. Amazon ECS manages a target tracking scaling -// policy using an Amazon ECS managed CloudWatch metric with the specified targetCapacity -// value as the target value for the metric. For more information, see Using -// managed scaling (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/asg-capacity-providers.html#asg-capacity-providers-managed-scaling) -// in the Amazon Elastic Container Service Developer Guide. -// -// If managed scaling is off, the user must manage the scaling of the Auto Scaling -// group. -type ManagedScaling struct { - _ struct{} `type:"structure"` - - // The period of time, in seconds, after a newly launched Amazon EC2 instance - // can contribute to CloudWatch metrics for Auto Scaling group. If this parameter - // is omitted, the default value of 300 seconds is used. - InstanceWarmupPeriod *int64 `locationName:"instanceWarmupPeriod" type:"integer"` - - // The maximum number of Amazon EC2 instances that Amazon ECS will scale out - // at one time. The scale in process is not affected by this parameter. If this - // parameter is omitted, the default value of 10000 is used. - MaximumScalingStepSize *int64 `locationName:"maximumScalingStepSize" min:"1" type:"integer"` - - // The minimum number of Amazon EC2 instances that Amazon ECS will scale out - // at one time. The scale in process is not affected by this parameter If this - // parameter is omitted, the default value of 1 is used. - // - // When additional capacity is required, Amazon ECS will scale up the minimum - // scaling step size even if the actual demand is less than the minimum scaling - // step size. - // - // If you use a capacity provider with an Auto Scaling group configured with - // more than one Amazon EC2 instance type or Availability Zone, Amazon ECS will - // scale up by the exact minimum scaling step size value and will ignore both - // the maximum scaling step size as well as the capacity demand. - MinimumScalingStepSize *int64 `locationName:"minimumScalingStepSize" min:"1" type:"integer"` - - ScalingApproach *string `locationName:"scalingApproach" type:"string" enum:"ManagedScalingScalingApproach"` - - // Determines whether to use managed scaling for the capacity provider. - Status *string `locationName:"status" type:"string" enum:"ManagedScalingStatus"` - - // The target capacity utilization as a percentage for the capacity provider. - // The specified value must be greater than 0 and less than or equal to 100. - // For example, if you want the capacity provider to maintain 10% spare capacity, - // then that means the utilization is 90%, so use a targetCapacity of 90. The - // default value of 100 percent results in the Amazon EC2 instances in your - // Auto Scaling group being completely used. - TargetCapacity *int64 `locationName:"targetCapacity" min:"1" type:"integer"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ManagedScaling) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ManagedScaling) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ManagedScaling) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ManagedScaling"} - if s.MaximumScalingStepSize != nil && *s.MaximumScalingStepSize < 1 { - invalidParams.Add(request.NewErrParamMinValue("MaximumScalingStepSize", 1)) - } - if s.MinimumScalingStepSize != nil && *s.MinimumScalingStepSize < 1 { - invalidParams.Add(request.NewErrParamMinValue("MinimumScalingStepSize", 1)) - } - if s.TargetCapacity != nil && *s.TargetCapacity < 1 { - invalidParams.Add(request.NewErrParamMinValue("TargetCapacity", 1)) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetInstanceWarmupPeriod sets the InstanceWarmupPeriod field's value. -func (s *ManagedScaling) SetInstanceWarmupPeriod(v int64) *ManagedScaling { - s.InstanceWarmupPeriod = &v - return s -} - -// SetMaximumScalingStepSize sets the MaximumScalingStepSize field's value. -func (s *ManagedScaling) SetMaximumScalingStepSize(v int64) *ManagedScaling { - s.MaximumScalingStepSize = &v - return s -} - -// SetMinimumScalingStepSize sets the MinimumScalingStepSize field's value. -func (s *ManagedScaling) SetMinimumScalingStepSize(v int64) *ManagedScaling { - s.MinimumScalingStepSize = &v - return s -} - -// SetScalingApproach sets the ScalingApproach field's value. -func (s *ManagedScaling) SetScalingApproach(v string) *ManagedScaling { - s.ScalingApproach = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *ManagedScaling) SetStatus(v string) *ManagedScaling { - s.Status = &v - return s -} - -// SetTargetCapacity sets the TargetCapacity field's value. -func (s *ManagedScaling) SetTargetCapacity(v int64) *ManagedScaling { - s.TargetCapacity = &v - return s -} - -// Amazon ECS can't determine the current version of the Amazon ECS container -// agent on the container instance and doesn't have enough information to proceed -// with an update. This could be because the agent running on the container -// instance is a previous or custom version that doesn't use our version information. -type MissingVersionException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s MissingVersionException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s MissingVersionException) GoString() string { - return s.String() -} - -func newErrorMissingVersionException(v protocol.ResponseMetadata) error { - return &MissingVersionException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *MissingVersionException) Code() string { - return "MissingVersionException" -} - -// Message returns the exception's message. -func (s *MissingVersionException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *MissingVersionException) OrigErr() error { - return nil -} - -func (s *MissingVersionException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *MissingVersionException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *MissingVersionException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The details for a volume mount point that's used in a container definition. -type MountPoint struct { - _ struct{} `type:"structure"` - - // The path on the container to mount the host volume at. - ContainerPath *string `locationName:"containerPath" type:"string"` - - // If this value is true, the container has read-only access to the volume. - // If this value is false, then the container can write to the volume. The default - // value is false. - ReadOnly *bool `locationName:"readOnly" type:"boolean"` - - // The name of the volume to mount. Must be a volume name referenced in the - // name parameter of task definition volume. - SourceVolume *string `locationName:"sourceVolume" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s MountPoint) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s MountPoint) GoString() string { - return s.String() -} - -// SetContainerPath sets the ContainerPath field's value. -func (s *MountPoint) SetContainerPath(v string) *MountPoint { - s.ContainerPath = &v - return s -} - -// SetReadOnly sets the ReadOnly field's value. -func (s *MountPoint) SetReadOnly(v bool) *MountPoint { - s.ReadOnly = &v - return s -} - -// SetSourceVolume sets the SourceVolume field's value. -func (s *MountPoint) SetSourceVolume(v string) *MountPoint { - s.SourceVolume = &v - return s -} - -// The specified namespace wasn't found. -type NamespaceNotFoundException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s NamespaceNotFoundException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s NamespaceNotFoundException) GoString() string { - return s.String() -} - -func newErrorNamespaceNotFoundException(v protocol.ResponseMetadata) error { - return &NamespaceNotFoundException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *NamespaceNotFoundException) Code() string { - return "NamespaceNotFoundException" -} - -// Message returns the exception's message. -func (s *NamespaceNotFoundException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *NamespaceNotFoundException) OrigErr() error { - return nil -} - -func (s *NamespaceNotFoundException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *NamespaceNotFoundException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *NamespaceNotFoundException) RequestID() string { - return s.RespMetadata.RequestID -} - -// Details on the network bindings between a container and its host container -// instance. After a task reaches the RUNNING status, manual and automatic host -// and container port assignments are visible in the networkBindings section -// of DescribeTasks API responses. -type NetworkBinding struct { - _ struct{} `type:"structure"` - - // The IP address that the container is bound to on the container instance. - BindIP *string `locationName:"bindIP" type:"string"` - - // The port number on the container that's used with the network binding. - ContainerPort *int64 `locationName:"containerPort" type:"integer"` - - // The port number on the host that's used with the network binding. - HostPort *int64 `locationName:"hostPort" type:"integer"` - - // The protocol used for the network binding. - Protocol *string `locationName:"protocol" type:"string" enum:"TransportProtocol"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s NetworkBinding) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s NetworkBinding) GoString() string { - return s.String() -} - -// SetBindIP sets the BindIP field's value. -func (s *NetworkBinding) SetBindIP(v string) *NetworkBinding { - s.BindIP = &v - return s -} - -// SetContainerPort sets the ContainerPort field's value. -func (s *NetworkBinding) SetContainerPort(v int64) *NetworkBinding { - s.ContainerPort = &v - return s -} - -// SetHostPort sets the HostPort field's value. -func (s *NetworkBinding) SetHostPort(v int64) *NetworkBinding { - s.HostPort = &v - return s -} - -// SetProtocol sets the Protocol field's value. -func (s *NetworkBinding) SetProtocol(v string) *NetworkBinding { - s.Protocol = &v - return s -} - -// The network configuration for a task or service. -type NetworkConfiguration struct { - _ struct{} `type:"structure"` - - // The VPC subnets and security groups that are associated with a task. - // - // All specified subnets and security groups must be from the same VPC. - AwsvpcConfiguration *AwsVpcConfiguration `locationName:"awsvpcConfiguration" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s NetworkConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s NetworkConfiguration) GoString() string { - return s.String() -} - -// SetAwsvpcConfiguration sets the AwsvpcConfiguration field's value. -func (s *NetworkConfiguration) SetAwsvpcConfiguration(v *AwsVpcConfiguration) *NetworkConfiguration { - s.AwsvpcConfiguration = v - return s -} - -// An object representing the elastic network interface for tasks that use the -// awsvpc network mode. -type NetworkInterface struct { - _ struct{} `type:"structure"` - - // The attachment ID for the network interface. - AttachmentId *string `locationName:"attachmentId" type:"string"` - - // The private IPv6 address for the network interface. - Ipv6Address *string `locationName:"ipv6Address" type:"string"` - - // The private IPv4 address for the network interface. - PrivateIpv4Address *string `locationName:"privateIpv4Address" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s NetworkInterface) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s NetworkInterface) GoString() string { - return s.String() -} - -// SetAttachmentId sets the AttachmentId field's value. -func (s *NetworkInterface) SetAttachmentId(v string) *NetworkInterface { - s.AttachmentId = &v - return s -} - -// SetIpv6Address sets the Ipv6Address field's value. -func (s *NetworkInterface) SetIpv6Address(v string) *NetworkInterface { - s.Ipv6Address = &v - return s -} - -// SetPrivateIpv4Address sets the PrivateIpv4Address field's value. -func (s *NetworkInterface) SetPrivateIpv4Address(v string) *NetworkInterface { - s.PrivateIpv4Address = &v - return s -} - -// There's no update available for this Amazon ECS container agent. This might -// be because the agent is already running the latest version or because it's -// so old that there's no update path to the current version. -type NoUpdateAvailableException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s NoUpdateAvailableException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s NoUpdateAvailableException) GoString() string { - return s.String() -} - -func newErrorNoUpdateAvailableException(v protocol.ResponseMetadata) error { - return &NoUpdateAvailableException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *NoUpdateAvailableException) Code() string { - return "NoUpdateAvailableException" -} - -// Message returns the exception's message. -func (s *NoUpdateAvailableException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *NoUpdateAvailableException) OrigErr() error { - return nil -} - -func (s *NoUpdateAvailableException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *NoUpdateAvailableException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *NoUpdateAvailableException) RequestID() string { - return s.RespMetadata.RequestID -} - -// An object representing a constraint on task placement. For more information, -// see Task placement constraints (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// If you're using the Fargate launch type, task placement constraints aren't -// supported. -type PlacementConstraint struct { - _ struct{} `type:"structure"` - - // A cluster query language expression to apply to the constraint. The expression - // can have a maximum length of 2000 characters. You can't specify an expression - // if the constraint type is distinctInstance. For more information, see Cluster - // query language (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-query-language.html) - // in the Amazon Elastic Container Service Developer Guide. - Expression *string `locationName:"expression" type:"string"` - - // The type of constraint. Use distinctInstance to ensure that each task in - // a particular group is running on a different container instance. Use memberOf - // to restrict the selection to a group of valid candidates. - Type *string `locationName:"type" type:"string" enum:"PlacementConstraintType"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PlacementConstraint) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PlacementConstraint) GoString() string { - return s.String() -} - -// SetExpression sets the Expression field's value. -func (s *PlacementConstraint) SetExpression(v string) *PlacementConstraint { - s.Expression = &v - return s -} - -// SetType sets the Type field's value. -func (s *PlacementConstraint) SetType(v string) *PlacementConstraint { - s.Type = &v - return s -} - -// The task placement strategy for a task or service. For more information, -// see Task placement strategies (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-strategies.html) -// in the Amazon Elastic Container Service Developer Guide. -type PlacementStrategy struct { - _ struct{} `type:"structure"` - - // The field to apply the placement strategy against. For the spread placement - // strategy, valid values are instanceId (or host, which has the same effect), - // or any platform or custom attribute that's applied to a container instance, - // such as attribute:ecs.availability-zone. For the binpack placement strategy, - // valid values are cpu and memory. For the random placement strategy, this - // field is not used. - Field *string `locationName:"field" type:"string"` - - // The type of placement strategy. The random placement strategy randomly places - // tasks on available candidates. The spread placement strategy spreads placement - // across available candidates evenly based on the field parameter. The binpack - // strategy places tasks on available candidates that have the least available - // amount of the resource that's specified with the field parameter. For example, - // if you binpack on memory, a task is placed on the instance with the least - // amount of remaining memory but still enough to run the task. - Type *string `locationName:"type" type:"string" enum:"PlacementStrategyType"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PlacementStrategy) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PlacementStrategy) GoString() string { - return s.String() -} - -// SetField sets the Field field's value. -func (s *PlacementStrategy) SetField(v string) *PlacementStrategy { - s.Field = &v - return s -} - -// SetType sets the Type field's value. -func (s *PlacementStrategy) SetType(v string) *PlacementStrategy { - s.Type = &v - return s -} - -// The devices that are available on the container instance. The only supported -// device type is a GPU. -type PlatformDevice struct { - _ struct{} `type:"structure"` - - // The ID for the GPUs on the container instance. The available GPU IDs can - // also be obtained on the container instance in the /var/lib/ecs/gpu/nvidia_gpu_info.json - // file. - // - // Id is a required field - Id *string `locationName:"id" type:"string" required:"true"` - - // The type of device that's available on the container instance. The only supported - // value is GPU. - // - // Type is a required field - Type *string `locationName:"type" type:"string" required:"true" enum:"PlatformDeviceType"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PlatformDevice) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PlatformDevice) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *PlatformDevice) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "PlatformDevice"} - if s.Id == nil { - invalidParams.Add(request.NewErrParamRequired("Id")) - } - if s.Type == nil { - invalidParams.Add(request.NewErrParamRequired("Type")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetId sets the Id field's value. -func (s *PlatformDevice) SetId(v string) *PlatformDevice { - s.Id = &v - return s -} - -// SetType sets the Type field's value. -func (s *PlatformDevice) SetType(v string) *PlatformDevice { - s.Type = &v - return s -} - -// The specified platform version doesn't satisfy the required capabilities -// of the task definition. -type PlatformTaskDefinitionIncompatibilityException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PlatformTaskDefinitionIncompatibilityException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PlatformTaskDefinitionIncompatibilityException) GoString() string { - return s.String() -} - -func newErrorPlatformTaskDefinitionIncompatibilityException(v protocol.ResponseMetadata) error { - return &PlatformTaskDefinitionIncompatibilityException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *PlatformTaskDefinitionIncompatibilityException) Code() string { - return "PlatformTaskDefinitionIncompatibilityException" -} - -// Message returns the exception's message. -func (s *PlatformTaskDefinitionIncompatibilityException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *PlatformTaskDefinitionIncompatibilityException) OrigErr() error { - return nil -} - -func (s *PlatformTaskDefinitionIncompatibilityException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *PlatformTaskDefinitionIncompatibilityException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *PlatformTaskDefinitionIncompatibilityException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The specified platform version doesn't exist. -type PlatformUnknownException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PlatformUnknownException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PlatformUnknownException) GoString() string { - return s.String() -} - -func newErrorPlatformUnknownException(v protocol.ResponseMetadata) error { - return &PlatformUnknownException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *PlatformUnknownException) Code() string { - return "PlatformUnknownException" -} - -// Message returns the exception's message. -func (s *PlatformUnknownException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *PlatformUnknownException) OrigErr() error { - return nil -} - -func (s *PlatformUnknownException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *PlatformUnknownException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *PlatformUnknownException) RequestID() string { - return s.RespMetadata.RequestID -} - -// Port mappings allow containers to access ports on the host container instance -// to send or receive traffic. Port mappings are specified as part of the container -// definition. -// -// If you use containers in a task with the awsvpc or host network mode, specify -// the exposed ports using containerPort. The hostPort can be left blank or -// it must be the same value as the containerPort. -// -// Most fields of this parameter (containerPort, hostPort, protocol) maps to -// PortBindings in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) -// section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) -// and the --publish option to docker run (https://docs.docker.com/engine/reference/commandline/run/). -// If the network mode of a task definition is set to host, host ports must -// either be undefined or match the container port in the port mapping. -// -// You can't expose the same container port for multiple protocols. If you attempt -// this, an error is returned. -// -// After a task reaches the RUNNING status, manual and automatic host and container -// port assignments are visible in the networkBindings section of DescribeTasks -// API responses. -type PortMapping struct { - _ struct{} `type:"structure"` - - // The application protocol that's used for the port mapping. This parameter - // only applies to Service Connect. We recommend that you set this parameter - // to be consistent with the protocol that your application uses. If you set - // this parameter, Amazon ECS adds protocol-specific connection handling to - // the Service Connect proxy. If you set this parameter, Amazon ECS adds protocol-specific - // telemetry in the Amazon ECS console and CloudWatch. - // - // If you don't set a value for this parameter, then TCP is used. However, Amazon - // ECS doesn't add protocol-specific telemetry for TCP. - // - // Tasks that run in a namespace can use short names to connect to services - // in the namespace. Tasks can connect to services across all of the clusters - // in the namespace. Tasks connect through a managed proxy container that collects - // logs and metrics for increased visibility. Only the tasks that Amazon ECS - // services create are supported with Service Connect. For more information, - // see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - AppProtocol *string `locationName:"appProtocol" type:"string" enum:"ApplicationProtocol"` - - // The port number on the container that's bound to the user-specified or automatically - // assigned host port. - // - // If you use containers in a task with the awsvpc or host network mode, specify - // the exposed ports using containerPort. - // - // If you use containers in a task with the bridge network mode and you specify - // a container port and not a host port, your container automatically receives - // a host port in the ephemeral port range. For more information, see hostPort. - // Port mappings that are automatically assigned in this way do not count toward - // the 100 reserved ports limit of a container instance. - ContainerPort *int64 `locationName:"containerPort" type:"integer"` - - // The port number on the container instance to reserve for your container. - // - // If you specify a containerPortRange, leave this field empty and the value - // of the hostPort is set as follows: - // - // * For containers in a task with the awsvpc network mode, the hostPort - // is set to the same value as the containerPort. This is a static mapping - // strategy. - // - // * For containers in a task with the bridge network mode, the Amazon ECS - // agent finds open ports on the host and automatically binds them to the - // container ports. This is a dynamic mapping strategy. - // - // If you use containers in a task with the awsvpc or host network mode, the - // hostPort can either be left blank or set to the same value as the containerPort. - // - // If you use containers in a task with the bridge network mode, you can specify - // a non-reserved host port for your container port mapping, or you can omit - // the hostPort (or set it to 0) while specifying a containerPort and your container - // automatically receives a port in the ephemeral port range for your container - // instance operating system and Docker version. - // - // The default ephemeral port range for Docker version 1.6.0 and later is listed - // on the instance under /proc/sys/net/ipv4/ip_local_port_range. If this kernel - // parameter is unavailable, the default ephemeral port range from 49153 through - // 65535 (Linux) or 49152 through 65535 (Windows) is used. Do not attempt to - // specify a host port in the ephemeral port range as these are reserved for - // automatic assignment. In general, ports below 32768 are outside of the ephemeral - // port range. - // - // The default reserved ports are 22 for SSH, the Docker ports 2375 and 2376, - // and the Amazon ECS container agent ports 51678-51680. Any host port that - // was previously specified in a running task is also reserved while the task - // is running. That is, after a task stops, the host port is released. The current - // reserved ports are displayed in the remainingResources of DescribeContainerInstances - // (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DescribeContainerInstances.html) - // output. A container instance can have up to 100 reserved ports at a time. - // This number includes the default reserved ports. Automatically assigned ports - // aren't included in the 100 reserved ports quota. - HostPort *int64 `locationName:"hostPort" type:"integer"` - - // The name that's used for the port mapping. This parameter only applies to - // Service Connect. This parameter is the name that you use in the serviceConnectConfiguration - // of a service. The name can include up to 64 characters. The characters can - // include lowercase letters, numbers, underscores (_), and hyphens (-). The - // name can't start with a hyphen. - // - // For more information, see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - Name *string `locationName:"name" type:"string"` - - // The protocol used for the port mapping. Valid values are tcp and udp. The - // default is tcp. - Protocol *string `locationName:"protocol" type:"string" enum:"TransportProtocol"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PortMapping) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PortMapping) GoString() string { - return s.String() -} - -// SetAppProtocol sets the AppProtocol field's value. -func (s *PortMapping) SetAppProtocol(v string) *PortMapping { - s.AppProtocol = &v - return s -} - -// SetContainerPort sets the ContainerPort field's value. -func (s *PortMapping) SetContainerPort(v int64) *PortMapping { - s.ContainerPort = &v - return s -} - -// SetHostPort sets the HostPort field's value. -func (s *PortMapping) SetHostPort(v int64) *PortMapping { - s.HostPort = &v - return s -} - -// SetName sets the Name field's value. -func (s *PortMapping) SetName(v string) *PortMapping { - s.Name = &v - return s -} - -// SetProtocol sets the Protocol field's value. -func (s *PortMapping) SetProtocol(v string) *PortMapping { - s.Protocol = &v - return s -} - -// An object representing the protection status details for a task. You can -// set the protection status with the UpdateTaskProtection API and get the status -// of tasks with the GetTaskProtection API. -type ProtectedTask struct { - _ struct{} `type:"structure"` - - // The epoch time when protection for the task will expire. - ExpirationDate *time.Time `locationName:"expirationDate" type:"timestamp"` - - // The protection status of the task. If scale-in protection is on for a task, - // the value is true. Otherwise, it is false. - ProtectionEnabled *bool `locationName:"protectionEnabled" type:"boolean"` - - // The task ARN. - TaskArn *string `locationName:"taskArn" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ProtectedTask) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ProtectedTask) GoString() string { - return s.String() -} - -// SetExpirationDate sets the ExpirationDate field's value. -func (s *ProtectedTask) SetExpirationDate(v time.Time) *ProtectedTask { - s.ExpirationDate = &v - return s -} - -// SetProtectionEnabled sets the ProtectionEnabled field's value. -func (s *ProtectedTask) SetProtectionEnabled(v bool) *ProtectedTask { - s.ProtectionEnabled = &v - return s -} - -// SetTaskArn sets the TaskArn field's value. -func (s *ProtectedTask) SetTaskArn(v string) *ProtectedTask { - s.TaskArn = &v - return s -} - -// The configuration details for the App Mesh proxy. -// -// For tasks that use the EC2 launch type, the container instances require at -// least version 1.26.0 of the container agent and at least version 1.26.0-1 -// of the ecs-init package to use a proxy configuration. If your container instances -// are launched from the Amazon ECS optimized AMI version 20190301 or later, -// then they contain the required versions of the container agent and ecs-init. -// For more information, see Amazon ECS-optimized Linux AMI (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html) -type ProxyConfiguration struct { - _ struct{} `type:"structure"` - - // The name of the container that will serve as the App Mesh proxy. - // - // ContainerName is a required field - ContainerName *string `locationName:"containerName" type:"string" required:"true"` - - // The set of network configuration parameters to provide the Container Network - // Interface (CNI) plugin, specified as key-value pairs. - // - // * IgnoredUID - (Required) The user ID (UID) of the proxy container as - // defined by the user parameter in a container definition. This is used - // to ensure the proxy ignores its own traffic. If IgnoredGID is specified, - // this field can be empty. - // - // * IgnoredGID - (Required) The group ID (GID) of the proxy container as - // defined by the user parameter in a container definition. This is used - // to ensure the proxy ignores its own traffic. If IgnoredUID is specified, - // this field can be empty. - // - // * AppPorts - (Required) The list of ports that the application uses. Network - // traffic to these ports is forwarded to the ProxyIngressPort and ProxyEgressPort. - // - // * ProxyIngressPort - (Required) Specifies the port that incoming traffic - // to the AppPorts is directed to. - // - // * ProxyEgressPort - (Required) Specifies the port that outgoing traffic - // from the AppPorts is directed to. - // - // * EgressIgnoredPorts - (Required) The egress traffic going to the specified - // ports is ignored and not redirected to the ProxyEgressPort. It can be - // an empty list. - // - // * EgressIgnoredIPs - (Required) The egress traffic going to the specified - // IP addresses is ignored and not redirected to the ProxyEgressPort. It - // can be an empty list. - Properties []*KeyValuePair `locationName:"properties" type:"list"` - - // The proxy type. The only supported value is APPMESH. - Type *string `locationName:"type" type:"string" enum:"ProxyConfigurationType"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ProxyConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ProxyConfiguration) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ProxyConfiguration) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ProxyConfiguration"} - if s.ContainerName == nil { - invalidParams.Add(request.NewErrParamRequired("ContainerName")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetContainerName sets the ContainerName field's value. -func (s *ProxyConfiguration) SetContainerName(v string) *ProxyConfiguration { - s.ContainerName = &v - return s -} - -// SetProperties sets the Properties field's value. -func (s *ProxyConfiguration) SetProperties(v []*KeyValuePair) *ProxyConfiguration { - s.Properties = v - return s -} - -// SetType sets the Type field's value. -func (s *ProxyConfiguration) SetType(v string) *ProxyConfiguration { - s.Type = &v - return s -} - -type PutAccountSettingDefaultInput struct { - _ struct{} `type:"structure"` - - // The resource name for which to modify the account setting. If you specify - // serviceLongArnFormat, the ARN for your Amazon ECS services is affected. If - // you specify taskLongArnFormat, the ARN and resource ID for your Amazon ECS - // tasks is affected. If you specify containerInstanceLongArnFormat, the ARN - // and resource ID for your Amazon ECS container instances is affected. If you - // specify awsvpcTrunking, the ENI limit for your Amazon ECS container instances - // is affected. If you specify containerInsights, the default setting for Amazon - // Web Services CloudWatch Container Insights for your clusters is affected. - // If you specify tagResourceAuthorization, the opt-in option for tagging resources - // on creation is affected. For information about the opt-in timeline, see Tagging - // authorization timeline (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#tag-resources) - // in the Amazon ECS Developer Guide. If you specify fargateTaskRetirementWaitPeriod, - // the default wait time to retire a Fargate task due to required maintenance - // is affected. - // - // When you specify fargateFIPSMode for the name and enabled for the value, - // Fargate uses FIPS-140 compliant cryptographic algorithms on your tasks. For - // more information about FIPS-140 compliance with Fargate, see Amazon Web Services - // Fargate Federal Information Processing Standard (FIPS) 140-2 compliance (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-fips-compliance.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // When Amazon Web Services determines that a security or infrastructure update - // is needed for an Amazon ECS task hosted on Fargate, the tasks need to be - // stopped and new tasks launched to replace them. Use fargateTaskRetirementWaitPeriod - // to set the wait time to retire a Fargate task to the default. For information - // about the Fargate tasks maintenance, see Amazon Web Services Fargate task - // maintenance (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-maintenance.html) - // in the Amazon ECS Developer Guide. - // - // Name is a required field - Name *string `locationName:"name" type:"string" required:"true" enum:"SettingName"` - - // The account setting value for the specified principal ARN. Accepted values - // are enabled, disabled, on, and off. - // - // When you specify fargateTaskRetirementWaitPeriod for the name, the following - // are the valid values: - // - // * 0 - Amazon Web Services sends the notification, and immediately retires - // the affected tasks. - // - // * 7 - Amazon Web Services sends the notification, and waits 7 calendar - // days to retire the tasks. - // - // * 14 - Amazon Web Services sends the notification, and waits 14 calendar - // days to retire the tasks. - // - // Value is a required field - Value *string `locationName:"value" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAccountSettingDefaultInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAccountSettingDefaultInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *PutAccountSettingDefaultInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "PutAccountSettingDefaultInput"} - if s.Name == nil { - invalidParams.Add(request.NewErrParamRequired("Name")) - } - if s.Value == nil { - invalidParams.Add(request.NewErrParamRequired("Value")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetName sets the Name field's value. -func (s *PutAccountSettingDefaultInput) SetName(v string) *PutAccountSettingDefaultInput { - s.Name = &v - return s -} - -// SetValue sets the Value field's value. -func (s *PutAccountSettingDefaultInput) SetValue(v string) *PutAccountSettingDefaultInput { - s.Value = &v - return s -} - -type PutAccountSettingDefaultOutput struct { - _ struct{} `type:"structure"` - - // The current setting for a resource. - Setting *Setting `locationName:"setting" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAccountSettingDefaultOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAccountSettingDefaultOutput) GoString() string { - return s.String() -} - -// SetSetting sets the Setting field's value. -func (s *PutAccountSettingDefaultOutput) SetSetting(v *Setting) *PutAccountSettingDefaultOutput { - s.Setting = v - return s -} - -type PutAccountSettingInput struct { - _ struct{} `type:"structure"` - - // The Amazon ECS resource name for which to modify the account setting. If - // you specify serviceLongArnFormat, the ARN for your Amazon ECS services is - // affected. If you specify taskLongArnFormat, the ARN and resource ID for your - // Amazon ECS tasks is affected. If you specify containerInstanceLongArnFormat, - // the ARN and resource ID for your Amazon ECS container instances is affected. - // If you specify awsvpcTrunking, the elastic network interface (ENI) limit - // for your Amazon ECS container instances is affected. If you specify containerInsights, - // the default setting for Amazon Web Services CloudWatch Container Insights - // for your clusters is affected. If you specify fargateFIPSMode, Fargate FIPS - // 140 compliance is affected. If you specify tagResourceAuthorization, the - // opt-in option for tagging resources on creation is affected. For information - // about the opt-in timeline, see Tagging authorization timeline (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#tag-resources) - // in the Amazon ECS Developer Guide. If you specify fargateTaskRetirementWaitPeriod, - // the wait time to retire a Fargate task is affected. - // - // Name is a required field - Name *string `locationName:"name" type:"string" required:"true" enum:"SettingName"` - - // The ARN of the principal, which can be a user, role, or the root user. If - // you specify the root user, it modifies the account setting for all users, - // roles, and the root user of the account unless a user or role explicitly - // overrides these settings. If this field is omitted, the setting is changed - // only for the authenticated user. - // - // You must use the root user when you set the Fargate wait time (fargateTaskRetirementWaitPeriod). - // - // Federated users assume the account setting of the root user and can't have - // explicit account settings set for them. - PrincipalArn *string `locationName:"principalArn" type:"string"` - - // The account setting value for the specified principal ARN. Accepted values - // are enabled, disabled, on, and off. - // - // When you specify fargateTaskRetirementWaitPeriod for the name, the following - // are the valid values: - // - // * 0 - Amazon Web Services sends the notification, and immediately retires - // the affected tasks. - // - // * 7 - Amazon Web Services sends the notification, and waits 7 calendar - // days to retire the tasks. - // - // * 14 - Amazon Web Services sends the notification, and waits 14 calendar - // days to retire the tasks. - // - // Value is a required field - Value *string `locationName:"value" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAccountSettingInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAccountSettingInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *PutAccountSettingInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "PutAccountSettingInput"} - if s.Name == nil { - invalidParams.Add(request.NewErrParamRequired("Name")) - } - if s.Value == nil { - invalidParams.Add(request.NewErrParamRequired("Value")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetName sets the Name field's value. -func (s *PutAccountSettingInput) SetName(v string) *PutAccountSettingInput { - s.Name = &v - return s -} - -// SetPrincipalArn sets the PrincipalArn field's value. -func (s *PutAccountSettingInput) SetPrincipalArn(v string) *PutAccountSettingInput { - s.PrincipalArn = &v - return s -} - -// SetValue sets the Value field's value. -func (s *PutAccountSettingInput) SetValue(v string) *PutAccountSettingInput { - s.Value = &v - return s -} - -type PutAccountSettingOutput struct { - _ struct{} `type:"structure"` - - // The current account setting for a resource. - Setting *Setting `locationName:"setting" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAccountSettingOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAccountSettingOutput) GoString() string { - return s.String() -} - -// SetSetting sets the Setting field's value. -func (s *PutAccountSettingOutput) SetSetting(v *Setting) *PutAccountSettingOutput { - s.Setting = v - return s -} - -type PutAttributesInput struct { - _ struct{} `type:"structure"` - - // The attributes to apply to your resource. You can specify up to 10 custom - // attributes for each resource. You can specify up to 10 attributes in a single - // call. - // - // Attributes is a required field - Attributes []*Attribute `locationName:"attributes" type:"list" required:"true"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that contains - // the resource to apply attributes. If you do not specify a cluster, the default - // cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAttributesInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAttributesInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *PutAttributesInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "PutAttributesInput"} - if s.Attributes == nil { - invalidParams.Add(request.NewErrParamRequired("Attributes")) - } - if s.Attributes != nil { - for i, v := range s.Attributes { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Attributes", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAttributes sets the Attributes field's value. -func (s *PutAttributesInput) SetAttributes(v []*Attribute) *PutAttributesInput { - s.Attributes = v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *PutAttributesInput) SetCluster(v string) *PutAttributesInput { - s.Cluster = &v - return s -} - -type PutAttributesOutput struct { - _ struct{} `type:"structure"` - - // The attributes applied to your resource. - Attributes []*Attribute `locationName:"attributes" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAttributesOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutAttributesOutput) GoString() string { - return s.String() -} - -// SetAttributes sets the Attributes field's value. -func (s *PutAttributesOutput) SetAttributes(v []*Attribute) *PutAttributesOutput { - s.Attributes = v - return s -} - -type PutClusterCapacityProvidersInput struct { - _ struct{} `type:"structure"` - - // The name of one or more capacity providers to associate with the cluster. - // - // If specifying a capacity provider that uses an Auto Scaling group, the capacity - // provider must already be created. New capacity providers can be created with - // the CreateCapacityProvider API operation. - // - // To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT - // capacity providers. The Fargate capacity providers are available to all accounts - // and only need to be associated with a cluster to be used. - // - // CapacityProviders is a required field - CapacityProviders []*string `locationName:"capacityProviders" type:"list" required:"true"` - - // The short name or full Amazon Resource Name (ARN) of the cluster to modify - // the capacity provider settings for. If you don't specify a cluster, the default - // cluster is assumed. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` - - // The capacity provider strategy to use by default for the cluster. - // - // When creating a service or running a task on a cluster, if no capacity provider - // or launch type is specified then the default capacity provider strategy for - // the cluster is used. - // - // A capacity provider strategy consists of one or more capacity providers along - // with the base and weight to assign to them. A capacity provider must be associated - // with the cluster to be used in a capacity provider strategy. The PutClusterCapacityProviders - // API is used to associate a capacity provider with a cluster. Only capacity - // providers with an ACTIVE or UPDATING status can be used. - // - // If specifying a capacity provider that uses an Auto Scaling group, the capacity - // provider must already be created. New capacity providers can be created with - // the CreateCapacityProvider API operation. - // - // To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT - // capacity providers. The Fargate capacity providers are available to all accounts - // and only need to be associated with a cluster to be used. - // - // DefaultCapacityProviderStrategy is a required field - DefaultCapacityProviderStrategy []*CapacityProviderStrategyItem `locationName:"defaultCapacityProviderStrategy" type:"list" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutClusterCapacityProvidersInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutClusterCapacityProvidersInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *PutClusterCapacityProvidersInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "PutClusterCapacityProvidersInput"} - if s.CapacityProviders == nil { - invalidParams.Add(request.NewErrParamRequired("CapacityProviders")) - } - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - if s.DefaultCapacityProviderStrategy == nil { - invalidParams.Add(request.NewErrParamRequired("DefaultCapacityProviderStrategy")) - } - if s.DefaultCapacityProviderStrategy != nil { - for i, v := range s.DefaultCapacityProviderStrategy { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "DefaultCapacityProviderStrategy", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCapacityProviders sets the CapacityProviders field's value. -func (s *PutClusterCapacityProvidersInput) SetCapacityProviders(v []*string) *PutClusterCapacityProvidersInput { - s.CapacityProviders = v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *PutClusterCapacityProvidersInput) SetCluster(v string) *PutClusterCapacityProvidersInput { - s.Cluster = &v - return s -} - -// SetDefaultCapacityProviderStrategy sets the DefaultCapacityProviderStrategy field's value. -func (s *PutClusterCapacityProvidersInput) SetDefaultCapacityProviderStrategy(v []*CapacityProviderStrategyItem) *PutClusterCapacityProvidersInput { - s.DefaultCapacityProviderStrategy = v - return s -} - -type PutClusterCapacityProvidersOutput struct { - _ struct{} `type:"structure"` - - // Details about the cluster. - Cluster *Cluster `locationName:"cluster" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutClusterCapacityProvidersOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s PutClusterCapacityProvidersOutput) GoString() string { - return s.String() -} - -// SetCluster sets the Cluster field's value. -func (s *PutClusterCapacityProvidersOutput) SetCluster(v *Cluster) *PutClusterCapacityProvidersOutput { - s.Cluster = v - return s -} - -type RegisterContainerInstanceInput struct { - _ struct{} `type:"structure"` - - // The container instance attributes that this container instance supports. - Attributes []*Attribute `locationName:"attributes" type:"list"` - - // The short name or full Amazon Resource Name (ARN) of the cluster to register - // your container instance with. If you do not specify a cluster, the default - // cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // The ARN of the container instance (if it was previously registered). - ContainerInstanceArn *string `locationName:"containerInstanceArn" type:"string"` - - // The instance identity document for the EC2 instance to register. This document - // can be found by running the following command from the instance: curl http://169.254.169.254/latest/dynamic/instance-identity/document/ - InstanceIdentityDocument *string `locationName:"instanceIdentityDocument" type:"string"` - - // The instance identity document signature for the EC2 instance to register. - // This signature can be found by running the following command from the instance: - // curl http://169.254.169.254/latest/dynamic/instance-identity/signature/ - InstanceIdentityDocumentSignature *string `locationName:"instanceIdentityDocumentSignature" type:"string"` - - // The devices that are available on the container instance. The only supported - // device type is a GPU. - PlatformDevices []*PlatformDevice `locationName:"platformDevices" type:"list"` - - // The metadata that you apply to the container instance to help you categorize - // and organize them. Each tag consists of a key and an optional value. You - // define both. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The resources available on the instance. - TotalResources []*Resource `locationName:"totalResources" type:"list"` - - // The version information for the Amazon ECS container agent and Docker daemon - // that runs on the container instance. - VersionInfo *VersionInfo `locationName:"versionInfo" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RegisterContainerInstanceInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RegisterContainerInstanceInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *RegisterContainerInstanceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "RegisterContainerInstanceInput"} - if s.Attributes != nil { - for i, v := range s.Attributes { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Attributes", i), err.(request.ErrInvalidParams)) - } - } - } - if s.PlatformDevices != nil { - for i, v := range s.PlatformDevices { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "PlatformDevices", i), err.(request.ErrInvalidParams)) - } - } - } - if s.Tags != nil { - for i, v := range s.Tags { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAttributes sets the Attributes field's value. -func (s *RegisterContainerInstanceInput) SetAttributes(v []*Attribute) *RegisterContainerInstanceInput { - s.Attributes = v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *RegisterContainerInstanceInput) SetCluster(v string) *RegisterContainerInstanceInput { - s.Cluster = &v - return s -} - -// SetContainerInstanceArn sets the ContainerInstanceArn field's value. -func (s *RegisterContainerInstanceInput) SetContainerInstanceArn(v string) *RegisterContainerInstanceInput { - s.ContainerInstanceArn = &v - return s -} - -// SetInstanceIdentityDocument sets the InstanceIdentityDocument field's value. -func (s *RegisterContainerInstanceInput) SetInstanceIdentityDocument(v string) *RegisterContainerInstanceInput { - s.InstanceIdentityDocument = &v - return s -} - -// SetInstanceIdentityDocumentSignature sets the InstanceIdentityDocumentSignature field's value. -func (s *RegisterContainerInstanceInput) SetInstanceIdentityDocumentSignature(v string) *RegisterContainerInstanceInput { - s.InstanceIdentityDocumentSignature = &v - return s -} - -// SetPlatformDevices sets the PlatformDevices field's value. -func (s *RegisterContainerInstanceInput) SetPlatformDevices(v []*PlatformDevice) *RegisterContainerInstanceInput { - s.PlatformDevices = v - return s -} - -// SetTags sets the Tags field's value. -func (s *RegisterContainerInstanceInput) SetTags(v []*Tag) *RegisterContainerInstanceInput { - s.Tags = v - return s -} - -// SetTotalResources sets the TotalResources field's value. -func (s *RegisterContainerInstanceInput) SetTotalResources(v []*Resource) *RegisterContainerInstanceInput { - s.TotalResources = v - return s -} - -// SetVersionInfo sets the VersionInfo field's value. -func (s *RegisterContainerInstanceInput) SetVersionInfo(v *VersionInfo) *RegisterContainerInstanceInput { - s.VersionInfo = v - return s -} - -type RegisterContainerInstanceOutput struct { - _ struct{} `type:"structure"` - - // The container instance that was registered. - ContainerInstance *ContainerInstance `locationName:"containerInstance" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RegisterContainerInstanceOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RegisterContainerInstanceOutput) GoString() string { - return s.String() -} - -// SetContainerInstance sets the ContainerInstance field's value. -func (s *RegisterContainerInstanceOutput) SetContainerInstance(v *ContainerInstance) *RegisterContainerInstanceOutput { - s.ContainerInstance = v - return s -} - -type RegisterTaskDefinitionInput struct { - _ struct{} `type:"structure"` - - // A list of container definitions in JSON format that describe the different - // containers that make up your task. - // - // ContainerDefinitions is a required field - ContainerDefinitions []*ContainerDefinition `locationName:"containerDefinitions" type:"list" required:"true"` - - // The number of CPU units used by the task. It can be expressed as an integer - // using CPU units (for example, 1024) or as a string using vCPUs (for example, - // 1 vCPU or 1 vcpu) in a task definition. String values are converted to an - // integer indicating the CPU units when the task definition is registered. - // - // Task-level CPU and memory parameters are ignored for Windows containers. - // We recommend specifying container-level resources for Windows containers. - // - // If you're using the EC2 launch type, this field is optional. Supported values - // are between 128 CPU units (0.125 vCPUs) and 10240 CPU units (10 vCPUs). If - // you do not specify a value, the parameter is ignored. - // - // If you're using the Fargate launch type, this field is required and you must - // use one of the following values, which determines your range of supported - // values for the memory parameter: - // - // The CPU units cannot be less than 1 vCPU when you use Windows containers - // on Fargate. - // - // * 256 (.25 vCPU) - Available memory values: 512 (0.5 GB), 1024 (1 GB), - // 2048 (2 GB) - // - // * 512 (.5 vCPU) - Available memory values: 1024 (1 GB), 2048 (2 GB), 3072 - // (3 GB), 4096 (4 GB) - // - // * 1024 (1 vCPU) - Available memory values: 2048 (2 GB), 3072 (3 GB), 4096 - // (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - // - // * 2048 (2 vCPU) - Available memory values: 4096 (4 GB) and 16384 (16 GB) - // in increments of 1024 (1 GB) - // - // * 4096 (4 vCPU) - Available memory values: 8192 (8 GB) and 30720 (30 GB) - // in increments of 1024 (1 GB) - // - // * 8192 (8 vCPU) - Available memory values: 16 GB and 60 GB in 4 GB increments - // This option requires Linux platform 1.4.0 or later. - // - // * 16384 (16vCPU) - Available memory values: 32GB and 120 GB in 8 GB increments - // This option requires Linux platform 1.4.0 or later. - Cpu *string `locationName:"cpu" type:"string"` - - // The Amazon Resource Name (ARN) of the task execution role that grants the - // Amazon ECS container agent permission to make Amazon Web Services API calls - // on your behalf. The task execution IAM role is required depending on the - // requirements of your task. For more information, see Amazon ECS task execution - // IAM role (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_execution_IAM_role.html) - // in the Amazon Elastic Container Service Developer Guide. - ExecutionRoleArn *string `locationName:"executionRoleArn" type:"string"` - - // You must specify a family for a task definition. You can use it track multiple - // versions of the same task definition. The family is used as a name for your - // task definition. Up to 255 letters (uppercase and lowercase), numbers, underscores, - // and hyphens are allowed. - // - // Family is a required field - Family *string `locationName:"family" type:"string" required:"true"` - - // The Elastic Inference accelerators to use for the containers in the task. - InferenceAccelerators []*InferenceAccelerator `locationName:"inferenceAccelerators" type:"list"` - - // The IPC resource namespace to use for the containers in the task. The valid - // values are host, task, or none. If host is specified, then all containers - // within the tasks that specified the host IPC mode on the same container instance - // share the same IPC resources with the host Amazon EC2 instance. If task is - // specified, all containers within the specified task share the same IPC resources. - // If none is specified, then IPC resources within the containers of a task - // are private and not shared with other containers in a task or on the container - // instance. If no value is specified, then the IPC resource namespace sharing - // depends on the Docker daemon setting on the container instance. For more - // information, see IPC settings (https://docs.docker.com/engine/reference/run/#ipc-settings---ipc) - // in the Docker run reference. - // - // If the host IPC mode is used, be aware that there is a heightened risk of - // undesired IPC namespace expose. For more information, see Docker security - // (https://docs.docker.com/engine/security/security/). - // - // If you are setting namespaced kernel parameters using systemControls for - // the containers in the task, the following will apply to your IPC resource - // namespace. For more information, see System Controls (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // * For tasks that use the host IPC mode, IPC namespace related systemControls - // are not supported. - // - // * For tasks that use the task IPC mode, IPC namespace related systemControls - // will apply to all containers within a task. - // - // This parameter is not supported for Windows containers or tasks run on Fargate. - IpcMode *string `locationName:"ipcMode" type:"string" enum:"IpcMode"` - - // The amount of memory (in MiB) used by the task. It can be expressed as an - // integer using MiB (for example ,1024) or as a string using GB (for example, - // 1GB or 1 GB) in a task definition. String values are converted to an integer - // indicating the MiB when the task definition is registered. - // - // Task-level CPU and memory parameters are ignored for Windows containers. - // We recommend specifying container-level resources for Windows containers. - // - // If using the EC2 launch type, this field is optional. - // - // If using the Fargate launch type, this field is required and you must use - // one of the following values. This determines your range of supported values - // for the cpu parameter. - // - // The CPU units cannot be less than 1 vCPU when you use Windows containers - // on Fargate. - // - // * 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 - // vCPU) - // - // * 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: - // 512 (.5 vCPU) - // - // * 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 - // (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU) - // - // * Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - - // Available cpu values: 2048 (2 vCPU) - // - // * Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - - // Available cpu values: 4096 (4 vCPU) - // - // * Between 16 GB and 60 GB in 4 GB increments - Available cpu values: 8192 - // (8 vCPU) This option requires Linux platform 1.4.0 or later. - // - // * Between 32GB and 120 GB in 8 GB increments - Available cpu values: 16384 - // (16 vCPU) This option requires Linux platform 1.4.0 or later. - Memory *string `locationName:"memory" type:"string"` - - // The Docker networking mode to use for the containers in the task. The valid - // values are none, bridge, awsvpc, and host. If no network mode is specified, - // the default is bridge. - // - // For Amazon ECS tasks on Fargate, the awsvpc network mode is required. For - // Amazon ECS tasks on Amazon EC2 Linux instances, any network mode can be used. - // For Amazon ECS tasks on Amazon EC2 Windows instances, or awsvpc - // can be used. If the network mode is set to none, you cannot specify port - // mappings in your container definitions, and the tasks containers do not have - // external connectivity. The host and awsvpc network modes offer the highest - // networking performance for containers because they use the EC2 network stack - // instead of the virtualized network stack provided by the bridge mode. - // - // With the host and awsvpc network modes, exposed container ports are mapped - // directly to the corresponding host port (for the host network mode) or the - // attached elastic network interface port (for the awsvpc network mode), so - // you cannot take advantage of dynamic host port mappings. - // - // When using the host network mode, you should not run containers using the - // root user (UID 0). It is considered best practice to use a non-root user. - // - // If the network mode is awsvpc, the task is allocated an elastic network interface, - // and you must specify a NetworkConfiguration value when you create a service - // or run a task with the task definition. For more information, see Task Networking - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // If the network mode is host, you cannot run multiple instantiations of the - // same task on a single container instance when port mappings are used. - // - // For more information, see Network settings (https://docs.docker.com/engine/reference/run/#network-settings) - // in the Docker run reference. - NetworkMode *string `locationName:"networkMode" type:"string" enum:"NetworkMode"` - - // The process namespace to use for the containers in the task. The valid values - // are host or task. On Fargate for Linux containers, the only valid value is - // task. For example, monitoring sidecars might need pidMode to access information - // about other containers running in the same task. - // - // If host is specified, all containers within the tasks that specified the - // host PID mode on the same container instance share the same process namespace - // with the host Amazon EC2 instance. - // - // If task is specified, all containers within the specified task share the - // same process namespace. - // - // If no value is specified, the default is a private namespace for each container. - // For more information, see PID settings (https://docs.docker.com/engine/reference/run/#pid-settings---pid) - // in the Docker run reference. - // - // If the host PID mode is used, there's a heightened risk of undesired process - // namespace exposure. For more information, see Docker security (https://docs.docker.com/engine/security/security/). - // - // This parameter is not supported for Windows containers. - // - // This parameter is only supported for tasks that are hosted on Fargate if - // the tasks are using platform version 1.4.0 or later (Linux). This isn't supported - // for Windows containers on Fargate. - PidMode *string `locationName:"pidMode" type:"string" enum:"PidMode"` - - // An array of placement constraint objects to use for the task. You can specify - // a maximum of 10 constraints for each task. This limit includes constraints - // in the task definition and those specified at runtime. - PlacementConstraints []*TaskDefinitionPlacementConstraint `locationName:"placementConstraints" type:"list"` - - // The configuration details for the App Mesh proxy. - // - // For tasks hosted on Amazon EC2 instances, the container instances require - // at least version 1.26.0 of the container agent and at least version 1.26.0-1 - // of the ecs-init package to use a proxy configuration. If your container instances - // are launched from the Amazon ECS-optimized AMI version 20190301 or later, - // then they contain the required versions of the container agent and ecs-init. - // For more information, see Amazon ECS-optimized AMI versions (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-ami-versions.html) - // in the Amazon Elastic Container Service Developer Guide. - ProxyConfiguration *ProxyConfiguration `locationName:"proxyConfiguration" type:"structure"` - - // The task launch type that Amazon ECS validates the task definition against. - // A client exception is returned if the task definition doesn't validate against - // the compatibilities specified. If no value is specified, the parameter is - // omitted from the response. - RequiresCompatibilities []*string `locationName:"requiresCompatibilities" type:"list" enum:"Compatibility"` - - // The metadata that you apply to the task definition to help you categorize - // and organize them. Each tag consists of a key and an optional value. You - // define both of them. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The short name or full Amazon Resource Name (ARN) of the IAM role that containers - // in this task can assume. All containers in this task are granted the permissions - // that are specified in this role. For more information, see IAM Roles for - // Tasks (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html) - // in the Amazon Elastic Container Service Developer Guide. - TaskRoleArn *string `locationName:"taskRoleArn" type:"string"` - - // A list of volume definitions in JSON format that containers in your task - // might use. - Volumes []*Volume `locationName:"volumes" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RegisterTaskDefinitionInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RegisterTaskDefinitionInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *RegisterTaskDefinitionInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "RegisterTaskDefinitionInput"} - if s.ContainerDefinitions == nil { - invalidParams.Add(request.NewErrParamRequired("ContainerDefinitions")) - } - if s.Family == nil { - invalidParams.Add(request.NewErrParamRequired("Family")) - } - if s.ContainerDefinitions != nil { - for i, v := range s.ContainerDefinitions { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "ContainerDefinitions", i), err.(request.ErrInvalidParams)) - } - } - } - if s.InferenceAccelerators != nil { - for i, v := range s.InferenceAccelerators { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "InferenceAccelerators", i), err.(request.ErrInvalidParams)) - } - } - } - if s.ProxyConfiguration != nil { - if err := s.ProxyConfiguration.Validate(); err != nil { - invalidParams.AddNested("ProxyConfiguration", err.(request.ErrInvalidParams)) - } - } - if s.Tags != nil { - for i, v := range s.Tags { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetContainerDefinitions sets the ContainerDefinitions field's value. -func (s *RegisterTaskDefinitionInput) SetContainerDefinitions(v []*ContainerDefinition) *RegisterTaskDefinitionInput { - s.ContainerDefinitions = v - return s -} - -// SetCpu sets the Cpu field's value. -func (s *RegisterTaskDefinitionInput) SetCpu(v string) *RegisterTaskDefinitionInput { - s.Cpu = &v - return s -} - -// SetExecutionRoleArn sets the ExecutionRoleArn field's value. -func (s *RegisterTaskDefinitionInput) SetExecutionRoleArn(v string) *RegisterTaskDefinitionInput { - s.ExecutionRoleArn = &v - return s -} - -// SetFamily sets the Family field's value. -func (s *RegisterTaskDefinitionInput) SetFamily(v string) *RegisterTaskDefinitionInput { - s.Family = &v - return s -} - -// SetInferenceAccelerators sets the InferenceAccelerators field's value. -func (s *RegisterTaskDefinitionInput) SetInferenceAccelerators(v []*InferenceAccelerator) *RegisterTaskDefinitionInput { - s.InferenceAccelerators = v - return s -} - -// SetIpcMode sets the IpcMode field's value. -func (s *RegisterTaskDefinitionInput) SetIpcMode(v string) *RegisterTaskDefinitionInput { - s.IpcMode = &v - return s -} - -// SetMemory sets the Memory field's value. -func (s *RegisterTaskDefinitionInput) SetMemory(v string) *RegisterTaskDefinitionInput { - s.Memory = &v - return s -} - -// SetNetworkMode sets the NetworkMode field's value. -func (s *RegisterTaskDefinitionInput) SetNetworkMode(v string) *RegisterTaskDefinitionInput { - s.NetworkMode = &v - return s -} - -// SetPidMode sets the PidMode field's value. -func (s *RegisterTaskDefinitionInput) SetPidMode(v string) *RegisterTaskDefinitionInput { - s.PidMode = &v - return s -} - -// SetPlacementConstraints sets the PlacementConstraints field's value. -func (s *RegisterTaskDefinitionInput) SetPlacementConstraints(v []*TaskDefinitionPlacementConstraint) *RegisterTaskDefinitionInput { - s.PlacementConstraints = v - return s -} - -// SetProxyConfiguration sets the ProxyConfiguration field's value. -func (s *RegisterTaskDefinitionInput) SetProxyConfiguration(v *ProxyConfiguration) *RegisterTaskDefinitionInput { - s.ProxyConfiguration = v - return s -} - -// SetRequiresCompatibilities sets the RequiresCompatibilities field's value. -func (s *RegisterTaskDefinitionInput) SetRequiresCompatibilities(v []*string) *RegisterTaskDefinitionInput { - s.RequiresCompatibilities = v - return s -} - -// SetTags sets the Tags field's value. -func (s *RegisterTaskDefinitionInput) SetTags(v []*Tag) *RegisterTaskDefinitionInput { - s.Tags = v - return s -} - -// SetTaskRoleArn sets the TaskRoleArn field's value. -func (s *RegisterTaskDefinitionInput) SetTaskRoleArn(v string) *RegisterTaskDefinitionInput { - s.TaskRoleArn = &v - return s -} - -// SetVolumes sets the Volumes field's value. -func (s *RegisterTaskDefinitionInput) SetVolumes(v []*Volume) *RegisterTaskDefinitionInput { - s.Volumes = v - return s -} - -type RegisterTaskDefinitionOutput struct { - _ struct{} `type:"structure"` - - // The list of tags associated with the task definition. - Tags []*Tag `locationName:"tags" type:"list"` - - // The full description of the registered task definition. - TaskDefinition *TaskDefinition `locationName:"taskDefinition" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RegisterTaskDefinitionOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RegisterTaskDefinitionOutput) GoString() string { - return s.String() -} - -// SetTags sets the Tags field's value. -func (s *RegisterTaskDefinitionOutput) SetTags(v []*Tag) *RegisterTaskDefinitionOutput { - s.Tags = v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *RegisterTaskDefinitionOutput) SetTaskDefinition(v *TaskDefinition) *RegisterTaskDefinitionOutput { - s.TaskDefinition = v - return s -} - -// The repository credentials for private registry authentication. -type RepositoryCredentials struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) of the secret containing the private repository - // credentials. - // - // When you use the Amazon ECS API, CLI, or Amazon Web Services SDK, if the - // secret exists in the same Region as the task that you're launching then you - // can use either the full ARN or the name of the secret. When you use the Amazon - // Web Services Management Console, you must specify the full ARN of the secret. - // - // CredentialsParameter is a required field - CredentialsParameter *string `locationName:"credentialsParameter" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RepositoryCredentials) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RepositoryCredentials) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *RepositoryCredentials) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "RepositoryCredentials"} - if s.CredentialsParameter == nil { - invalidParams.Add(request.NewErrParamRequired("CredentialsParameter")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCredentialsParameter sets the CredentialsParameter field's value. -func (s *RepositoryCredentials) SetCredentialsParameter(v string) *RepositoryCredentials { - s.CredentialsParameter = &v - return s -} - -// Describes the resources available for a container instance. -type Resource struct { - _ struct{} `type:"structure"` - - // When the doubleValue type is set, the value of the resource must be a double - // precision floating-point type. - DoubleValue *float64 `locationName:"doubleValue" type:"double"` - - // When the integerValue type is set, the value of the resource must be an integer. - IntegerValue *int64 `locationName:"integerValue" type:"integer"` - - // When the longValue type is set, the value of the resource must be an extended - // precision floating-point type. - LongValue *int64 `locationName:"longValue" type:"long"` - - // The name of the resource, such as CPU, MEMORY, PORTS, PORTS_UDP, or a user-defined - // resource. - Name *string `locationName:"name" type:"string"` - - // When the stringSetValue type is set, the value of the resource must be a - // string type. - StringSetValue []*string `locationName:"stringSetValue" type:"list"` - - // The type of the resource. Valid values: INTEGER, DOUBLE, LONG, or STRINGSET. - Type *string `locationName:"type" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Resource) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Resource) GoString() string { - return s.String() -} - -// SetDoubleValue sets the DoubleValue field's value. -func (s *Resource) SetDoubleValue(v float64) *Resource { - s.DoubleValue = &v - return s -} - -// SetIntegerValue sets the IntegerValue field's value. -func (s *Resource) SetIntegerValue(v int64) *Resource { - s.IntegerValue = &v - return s -} - -// SetLongValue sets the LongValue field's value. -func (s *Resource) SetLongValue(v int64) *Resource { - s.LongValue = &v - return s -} - -// SetName sets the Name field's value. -func (s *Resource) SetName(v string) *Resource { - s.Name = &v - return s -} - -// SetStringSetValue sets the StringSetValue field's value. -func (s *Resource) SetStringSetValue(v []*string) *Resource { - s.StringSetValue = v - return s -} - -// SetType sets the Type field's value. -func (s *Resource) SetType(v string) *Resource { - s.Type = &v - return s -} - -// The specified resource is in-use and can't be removed. -type ResourceInUseException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ResourceInUseException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ResourceInUseException) GoString() string { - return s.String() -} - -func newErrorResourceInUseException(v protocol.ResponseMetadata) error { - return &ResourceInUseException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ResourceInUseException) Code() string { - return "ResourceInUseException" -} - -// Message returns the exception's message. -func (s *ResourceInUseException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ResourceInUseException) OrigErr() error { - return nil -} - -func (s *ResourceInUseException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ResourceInUseException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ResourceInUseException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The specified resource wasn't found. -type ResourceNotFoundException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ResourceNotFoundException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ResourceNotFoundException) GoString() string { - return s.String() -} - -func newErrorResourceNotFoundException(v protocol.ResponseMetadata) error { - return &ResourceNotFoundException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ResourceNotFoundException) Code() string { - return "ResourceNotFoundException" -} - -// Message returns the exception's message. -func (s *ResourceNotFoundException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ResourceNotFoundException) OrigErr() error { - return nil -} - -func (s *ResourceNotFoundException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ResourceNotFoundException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ResourceNotFoundException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The type and amount of a resource to assign to a container. The supported -// resource types are GPUs and Elastic Inference accelerators. For more information, -// see Working with GPUs on Amazon ECS (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-gpu.html) -// or Working with Amazon Elastic Inference on Amazon ECS (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-inference.html) -// in the Amazon Elastic Container Service Developer Guide -type ResourceRequirement struct { - _ struct{} `type:"structure"` - - // The type of resource to assign to a container. The supported values are GPU - // or InferenceAccelerator. - // - // Type is a required field - Type *string `locationName:"type" type:"string" required:"true" enum:"ResourceType"` - - // The value for the specified resource type. - // - // If the GPU type is used, the value is the number of physical GPUs the Amazon - // ECS container agent reserves for the container. The number of GPUs that's - // reserved for all containers in a task can't exceed the number of available - // GPUs on the container instance that the task is launched on. - // - // If the InferenceAccelerator type is used, the value matches the deviceName - // for an InferenceAccelerator (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_InferenceAccelerator.html) - // specified in a task definition. - // - // Value is a required field - Value *string `locationName:"value" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ResourceRequirement) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ResourceRequirement) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ResourceRequirement) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ResourceRequirement"} - if s.Type == nil { - invalidParams.Add(request.NewErrParamRequired("Type")) - } - if s.Value == nil { - invalidParams.Add(request.NewErrParamRequired("Value")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetType sets the Type field's value. -func (s *ResourceRequirement) SetType(v string) *ResourceRequirement { - s.Type = &v - return s -} - -// SetValue sets the Value field's value. -func (s *ResourceRequirement) SetValue(v string) *ResourceRequirement { - s.Value = &v - return s -} - -type RunTaskInput struct { - _ struct{} `type:"structure"` - - // The capacity provider strategy to use for the task. - // - // If a capacityProviderStrategy is specified, the launchType parameter must - // be omitted. If no capacityProviderStrategy or launchType is specified, the - // defaultCapacityProviderStrategy for the cluster is used. - // - // When you use cluster auto scaling, you must specify capacityProviderStrategy - // and not launchType. - // - // A capacity provider strategy may contain a maximum of 6 capacity providers. - CapacityProviderStrategy []*CapacityProviderStrategyItem `locationName:"capacityProviderStrategy" type:"list"` - - ClientToken *string `locationName:"clientToken" type:"string"` - - // The short name or full Amazon Resource Name (ARN) of the cluster to run your - // task on. If you do not specify a cluster, the default cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // The number of instantiations of the specified task to place on your cluster. - // You can specify up to 10 tasks for each call. - Count *int64 `locationName:"count" type:"integer"` - - // Specifies whether to use Amazon ECS managed tags for the task. For more information, - // see Tagging Your Amazon ECS Resources (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html) - // in the Amazon Elastic Container Service Developer Guide. - EnableECSManagedTags *bool `locationName:"enableECSManagedTags" type:"boolean"` - - // Determines whether to use the execute command functionality for the containers - // in this task. If true, this enables execute command functionality on all - // containers in the task. - // - // If true, then the task definition must have a task role, or you must provide - // one as an override. - EnableExecuteCommand *bool `locationName:"enableExecuteCommand" type:"boolean"` - - // The name of the task group to associate with the task. The default value - // is the family name of the task definition (for example, family:my-family-name). - Group *string `locationName:"group" type:"string"` - - // The infrastructure to run your standalone task on. For more information, - // see Amazon ECS launch types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // The FARGATE launch type runs your tasks on Fargate On-Demand infrastructure. - // - // Fargate Spot infrastructure is available for use but a capacity provider - // strategy must be used. For more information, see Fargate capacity providers - // (https://docs.aws.amazon.com/AmazonECS/latest/userguide/fargate-capacity-providers.html) - // in the Amazon ECS User Guide for Fargate. - // - // The EC2 launch type runs your tasks on Amazon EC2 instances registered to - // your cluster. - // - // The EXTERNAL launch type runs your tasks on your on-premises server or virtual - // machine (VM) capacity registered to your cluster. - // - // A task can use either a launch type or a capacity provider strategy. If a - // launchType is specified, the capacityProviderStrategy parameter must be omitted. - // - // When you use cluster auto scaling, you must specify capacityProviderStrategy - // and not launchType. - LaunchType *string `locationName:"launchType" type:"string" enum:"LaunchType"` - - // The network configuration for the task. This parameter is required for task - // definitions that use the awsvpc network mode to receive their own elastic - // network interface, and it isn't supported for other network modes. For more - // information, see Task networking (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html) - // in the Amazon Elastic Container Service Developer Guide. - NetworkConfiguration *NetworkConfiguration `locationName:"networkConfiguration" type:"structure"` - - Originator *AccountDetail `locationName:"originator" type:"structure"` - - // A list of container overrides in JSON format that specify the name of a container - // in the specified task definition and the overrides it should receive. You - // can override the default command for a container (that's specified in the - // task definition or Docker image) with a command override. You can also override - // existing environment variables (that are specified in the task definition - // or Docker image) on a container or add new environment variables to it with - // an environment override. - // - // A total of 8192 characters are allowed for overrides. This limit includes - // the JSON formatting characters of the override structure. - Overrides *TaskOverride `locationName:"overrides" type:"structure"` - - // An array of placement constraint objects to use for the task. You can specify - // up to 10 constraints for each task (including constraints in the task definition - // and those specified at runtime). - PlacementConstraints []*PlacementConstraint `locationName:"placementConstraints" type:"list"` - - // The placement strategy objects to use for the task. You can specify a maximum - // of 5 strategy rules for each task. - PlacementStrategy []*PlacementStrategy `locationName:"placementStrategy" type:"list"` - - // The platform version the task uses. A platform version is only specified - // for tasks hosted on Fargate. If one isn't specified, the LATEST platform - // version is used. For more information, see Fargate platform versions (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html) - // in the Amazon Elastic Container Service Developer Guide. - PlatformVersion *string `locationName:"platformVersion" type:"string"` - - // Specifies whether to propagate the tags from the task definition to the task. - // If no value is specified, the tags aren't propagated. Tags can only be propagated - // to the task during task creation. To add tags to a task after task creation, - // use the TagResource API action. - // - // An error will be received if you specify the SERVICE option when running - // a task. - PropagateTags *string `locationName:"propagateTags" type:"string" enum:"PropagateTags"` - - // The reference ID to use for the task. The reference ID can have a maximum - // length of 1024 characters. - ReferenceId *string `locationName:"referenceId" type:"string"` - - // An optional tag specified when a task is started. For example, if you automatically - // trigger a task to run a batch process job, you could apply a unique identifier - // for that job to your task with the startedBy parameter. You can then identify - // which tasks belong to that job by filtering the results of a ListTasks call - // with the startedBy value. Up to 36 letters (uppercase and lowercase), numbers, - // hyphens (-), and underscores (_) are allowed. - // - // If a task is started by an Amazon ECS service, then the startedBy parameter - // contains the deployment ID of the service that starts it. - StartedBy *string `locationName:"startedBy" type:"string"` - - // The metadata that you apply to the task to help you categorize and organize - // them. Each tag consists of a key and an optional value, both of which you - // define. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The family and revision (family:revision) or full ARN of the task definition - // to run. If a revision isn't specified, the latest ACTIVE revision is used. - // - // When you create a policy for run-task, you can set the resource to be the - // latest task definition revision, or a specific revision. - // - // The full ARN value must match the value that you specified as the Resource - // of the principal's permissions policy. - // - // When you specify the policy resource as the latest task definition version - // (by setting the Resource in the policy to arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName), - // then set this value to arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName. - // - // When you specify the policy resource as a specific task definition version - // (by setting the Resource in the policy to arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1 - // or arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:*), - // then set this value to arn:aws:ecs:us-east-1:111122223333:task-definition/TaskFamilyName:1. - // - // For more information, see Policy Resources for Amazon ECS (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-resources) - // in the Amazon Elastic Container Service developer Guide. - // - // TaskDefinition is a required field - TaskDefinition *string `locationName:"taskDefinition" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RunTaskInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RunTaskInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *RunTaskInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "RunTaskInput"} - if s.TaskDefinition == nil { - invalidParams.Add(request.NewErrParamRequired("TaskDefinition")) - } - if s.CapacityProviderStrategy != nil { - for i, v := range s.CapacityProviderStrategy { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "CapacityProviderStrategy", i), err.(request.ErrInvalidParams)) - } - } - } - if s.Overrides != nil { - if err := s.Overrides.Validate(); err != nil { - invalidParams.AddNested("Overrides", err.(request.ErrInvalidParams)) - } - } - if s.Tags != nil { - for i, v := range s.Tags { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCapacityProviderStrategy sets the CapacityProviderStrategy field's value. -func (s *RunTaskInput) SetCapacityProviderStrategy(v []*CapacityProviderStrategyItem) *RunTaskInput { - s.CapacityProviderStrategy = v - return s -} - -// SetClientToken sets the ClientToken field's value. -func (s *RunTaskInput) SetClientToken(v string) *RunTaskInput { - s.ClientToken = &v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *RunTaskInput) SetCluster(v string) *RunTaskInput { - s.Cluster = &v - return s -} - -// SetCount sets the Count field's value. -func (s *RunTaskInput) SetCount(v int64) *RunTaskInput { - s.Count = &v - return s -} - -// SetEnableECSManagedTags sets the EnableECSManagedTags field's value. -func (s *RunTaskInput) SetEnableECSManagedTags(v bool) *RunTaskInput { - s.EnableECSManagedTags = &v - return s -} - -// SetEnableExecuteCommand sets the EnableExecuteCommand field's value. -func (s *RunTaskInput) SetEnableExecuteCommand(v bool) *RunTaskInput { - s.EnableExecuteCommand = &v - return s -} - -// SetGroup sets the Group field's value. -func (s *RunTaskInput) SetGroup(v string) *RunTaskInput { - s.Group = &v - return s -} - -// SetLaunchType sets the LaunchType field's value. -func (s *RunTaskInput) SetLaunchType(v string) *RunTaskInput { - s.LaunchType = &v - return s -} - -// SetNetworkConfiguration sets the NetworkConfiguration field's value. -func (s *RunTaskInput) SetNetworkConfiguration(v *NetworkConfiguration) *RunTaskInput { - s.NetworkConfiguration = v - return s -} - -// SetOriginator sets the Originator field's value. -func (s *RunTaskInput) SetOriginator(v *AccountDetail) *RunTaskInput { - s.Originator = v - return s -} - -// SetOverrides sets the Overrides field's value. -func (s *RunTaskInput) SetOverrides(v *TaskOverride) *RunTaskInput { - s.Overrides = v - return s -} - -// SetPlacementConstraints sets the PlacementConstraints field's value. -func (s *RunTaskInput) SetPlacementConstraints(v []*PlacementConstraint) *RunTaskInput { - s.PlacementConstraints = v - return s -} - -// SetPlacementStrategy sets the PlacementStrategy field's value. -func (s *RunTaskInput) SetPlacementStrategy(v []*PlacementStrategy) *RunTaskInput { - s.PlacementStrategy = v - return s -} - -// SetPlatformVersion sets the PlatformVersion field's value. -func (s *RunTaskInput) SetPlatformVersion(v string) *RunTaskInput { - s.PlatformVersion = &v - return s -} - -// SetPropagateTags sets the PropagateTags field's value. -func (s *RunTaskInput) SetPropagateTags(v string) *RunTaskInput { - s.PropagateTags = &v - return s -} - -// SetReferenceId sets the ReferenceId field's value. -func (s *RunTaskInput) SetReferenceId(v string) *RunTaskInput { - s.ReferenceId = &v - return s -} - -// SetStartedBy sets the StartedBy field's value. -func (s *RunTaskInput) SetStartedBy(v string) *RunTaskInput { - s.StartedBy = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *RunTaskInput) SetTags(v []*Tag) *RunTaskInput { - s.Tags = v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *RunTaskInput) SetTaskDefinition(v string) *RunTaskInput { - s.TaskDefinition = &v - return s -} - -type RunTaskOutput struct { - _ struct{} `type:"structure"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` - - // A full description of the tasks that were run. The tasks that were successfully - // placed on your cluster are described here. - Tasks []*Task `locationName:"tasks" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RunTaskOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s RunTaskOutput) GoString() string { - return s.String() -} - -// SetFailures sets the Failures field's value. -func (s *RunTaskOutput) SetFailures(v []*Failure) *RunTaskOutput { - s.Failures = v - return s -} - -// SetTasks sets the Tasks field's value. -func (s *RunTaskOutput) SetTasks(v []*Task) *RunTaskOutput { - s.Tasks = v - return s -} - -// A floating-point percentage of the desired number of tasks to place and keep -// running in the task set. -type Scale struct { - _ struct{} `type:"structure"` - - // The unit of measure for the scale value. - Unit *string `locationName:"unit" type:"string" enum:"ScaleUnit"` - - // The value, specified as a percent total of a service's desiredCount, to scale - // the task set. Accepted values are numbers between 0 and 100. - Value *float64 `locationName:"value" type:"double"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Scale) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Scale) GoString() string { - return s.String() -} - -// SetUnit sets the Unit field's value. -func (s *Scale) SetUnit(v string) *Scale { - s.Unit = &v - return s -} - -// SetValue sets the Value field's value. -func (s *Scale) SetValue(v float64) *Scale { - s.Value = &v - return s -} - -// An object representing the secret to expose to your container. Secrets can -// be exposed to a container in the following ways: -// -// - To inject sensitive data into your containers as environment variables, -// use the secrets container definition parameter. -// -// - To reference sensitive information in the log configuration of a container, -// use the secretOptions container definition parameter. -// -// For more information, see Specifying sensitive data (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data.html) -// in the Amazon Elastic Container Service Developer Guide. -type Secret struct { - _ struct{} `type:"structure"` - - // The name of the secret. - // - // Name is a required field - Name *string `locationName:"name" type:"string" required:"true"` - - // The secret to expose to the container. The supported values are either the - // full ARN of the Secrets Manager secret or the full ARN of the parameter in - // the SSM Parameter Store. - // - // For information about the require Identity and Access Management permissions, - // see Required IAM permissions for Amazon ECS secrets (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data-secrets.html#secrets-iam) - // (for Secrets Manager) or Required IAM permissions for Amazon ECS secrets - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data-parameters.html) - // (for Systems Manager Parameter store) in the Amazon Elastic Container Service - // Developer Guide. - // - // If the SSM Parameter Store parameter exists in the same Region as the task - // you're launching, then you can use either the full ARN or name of the parameter. - // If the parameter exists in a different Region, then the full ARN must be - // specified. - // - // ValueFrom is a required field - ValueFrom *string `locationName:"valueFrom" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Secret) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Secret) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *Secret) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "Secret"} - if s.Name == nil { - invalidParams.Add(request.NewErrParamRequired("Name")) - } - if s.ValueFrom == nil { - invalidParams.Add(request.NewErrParamRequired("ValueFrom")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetName sets the Name field's value. -func (s *Secret) SetName(v string) *Secret { - s.Name = &v - return s -} - -// SetValueFrom sets the ValueFrom field's value. -func (s *Secret) SetValueFrom(v string) *Secret { - s.ValueFrom = &v - return s -} - -// These errors are usually caused by a server issue. -type ServerException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServerException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServerException) GoString() string { - return s.String() -} - -func newErrorServerException(v protocol.ResponseMetadata) error { - return &ServerException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ServerException) Code() string { - return "ServerException" -} - -// Message returns the exception's message. -func (s *ServerException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ServerException) OrigErr() error { - return nil -} - -func (s *ServerException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ServerException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ServerException) RequestID() string { - return s.RespMetadata.RequestID -} - -// Details on a service within a cluster. -type Service struct { - _ struct{} `type:"structure"` - - // The capacity provider strategy the service uses. When using the DescribeServices - // API, this field is omitted if the service was created using a launch type. - CapacityProviderStrategy []*CapacityProviderStrategyItem `locationName:"capacityProviderStrategy" type:"list"` - - // The Amazon Resource Name (ARN) of the cluster that hosts the service. - ClusterArn *string `locationName:"clusterArn" type:"string"` - - // The Unix timestamp for the time when the service was created. - CreatedAt *time.Time `locationName:"createdAt" type:"timestamp"` - - // The principal that created the service. - CreatedBy *string `locationName:"createdBy" type:"string"` - - // Optional deployment parameters that control how many tasks run during the - // deployment and the ordering of stopping and starting tasks. - DeploymentConfiguration *DeploymentConfiguration `locationName:"deploymentConfiguration" type:"structure"` - - // The deployment controller type the service is using. - DeploymentController *DeploymentController `locationName:"deploymentController" type:"structure"` - - // The current state of deployments for the service. - Deployments []*Deployment `locationName:"deployments" type:"list"` - - // The desired number of instantiations of the task definition to keep running - // on the service. This value is specified when the service is created with - // CreateService, and it can be modified with UpdateService. - DesiredCount *int64 `locationName:"desiredCount" type:"integer"` - - // Determines whether to use Amazon ECS managed tags for the tasks in the service. - // For more information, see Tagging Your Amazon ECS Resources (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html) - // in the Amazon Elastic Container Service Developer Guide. - EnableECSManagedTags *bool `locationName:"enableECSManagedTags" type:"boolean"` - - // Determines whether the execute command functionality is turned on for the - // service. If true, the execute command functionality is turned on for all - // containers in tasks as part of the service. - EnableExecuteCommand *bool `locationName:"enableExecuteCommand" type:"boolean"` - - // The event stream for your service. A maximum of 100 of the latest events - // are displayed. - Events []*ServiceEvent `locationName:"events" type:"list"` - - // The period of time, in seconds, that the Amazon ECS service scheduler ignores - // unhealthy Elastic Load Balancing target health checks after a task has first - // started. - HealthCheckGracePeriodSeconds *int64 `locationName:"healthCheckGracePeriodSeconds" type:"integer"` - - // The launch type the service is using. When using the DescribeServices API, - // this field is omitted if the service was created using a capacity provider - // strategy. - LaunchType *string `locationName:"launchType" type:"string" enum:"LaunchType"` - - // A list of Elastic Load Balancing load balancer objects. It contains the load - // balancer name, the container name, and the container port to access from - // the load balancer. The container name is as it appears in a container definition. - LoadBalancers []*LoadBalancer `locationName:"loadBalancers" type:"list"` - - // The VPC subnet and security group configuration for tasks that receive their - // own elastic network interface by using the awsvpc networking mode. - NetworkConfiguration *NetworkConfiguration `locationName:"networkConfiguration" type:"structure"` - - // The number of tasks in the cluster that are in the PENDING state. - PendingCount *int64 `locationName:"pendingCount" type:"integer"` - - // The placement constraints for the tasks in the service. - PlacementConstraints []*PlacementConstraint `locationName:"placementConstraints" type:"list"` - - // The placement strategy that determines how tasks for the service are placed. - PlacementStrategy []*PlacementStrategy `locationName:"placementStrategy" type:"list"` - - // The platform version to run your service on. A platform version is only specified - // for tasks that are hosted on Fargate. If one isn't specified, the LATEST - // platform version is used. For more information, see Fargate Platform Versions - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html) - // in the Amazon Elastic Container Service Developer Guide. - PlatformVersion *string `locationName:"platformVersion" type:"string"` - - // Determines whether to propagate the tags from the task definition or the - // service to the task. If no value is specified, the tags aren't propagated. - PropagateTags *string `locationName:"propagateTags" type:"string" enum:"PropagateTags"` - - // The ARN of the IAM role that's associated with the service. It allows the - // Amazon ECS container agent to register container instances with an Elastic - // Load Balancing load balancer. - RoleArn *string `locationName:"roleArn" type:"string"` - - // The number of tasks in the cluster that are in the RUNNING state. - RunningCount *int64 `locationName:"runningCount" type:"integer"` - - // The scheduling strategy to use for the service. For more information, see - // Services (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html). - // - // There are two service scheduler strategies available. - // - // * REPLICA-The replica scheduling strategy places and maintains the desired - // number of tasks across your cluster. By default, the service scheduler - // spreads tasks across Availability Zones. You can use task placement strategies - // and constraints to customize task placement decisions. - // - // * DAEMON-The daemon scheduling strategy deploys exactly one task on each - // active container instance. This task meets all of the task placement constraints - // that you specify in your cluster. The service scheduler also evaluates - // the task placement constraints for running tasks. It stop tasks that don't - // meet the placement constraints. Fargate tasks don't support the DAEMON - // scheduling strategy. - SchedulingStrategy *string `locationName:"schedulingStrategy" type:"string" enum:"SchedulingStrategy"` - - // The ARN that identifies the service. For more information about the ARN format, - // see Amazon Resource Name (ARN) (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids) - // in the Amazon ECS Developer Guide. - ServiceArn *string `locationName:"serviceArn" type:"string"` - - // The name of your service. Up to 255 letters (uppercase and lowercase), numbers, - // underscores, and hyphens are allowed. Service names must be unique within - // a cluster. However, you can have similarly named services in multiple clusters - // within a Region or across multiple Regions. - ServiceName *string `locationName:"serviceName" type:"string"` - - // The details for the service discovery registries to assign to this service. - // For more information, see Service Discovery (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html). - ServiceRegistries []*ServiceRegistry `locationName:"serviceRegistries" type:"list"` - - // The status of the service. The valid values are ACTIVE, DRAINING, or INACTIVE. - Status *string `locationName:"status" type:"string"` - - // The metadata that you apply to the service to help you categorize and organize - // them. Each tag consists of a key and an optional value. You define bot the - // key and value. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The task definition to use for tasks in the service. This value is specified - // when the service is created with CreateService, and it can be modified with - // UpdateService. - TaskDefinition *string `locationName:"taskDefinition" type:"string"` - - // Information about a set of Amazon ECS tasks in either an CodeDeploy or an - // EXTERNAL deployment. An Amazon ECS task set includes details such as the - // desired number of tasks, how many tasks are running, and whether the task - // set serves production traffic. - TaskSets []*TaskSet `locationName:"taskSets" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Service) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Service) GoString() string { - return s.String() -} - -// SetCapacityProviderStrategy sets the CapacityProviderStrategy field's value. -func (s *Service) SetCapacityProviderStrategy(v []*CapacityProviderStrategyItem) *Service { - s.CapacityProviderStrategy = v - return s -} - -// SetClusterArn sets the ClusterArn field's value. -func (s *Service) SetClusterArn(v string) *Service { - s.ClusterArn = &v - return s -} - -// SetCreatedAt sets the CreatedAt field's value. -func (s *Service) SetCreatedAt(v time.Time) *Service { - s.CreatedAt = &v - return s -} - -// SetCreatedBy sets the CreatedBy field's value. -func (s *Service) SetCreatedBy(v string) *Service { - s.CreatedBy = &v - return s -} - -// SetDeploymentConfiguration sets the DeploymentConfiguration field's value. -func (s *Service) SetDeploymentConfiguration(v *DeploymentConfiguration) *Service { - s.DeploymentConfiguration = v - return s -} - -// SetDeploymentController sets the DeploymentController field's value. -func (s *Service) SetDeploymentController(v *DeploymentController) *Service { - s.DeploymentController = v - return s -} - -// SetDeployments sets the Deployments field's value. -func (s *Service) SetDeployments(v []*Deployment) *Service { - s.Deployments = v - return s -} - -// SetDesiredCount sets the DesiredCount field's value. -func (s *Service) SetDesiredCount(v int64) *Service { - s.DesiredCount = &v - return s -} - -// SetEnableECSManagedTags sets the EnableECSManagedTags field's value. -func (s *Service) SetEnableECSManagedTags(v bool) *Service { - s.EnableECSManagedTags = &v - return s -} - -// SetEnableExecuteCommand sets the EnableExecuteCommand field's value. -func (s *Service) SetEnableExecuteCommand(v bool) *Service { - s.EnableExecuteCommand = &v - return s -} - -// SetEvents sets the Events field's value. -func (s *Service) SetEvents(v []*ServiceEvent) *Service { - s.Events = v - return s -} - -// SetHealthCheckGracePeriodSeconds sets the HealthCheckGracePeriodSeconds field's value. -func (s *Service) SetHealthCheckGracePeriodSeconds(v int64) *Service { - s.HealthCheckGracePeriodSeconds = &v - return s -} - -// SetLaunchType sets the LaunchType field's value. -func (s *Service) SetLaunchType(v string) *Service { - s.LaunchType = &v - return s -} - -// SetLoadBalancers sets the LoadBalancers field's value. -func (s *Service) SetLoadBalancers(v []*LoadBalancer) *Service { - s.LoadBalancers = v - return s -} - -// SetNetworkConfiguration sets the NetworkConfiguration field's value. -func (s *Service) SetNetworkConfiguration(v *NetworkConfiguration) *Service { - s.NetworkConfiguration = v - return s -} - -// SetPendingCount sets the PendingCount field's value. -func (s *Service) SetPendingCount(v int64) *Service { - s.PendingCount = &v - return s -} - -// SetPlacementConstraints sets the PlacementConstraints field's value. -func (s *Service) SetPlacementConstraints(v []*PlacementConstraint) *Service { - s.PlacementConstraints = v - return s -} - -// SetPlacementStrategy sets the PlacementStrategy field's value. -func (s *Service) SetPlacementStrategy(v []*PlacementStrategy) *Service { - s.PlacementStrategy = v - return s -} - -// SetPlatformVersion sets the PlatformVersion field's value. -func (s *Service) SetPlatformVersion(v string) *Service { - s.PlatformVersion = &v - return s -} - -// SetPropagateTags sets the PropagateTags field's value. -func (s *Service) SetPropagateTags(v string) *Service { - s.PropagateTags = &v - return s -} - -// SetRoleArn sets the RoleArn field's value. -func (s *Service) SetRoleArn(v string) *Service { - s.RoleArn = &v - return s -} - -// SetRunningCount sets the RunningCount field's value. -func (s *Service) SetRunningCount(v int64) *Service { - s.RunningCount = &v - return s -} - -// SetSchedulingStrategy sets the SchedulingStrategy field's value. -func (s *Service) SetSchedulingStrategy(v string) *Service { - s.SchedulingStrategy = &v - return s -} - -// SetServiceArn sets the ServiceArn field's value. -func (s *Service) SetServiceArn(v string) *Service { - s.ServiceArn = &v - return s -} - -// SetServiceName sets the ServiceName field's value. -func (s *Service) SetServiceName(v string) *Service { - s.ServiceName = &v - return s -} - -// SetServiceRegistries sets the ServiceRegistries field's value. -func (s *Service) SetServiceRegistries(v []*ServiceRegistry) *Service { - s.ServiceRegistries = v - return s -} - -// SetStatus sets the Status field's value. -func (s *Service) SetStatus(v string) *Service { - s.Status = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *Service) SetTags(v []*Tag) *Service { - s.Tags = v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *Service) SetTaskDefinition(v string) *Service { - s.TaskDefinition = &v - return s -} - -// SetTaskSets sets the TaskSets field's value. -func (s *Service) SetTaskSets(v []*TaskSet) *Service { - s.TaskSets = v - return s -} - -// Each alias ("endpoint") is a fully-qualified name and port number that other -// tasks ("clients") can use to connect to this service. -// -// Each name and port mapping must be unique within the namespace. -// -// Tasks that run in a namespace can use short names to connect to services -// in the namespace. Tasks can connect to services across all of the clusters -// in the namespace. Tasks connect through a managed proxy container that collects -// logs and metrics for increased visibility. Only the tasks that Amazon ECS -// services create are supported with Service Connect. For more information, -// see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) -// in the Amazon Elastic Container Service Developer Guide. -type ServiceConnectClientAlias struct { - _ struct{} `type:"structure"` - - // The dnsName is the name that you use in the applications of client tasks - // to connect to this service. The name must be a valid DNS name but doesn't - // need to be fully-qualified. The name can include up to 127 characters. The - // name can include lowercase letters, numbers, underscores (_), hyphens (-), - // and periods (.). The name can't start with a hyphen. - // - // If this parameter isn't specified, the default value of discoveryName.namespace - // is used. If the discoveryName isn't specified, the port mapping name from - // the task definition is used in portName.namespace. - // - // To avoid changing your applications in client Amazon ECS services, set this - // to the same name that the client application uses by default. For example, - // a few common names are database, db, or the lowercase name of a database, - // such as mysql or redis. For more information, see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - DnsName *string `locationName:"dnsName" type:"string"` - - // The listening port number for the Service Connect proxy. This port is available - // inside of all of the tasks within the same namespace. - // - // To avoid changing your applications in client Amazon ECS services, set this - // to the same port that the client application uses by default. For more information, - // see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // Port is a required field - Port *int64 `locationName:"port" type:"integer" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectClientAlias) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectClientAlias) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ServiceConnectClientAlias) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ServiceConnectClientAlias"} - if s.Port == nil { - invalidParams.Add(request.NewErrParamRequired("Port")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetDnsName sets the DnsName field's value. -func (s *ServiceConnectClientAlias) SetDnsName(v string) *ServiceConnectClientAlias { - s.DnsName = &v - return s -} - -// SetPort sets the Port field's value. -func (s *ServiceConnectClientAlias) SetPort(v int64) *ServiceConnectClientAlias { - s.Port = &v - return s -} - -// The Service Connect configuration of your Amazon ECS service. The configuration -// for this service to discover and connect to services, and be discovered by, -// and connected from, other services within a namespace. -// -// Tasks that run in a namespace can use short names to connect to services -// in the namespace. Tasks can connect to services across all of the clusters -// in the namespace. Tasks connect through a managed proxy container that collects -// logs and metrics for increased visibility. Only the tasks that Amazon ECS -// services create are supported with Service Connect. For more information, -// see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) -// in the Amazon Elastic Container Service Developer Guide. -type ServiceConnectConfiguration struct { - _ struct{} `type:"structure"` - - // Specifies whether to use Service Connect with this service. - // - // Enabled is a required field - Enabled *bool `locationName:"enabled" type:"boolean" required:"true"` - - // The log configuration for the container. This parameter maps to LogConfig - // in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) - // section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) - // and the --log-driver option to docker run (https://docs.docker.com/engine/reference/commandline/run/). - // - // By default, containers use the same logging driver that the Docker daemon - // uses. However, the container might use a different logging driver than the - // Docker daemon by specifying a log driver configuration in the container definition. - // For more information about the options for different supported log drivers, - // see Configure logging drivers (https://docs.docker.com/engine/admin/logging/overview/) - // in the Docker documentation. - // - // Understand the following when specifying a log configuration for your containers. - // - // * Amazon ECS currently supports a subset of the logging drivers available - // to the Docker daemon. Additional log drivers may be available in future - // releases of the Amazon ECS container agent. For tasks on Fargate, the - // supported log drivers are awslogs, splunk, and awsfirelens. For tasks - // hosted on Amazon EC2 instances, the supported log drivers are awslogs, - // fluentd, gelf, json-file, journald, logentries,syslog, splunk, and awsfirelens. - // - // * This parameter requires version 1.18 of the Docker Remote API or greater - // on your container instance. - // - // * For tasks that are hosted on Amazon EC2 instances, the Amazon ECS container - // agent must register the available logging drivers with the ECS_AVAILABLE_LOGGING_DRIVERS - // environment variable before containers placed on that instance can use - // these log configuration options. For more information, see Amazon ECS - // container agent configuration (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // * For tasks that are on Fargate, because you don't have access to the - // underlying infrastructure your tasks are hosted on, any additional software - // needed must be installed outside of the task. For example, the Fluentd - // output aggregators or a remote host running Logstash to send Gelf logs - // to. - LogConfiguration *LogConfiguration `locationName:"logConfiguration" type:"structure"` - - // The namespace name or full Amazon Resource Name (ARN) of the Cloud Map namespace - // for use with Service Connect. The namespace must be in the same Amazon Web - // Services Region as the Amazon ECS service and cluster. The type of namespace - // doesn't affect Service Connect. For more information about Cloud Map, see - // Working with Services (https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) - // in the Cloud Map Developer Guide. - Namespace *string `locationName:"namespace" type:"string"` - - // The list of Service Connect service objects. These are names and aliases - // (also known as endpoints) that are used by other Amazon ECS services to connect - // to this service. - // - // This field is not required for a "client" Amazon ECS service that's a member - // of a namespace only to connect to other services within the namespace. An - // example of this would be a frontend application that accepts incoming requests - // from either a load balancer that's attached to the service or by other means. - // - // An object selects a port from the task definition, assigns a name for the - // Cloud Map service, and a list of aliases (endpoints) and ports for client - // applications to refer to this service. - Services []*ServiceConnectService `locationName:"services" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectConfiguration) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ServiceConnectConfiguration) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ServiceConnectConfiguration"} - if s.Enabled == nil { - invalidParams.Add(request.NewErrParamRequired("Enabled")) - } - if s.LogConfiguration != nil { - if err := s.LogConfiguration.Validate(); err != nil { - invalidParams.AddNested("LogConfiguration", err.(request.ErrInvalidParams)) - } - } - if s.Services != nil { - for i, v := range s.Services { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Services", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetEnabled sets the Enabled field's value. -func (s *ServiceConnectConfiguration) SetEnabled(v bool) *ServiceConnectConfiguration { - s.Enabled = &v - return s -} - -// SetLogConfiguration sets the LogConfiguration field's value. -func (s *ServiceConnectConfiguration) SetLogConfiguration(v *LogConfiguration) *ServiceConnectConfiguration { - s.LogConfiguration = v - return s -} - -// SetNamespace sets the Namespace field's value. -func (s *ServiceConnectConfiguration) SetNamespace(v string) *ServiceConnectConfiguration { - s.Namespace = &v - return s -} - -// SetServices sets the Services field's value. -func (s *ServiceConnectConfiguration) SetServices(v []*ServiceConnectService) *ServiceConnectConfiguration { - s.Services = v - return s -} - -// The Service Connect service object configuration. For more information, see -// Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) -// in the Amazon Elastic Container Service Developer Guide. -type ServiceConnectService struct { - _ struct{} `type:"structure"` - - // The list of client aliases for this Service Connect service. You use these - // to assign names that can be used by client applications. The maximum number - // of client aliases that you can have in this list is 1. - // - // Each alias ("endpoint") is a fully-qualified name and port number that other - // Amazon ECS tasks ("clients") can use to connect to this service. - // - // Each name and port mapping must be unique within the namespace. - // - // For each ServiceConnectService, you must provide at least one clientAlias - // with one port. - ClientAliases []*ServiceConnectClientAlias `locationName:"clientAliases" type:"list"` - - // The discoveryName is the name of the new Cloud Map service that Amazon ECS - // creates for this Amazon ECS service. This must be unique within the Cloud - // Map namespace. The name can contain up to 64 characters. The name can include - // lowercase letters, numbers, underscores (_), and hyphens (-). The name can't - // start with a hyphen. - // - // If the discoveryName isn't specified, the port mapping name from the task - // definition is used in portName.namespace. - DiscoveryName *string `locationName:"discoveryName" type:"string"` - - // The port number for the Service Connect proxy to listen on. - // - // Use the value of this field to bypass the proxy for traffic on the port number - // specified in the named portMapping in the task definition of this application, - // and then use it in your VPC security groups to allow traffic into the proxy - // for this Amazon ECS service. - // - // In awsvpc mode and Fargate, the default value is the container port number. - // The container port number is in the portMapping in the task definition. In - // bridge mode, the default value is the ephemeral port of the Service Connect - // proxy. - IngressPortOverride *int64 `locationName:"ingressPortOverride" type:"integer"` - - // The portName must match the name of one of the portMappings from all the - // containers in the task definition of this Amazon ECS service. - // - // PortName is a required field - PortName *string `locationName:"portName" type:"string" required:"true"` - - Tls *ServiceConnectTlsConfiguration `locationName:"tls" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectService) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectService) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ServiceConnectService) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ServiceConnectService"} - if s.PortName == nil { - invalidParams.Add(request.NewErrParamRequired("PortName")) - } - if s.ClientAliases != nil { - for i, v := range s.ClientAliases { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "ClientAliases", i), err.(request.ErrInvalidParams)) - } - } - } - if s.Tls != nil { - if err := s.Tls.Validate(); err != nil { - invalidParams.AddNested("Tls", err.(request.ErrInvalidParams)) - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetClientAliases sets the ClientAliases field's value. -func (s *ServiceConnectService) SetClientAliases(v []*ServiceConnectClientAlias) *ServiceConnectService { - s.ClientAliases = v - return s -} - -// SetDiscoveryName sets the DiscoveryName field's value. -func (s *ServiceConnectService) SetDiscoveryName(v string) *ServiceConnectService { - s.DiscoveryName = &v - return s -} - -// SetIngressPortOverride sets the IngressPortOverride field's value. -func (s *ServiceConnectService) SetIngressPortOverride(v int64) *ServiceConnectService { - s.IngressPortOverride = &v - return s -} - -// SetPortName sets the PortName field's value. -func (s *ServiceConnectService) SetPortName(v string) *ServiceConnectService { - s.PortName = &v - return s -} - -// SetTls sets the Tls field's value. -func (s *ServiceConnectService) SetTls(v *ServiceConnectTlsConfiguration) *ServiceConnectService { - s.Tls = v - return s -} - -// The Service Connect resource. Each configuration maps a discovery name to -// a Cloud Map service name. The data is stored in Cloud Map as part of the -// Service Connect configuration for each discovery name of this Amazon ECS -// service. -// -// A task can resolve the dnsName for each of the clientAliases of a service. -// However a task can't resolve the discovery names. If you want to connect -// to a service, refer to the ServiceConnectConfiguration of that service for -// the list of clientAliases that you can use. -type ServiceConnectServiceResource struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) for the namespace in Cloud Map that matches - // the discovery name for this Service Connect resource. You can use this ARN - // in other integrations with Cloud Map. However, Service Connect can't ensure - // connectivity outside of Amazon ECS. - DiscoveryArn *string `locationName:"discoveryArn" type:"string"` - - // The discovery name of this Service Connect resource. - // - // The discoveryName is the name of the new Cloud Map service that Amazon ECS - // creates for this Amazon ECS service. This must be unique within the Cloud - // Map namespace. The name can contain up to 64 characters. The name can include - // lowercase letters, numbers, underscores (_), and hyphens (-). The name can't - // start with a hyphen. - // - // If the discoveryName isn't specified, the port mapping name from the task - // definition is used in portName.namespace. - DiscoveryName *string `locationName:"discoveryName" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectServiceResource) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectServiceResource) GoString() string { - return s.String() -} - -// SetDiscoveryArn sets the DiscoveryArn field's value. -func (s *ServiceConnectServiceResource) SetDiscoveryArn(v string) *ServiceConnectServiceResource { - s.DiscoveryArn = &v - return s -} - -// SetDiscoveryName sets the DiscoveryName field's value. -func (s *ServiceConnectServiceResource) SetDiscoveryName(v string) *ServiceConnectServiceResource { - s.DiscoveryName = &v - return s -} - -type ServiceConnectTlsCertificateAuthority struct { - _ struct{} `type:"structure"` - - AwsPcaAuthorityArn *string `locationName:"awsPcaAuthorityArn" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectTlsCertificateAuthority) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectTlsCertificateAuthority) GoString() string { - return s.String() -} - -// SetAwsPcaAuthorityArn sets the AwsPcaAuthorityArn field's value. -func (s *ServiceConnectTlsCertificateAuthority) SetAwsPcaAuthorityArn(v string) *ServiceConnectTlsCertificateAuthority { - s.AwsPcaAuthorityArn = &v - return s -} - -type ServiceConnectTlsConfiguration struct { - _ struct{} `type:"structure"` - - // IssuerCertificateAuthority is a required field - IssuerCertificateAuthority *ServiceConnectTlsCertificateAuthority `locationName:"issuerCertificateAuthority" type:"structure" required:"true"` - - KmsKey *string `locationName:"kmsKey" type:"string"` - - RoleArn *string `locationName:"roleArn" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectTlsConfiguration) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceConnectTlsConfiguration) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *ServiceConnectTlsConfiguration) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "ServiceConnectTlsConfiguration"} - if s.IssuerCertificateAuthority == nil { - invalidParams.Add(request.NewErrParamRequired("IssuerCertificateAuthority")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetIssuerCertificateAuthority sets the IssuerCertificateAuthority field's value. -func (s *ServiceConnectTlsConfiguration) SetIssuerCertificateAuthority(v *ServiceConnectTlsCertificateAuthority) *ServiceConnectTlsConfiguration { - s.IssuerCertificateAuthority = v - return s -} - -// SetKmsKey sets the KmsKey field's value. -func (s *ServiceConnectTlsConfiguration) SetKmsKey(v string) *ServiceConnectTlsConfiguration { - s.KmsKey = &v - return s -} - -// SetRoleArn sets the RoleArn field's value. -func (s *ServiceConnectTlsConfiguration) SetRoleArn(v string) *ServiceConnectTlsConfiguration { - s.RoleArn = &v - return s -} - -// The details for an event that's associated with a service. -type ServiceEvent struct { - _ struct{} `type:"structure"` - - // The Unix timestamp for the time when the event was triggered. - CreatedAt *time.Time `locationName:"createdAt" type:"timestamp"` - - // The ID string for the event. - Id *string `locationName:"id" type:"string"` - - // The event message. - Message *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceEvent) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceEvent) GoString() string { - return s.String() -} - -// SetCreatedAt sets the CreatedAt field's value. -func (s *ServiceEvent) SetCreatedAt(v time.Time) *ServiceEvent { - s.CreatedAt = &v - return s -} - -// SetId sets the Id field's value. -func (s *ServiceEvent) SetId(v string) *ServiceEvent { - s.Id = &v - return s -} - -// SetMessage sets the Message field's value. -func (s *ServiceEvent) SetMessage(v string) *ServiceEvent { - s.Message = &v - return s -} - -// The specified service isn't active. You can't update a service that's inactive. -// If you have previously deleted a service, you can re-create it with CreateService. -type ServiceNotActiveException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceNotActiveException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceNotActiveException) GoString() string { - return s.String() -} - -func newErrorServiceNotActiveException(v protocol.ResponseMetadata) error { - return &ServiceNotActiveException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ServiceNotActiveException) Code() string { - return "ServiceNotActiveException" -} - -// Message returns the exception's message. -func (s *ServiceNotActiveException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ServiceNotActiveException) OrigErr() error { - return nil -} - -func (s *ServiceNotActiveException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ServiceNotActiveException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ServiceNotActiveException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The specified service wasn't found. You can view your available services -// with ListServices. Amazon ECS services are cluster specific and Region specific. -type ServiceNotFoundException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceNotFoundException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceNotFoundException) GoString() string { - return s.String() -} - -func newErrorServiceNotFoundException(v protocol.ResponseMetadata) error { - return &ServiceNotFoundException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *ServiceNotFoundException) Code() string { - return "ServiceNotFoundException" -} - -// Message returns the exception's message. -func (s *ServiceNotFoundException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *ServiceNotFoundException) OrigErr() error { - return nil -} - -func (s *ServiceNotFoundException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *ServiceNotFoundException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *ServiceNotFoundException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The details for the service registry. -// -// Each service may be associated with one service registry. Multiple service -// registries for each service are not supported. -// -// When you add, update, or remove the service registries configuration, Amazon -// ECS starts a new deployment. New tasks are registered and deregistered to -// the updated service registry configuration. -type ServiceRegistry struct { - _ struct{} `type:"structure"` - - // The container name value to be used for your service discovery service. It's - // already specified in the task definition. If the task definition that your - // service task specifies uses the bridge or host network mode, you must specify - // a containerName and containerPort combination from the task definition. If - // the task definition that your service task specifies uses the awsvpc network - // mode and a type SRV DNS record is used, you must specify either a containerName - // and containerPort combination or a port value. However, you can't specify - // both. - ContainerName *string `locationName:"containerName" type:"string"` - - // The port value to be used for your service discovery service. It's already - // specified in the task definition. If the task definition your service task - // specifies uses the bridge or host network mode, you must specify a containerName - // and containerPort combination from the task definition. If the task definition - // your service task specifies uses the awsvpc network mode and a type SRV DNS - // record is used, you must specify either a containerName and containerPort - // combination or a port value. However, you can't specify both. - ContainerPort *int64 `locationName:"containerPort" type:"integer"` - - // The port value used if your service discovery service specified an SRV record. - // This field might be used if both the awsvpc network mode and SRV records - // are used. - Port *int64 `locationName:"port" type:"integer"` - - // The Amazon Resource Name (ARN) of the service registry. The currently supported - // service registry is Cloud Map. For more information, see CreateService (https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html). - RegistryArn *string `locationName:"registryArn" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceRegistry) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s ServiceRegistry) GoString() string { - return s.String() -} - -// SetContainerName sets the ContainerName field's value. -func (s *ServiceRegistry) SetContainerName(v string) *ServiceRegistry { - s.ContainerName = &v - return s -} - -// SetContainerPort sets the ContainerPort field's value. -func (s *ServiceRegistry) SetContainerPort(v int64) *ServiceRegistry { - s.ContainerPort = &v - return s -} - -// SetPort sets the Port field's value. -func (s *ServiceRegistry) SetPort(v int64) *ServiceRegistry { - s.Port = &v - return s -} - -// SetRegistryArn sets the RegistryArn field's value. -func (s *ServiceRegistry) SetRegistryArn(v string) *ServiceRegistry { - s.RegistryArn = &v - return s -} - -// The details for the execute command session. -type Session struct { - _ struct{} `type:"structure"` - - // The ID of the execute command session. - SessionId *string `locationName:"sessionId" type:"string"` - - // A URL to the managed agent on the container that the SSM Session Manager - // client uses to send commands and receive output from the container. - StreamUrl *string `locationName:"streamUrl" type:"string"` - - // An encrypted token value containing session and caller information. It's - // used to authenticate the connection to the container. - // - // TokenValue is a sensitive parameter and its value will be - // replaced with "sensitive" in string returned by Session's - // String and GoString methods. - TokenValue *string `locationName:"tokenValue" type:"string" sensitive:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Session) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Session) GoString() string { - return s.String() -} - -// SetSessionId sets the SessionId field's value. -func (s *Session) SetSessionId(v string) *Session { - s.SessionId = &v - return s -} - -// SetStreamUrl sets the StreamUrl field's value. -func (s *Session) SetStreamUrl(v string) *Session { - s.StreamUrl = &v - return s -} - -// SetTokenValue sets the TokenValue field's value. -func (s *Session) SetTokenValue(v string) *Session { - s.TokenValue = &v - return s -} - -// The current account setting for a resource. -type Setting struct { - _ struct{} `type:"structure"` - - // The Amazon ECS resource name. - Name *string `locationName:"name" type:"string" enum:"SettingName"` - - // The ARN of the principal. It can be a user, role, or the root user. If this - // field is omitted, the authenticated user is assumed. - PrincipalArn *string `locationName:"principalArn" type:"string"` - - // Determines whether the account setting is on or off for the specified resource. - Value *string `locationName:"value" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Setting) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Setting) GoString() string { - return s.String() -} - -// SetName sets the Name field's value. -func (s *Setting) SetName(v string) *Setting { - s.Name = &v - return s -} - -// SetPrincipalArn sets the PrincipalArn field's value. -func (s *Setting) SetPrincipalArn(v string) *Setting { - s.PrincipalArn = &v - return s -} - -// SetValue sets the Value field's value. -func (s *Setting) SetValue(v string) *Setting { - s.Value = &v - return s -} - -type StartTaskInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster where to - // start your task. If you do not specify a cluster, the default cluster is - // assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // The container instance IDs or full ARN entries for the container instances - // where you would like to place your task. You can specify up to 10 container - // instances. - // - // ContainerInstances is a required field - ContainerInstances []*string `locationName:"containerInstances" type:"list" required:"true"` - - // Specifies whether to use Amazon ECS managed tags for the task. For more information, - // see Tagging Your Amazon ECS Resources (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html) - // in the Amazon Elastic Container Service Developer Guide. - EnableECSManagedTags *bool `locationName:"enableECSManagedTags" type:"boolean"` - - // Whether or not the execute command functionality is turned on for the task. - // If true, this turns on the execute command functionality on all containers - // in the task. - EnableExecuteCommand *bool `locationName:"enableExecuteCommand" type:"boolean"` - - // The name of the task group to associate with the task. The default value - // is the family name of the task definition (for example, family:my-family-name). - Group *string `locationName:"group" type:"string"` - - // The VPC subnet and security group configuration for tasks that receive their - // own elastic network interface by using the awsvpc networking mode. - NetworkConfiguration *NetworkConfiguration `locationName:"networkConfiguration" type:"structure"` - - // A list of container overrides in JSON format that specify the name of a container - // in the specified task definition and the overrides it receives. You can override - // the default command for a container (that's specified in the task definition - // or Docker image) with a command override. You can also override existing - // environment variables (that are specified in the task definition or Docker - // image) on a container or add new environment variables to it with an environment - // override. - // - // A total of 8192 characters are allowed for overrides. This limit includes - // the JSON formatting characters of the override structure. - Overrides *TaskOverride `locationName:"overrides" type:"structure"` - - // Specifies whether to propagate the tags from the task definition or the service - // to the task. If no value is specified, the tags aren't propagated. - PropagateTags *string `locationName:"propagateTags" type:"string" enum:"PropagateTags"` - - // The reference ID to use for the task. - ReferenceId *string `locationName:"referenceId" type:"string"` - - // An optional tag specified when a task is started. For example, if you automatically - // trigger a task to run a batch process job, you could apply a unique identifier - // for that job to your task with the startedBy parameter. You can then identify - // which tasks belong to that job by filtering the results of a ListTasks call - // with the startedBy value. Up to 36 letters (uppercase and lowercase), numbers, - // hyphens (-), and underscores (_) are allowed. - // - // If a task is started by an Amazon ECS service, the startedBy parameter contains - // the deployment ID of the service that starts it. - StartedBy *string `locationName:"startedBy" type:"string"` - - // The metadata that you apply to the task to help you categorize and organize - // them. Each tag consists of a key and an optional value, both of which you - // define. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The family and revision (family:revision) or full ARN of the task definition - // to start. If a revision isn't specified, the latest ACTIVE revision is used. - // - // TaskDefinition is a required field - TaskDefinition *string `locationName:"taskDefinition" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s StartTaskInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s StartTaskInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *StartTaskInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "StartTaskInput"} - if s.ContainerInstances == nil { - invalidParams.Add(request.NewErrParamRequired("ContainerInstances")) - } - if s.TaskDefinition == nil { - invalidParams.Add(request.NewErrParamRequired("TaskDefinition")) - } - if s.Overrides != nil { - if err := s.Overrides.Validate(); err != nil { - invalidParams.AddNested("Overrides", err.(request.ErrInvalidParams)) - } - } - if s.Tags != nil { - for i, v := range s.Tags { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *StartTaskInput) SetCluster(v string) *StartTaskInput { - s.Cluster = &v - return s -} - -// SetContainerInstances sets the ContainerInstances field's value. -func (s *StartTaskInput) SetContainerInstances(v []*string) *StartTaskInput { - s.ContainerInstances = v - return s -} - -// SetEnableECSManagedTags sets the EnableECSManagedTags field's value. -func (s *StartTaskInput) SetEnableECSManagedTags(v bool) *StartTaskInput { - s.EnableECSManagedTags = &v - return s -} - -// SetEnableExecuteCommand sets the EnableExecuteCommand field's value. -func (s *StartTaskInput) SetEnableExecuteCommand(v bool) *StartTaskInput { - s.EnableExecuteCommand = &v - return s -} - -// SetGroup sets the Group field's value. -func (s *StartTaskInput) SetGroup(v string) *StartTaskInput { - s.Group = &v - return s -} - -// SetNetworkConfiguration sets the NetworkConfiguration field's value. -func (s *StartTaskInput) SetNetworkConfiguration(v *NetworkConfiguration) *StartTaskInput { - s.NetworkConfiguration = v - return s -} - -// SetOverrides sets the Overrides field's value. -func (s *StartTaskInput) SetOverrides(v *TaskOverride) *StartTaskInput { - s.Overrides = v - return s -} - -// SetPropagateTags sets the PropagateTags field's value. -func (s *StartTaskInput) SetPropagateTags(v string) *StartTaskInput { - s.PropagateTags = &v - return s -} - -// SetReferenceId sets the ReferenceId field's value. -func (s *StartTaskInput) SetReferenceId(v string) *StartTaskInput { - s.ReferenceId = &v - return s -} - -// SetStartedBy sets the StartedBy field's value. -func (s *StartTaskInput) SetStartedBy(v string) *StartTaskInput { - s.StartedBy = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *StartTaskInput) SetTags(v []*Tag) *StartTaskInput { - s.Tags = v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *StartTaskInput) SetTaskDefinition(v string) *StartTaskInput { - s.TaskDefinition = &v - return s -} - -type StartTaskOutput struct { - _ struct{} `type:"structure"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` - - // A full description of the tasks that were started. Each task that was successfully - // placed on your container instances is described. - Tasks []*Task `locationName:"tasks" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s StartTaskOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s StartTaskOutput) GoString() string { - return s.String() -} - -// SetFailures sets the Failures field's value. -func (s *StartTaskOutput) SetFailures(v []*Failure) *StartTaskOutput { - s.Failures = v - return s -} - -// SetTasks sets the Tasks field's value. -func (s *StartTaskOutput) SetTasks(v []*Task) *StartTaskOutput { - s.Tasks = v - return s -} - -type StopTaskInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the task to stop. If you do not specify a cluster, the default cluster is - // assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // An optional message specified when a task is stopped. For example, if you're - // using a custom scheduler, you can use this parameter to specify the reason - // for stopping the task here, and the message appears in subsequent DescribeTasks - // API operations on this task. Up to 255 characters are allowed in this message. - Reason *string `locationName:"reason" type:"string"` - - // The task ID of the task to stop. - // - // Task is a required field - Task *string `locationName:"task" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s StopTaskInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s StopTaskInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *StopTaskInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "StopTaskInput"} - if s.Task == nil { - invalidParams.Add(request.NewErrParamRequired("Task")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *StopTaskInput) SetCluster(v string) *StopTaskInput { - s.Cluster = &v - return s -} - -// SetReason sets the Reason field's value. -func (s *StopTaskInput) SetReason(v string) *StopTaskInput { - s.Reason = &v - return s -} - -// SetTask sets the Task field's value. -func (s *StopTaskInput) SetTask(v string) *StopTaskInput { - s.Task = &v - return s -} - -type StopTaskOutput struct { - _ struct{} `type:"structure"` - - // The task that was stopped. - Task *Task `locationName:"task" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s StopTaskOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s StopTaskOutput) GoString() string { - return s.String() -} - -// SetTask sets the Task field's value. -func (s *StopTaskOutput) SetTask(v *Task) *StopTaskOutput { - s.Task = v - return s -} - -type SubmitAttachmentStateChangesInput struct { - _ struct{} `type:"structure"` - - // Any attachments associated with the state change request. - // - // Attachments is a required field - Attachments []*AttachmentStateChange `locationName:"attachments" type:"list" required:"true"` - - // The short name or full ARN of the cluster that hosts the container instance - // the attachment belongs to. - Cluster *string `locationName:"cluster" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitAttachmentStateChangesInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitAttachmentStateChangesInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *SubmitAttachmentStateChangesInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "SubmitAttachmentStateChangesInput"} - if s.Attachments == nil { - invalidParams.Add(request.NewErrParamRequired("Attachments")) - } - if s.Attachments != nil { - for i, v := range s.Attachments { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Attachments", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAttachments sets the Attachments field's value. -func (s *SubmitAttachmentStateChangesInput) SetAttachments(v []*AttachmentStateChange) *SubmitAttachmentStateChangesInput { - s.Attachments = v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *SubmitAttachmentStateChangesInput) SetCluster(v string) *SubmitAttachmentStateChangesInput { - s.Cluster = &v - return s -} - -type SubmitAttachmentStateChangesOutput struct { - _ struct{} `type:"structure"` - - // Acknowledgement of the state change. - Acknowledgment *string `locationName:"acknowledgment" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitAttachmentStateChangesOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitAttachmentStateChangesOutput) GoString() string { - return s.String() -} - -// SetAcknowledgment sets the Acknowledgment field's value. -func (s *SubmitAttachmentStateChangesOutput) SetAcknowledgment(v string) *SubmitAttachmentStateChangesOutput { - s.Acknowledgment = &v - return s -} - -type SubmitContainerStateChangeInput struct { - _ struct{} `type:"structure"` - - // The short name or full ARN of the cluster that hosts the container. - Cluster *string `locationName:"cluster" type:"string"` - - // The name of the container. - ContainerName *string `locationName:"containerName" type:"string"` - - // The exit code that's returned for the state change request. - ExitCode *int64 `locationName:"exitCode" type:"integer"` - - // The network bindings of the container. - NetworkBindings []*NetworkBinding `locationName:"networkBindings" type:"list"` - - // The reason for the state change request. - Reason *string `locationName:"reason" type:"string"` - - // The ID of the Docker container. - RuntimeId *string `locationName:"runtimeId" type:"string"` - - // The status of the state change request. - Status *string `locationName:"status" type:"string"` - - // The task ID or full Amazon Resource Name (ARN) of the task that hosts the - // container. - Task *string `locationName:"task" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitContainerStateChangeInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitContainerStateChangeInput) GoString() string { - return s.String() -} - -// SetCluster sets the Cluster field's value. -func (s *SubmitContainerStateChangeInput) SetCluster(v string) *SubmitContainerStateChangeInput { - s.Cluster = &v - return s -} - -// SetContainerName sets the ContainerName field's value. -func (s *SubmitContainerStateChangeInput) SetContainerName(v string) *SubmitContainerStateChangeInput { - s.ContainerName = &v - return s -} - -// SetExitCode sets the ExitCode field's value. -func (s *SubmitContainerStateChangeInput) SetExitCode(v int64) *SubmitContainerStateChangeInput { - s.ExitCode = &v - return s -} - -// SetNetworkBindings sets the NetworkBindings field's value. -func (s *SubmitContainerStateChangeInput) SetNetworkBindings(v []*NetworkBinding) *SubmitContainerStateChangeInput { - s.NetworkBindings = v - return s -} - -// SetReason sets the Reason field's value. -func (s *SubmitContainerStateChangeInput) SetReason(v string) *SubmitContainerStateChangeInput { - s.Reason = &v - return s -} - -// SetRuntimeId sets the RuntimeId field's value. -func (s *SubmitContainerStateChangeInput) SetRuntimeId(v string) *SubmitContainerStateChangeInput { - s.RuntimeId = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *SubmitContainerStateChangeInput) SetStatus(v string) *SubmitContainerStateChangeInput { - s.Status = &v - return s -} - -// SetTask sets the Task field's value. -func (s *SubmitContainerStateChangeInput) SetTask(v string) *SubmitContainerStateChangeInput { - s.Task = &v - return s -} - -type SubmitContainerStateChangeOutput struct { - _ struct{} `type:"structure"` - - // Acknowledgement of the state change. - Acknowledgment *string `locationName:"acknowledgment" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitContainerStateChangeOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitContainerStateChangeOutput) GoString() string { - return s.String() -} - -// SetAcknowledgment sets the Acknowledgment field's value. -func (s *SubmitContainerStateChangeOutput) SetAcknowledgment(v string) *SubmitContainerStateChangeOutput { - s.Acknowledgment = &v - return s -} - -type SubmitTaskStateChangeInput struct { - _ struct{} `type:"structure"` - - // Any attachments associated with the state change request. - Attachments []*AttachmentStateChange `locationName:"attachments" type:"list"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the task. - Cluster *string `locationName:"cluster" type:"string"` - - // Any containers that's associated with the state change request. - Containers []*ContainerStateChange `locationName:"containers" type:"list"` - - // The Unix timestamp for the time when the task execution stopped. - ExecutionStoppedAt *time.Time `locationName:"executionStoppedAt" type:"timestamp"` - - // The details for the managed agent that's associated with the task. - ManagedAgents []*ManagedAgentStateChange `locationName:"managedAgents" type:"list"` - - // The Unix timestamp for the time when the container image pull started. - PullStartedAt *time.Time `locationName:"pullStartedAt" type:"timestamp"` - - // The Unix timestamp for the time when the container image pull completed. - PullStoppedAt *time.Time `locationName:"pullStoppedAt" type:"timestamp"` - - // The reason for the state change request. - Reason *string `locationName:"reason" type:"string"` - - // The status of the state change request. - Status *string `locationName:"status" type:"string"` - - // The task ID or full ARN of the task in the state change request. - Task *string `locationName:"task" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitTaskStateChangeInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitTaskStateChangeInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *SubmitTaskStateChangeInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "SubmitTaskStateChangeInput"} - if s.Attachments != nil { - for i, v := range s.Attachments { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Attachments", i), err.(request.ErrInvalidParams)) - } - } - } - if s.ManagedAgents != nil { - for i, v := range s.ManagedAgents { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "ManagedAgents", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAttachments sets the Attachments field's value. -func (s *SubmitTaskStateChangeInput) SetAttachments(v []*AttachmentStateChange) *SubmitTaskStateChangeInput { - s.Attachments = v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *SubmitTaskStateChangeInput) SetCluster(v string) *SubmitTaskStateChangeInput { - s.Cluster = &v - return s -} - -// SetContainers sets the Containers field's value. -func (s *SubmitTaskStateChangeInput) SetContainers(v []*ContainerStateChange) *SubmitTaskStateChangeInput { - s.Containers = v - return s -} - -// SetExecutionStoppedAt sets the ExecutionStoppedAt field's value. -func (s *SubmitTaskStateChangeInput) SetExecutionStoppedAt(v time.Time) *SubmitTaskStateChangeInput { - s.ExecutionStoppedAt = &v - return s -} - -// SetManagedAgents sets the ManagedAgents field's value. -func (s *SubmitTaskStateChangeInput) SetManagedAgents(v []*ManagedAgentStateChange) *SubmitTaskStateChangeInput { - s.ManagedAgents = v - return s -} - -// SetPullStartedAt sets the PullStartedAt field's value. -func (s *SubmitTaskStateChangeInput) SetPullStartedAt(v time.Time) *SubmitTaskStateChangeInput { - s.PullStartedAt = &v - return s -} - -// SetPullStoppedAt sets the PullStoppedAt field's value. -func (s *SubmitTaskStateChangeInput) SetPullStoppedAt(v time.Time) *SubmitTaskStateChangeInput { - s.PullStoppedAt = &v - return s -} - -// SetReason sets the Reason field's value. -func (s *SubmitTaskStateChangeInput) SetReason(v string) *SubmitTaskStateChangeInput { - s.Reason = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *SubmitTaskStateChangeInput) SetStatus(v string) *SubmitTaskStateChangeInput { - s.Status = &v - return s -} - -// SetTask sets the Task field's value. -func (s *SubmitTaskStateChangeInput) SetTask(v string) *SubmitTaskStateChangeInput { - s.Task = &v - return s -} - -type SubmitTaskStateChangeOutput struct { - _ struct{} `type:"structure"` - - // Acknowledgement of the state change. - Acknowledgment *string `locationName:"acknowledgment" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitTaskStateChangeOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SubmitTaskStateChangeOutput) GoString() string { - return s.String() -} - -// SetAcknowledgment sets the Acknowledgment field's value. -func (s *SubmitTaskStateChangeOutput) SetAcknowledgment(v string) *SubmitTaskStateChangeOutput { - s.Acknowledgment = &v - return s -} - -// A list of namespaced kernel parameters to set in the container. This parameter -// maps to Sysctls in the Create a container (https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate) -// section of the Docker Remote API (https://docs.docker.com/engine/api/v1.35/) -// and the --sysctl option to docker run (https://docs.docker.com/engine/reference/run/#security-configuration). -// -// We don't recommend that you specify network-related systemControls parameters -// for multiple containers in a single task. This task also uses either the -// awsvpc or host network mode. It does it for the following reasons. -// -// - For tasks that use the awsvpc network mode, if you set systemControls -// for any container, it applies to all containers in the task. If you set -// different systemControls for multiple containers in a single task, the -// container that's started last determines which systemControls take effect. -// -// - For tasks that use the host network mode, the systemControls parameter -// applies to the container instance's kernel parameter and that of all containers -// of any tasks running on that container instance. -type SystemControl struct { - _ struct{} `type:"structure"` - - // The namespaced kernel parameter to set a value for. - Namespace *string `locationName:"namespace" type:"string"` - - // The namespaced kernel parameter to set a value for. - // - // Valid IPC namespace values: "kernel.msgmax" | "kernel.msgmnb" | "kernel.msgmni" - // | "kernel.sem" | "kernel.shmall" | "kernel.shmmax" | "kernel.shmmni" | "kernel.shm_rmid_forced", - // and Sysctls that start with "fs.mqueue.*" - // - // Valid network namespace values: Sysctls that start with "net.*" - // - // All of these values are supported by Fargate. - Value *string `locationName:"value" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SystemControl) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s SystemControl) GoString() string { - return s.String() -} - -// SetNamespace sets the Namespace field's value. -func (s *SystemControl) SetNamespace(v string) *SystemControl { - s.Namespace = &v - return s -} - -// SetValue sets the Value field's value. -func (s *SystemControl) SetValue(v string) *SystemControl { - s.Value = &v - return s -} - -// The metadata that you apply to a resource to help you categorize and organize -// them. Each tag consists of a key and an optional value. You define them. -// -// The following basic restrictions apply to tags: -// -// - Maximum number of tags per resource - 50 -// -// - For each resource, each tag key must be unique, and each tag key can -// have only one value. -// -// - Maximum key length - 128 Unicode characters in UTF-8 -// -// - Maximum value length - 256 Unicode characters in UTF-8 -// -// - If your tagging schema is used across multiple services and resources, -// remember that other services may have restrictions on allowed characters. -// Generally allowed characters are: letters, numbers, and spaces representable -// in UTF-8, and the following characters: + - = . _ : / @. -// -// - Tag keys and values are case-sensitive. -// -// - Do not use aws:, AWS:, or any upper or lowercase combination of such -// as a prefix for either keys or values as it is reserved for Amazon Web -// Services use. You cannot edit or delete tag keys or values with this prefix. -// Tags with this prefix do not count against your tags per resource limit. -type Tag struct { - _ struct{} `type:"structure"` - - // One part of a key-value pair that make up a tag. A key is a general label - // that acts like a category for more specific tag values. - Key *string `locationName:"key" min:"1" type:"string"` - - // The optional part of a key-value pair that make up a tag. A value acts as - // a descriptor within a tag category (key). - Value *string `locationName:"value" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Tag) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Tag) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *Tag) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "Tag"} - if s.Key != nil && len(*s.Key) < 1 { - invalidParams.Add(request.NewErrParamMinLen("Key", 1)) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetKey sets the Key field's value. -func (s *Tag) SetKey(v string) *Tag { - s.Key = &v - return s -} - -// SetValue sets the Value field's value. -func (s *Tag) SetValue(v string) *Tag { - s.Value = &v - return s -} - -type TagResourceInput struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) of the resource to add tags to. Currently, - // the supported resources are Amazon ECS capacity providers, tasks, services, - // task definitions, clusters, and container instances. - // - // ResourceArn is a required field - ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"` - - // The tags to add to the resource. A tag is an array of key-value pairs. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - // - // Tags is a required field - Tags []*Tag `locationName:"tags" type:"list" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TagResourceInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TagResourceInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *TagResourceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "TagResourceInput"} - if s.ResourceArn == nil { - invalidParams.Add(request.NewErrParamRequired("ResourceArn")) - } - if s.Tags == nil { - invalidParams.Add(request.NewErrParamRequired("Tags")) - } - if s.Tags != nil { - for i, v := range s.Tags { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetResourceArn sets the ResourceArn field's value. -func (s *TagResourceInput) SetResourceArn(v string) *TagResourceInput { - s.ResourceArn = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *TagResourceInput) SetTags(v []*Tag) *TagResourceInput { - s.Tags = v - return s -} - -type TagResourceOutput struct { - _ struct{} `type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TagResourceOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TagResourceOutput) GoString() string { - return s.String() -} - -// The execute command cannot run. This error can be caused by any of the following -// configuration issues: -// -// - Incorrect IAM permissions -// -// - The SSM agent is not installed or is not running -// -// - There is an interface Amazon VPC endpoint for Amazon ECS, but there -// is not one for Systems Manager Session Manager -// -// For information about how to troubleshoot the issues, see Troubleshooting -// issues with ECS Exec (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html) -// in the Amazon Elastic Container Service Developer Guide. -type TargetNotConnectedException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TargetNotConnectedException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TargetNotConnectedException) GoString() string { - return s.String() -} - -func newErrorTargetNotConnectedException(v protocol.ResponseMetadata) error { - return &TargetNotConnectedException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *TargetNotConnectedException) Code() string { - return "TargetNotConnectedException" -} - -// Message returns the exception's message. -func (s *TargetNotConnectedException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *TargetNotConnectedException) OrigErr() error { - return nil -} - -func (s *TargetNotConnectedException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *TargetNotConnectedException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *TargetNotConnectedException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The specified target wasn't found. You can view your available container -// instances with ListContainerInstances. Amazon ECS container instances are -// cluster-specific and Region-specific. -type TargetNotFoundException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TargetNotFoundException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TargetNotFoundException) GoString() string { - return s.String() -} - -func newErrorTargetNotFoundException(v protocol.ResponseMetadata) error { - return &TargetNotFoundException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *TargetNotFoundException) Code() string { - return "TargetNotFoundException" -} - -// Message returns the exception's message. -func (s *TargetNotFoundException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *TargetNotFoundException) OrigErr() error { - return nil -} - -func (s *TargetNotFoundException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *TargetNotFoundException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *TargetNotFoundException) RequestID() string { - return s.RespMetadata.RequestID -} - -// Details on a task in a cluster. -type Task struct { - _ struct{} `type:"structure"` - - // The Elastic Network Adapter that's associated with the task if the task uses - // the awsvpc network mode. - Attachments []*Attachment `locationName:"attachments" type:"list"` - - // The attributes of the task - Attributes []*Attribute `locationName:"attributes" type:"list"` - - // The Availability Zone for the task. - AvailabilityZone *string `locationName:"availabilityZone" type:"string"` - - // The capacity provider that's associated with the task. - CapacityProviderName *string `locationName:"capacityProviderName" type:"string"` - - // The ARN of the cluster that hosts the task. - ClusterArn *string `locationName:"clusterArn" type:"string"` - - // The connectivity status of a task. - Connectivity *string `locationName:"connectivity" type:"string" enum:"Connectivity"` - - // The Unix timestamp for the time when the task last went into CONNECTED status. - ConnectivityAt *time.Time `locationName:"connectivityAt" type:"timestamp"` - - // The ARN of the container instances that host the task. - ContainerInstanceArn *string `locationName:"containerInstanceArn" type:"string"` - - // The containers that's associated with the task. - Containers []*Container `locationName:"containers" type:"list"` - - // The number of CPU units used by the task as expressed in a task definition. - // It can be expressed as an integer using CPU units (for example, 1024). It - // can also be expressed as a string using vCPUs (for example, 1 vCPU or 1 vcpu). - // String values are converted to an integer that indicates the CPU units when - // the task definition is registered. - // - // If you use the EC2 launch type, this field is optional. Supported values - // are between 128 CPU units (0.125 vCPUs) and 10240 CPU units (10 vCPUs). - // - // If you use the Fargate launch type, this field is required. You must use - // one of the following values. These values determine the range of supported - // values for the memory parameter: - // - // The CPU units cannot be less than 1 vCPU when you use Windows containers - // on Fargate. - // - // * 256 (.25 vCPU) - Available memory values: 512 (0.5 GB), 1024 (1 GB), - // 2048 (2 GB) - // - // * 512 (.5 vCPU) - Available memory values: 1024 (1 GB), 2048 (2 GB), 3072 - // (3 GB), 4096 (4 GB) - // - // * 1024 (1 vCPU) - Available memory values: 2048 (2 GB), 3072 (3 GB), 4096 - // (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - // - // * 2048 (2 vCPU) - Available memory values: 4096 (4 GB) and 16384 (16 GB) - // in increments of 1024 (1 GB) - // - // * 4096 (4 vCPU) - Available memory values: 8192 (8 GB) and 30720 (30 GB) - // in increments of 1024 (1 GB) - // - // * 8192 (8 vCPU) - Available memory values: 16 GB and 60 GB in 4 GB increments - // This option requires Linux platform 1.4.0 or later. - // - // * 16384 (16vCPU) - Available memory values: 32GB and 120 GB in 8 GB increments - // This option requires Linux platform 1.4.0 or later. - Cpu *string `locationName:"cpu" type:"string"` - - // The Unix timestamp for the time when the task was created. More specifically, - // it's for the time when the task entered the PENDING state. - CreatedAt *time.Time `locationName:"createdAt" type:"timestamp"` - - // The desired status of the task. For more information, see Task Lifecycle - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-lifecycle.html). - DesiredStatus *string `locationName:"desiredStatus" type:"string"` - - // Determines whether execute command functionality is turned on for this task. - // If true, execute command functionality is turned on all the containers in - // the task. - EnableExecuteCommand *bool `locationName:"enableExecuteCommand" type:"boolean"` - - // The Unix timestamp for the time when the task execution stopped. - ExecutionStoppedAt *time.Time `locationName:"executionStoppedAt" type:"timestamp"` - - // The name of the task group that's associated with the task. - Group *string `locationName:"group" type:"string"` - - // The health status for the task. It's determined by the health of the essential - // containers in the task. If all essential containers in the task are reporting - // as HEALTHY, the task status also reports as HEALTHY. If any essential containers - // in the task are reporting as UNHEALTHY or UNKNOWN, the task status also reports - // as UNHEALTHY or UNKNOWN. - // - // The Amazon ECS container agent doesn't monitor or report on Docker health - // checks that are embedded in a container image and not specified in the container - // definition. For example, this includes those specified in a parent image - // or from the image's Dockerfile. Health check parameters that are specified - // in a container definition override any Docker health checks that are found - // in the container image. - HealthStatus *string `locationName:"healthStatus" type:"string" enum:"HealthStatus"` - - // The last known status for the task. For more information, see Task Lifecycle - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-lifecycle.html). - LastStatus *string `locationName:"lastStatus" type:"string"` - - // The infrastructure where your task runs on. For more information, see Amazon - // ECS launch types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) - // in the Amazon Elastic Container Service Developer Guide. - LaunchType *string `locationName:"launchType" type:"string" enum:"LaunchType"` - - // The amount of memory (in MiB) that the task uses as expressed in a task definition. - // It can be expressed as an integer using MiB (for example, 1024). If it's - // expressed as a string using GB (for example, 1GB or 1 GB), it's converted - // to an integer indicating the MiB when the task definition is registered. - // - // If you use the EC2 launch type, this field is optional. - // - // If you use the Fargate launch type, this field is required. You must use - // one of the following values. The value that you choose determines the range - // of supported values for the cpu parameter. - // - // * 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 - // vCPU) - // - // * 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: - // 512 (.5 vCPU) - // - // * 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 - // (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU) - // - // * Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - - // Available cpu values: 2048 (2 vCPU) - // - // * Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - - // Available cpu values: 4096 (4 vCPU) - // - // * Between 16 GB and 60 GB in 4 GB increments - Available cpu values: 8192 - // (8 vCPU) This option requires Linux platform 1.4.0 or later. - // - // * Between 32GB and 120 GB in 8 GB increments - Available cpu values: 16384 - // (16 vCPU) This option requires Linux platform 1.4.0 or later. - Memory *string `locationName:"memory" type:"string"` - - // One or more container overrides. - Overrides *TaskOverride `locationName:"overrides" type:"structure"` - - // The platform version where your task runs on. A platform version is only - // specified for tasks that use the Fargate launch type. If you didn't specify - // one, the LATEST platform version is used. For more information, see Fargate - // Platform Versions (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html) - // in the Amazon Elastic Container Service Developer Guide. - PlatformVersion *string `locationName:"platformVersion" type:"string"` - - // The Unix timestamp for the time when the container image pull began. - PullStartedAt *time.Time `locationName:"pullStartedAt" type:"timestamp"` - - // The Unix timestamp for the time when the container image pull completed. - PullStoppedAt *time.Time `locationName:"pullStoppedAt" type:"timestamp"` - - // The Unix timestamp for the time when the task started. More specifically, - // it's for the time when the task transitioned from the PENDING state to the - // RUNNING state. - StartedAt *time.Time `locationName:"startedAt" type:"timestamp"` - - // The tag specified when a task is started. If an Amazon ECS service started - // the task, the startedBy parameter contains the deployment ID of that service. - StartedBy *string `locationName:"startedBy" type:"string"` - - // The stop code indicating why a task was stopped. The stoppedReason might - // contain additional details. - // - // For more information about stop code, see Stopped tasks error codes (https://docs.aws.amazon.com/AmazonECS/latest/userguide/stopped-task-error-codes.html) - // in the Amazon ECS User Guide. - // - // The following are valid values: - // - // * TaskFailedToStart - // - // * EssentialContainerExited - // - // * UserInitiated - // - // * TerminationNotice - // - // * ServiceSchedulerInitiated - // - // * SpotInterruption - StopCode *string `locationName:"stopCode" type:"string" enum:"TaskStopCode"` - - // The Unix timestamp for the time when the task was stopped. More specifically, - // it's for the time when the task transitioned from the RUNNING state to the - // STOPPED state. - StoppedAt *time.Time `locationName:"stoppedAt" type:"timestamp"` - - // The reason that the task was stopped. - StoppedReason *string `locationName:"stoppedReason" type:"string"` - - // The Unix timestamp for the time when the task stops. More specifically, it's - // for the time when the task transitions from the RUNNING state to STOPPING. - StoppingAt *time.Time `locationName:"stoppingAt" type:"timestamp"` - - // The metadata that you apply to the task to help you categorize and organize - // the task. Each tag consists of a key and an optional value. You define both - // the key and value. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The Amazon Resource Name (ARN) of the task. - TaskArn *string `locationName:"taskArn" type:"string"` - - // The ARN of the task definition that creates the task. - TaskDefinitionArn *string `locationName:"taskDefinitionArn" type:"string"` - - // The version counter for the task. Every time a task experiences a change - // that starts a CloudWatch event, the version counter is incremented. If you - // replicate your Amazon ECS task state with CloudWatch Events, you can compare - // the version of a task reported by the Amazon ECS API actions with the version - // reported in CloudWatch Events for the task (inside the detail object) to - // verify that the version in your event stream is current. - Version *int64 `locationName:"version" type:"long"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Task) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Task) GoString() string { - return s.String() -} - -// SetAttachments sets the Attachments field's value. -func (s *Task) SetAttachments(v []*Attachment) *Task { - s.Attachments = v - return s -} - -// SetAttributes sets the Attributes field's value. -func (s *Task) SetAttributes(v []*Attribute) *Task { - s.Attributes = v - return s -} - -// SetAvailabilityZone sets the AvailabilityZone field's value. -func (s *Task) SetAvailabilityZone(v string) *Task { - s.AvailabilityZone = &v - return s -} - -// SetCapacityProviderName sets the CapacityProviderName field's value. -func (s *Task) SetCapacityProviderName(v string) *Task { - s.CapacityProviderName = &v - return s -} - -// SetClusterArn sets the ClusterArn field's value. -func (s *Task) SetClusterArn(v string) *Task { - s.ClusterArn = &v - return s -} - -// SetConnectivity sets the Connectivity field's value. -func (s *Task) SetConnectivity(v string) *Task { - s.Connectivity = &v - return s -} - -// SetConnectivityAt sets the ConnectivityAt field's value. -func (s *Task) SetConnectivityAt(v time.Time) *Task { - s.ConnectivityAt = &v - return s -} - -// SetContainerInstanceArn sets the ContainerInstanceArn field's value. -func (s *Task) SetContainerInstanceArn(v string) *Task { - s.ContainerInstanceArn = &v - return s -} - -// SetContainers sets the Containers field's value. -func (s *Task) SetContainers(v []*Container) *Task { - s.Containers = v - return s -} - -// SetCpu sets the Cpu field's value. -func (s *Task) SetCpu(v string) *Task { - s.Cpu = &v - return s -} - -// SetCreatedAt sets the CreatedAt field's value. -func (s *Task) SetCreatedAt(v time.Time) *Task { - s.CreatedAt = &v - return s -} - -// SetDesiredStatus sets the DesiredStatus field's value. -func (s *Task) SetDesiredStatus(v string) *Task { - s.DesiredStatus = &v - return s -} - -// SetEnableExecuteCommand sets the EnableExecuteCommand field's value. -func (s *Task) SetEnableExecuteCommand(v bool) *Task { - s.EnableExecuteCommand = &v - return s -} - -// SetExecutionStoppedAt sets the ExecutionStoppedAt field's value. -func (s *Task) SetExecutionStoppedAt(v time.Time) *Task { - s.ExecutionStoppedAt = &v - return s -} - -// SetGroup sets the Group field's value. -func (s *Task) SetGroup(v string) *Task { - s.Group = &v - return s -} - -// SetHealthStatus sets the HealthStatus field's value. -func (s *Task) SetHealthStatus(v string) *Task { - s.HealthStatus = &v - return s -} - -// SetLastStatus sets the LastStatus field's value. -func (s *Task) SetLastStatus(v string) *Task { - s.LastStatus = &v - return s -} - -// SetLaunchType sets the LaunchType field's value. -func (s *Task) SetLaunchType(v string) *Task { - s.LaunchType = &v - return s -} - -// SetMemory sets the Memory field's value. -func (s *Task) SetMemory(v string) *Task { - s.Memory = &v - return s -} - -// SetOverrides sets the Overrides field's value. -func (s *Task) SetOverrides(v *TaskOverride) *Task { - s.Overrides = v - return s -} - -// SetPlatformVersion sets the PlatformVersion field's value. -func (s *Task) SetPlatformVersion(v string) *Task { - s.PlatformVersion = &v - return s -} - -// SetPullStartedAt sets the PullStartedAt field's value. -func (s *Task) SetPullStartedAt(v time.Time) *Task { - s.PullStartedAt = &v - return s -} - -// SetPullStoppedAt sets the PullStoppedAt field's value. -func (s *Task) SetPullStoppedAt(v time.Time) *Task { - s.PullStoppedAt = &v - return s -} - -// SetStartedAt sets the StartedAt field's value. -func (s *Task) SetStartedAt(v time.Time) *Task { - s.StartedAt = &v - return s -} - -// SetStartedBy sets the StartedBy field's value. -func (s *Task) SetStartedBy(v string) *Task { - s.StartedBy = &v - return s -} - -// SetStopCode sets the StopCode field's value. -func (s *Task) SetStopCode(v string) *Task { - s.StopCode = &v - return s -} - -// SetStoppedAt sets the StoppedAt field's value. -func (s *Task) SetStoppedAt(v time.Time) *Task { - s.StoppedAt = &v - return s -} - -// SetStoppedReason sets the StoppedReason field's value. -func (s *Task) SetStoppedReason(v string) *Task { - s.StoppedReason = &v - return s -} - -// SetStoppingAt sets the StoppingAt field's value. -func (s *Task) SetStoppingAt(v time.Time) *Task { - s.StoppingAt = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *Task) SetTags(v []*Tag) *Task { - s.Tags = v - return s -} - -// SetTaskArn sets the TaskArn field's value. -func (s *Task) SetTaskArn(v string) *Task { - s.TaskArn = &v - return s -} - -// SetTaskDefinitionArn sets the TaskDefinitionArn field's value. -func (s *Task) SetTaskDefinitionArn(v string) *Task { - s.TaskDefinitionArn = &v - return s -} - -// SetVersion sets the Version field's value. -func (s *Task) SetVersion(v int64) *Task { - s.Version = &v - return s -} - -// The details of a task definition which describes the container and volume -// definitions of an Amazon Elastic Container Service task. You can specify -// which Docker images to use, the required resources, and other configurations -// related to launching the task definition through an Amazon ECS service or -// task. -type TaskDefinition struct { - _ struct{} `type:"structure"` - - // The task launch types the task definition validated against during task definition - // registration. For more information, see Amazon ECS launch types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) - // in the Amazon Elastic Container Service Developer Guide. - Compatibilities []*string `locationName:"compatibilities" type:"list" enum:"Compatibility"` - - // A list of container definitions in JSON format that describe the different - // containers that make up your task. For more information about container definition - // parameters and defaults, see Amazon ECS Task Definitions (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html) - // in the Amazon Elastic Container Service Developer Guide. - ContainerDefinitions []*ContainerDefinition `locationName:"containerDefinitions" type:"list"` - - // The number of cpu units used by the task. If you use the EC2 launch type, - // this field is optional. Any value can be used. If you use the Fargate launch - // type, this field is required. You must use one of the following values. The - // value that you choose determines your range of valid values for the memory - // parameter. - // - // The CPU units cannot be less than 1 vCPU when you use Windows containers - // on Fargate. - // - // * 256 (.25 vCPU) - Available memory values: 512 (0.5 GB), 1024 (1 GB), - // 2048 (2 GB) - // - // * 512 (.5 vCPU) - Available memory values: 1024 (1 GB), 2048 (2 GB), 3072 - // (3 GB), 4096 (4 GB) - // - // * 1024 (1 vCPU) - Available memory values: 2048 (2 GB), 3072 (3 GB), 4096 - // (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - // - // * 2048 (2 vCPU) - Available memory values: 4096 (4 GB) and 16384 (16 GB) - // in increments of 1024 (1 GB) - // - // * 4096 (4 vCPU) - Available memory values: 8192 (8 GB) and 30720 (30 GB) - // in increments of 1024 (1 GB) - // - // * 8192 (8 vCPU) - Available memory values: 16 GB and 60 GB in 4 GB increments - // This option requires Linux platform 1.4.0 or later. - // - // * 16384 (16vCPU) - Available memory values: 32GB and 120 GB in 8 GB increments - // This option requires Linux platform 1.4.0 or later. - Cpu *string `locationName:"cpu" type:"string"` - - // The Amazon Resource Name (ARN) of the task execution role that grants the - // Amazon ECS container agent permission to make Amazon Web Services API calls - // on your behalf. The task execution IAM role is required depending on the - // requirements of your task. For more information, see Amazon ECS task execution - // IAM role (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_execution_IAM_role.html) - // in the Amazon Elastic Container Service Developer Guide. - ExecutionRoleArn *string `locationName:"executionRoleArn" type:"string"` - - // The name of a family that this task definition is registered to. Up to 255 - // characters are allowed. Letters (both uppercase and lowercase letters), numbers, - // hyphens (-), and underscores (_) are allowed. - // - // A family groups multiple versions of a task definition. Amazon ECS gives - // the first task definition that you registered to a family a revision number - // of 1. Amazon ECS gives sequential revision numbers to each task definition - // that you add. - Family *string `locationName:"family" type:"string"` - - // The IPC resource namespace to use for the containers in the task. The valid - // values are host, task, or none. If host is specified, then all containers - // within the tasks that specified the host IPC mode on the same container instance - // share the same IPC resources with the host Amazon EC2 instance. If task is - // specified, all containers within the specified task share the same IPC resources. - // If none is specified, then IPC resources within the containers of a task - // are private and not shared with other containers in a task or on the container - // instance. If no value is specified, then the IPC resource namespace sharing - // depends on the Docker daemon setting on the container instance. For more - // information, see IPC settings (https://docs.docker.com/engine/reference/run/#ipc-settings---ipc) - // in the Docker run reference. - // - // If the host IPC mode is used, be aware that there is a heightened risk of - // undesired IPC namespace expose. For more information, see Docker security - // (https://docs.docker.com/engine/security/security/). - // - // If you are setting namespaced kernel parameters using systemControls for - // the containers in the task, the following will apply to your IPC resource - // namespace. For more information, see System Controls (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // * For tasks that use the host IPC mode, IPC namespace related systemControls - // are not supported. - // - // * For tasks that use the task IPC mode, IPC namespace related systemControls - // will apply to all containers within a task. - // - // This parameter is not supported for Windows containers or tasks run on Fargate. - IpcMode *string `locationName:"ipcMode" type:"string" enum:"IpcMode"` - - // The amount (in MiB) of memory used by the task. - // - // If your tasks runs on Amazon EC2 instances, you must specify either a task-level - // memory value or a container-level memory value. This field is optional and - // any value can be used. If a task-level memory value is specified, the container-level - // memory value is optional. For more information regarding container-level - // memory and memory reservation, see ContainerDefinition (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ContainerDefinition.html). - // - // If your tasks runs on Fargate, this field is required. You must use one of - // the following values. The value you choose determines your range of valid - // values for the cpu parameter. - // - // * 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - Available cpu values: 256 (.25 - // vCPU) - // - // * 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - Available cpu values: - // 512 (.5 vCPU) - // - // * 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 - // (7 GB), 8192 (8 GB) - Available cpu values: 1024 (1 vCPU) - // - // * Between 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - - // Available cpu values: 2048 (2 vCPU) - // - // * Between 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - - // Available cpu values: 4096 (4 vCPU) - // - // * Between 16 GB and 60 GB in 4 GB increments - Available cpu values: 8192 - // (8 vCPU) This option requires Linux platform 1.4.0 or later. - // - // * Between 32GB and 120 GB in 8 GB increments - Available cpu values: 16384 - // (16 vCPU) This option requires Linux platform 1.4.0 or later. - Memory *string `locationName:"memory" type:"string"` - - // The Docker networking mode to use for the containers in the task. The valid - // values are none, bridge, awsvpc, and host. If no network mode is specified, - // the default is bridge. - // - // For Amazon ECS tasks on Fargate, the awsvpc network mode is required. For - // Amazon ECS tasks on Amazon EC2 Linux instances, any network mode can be used. - // For Amazon ECS tasks on Amazon EC2 Windows instances, or awsvpc - // can be used. If the network mode is set to none, you cannot specify port - // mappings in your container definitions, and the tasks containers do not have - // external connectivity. The host and awsvpc network modes offer the highest - // networking performance for containers because they use the EC2 network stack - // instead of the virtualized network stack provided by the bridge mode. - // - // With the host and awsvpc network modes, exposed container ports are mapped - // directly to the corresponding host port (for the host network mode) or the - // attached elastic network interface port (for the awsvpc network mode), so - // you cannot take advantage of dynamic host port mappings. - // - // When using the host network mode, you should not run containers using the - // root user (UID 0). It is considered best practice to use a non-root user. - // - // If the network mode is awsvpc, the task is allocated an elastic network interface, - // and you must specify a NetworkConfiguration value when you create a service - // or run a task with the task definition. For more information, see Task Networking - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // If the network mode is host, you cannot run multiple instantiations of the - // same task on a single container instance when port mappings are used. - // - // For more information, see Network settings (https://docs.docker.com/engine/reference/run/#network-settings) - // in the Docker run reference. - NetworkMode *string `locationName:"networkMode" type:"string" enum:"NetworkMode"` - - // The process namespace to use for the containers in the task. The valid values - // are host or task. On Fargate for Linux containers, the only valid value is - // task. For example, monitoring sidecars might need pidMode to access information - // about other containers running in the same task. - // - // If host is specified, all containers within the tasks that specified the - // host PID mode on the same container instance share the same process namespace - // with the host Amazon EC2 instance. - // - // If task is specified, all containers within the specified task share the - // same process namespace. - // - // If no value is specified, the default is a private namespace for each container. - // For more information, see PID settings (https://docs.docker.com/engine/reference/run/#pid-settings---pid) - // in the Docker run reference. - // - // If the host PID mode is used, there's a heightened risk of undesired process - // namespace exposure. For more information, see Docker security (https://docs.docker.com/engine/security/security/). - // - // This parameter is not supported for Windows containers. - // - // This parameter is only supported for tasks that are hosted on Fargate if - // the tasks are using platform version 1.4.0 or later (Linux). This isn't supported - // for Windows containers on Fargate. - PidMode *string `locationName:"pidMode" type:"string" enum:"PidMode"` - - // An array of placement constraint objects to use for tasks. - // - // This parameter isn't supported for tasks run on Fargate. - PlacementConstraints []*TaskDefinitionPlacementConstraint `locationName:"placementConstraints" type:"list"` - - // The configuration details for the App Mesh proxy. - // - // Your Amazon ECS container instances require at least version 1.26.0 of the - // container agent and at least version 1.26.0-1 of the ecs-init package to - // use a proxy configuration. If your container instances are launched from - // the Amazon ECS optimized AMI version 20190301 or later, they contain the - // required versions of the container agent and ecs-init. For more information, - // see Amazon ECS-optimized Linux AMI (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html) - // in the Amazon Elastic Container Service Developer Guide. - ProxyConfiguration *ProxyConfiguration `locationName:"proxyConfiguration" type:"structure"` - - // The container instance attributes required by your task. When an Amazon EC2 - // instance is registered to your cluster, the Amazon ECS container agent assigns - // some standard attributes to the instance. You can apply custom attributes. - // These are specified as key-value pairs using the Amazon ECS console or the - // PutAttributes API. These attributes are used when determining task placement - // for tasks hosted on Amazon EC2 instances. For more information, see Attributes - // (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html#attributes) - // in the Amazon Elastic Container Service Developer Guide. - // - // This parameter isn't supported for tasks run on Fargate. - RequiresAttributes []*Attribute `locationName:"requiresAttributes" type:"list"` - - // The task launch types the task definition was validated against. The valid - // values are EC2, FARGATE, and EXTERNAL. For more information, see Amazon ECS - // launch types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) - // in the Amazon Elastic Container Service Developer Guide. - RequiresCompatibilities []*string `locationName:"requiresCompatibilities" type:"list" enum:"Compatibility"` - - // The revision of the task in a particular family. The revision is a version - // number of a task definition in a family. When you register a task definition - // for the first time, the revision is 1. Each time that you register a new - // revision of a task definition in the same family, the revision value always - // increases by one. This is even if you deregistered previous revisions in - // this family. - Revision *int64 `locationName:"revision" type:"integer"` - - // The status of the task definition. - Status *string `locationName:"status" type:"string" enum:"TaskDefinitionStatus"` - - // The full Amazon Resource Name (ARN) of the task definition. - TaskDefinitionArn *string `locationName:"taskDefinitionArn" type:"string"` - - // The short name or full Amazon Resource Name (ARN) of the Identity and Access - // Management role that grants containers in the task permission to call Amazon - // Web Services APIs on your behalf. For more information, see Amazon ECS Task - // Role (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // IAM roles for tasks on Windows require that the -EnableTaskIAMRole option - // is set when you launch the Amazon ECS-optimized Windows AMI. Your containers - // must also run some configuration code to use the feature. For more information, - // see Windows IAM roles for tasks (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/windows_task_IAM_roles.html) - // in the Amazon Elastic Container Service Developer Guide. - TaskRoleArn *string `locationName:"taskRoleArn" type:"string"` - - // The list of data volume definitions for the task. For more information, see - // Using data volumes in tasks (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_data_volumes.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // The host and sourcePath parameters aren't supported for tasks run on Fargate. - Volumes []*Volume `locationName:"volumes" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TaskDefinition) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TaskDefinition) GoString() string { - return s.String() -} - -// SetCompatibilities sets the Compatibilities field's value. -func (s *TaskDefinition) SetCompatibilities(v []*string) *TaskDefinition { - s.Compatibilities = v - return s -} - -// SetContainerDefinitions sets the ContainerDefinitions field's value. -func (s *TaskDefinition) SetContainerDefinitions(v []*ContainerDefinition) *TaskDefinition { - s.ContainerDefinitions = v - return s -} - -// SetCpu sets the Cpu field's value. -func (s *TaskDefinition) SetCpu(v string) *TaskDefinition { - s.Cpu = &v - return s -} - -// SetExecutionRoleArn sets the ExecutionRoleArn field's value. -func (s *TaskDefinition) SetExecutionRoleArn(v string) *TaskDefinition { - s.ExecutionRoleArn = &v - return s -} - -// SetFamily sets the Family field's value. -func (s *TaskDefinition) SetFamily(v string) *TaskDefinition { - s.Family = &v - return s -} - -// SetIpcMode sets the IpcMode field's value. -func (s *TaskDefinition) SetIpcMode(v string) *TaskDefinition { - s.IpcMode = &v - return s -} - -// SetMemory sets the Memory field's value. -func (s *TaskDefinition) SetMemory(v string) *TaskDefinition { - s.Memory = &v - return s -} - -// SetNetworkMode sets the NetworkMode field's value. -func (s *TaskDefinition) SetNetworkMode(v string) *TaskDefinition { - s.NetworkMode = &v - return s -} - -// SetPidMode sets the PidMode field's value. -func (s *TaskDefinition) SetPidMode(v string) *TaskDefinition { - s.PidMode = &v - return s -} - -// SetPlacementConstraints sets the PlacementConstraints field's value. -func (s *TaskDefinition) SetPlacementConstraints(v []*TaskDefinitionPlacementConstraint) *TaskDefinition { - s.PlacementConstraints = v - return s -} - -// SetProxyConfiguration sets the ProxyConfiguration field's value. -func (s *TaskDefinition) SetProxyConfiguration(v *ProxyConfiguration) *TaskDefinition { - s.ProxyConfiguration = v - return s -} - -// SetRequiresAttributes sets the RequiresAttributes field's value. -func (s *TaskDefinition) SetRequiresAttributes(v []*Attribute) *TaskDefinition { - s.RequiresAttributes = v - return s -} - -// SetRequiresCompatibilities sets the RequiresCompatibilities field's value. -func (s *TaskDefinition) SetRequiresCompatibilities(v []*string) *TaskDefinition { - s.RequiresCompatibilities = v - return s -} - -// SetRevision sets the Revision field's value. -func (s *TaskDefinition) SetRevision(v int64) *TaskDefinition { - s.Revision = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *TaskDefinition) SetStatus(v string) *TaskDefinition { - s.Status = &v - return s -} - -// SetTaskDefinitionArn sets the TaskDefinitionArn field's value. -func (s *TaskDefinition) SetTaskDefinitionArn(v string) *TaskDefinition { - s.TaskDefinitionArn = &v - return s -} - -// SetTaskRoleArn sets the TaskRoleArn field's value. -func (s *TaskDefinition) SetTaskRoleArn(v string) *TaskDefinition { - s.TaskRoleArn = &v - return s -} - -// SetVolumes sets the Volumes field's value. -func (s *TaskDefinition) SetVolumes(v []*Volume) *TaskDefinition { - s.Volumes = v - return s -} - -// The constraint on task placement in the task definition. For more information, -// see Task placement constraints (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-placement-constraints.html) -// in the Amazon Elastic Container Service Developer Guide. -// -// Task placement constraints aren't supported for tasks run on Fargate. -type TaskDefinitionPlacementConstraint struct { - _ struct{} `type:"structure"` - - // A cluster query language expression to apply to the constraint. For more - // information, see Cluster query language (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cluster-query-language.html) - // in the Amazon Elastic Container Service Developer Guide. - Expression *string `locationName:"expression" type:"string"` - - // The type of constraint. The MemberOf constraint restricts selection to be - // from a group of valid candidates. - Type *string `locationName:"type" type:"string" enum:"TaskDefinitionPlacementConstraintType"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TaskDefinitionPlacementConstraint) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TaskDefinitionPlacementConstraint) GoString() string { - return s.String() -} - -// SetExpression sets the Expression field's value. -func (s *TaskDefinitionPlacementConstraint) SetExpression(v string) *TaskDefinitionPlacementConstraint { - s.Expression = &v - return s -} - -// SetType sets the Type field's value. -func (s *TaskDefinitionPlacementConstraint) SetType(v string) *TaskDefinitionPlacementConstraint { - s.Type = &v - return s -} - -// The overrides that are associated with a task. -type TaskOverride struct { - _ struct{} `type:"structure"` - - // One or more container overrides that are sent to a task. - ContainerOverrides []*ContainerOverride `locationName:"containerOverrides" type:"list"` - - // The CPU override for the task. - Cpu *string `locationName:"cpu" type:"string"` - - // The Amazon Resource Name (ARN) of the task execution role override for the - // task. For more information, see Amazon ECS task execution IAM role (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_execution_IAM_role.html) - // in the Amazon Elastic Container Service Developer Guide. - ExecutionRoleArn *string `locationName:"executionRoleArn" type:"string"` - - // The Elastic Inference accelerator override for the task. - InferenceAcceleratorOverrides []*InferenceAcceleratorOverride `locationName:"inferenceAcceleratorOverrides" type:"list"` - - // The memory override for the task. - Memory *string `locationName:"memory" type:"string"` - - // The Amazon Resource Name (ARN) of the role that containers in this task can - // assume. All containers in this task are granted the permissions that are - // specified in this role. For more information, see IAM Role for Tasks (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html) - // in the Amazon Elastic Container Service Developer Guide. - TaskRoleArn *string `locationName:"taskRoleArn" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TaskOverride) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TaskOverride) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *TaskOverride) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "TaskOverride"} - if s.ContainerOverrides != nil { - for i, v := range s.ContainerOverrides { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "ContainerOverrides", i), err.(request.ErrInvalidParams)) - } - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetContainerOverrides sets the ContainerOverrides field's value. -func (s *TaskOverride) SetContainerOverrides(v []*ContainerOverride) *TaskOverride { - s.ContainerOverrides = v - return s -} - -// SetCpu sets the Cpu field's value. -func (s *TaskOverride) SetCpu(v string) *TaskOverride { - s.Cpu = &v - return s -} - -// SetExecutionRoleArn sets the ExecutionRoleArn field's value. -func (s *TaskOverride) SetExecutionRoleArn(v string) *TaskOverride { - s.ExecutionRoleArn = &v - return s -} - -// SetInferenceAcceleratorOverrides sets the InferenceAcceleratorOverrides field's value. -func (s *TaskOverride) SetInferenceAcceleratorOverrides(v []*InferenceAcceleratorOverride) *TaskOverride { - s.InferenceAcceleratorOverrides = v - return s -} - -// SetMemory sets the Memory field's value. -func (s *TaskOverride) SetMemory(v string) *TaskOverride { - s.Memory = &v - return s -} - -// SetTaskRoleArn sets the TaskRoleArn field's value. -func (s *TaskOverride) SetTaskRoleArn(v string) *TaskOverride { - s.TaskRoleArn = &v - return s -} - -// Information about a set of Amazon ECS tasks in either an CodeDeploy or an -// EXTERNAL deployment. An Amazon ECS task set includes details such as the -// desired number of tasks, how many tasks are running, and whether the task -// set serves production traffic. -type TaskSet struct { - _ struct{} `type:"structure"` - - // The capacity provider strategy that are associated with the task set. - CapacityProviderStrategy []*CapacityProviderStrategyItem `locationName:"capacityProviderStrategy" type:"list"` - - // The Amazon Resource Name (ARN) of the cluster that the service that hosts - // the task set exists in. - ClusterArn *string `locationName:"clusterArn" type:"string"` - - // The computed desired count for the task set. This is calculated by multiplying - // the service's desiredCount by the task set's scale percentage. The result - // is always rounded up. For example, if the computed desired count is 1.2, - // it rounds up to 2 tasks. - ComputedDesiredCount *int64 `locationName:"computedDesiredCount" type:"integer"` - - // The Unix timestamp for the time when the task set was created. - CreatedAt *time.Time `locationName:"createdAt" type:"timestamp"` - - // The external ID associated with the task set. - // - // If an CodeDeploy deployment created a task set, the externalId parameter - // contains the CodeDeploy deployment ID. - // - // If a task set is created for an external deployment and is associated with - // a service discovery registry, the externalId parameter contains the ECS_TASK_SET_EXTERNAL_ID - // Cloud Map attribute. - ExternalId *string `locationName:"externalId" type:"string"` - - // The ID of the task set. - Id *string `locationName:"id" type:"string"` - - // The launch type the tasks in the task set are using. For more information, - // see Amazon ECS launch types (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) - // in the Amazon Elastic Container Service Developer Guide. - LaunchType *string `locationName:"launchType" type:"string" enum:"LaunchType"` - - // Details on a load balancer that are used with a task set. - LoadBalancers []*LoadBalancer `locationName:"loadBalancers" type:"list"` - - // The network configuration for the task set. - NetworkConfiguration *NetworkConfiguration `locationName:"networkConfiguration" type:"structure"` - - // The number of tasks in the task set that are in the PENDING status during - // a deployment. A task in the PENDING state is preparing to enter the RUNNING - // state. A task set enters the PENDING status when it launches for the first - // time or when it's restarted after being in the STOPPED state. - PendingCount *int64 `locationName:"pendingCount" type:"integer"` - - // The Fargate platform version where the tasks in the task set are running. - // A platform version is only specified for tasks run on Fargate. For more information, - // see Fargate platform versions (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html) - // in the Amazon Elastic Container Service Developer Guide. - PlatformVersion *string `locationName:"platformVersion" type:"string"` - - // The number of tasks in the task set that are in the RUNNING status during - // a deployment. A task in the RUNNING state is running and ready for use. - RunningCount *int64 `locationName:"runningCount" type:"integer"` - - // A floating-point percentage of your desired number of tasks to place and - // keep running in the task set. - Scale *Scale `locationName:"scale" type:"structure"` - - // The Amazon Resource Name (ARN) of the service the task set exists in. - ServiceArn *string `locationName:"serviceArn" type:"string"` - - // The details for the service discovery registries to assign to this task set. - // For more information, see Service discovery (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html). - ServiceRegistries []*ServiceRegistry `locationName:"serviceRegistries" type:"list"` - - // The stability status. This indicates whether the task set has reached a steady - // state. If the following conditions are met, the task set are in STEADY_STATE: - // - // * The task runningCount is equal to the computedDesiredCount. - // - // * The pendingCount is 0. - // - // * There are no tasks that are running on container instances in the DRAINING - // status. - // - // * All tasks are reporting a healthy status from the load balancers, service - // discovery, and container health checks. - // - // If any of those conditions aren't met, the stability status returns STABILIZING. - StabilityStatus *string `locationName:"stabilityStatus" type:"string" enum:"StabilityStatus"` - - // The Unix timestamp for the time when the task set stability status was retrieved. - StabilityStatusAt *time.Time `locationName:"stabilityStatusAt" type:"timestamp"` - - // The tag specified when a task set is started. If an CodeDeploy deployment - // created the task set, the startedBy parameter is CODE_DEPLOY. If an external - // deployment created the task set, the startedBy field isn't used. - StartedBy *string `locationName:"startedBy" type:"string"` - - // The status of the task set. The following describes each state. - // - // PRIMARY - // - // The task set is serving production traffic. - // - // ACTIVE - // - // The task set isn't serving production traffic. - // - // DRAINING - // - // The tasks in the task set are being stopped, and their corresponding targets - // are being deregistered from their target group. - Status *string `locationName:"status" type:"string"` - - // The metadata that you apply to the task set to help you categorize and organize - // them. Each tag consists of a key and an optional value. You define both. - // - // The following basic restrictions apply to tags: - // - // * Maximum number of tags per resource - 50 - // - // * For each resource, each tag key must be unique, and each tag key can - // have only one value. - // - // * Maximum key length - 128 Unicode characters in UTF-8 - // - // * Maximum value length - 256 Unicode characters in UTF-8 - // - // * If your tagging schema is used across multiple services and resources, - // remember that other services may have restrictions on allowed characters. - // Generally allowed characters are: letters, numbers, and spaces representable - // in UTF-8, and the following characters: + - = . _ : / @. - // - // * Tag keys and values are case-sensitive. - // - // * Do not use aws:, AWS:, or any upper or lowercase combination of such - // as a prefix for either keys or values as it is reserved for Amazon Web - // Services use. You cannot edit or delete tag keys or values with this prefix. - // Tags with this prefix do not count against your tags per resource limit. - Tags []*Tag `locationName:"tags" type:"list"` - - // The task definition that the task set is using. - TaskDefinition *string `locationName:"taskDefinition" type:"string"` - - // The Amazon Resource Name (ARN) of the task set. - TaskSetArn *string `locationName:"taskSetArn" type:"string"` - - // The Unix timestamp for the time when the task set was last updated. - UpdatedAt *time.Time `locationName:"updatedAt" type:"timestamp"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TaskSet) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TaskSet) GoString() string { - return s.String() -} - -// SetCapacityProviderStrategy sets the CapacityProviderStrategy field's value. -func (s *TaskSet) SetCapacityProviderStrategy(v []*CapacityProviderStrategyItem) *TaskSet { - s.CapacityProviderStrategy = v - return s -} - -// SetClusterArn sets the ClusterArn field's value. -func (s *TaskSet) SetClusterArn(v string) *TaskSet { - s.ClusterArn = &v - return s -} - -// SetComputedDesiredCount sets the ComputedDesiredCount field's value. -func (s *TaskSet) SetComputedDesiredCount(v int64) *TaskSet { - s.ComputedDesiredCount = &v - return s -} - -// SetCreatedAt sets the CreatedAt field's value. -func (s *TaskSet) SetCreatedAt(v time.Time) *TaskSet { - s.CreatedAt = &v - return s -} - -// SetExternalId sets the ExternalId field's value. -func (s *TaskSet) SetExternalId(v string) *TaskSet { - s.ExternalId = &v - return s -} - -// SetId sets the Id field's value. -func (s *TaskSet) SetId(v string) *TaskSet { - s.Id = &v - return s -} - -// SetLaunchType sets the LaunchType field's value. -func (s *TaskSet) SetLaunchType(v string) *TaskSet { - s.LaunchType = &v - return s -} - -// SetLoadBalancers sets the LoadBalancers field's value. -func (s *TaskSet) SetLoadBalancers(v []*LoadBalancer) *TaskSet { - s.LoadBalancers = v - return s -} - -// SetNetworkConfiguration sets the NetworkConfiguration field's value. -func (s *TaskSet) SetNetworkConfiguration(v *NetworkConfiguration) *TaskSet { - s.NetworkConfiguration = v - return s -} - -// SetPendingCount sets the PendingCount field's value. -func (s *TaskSet) SetPendingCount(v int64) *TaskSet { - s.PendingCount = &v - return s -} - -// SetPlatformVersion sets the PlatformVersion field's value. -func (s *TaskSet) SetPlatformVersion(v string) *TaskSet { - s.PlatformVersion = &v - return s -} - -// SetRunningCount sets the RunningCount field's value. -func (s *TaskSet) SetRunningCount(v int64) *TaskSet { - s.RunningCount = &v - return s -} - -// SetScale sets the Scale field's value. -func (s *TaskSet) SetScale(v *Scale) *TaskSet { - s.Scale = v - return s -} - -// SetServiceArn sets the ServiceArn field's value. -func (s *TaskSet) SetServiceArn(v string) *TaskSet { - s.ServiceArn = &v - return s -} - -// SetServiceRegistries sets the ServiceRegistries field's value. -func (s *TaskSet) SetServiceRegistries(v []*ServiceRegistry) *TaskSet { - s.ServiceRegistries = v - return s -} - -// SetStabilityStatus sets the StabilityStatus field's value. -func (s *TaskSet) SetStabilityStatus(v string) *TaskSet { - s.StabilityStatus = &v - return s -} - -// SetStabilityStatusAt sets the StabilityStatusAt field's value. -func (s *TaskSet) SetStabilityStatusAt(v time.Time) *TaskSet { - s.StabilityStatusAt = &v - return s -} - -// SetStartedBy sets the StartedBy field's value. -func (s *TaskSet) SetStartedBy(v string) *TaskSet { - s.StartedBy = &v - return s -} - -// SetStatus sets the Status field's value. -func (s *TaskSet) SetStatus(v string) *TaskSet { - s.Status = &v - return s -} - -// SetTags sets the Tags field's value. -func (s *TaskSet) SetTags(v []*Tag) *TaskSet { - s.Tags = v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *TaskSet) SetTaskDefinition(v string) *TaskSet { - s.TaskDefinition = &v - return s -} - -// SetTaskSetArn sets the TaskSetArn field's value. -func (s *TaskSet) SetTaskSetArn(v string) *TaskSet { - s.TaskSetArn = &v - return s -} - -// SetUpdatedAt sets the UpdatedAt field's value. -func (s *TaskSet) SetUpdatedAt(v time.Time) *TaskSet { - s.UpdatedAt = &v - return s -} - -// The specified task set wasn't found. You can view your available task sets -// with DescribeTaskSets. Task sets are specific to each cluster, service and -// Region. -type TaskSetNotFoundException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TaskSetNotFoundException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s TaskSetNotFoundException) GoString() string { - return s.String() -} - -func newErrorTaskSetNotFoundException(v protocol.ResponseMetadata) error { - return &TaskSetNotFoundException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *TaskSetNotFoundException) Code() string { - return "TaskSetNotFoundException" -} - -// Message returns the exception's message. -func (s *TaskSetNotFoundException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *TaskSetNotFoundException) OrigErr() error { - return nil -} - -func (s *TaskSetNotFoundException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *TaskSetNotFoundException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *TaskSetNotFoundException) RequestID() string { - return s.RespMetadata.RequestID -} - -// The container path, mount options, and size of the tmpfs mount. -type Tmpfs struct { - _ struct{} `type:"structure"` - - // The absolute file path where the tmpfs volume is to be mounted. - // - // ContainerPath is a required field - ContainerPath *string `locationName:"containerPath" type:"string" required:"true"` - - // The list of tmpfs volume mount options. - // - // Valid values: "defaults" | "ro" | "rw" | "suid" | "nosuid" | "dev" | "nodev" - // | "exec" | "noexec" | "sync" | "async" | "dirsync" | "remount" | "mand" | - // "nomand" | "atime" | "noatime" | "diratime" | "nodiratime" | "bind" | "rbind" - // | "unbindable" | "runbindable" | "private" | "rprivate" | "shared" | "rshared" - // | "slave" | "rslave" | "relatime" | "norelatime" | "strictatime" | "nostrictatime" - // | "mode" | "uid" | "gid" | "nr_inodes" | "nr_blocks" | "mpol" - MountOptions []*string `locationName:"mountOptions" type:"list"` - - // The maximum size (in MiB) of the tmpfs volume. - // - // Size is a required field - Size *int64 `locationName:"size" type:"integer" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Tmpfs) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Tmpfs) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *Tmpfs) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "Tmpfs"} - if s.ContainerPath == nil { - invalidParams.Add(request.NewErrParamRequired("ContainerPath")) - } - if s.Size == nil { - invalidParams.Add(request.NewErrParamRequired("Size")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetContainerPath sets the ContainerPath field's value. -func (s *Tmpfs) SetContainerPath(v string) *Tmpfs { - s.ContainerPath = &v - return s -} - -// SetMountOptions sets the MountOptions field's value. -func (s *Tmpfs) SetMountOptions(v []*string) *Tmpfs { - s.MountOptions = v - return s -} - -// SetSize sets the Size field's value. -func (s *Tmpfs) SetSize(v int64) *Tmpfs { - s.Size = &v - return s -} - -// The ulimit settings to pass to the container. -// -// Amazon ECS tasks hosted on Fargate use the default resource limit values -// set by the operating system with the exception of the nofile resource limit -// parameter which Fargate overrides. The nofile resource limit sets a restriction -// on the number of open files that a container can use. The default nofile -// soft limit is 1024 and the default hard limit is 4096. -// -// You can specify the ulimit settings for a container in a task definition. -type Ulimit struct { - _ struct{} `type:"structure"` - - // The hard limit for the ulimit type. - // - // HardLimit is a required field - HardLimit *int64 `locationName:"hardLimit" type:"integer" required:"true"` - - // The type of the ulimit. - // - // Name is a required field - Name *string `locationName:"name" type:"string" required:"true" enum:"UlimitName"` - - // The soft limit for the ulimit type. - // - // SoftLimit is a required field - SoftLimit *int64 `locationName:"softLimit" type:"integer" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Ulimit) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Ulimit) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *Ulimit) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "Ulimit"} - if s.HardLimit == nil { - invalidParams.Add(request.NewErrParamRequired("HardLimit")) - } - if s.Name == nil { - invalidParams.Add(request.NewErrParamRequired("Name")) - } - if s.SoftLimit == nil { - invalidParams.Add(request.NewErrParamRequired("SoftLimit")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetHardLimit sets the HardLimit field's value. -func (s *Ulimit) SetHardLimit(v int64) *Ulimit { - s.HardLimit = &v - return s -} - -// SetName sets the Name field's value. -func (s *Ulimit) SetName(v string) *Ulimit { - s.Name = &v - return s -} - -// SetSoftLimit sets the SoftLimit field's value. -func (s *Ulimit) SetSoftLimit(v int64) *Ulimit { - s.SoftLimit = &v - return s -} - -// The specified task isn't supported in this Region. -type UnsupportedFeatureException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UnsupportedFeatureException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UnsupportedFeatureException) GoString() string { - return s.String() -} - -func newErrorUnsupportedFeatureException(v protocol.ResponseMetadata) error { - return &UnsupportedFeatureException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *UnsupportedFeatureException) Code() string { - return "UnsupportedFeatureException" -} - -// Message returns the exception's message. -func (s *UnsupportedFeatureException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *UnsupportedFeatureException) OrigErr() error { - return nil -} - -func (s *UnsupportedFeatureException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *UnsupportedFeatureException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *UnsupportedFeatureException) RequestID() string { - return s.RespMetadata.RequestID -} - -type UntagResourceInput struct { - _ struct{} `type:"structure"` - - // The Amazon Resource Name (ARN) of the resource to delete tags from. Currently, - // the supported resources are Amazon ECS capacity providers, tasks, services, - // task definitions, clusters, and container instances. - // - // ResourceArn is a required field - ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"` - - // The keys of the tags to be removed. - // - // TagKeys is a required field - TagKeys []*string `locationName:"tagKeys" type:"list" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UntagResourceInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UntagResourceInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *UntagResourceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "UntagResourceInput"} - if s.ResourceArn == nil { - invalidParams.Add(request.NewErrParamRequired("ResourceArn")) - } - if s.TagKeys == nil { - invalidParams.Add(request.NewErrParamRequired("TagKeys")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetResourceArn sets the ResourceArn field's value. -func (s *UntagResourceInput) SetResourceArn(v string) *UntagResourceInput { - s.ResourceArn = &v - return s -} - -// SetTagKeys sets the TagKeys field's value. -func (s *UntagResourceInput) SetTagKeys(v []*string) *UntagResourceInput { - s.TagKeys = v - return s -} - -type UntagResourceOutput struct { - _ struct{} `type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UntagResourceOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UntagResourceOutput) GoString() string { - return s.String() -} - -type UpdateCapacityProviderInput struct { - _ struct{} `type:"structure"` - - // An object that represent the parameters to update for the Auto Scaling group - // capacity provider. - // - // AutoScalingGroupProvider is a required field - AutoScalingGroupProvider *AutoScalingGroupProviderUpdate `locationName:"autoScalingGroupProvider" type:"structure" required:"true"` - - // The name of the capacity provider to update. - // - // Name is a required field - Name *string `locationName:"name" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateCapacityProviderInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateCapacityProviderInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *UpdateCapacityProviderInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "UpdateCapacityProviderInput"} - if s.AutoScalingGroupProvider == nil { - invalidParams.Add(request.NewErrParamRequired("AutoScalingGroupProvider")) - } - if s.Name == nil { - invalidParams.Add(request.NewErrParamRequired("Name")) - } - if s.AutoScalingGroupProvider != nil { - if err := s.AutoScalingGroupProvider.Validate(); err != nil { - invalidParams.AddNested("AutoScalingGroupProvider", err.(request.ErrInvalidParams)) - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetAutoScalingGroupProvider sets the AutoScalingGroupProvider field's value. -func (s *UpdateCapacityProviderInput) SetAutoScalingGroupProvider(v *AutoScalingGroupProviderUpdate) *UpdateCapacityProviderInput { - s.AutoScalingGroupProvider = v - return s -} - -// SetName sets the Name field's value. -func (s *UpdateCapacityProviderInput) SetName(v string) *UpdateCapacityProviderInput { - s.Name = &v - return s -} - -type UpdateCapacityProviderOutput struct { - _ struct{} `type:"structure"` - - // Details about the capacity provider. - CapacityProvider *CapacityProvider `locationName:"capacityProvider" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateCapacityProviderOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateCapacityProviderOutput) GoString() string { - return s.String() -} - -// SetCapacityProvider sets the CapacityProvider field's value. -func (s *UpdateCapacityProviderOutput) SetCapacityProvider(v *CapacityProvider) *UpdateCapacityProviderOutput { - s.CapacityProvider = v - return s -} - -type UpdateClusterInput struct { - _ struct{} `type:"structure"` - - // The name of the cluster to modify the settings for. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` - - // The execute command configuration for the cluster. - Configuration *ClusterConfiguration `locationName:"configuration" type:"structure"` - - // Use this parameter to set a default Service Connect namespace. After you - // set a default Service Connect namespace, any new services with Service Connect - // turned on that are created in the cluster are added as client services in - // the namespace. This setting only applies to new services that set the enabled - // parameter to true in the ServiceConnectConfiguration. You can set the namespace - // of each service individually in the ServiceConnectConfiguration to override - // this default parameter. - // - // Tasks that run in a namespace can use short names to connect to services - // in the namespace. Tasks can connect to services across all of the clusters - // in the namespace. Tasks connect through a managed proxy container that collects - // logs and metrics for increased visibility. Only the tasks that Amazon ECS - // services create are supported with Service Connect. For more information, - // see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - ServiceConnectDefaults *ClusterServiceConnectDefaultsRequest `locationName:"serviceConnectDefaults" type:"structure"` - - // The cluster settings for your cluster. - Settings []*ClusterSetting `locationName:"settings" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateClusterInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateClusterInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *UpdateClusterInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "UpdateClusterInput"} - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *UpdateClusterInput) SetCluster(v string) *UpdateClusterInput { - s.Cluster = &v - return s -} - -// SetConfiguration sets the Configuration field's value. -func (s *UpdateClusterInput) SetConfiguration(v *ClusterConfiguration) *UpdateClusterInput { - s.Configuration = v - return s -} - -// SetServiceConnectDefaults sets the ServiceConnectDefaults field's value. -func (s *UpdateClusterInput) SetServiceConnectDefaults(v *ClusterServiceConnectDefaultsRequest) *UpdateClusterInput { - s.ServiceConnectDefaults = v - return s -} - -// SetSettings sets the Settings field's value. -func (s *UpdateClusterInput) SetSettings(v []*ClusterSetting) *UpdateClusterInput { - s.Settings = v - return s -} - -type UpdateClusterOutput struct { - _ struct{} `type:"structure"` - - // Details about the cluster. - Cluster *Cluster `locationName:"cluster" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateClusterOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateClusterOutput) GoString() string { - return s.String() -} - -// SetCluster sets the Cluster field's value. -func (s *UpdateClusterOutput) SetCluster(v *Cluster) *UpdateClusterOutput { - s.Cluster = v - return s -} - -type UpdateClusterSettingsInput struct { - _ struct{} `type:"structure"` - - // The name of the cluster to modify the settings for. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` - - // The setting to use by default for a cluster. This parameter is used to turn - // on CloudWatch Container Insights for a cluster. If this value is specified, - // it overrides the containerInsights value set with PutAccountSetting or PutAccountSettingDefault. - // - // Currently, if you delete an existing cluster that does not have Container - // Insights turned on, and then create a new cluster with the same name with - // Container Insights tuned on, Container Insights will not actually be turned - // on. If you want to preserve the same name for your existing cluster and turn - // on Container Insights, you must wait 7 days before you can re-create it. - // - // Settings is a required field - Settings []*ClusterSetting `locationName:"settings" type:"list" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateClusterSettingsInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateClusterSettingsInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *UpdateClusterSettingsInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "UpdateClusterSettingsInput"} - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - if s.Settings == nil { - invalidParams.Add(request.NewErrParamRequired("Settings")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *UpdateClusterSettingsInput) SetCluster(v string) *UpdateClusterSettingsInput { - s.Cluster = &v - return s -} - -// SetSettings sets the Settings field's value. -func (s *UpdateClusterSettingsInput) SetSettings(v []*ClusterSetting) *UpdateClusterSettingsInput { - s.Settings = v - return s -} - -type UpdateClusterSettingsOutput struct { - _ struct{} `type:"structure"` - - // Details about the cluster - Cluster *Cluster `locationName:"cluster" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateClusterSettingsOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateClusterSettingsOutput) GoString() string { - return s.String() -} - -// SetCluster sets the Cluster field's value. -func (s *UpdateClusterSettingsOutput) SetCluster(v *Cluster) *UpdateClusterSettingsOutput { - s.Cluster = v - return s -} - -type UpdateContainerAgentInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that your - // container instance is running on. If you do not specify a cluster, the default - // cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // The container instance ID or full ARN entries for the container instance - // where you would like to update the Amazon ECS container agent. - // - // ContainerInstance is a required field - ContainerInstance *string `locationName:"containerInstance" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateContainerAgentInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateContainerAgentInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *UpdateContainerAgentInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "UpdateContainerAgentInput"} - if s.ContainerInstance == nil { - invalidParams.Add(request.NewErrParamRequired("ContainerInstance")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *UpdateContainerAgentInput) SetCluster(v string) *UpdateContainerAgentInput { - s.Cluster = &v - return s -} - -// SetContainerInstance sets the ContainerInstance field's value. -func (s *UpdateContainerAgentInput) SetContainerInstance(v string) *UpdateContainerAgentInput { - s.ContainerInstance = &v - return s -} - -type UpdateContainerAgentOutput struct { - _ struct{} `type:"structure"` - - // The container instance that the container agent was updated for. - ContainerInstance *ContainerInstance `locationName:"containerInstance" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateContainerAgentOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateContainerAgentOutput) GoString() string { - return s.String() -} - -// SetContainerInstance sets the ContainerInstance field's value. -func (s *UpdateContainerAgentOutput) SetContainerInstance(v *ContainerInstance) *UpdateContainerAgentOutput { - s.ContainerInstance = v - return s -} - -type UpdateContainerInstancesStateInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the container instance to update. If you do not specify a cluster, the default - // cluster is assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // A list of up to 10 container instance IDs or full ARN entries. - // - // ContainerInstances is a required field - ContainerInstances []*string `locationName:"containerInstances" type:"list" required:"true"` - - // The container instance state to update the container instance with. The only - // valid values for this action are ACTIVE and DRAINING. A container instance - // can only be updated to DRAINING status once it has reached an ACTIVE state. - // If a container instance is in REGISTERING, DEREGISTERING, or REGISTRATION_FAILED - // state you can describe the container instance but can't update the container - // instance state. - // - // Status is a required field - Status *string `locationName:"status" type:"string" required:"true" enum:"ContainerInstanceStatus"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateContainerInstancesStateInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateContainerInstancesStateInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *UpdateContainerInstancesStateInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "UpdateContainerInstancesStateInput"} - if s.ContainerInstances == nil { - invalidParams.Add(request.NewErrParamRequired("ContainerInstances")) - } - if s.Status == nil { - invalidParams.Add(request.NewErrParamRequired("Status")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *UpdateContainerInstancesStateInput) SetCluster(v string) *UpdateContainerInstancesStateInput { - s.Cluster = &v - return s -} - -// SetContainerInstances sets the ContainerInstances field's value. -func (s *UpdateContainerInstancesStateInput) SetContainerInstances(v []*string) *UpdateContainerInstancesStateInput { - s.ContainerInstances = v - return s -} - -// SetStatus sets the Status field's value. -func (s *UpdateContainerInstancesStateInput) SetStatus(v string) *UpdateContainerInstancesStateInput { - s.Status = &v - return s -} - -type UpdateContainerInstancesStateOutput struct { - _ struct{} `type:"structure"` - - // The list of container instances. - ContainerInstances []*ContainerInstance `locationName:"containerInstances" type:"list"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateContainerInstancesStateOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateContainerInstancesStateOutput) GoString() string { - return s.String() -} - -// SetContainerInstances sets the ContainerInstances field's value. -func (s *UpdateContainerInstancesStateOutput) SetContainerInstances(v []*ContainerInstance) *UpdateContainerInstancesStateOutput { - s.ContainerInstances = v - return s -} - -// SetFailures sets the Failures field's value. -func (s *UpdateContainerInstancesStateOutput) SetFailures(v []*Failure) *UpdateContainerInstancesStateOutput { - s.Failures = v - return s -} - -// There's already a current Amazon ECS container agent update in progress on -// the container instance that's specified. If the container agent becomes disconnected -// while it's in a transitional stage, such as PENDING or STAGING, the update -// process can get stuck in that state. However, when the agent reconnects, -// it resumes where it stopped previously. -type UpdateInProgressException struct { - _ struct{} `type:"structure"` - RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` - - Message_ *string `locationName:"message" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateInProgressException) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateInProgressException) GoString() string { - return s.String() -} - -func newErrorUpdateInProgressException(v protocol.ResponseMetadata) error { - return &UpdateInProgressException{ - RespMetadata: v, - } -} - -// Code returns the exception type name. -func (s *UpdateInProgressException) Code() string { - return "UpdateInProgressException" -} - -// Message returns the exception's message. -func (s *UpdateInProgressException) Message() string { - if s.Message_ != nil { - return *s.Message_ - } - return "" -} - -// OrigErr always returns nil, satisfies awserr.Error interface. -func (s *UpdateInProgressException) OrigErr() error { - return nil -} - -func (s *UpdateInProgressException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) -} - -// Status code returns the HTTP status code for the request's response error. -func (s *UpdateInProgressException) StatusCode() int { - return s.RespMetadata.StatusCode -} - -// RequestID returns the service's response RequestID for request. -func (s *UpdateInProgressException) RequestID() string { - return s.RespMetadata.RequestID -} - -type UpdateServiceInput struct { - _ struct{} `type:"structure"` - - // The capacity provider strategy to update the service to use. - // - // if the service uses the default capacity provider strategy for the cluster, - // the service can be updated to use one or more capacity providers as opposed - // to the default capacity provider strategy. However, when a service is using - // a capacity provider strategy that's not the default capacity provider strategy, - // the service can't be updated to use the cluster's default capacity provider - // strategy. - // - // A capacity provider strategy consists of one or more capacity providers along - // with the base and weight to assign to them. A capacity provider must be associated - // with the cluster to be used in a capacity provider strategy. The PutClusterCapacityProviders - // API is used to associate a capacity provider with a cluster. Only capacity - // providers with an ACTIVE or UPDATING status can be used. - // - // If specifying a capacity provider that uses an Auto Scaling group, the capacity - // provider must already be created. New capacity providers can be created with - // the CreateCapacityProvider API operation. - // - // To use a Fargate capacity provider, specify either the FARGATE or FARGATE_SPOT - // capacity providers. The Fargate capacity providers are available to all accounts - // and only need to be associated with a cluster to be used. - // - // The PutClusterCapacityProviders API operation is used to update the list - // of available capacity providers for a cluster after the cluster is created. - CapacityProviderStrategy []*CapacityProviderStrategyItem `locationName:"capacityProviderStrategy" type:"list"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that your - // service runs on. If you do not specify a cluster, the default cluster is - // assumed. - Cluster *string `locationName:"cluster" type:"string"` - - // Optional deployment parameters that control how many tasks run during the - // deployment and the ordering of stopping and starting tasks. - DeploymentConfiguration *DeploymentConfiguration `locationName:"deploymentConfiguration" type:"structure"` - - // The number of instantiations of the task to place and keep running in your - // service. - DesiredCount *int64 `locationName:"desiredCount" type:"integer"` - - // Determines whether to turn on Amazon ECS managed tags for the tasks in the - // service. For more information, see Tagging Your Amazon ECS Resources (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // Only tasks launched after the update will reflect the update. To update the - // tags on all tasks, set forceNewDeployment to true, so that Amazon ECS starts - // new tasks with the updated tags. - EnableECSManagedTags *bool `locationName:"enableECSManagedTags" type:"boolean"` - - // If true, this enables execute command functionality on all task containers. - // - // If you do not want to override the value that was set when the service was - // created, you can set this to null when performing this action. - EnableExecuteCommand *bool `locationName:"enableExecuteCommand" type:"boolean"` - - // Determines whether to force a new deployment of the service. By default, - // deployments aren't forced. You can use this option to start a new deployment - // with no service definition changes. For example, you can update a service's - // tasks to use a newer Docker image with the same image/tag combination (my_image:latest) - // or to roll Fargate tasks onto a newer platform version. - ForceNewDeployment *bool `locationName:"forceNewDeployment" type:"boolean"` - - // The period of time, in seconds, that the Amazon ECS service scheduler ignores - // unhealthy Elastic Load Balancing target health checks after a task has first - // started. This is only valid if your service is configured to use a load balancer. - // If your service's tasks take a while to start and respond to Elastic Load - // Balancing health checks, you can specify a health check grace period of up - // to 2,147,483,647 seconds. During that time, the Amazon ECS service scheduler - // ignores the Elastic Load Balancing health check status. This grace period - // can prevent the ECS service scheduler from marking tasks as unhealthy and - // stopping them before they have time to come up. - HealthCheckGracePeriodSeconds *int64 `locationName:"healthCheckGracePeriodSeconds" type:"integer"` - - LaunchType *string `locationName:"launchType" type:"string" enum:"LaunchType"` - - // A list of Elastic Load Balancing load balancer objects. It contains the load - // balancer name, the container name, and the container port to access from - // the load balancer. The container name is as it appears in a container definition. - // - // When you add, update, or remove a load balancer configuration, Amazon ECS - // starts new tasks with the updated Elastic Load Balancing configuration, and - // then stops the old tasks when the new tasks are running. - // - // For services that use rolling updates, you can add, update, or remove Elastic - // Load Balancing target groups. You can update from a single target group to - // multiple target groups and from multiple target groups to a single target - // group. - // - // For services that use blue/green deployments, you can update Elastic Load - // Balancing target groups by using CreateDeployment (https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html) - // through CodeDeploy. Note that multiple target groups are not supported for - // blue/green deployments. For more information see Register multiple target - // groups with a service (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/register-multiple-targetgroups.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // For services that use the external deployment controller, you can add, update, - // or remove load balancers by using CreateTaskSet (https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html). - // Note that multiple target groups are not supported for external deployments. - // For more information see Register multiple target groups with a service (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/register-multiple-targetgroups.html) - // in the Amazon Elastic Container Service Developer Guide. - // - // You can remove existing loadBalancers by passing an empty list. - LoadBalancers []*LoadBalancer `locationName:"loadBalancers" type:"list"` - - // An object representing the network configuration for the service. - NetworkConfiguration *NetworkConfiguration `locationName:"networkConfiguration" type:"structure"` - - // An array of task placement constraint objects to update the service to use. - // If no value is specified, the existing placement constraints for the service - // will remain unchanged. If this value is specified, it will override any existing - // placement constraints defined for the service. To remove all existing placement - // constraints, specify an empty array. - // - // You can specify a maximum of 10 constraints for each task. This limit includes - // constraints in the task definition and those specified at runtime. - PlacementConstraints []*PlacementConstraint `locationName:"placementConstraints" type:"list"` - - // The task placement strategy objects to update the service to use. If no value - // is specified, the existing placement strategy for the service will remain - // unchanged. If this value is specified, it will override the existing placement - // strategy defined for the service. To remove an existing placement strategy, - // specify an empty object. - // - // You can specify a maximum of five strategy rules for each service. - PlacementStrategy []*PlacementStrategy `locationName:"placementStrategy" type:"list"` - - // The platform version that your tasks in the service run on. A platform version - // is only specified for tasks using the Fargate launch type. If a platform - // version is not specified, the LATEST platform version is used. For more information, - // see Fargate Platform Versions (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html) - // in the Amazon Elastic Container Service Developer Guide. - PlatformVersion *string `locationName:"platformVersion" type:"string"` - - // Determines whether to propagate the tags from the task definition or the - // service to the task. If no value is specified, the tags aren't propagated. - // - // Only tasks launched after the update will reflect the update. To update the - // tags on all tasks, set forceNewDeployment to true, so that Amazon ECS starts - // new tasks with the updated tags. - PropagateTags *string `locationName:"propagateTags" type:"string" enum:"PropagateTags"` - - // The name of the service to update. - // - // Service is a required field - Service *string `locationName:"service" type:"string" required:"true"` - - // The configuration for this service to discover and connect to services, and - // be discovered by, and connected from, other services within a namespace. - // - // Tasks that run in a namespace can use short names to connect to services - // in the namespace. Tasks can connect to services across all of the clusters - // in the namespace. Tasks connect through a managed proxy container that collects - // logs and metrics for increased visibility. Only the tasks that Amazon ECS - // services create are supported with Service Connect. For more information, - // see Service Connect (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html) - // in the Amazon Elastic Container Service Developer Guide. - ServiceConnectConfiguration *ServiceConnectConfiguration `locationName:"serviceConnectConfiguration" type:"structure"` - - // The details for the service discovery registries to assign to this service. - // For more information, see Service Discovery (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html). - // - // When you add, update, or remove the service registries configuration, Amazon - // ECS starts new tasks with the updated service registries configuration, and - // then stops the old tasks when the new tasks are running. - // - // You can remove existing serviceRegistries by passing an empty list. - ServiceRegistries []*ServiceRegistry `locationName:"serviceRegistries" type:"list"` - - // The family and revision (family:revision) or full ARN of the task definition - // to run in your service. If a revision is not specified, the latest ACTIVE - // revision is used. If you modify the task definition with UpdateService, Amazon - // ECS spawns a task with the new version of the task definition and then stops - // an old task after the new version is running. - TaskDefinition *string `locationName:"taskDefinition" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateServiceInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateServiceInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *UpdateServiceInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "UpdateServiceInput"} - if s.Service == nil { - invalidParams.Add(request.NewErrParamRequired("Service")) - } - if s.CapacityProviderStrategy != nil { - for i, v := range s.CapacityProviderStrategy { - if v == nil { - continue - } - if err := v.Validate(); err != nil { - invalidParams.AddNested(fmt.Sprintf("%s[%v]", "CapacityProviderStrategy", i), err.(request.ErrInvalidParams)) - } - } - } - if s.DeploymentConfiguration != nil { - if err := s.DeploymentConfiguration.Validate(); err != nil { - invalidParams.AddNested("DeploymentConfiguration", err.(request.ErrInvalidParams)) - } - } - if s.ServiceConnectConfiguration != nil { - if err := s.ServiceConnectConfiguration.Validate(); err != nil { - invalidParams.AddNested("ServiceConnectConfiguration", err.(request.ErrInvalidParams)) - } - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCapacityProviderStrategy sets the CapacityProviderStrategy field's value. -func (s *UpdateServiceInput) SetCapacityProviderStrategy(v []*CapacityProviderStrategyItem) *UpdateServiceInput { - s.CapacityProviderStrategy = v - return s -} - -// SetCluster sets the Cluster field's value. -func (s *UpdateServiceInput) SetCluster(v string) *UpdateServiceInput { - s.Cluster = &v - return s -} - -// SetDeploymentConfiguration sets the DeploymentConfiguration field's value. -func (s *UpdateServiceInput) SetDeploymentConfiguration(v *DeploymentConfiguration) *UpdateServiceInput { - s.DeploymentConfiguration = v - return s -} - -// SetDesiredCount sets the DesiredCount field's value. -func (s *UpdateServiceInput) SetDesiredCount(v int64) *UpdateServiceInput { - s.DesiredCount = &v - return s -} - -// SetEnableECSManagedTags sets the EnableECSManagedTags field's value. -func (s *UpdateServiceInput) SetEnableECSManagedTags(v bool) *UpdateServiceInput { - s.EnableECSManagedTags = &v - return s -} - -// SetEnableExecuteCommand sets the EnableExecuteCommand field's value. -func (s *UpdateServiceInput) SetEnableExecuteCommand(v bool) *UpdateServiceInput { - s.EnableExecuteCommand = &v - return s -} - -// SetForceNewDeployment sets the ForceNewDeployment field's value. -func (s *UpdateServiceInput) SetForceNewDeployment(v bool) *UpdateServiceInput { - s.ForceNewDeployment = &v - return s -} - -// SetHealthCheckGracePeriodSeconds sets the HealthCheckGracePeriodSeconds field's value. -func (s *UpdateServiceInput) SetHealthCheckGracePeriodSeconds(v int64) *UpdateServiceInput { - s.HealthCheckGracePeriodSeconds = &v - return s -} - -// SetLaunchType sets the LaunchType field's value. -func (s *UpdateServiceInput) SetLaunchType(v string) *UpdateServiceInput { - s.LaunchType = &v - return s -} - -// SetLoadBalancers sets the LoadBalancers field's value. -func (s *UpdateServiceInput) SetLoadBalancers(v []*LoadBalancer) *UpdateServiceInput { - s.LoadBalancers = v - return s -} - -// SetNetworkConfiguration sets the NetworkConfiguration field's value. -func (s *UpdateServiceInput) SetNetworkConfiguration(v *NetworkConfiguration) *UpdateServiceInput { - s.NetworkConfiguration = v - return s -} - -// SetPlacementConstraints sets the PlacementConstraints field's value. -func (s *UpdateServiceInput) SetPlacementConstraints(v []*PlacementConstraint) *UpdateServiceInput { - s.PlacementConstraints = v - return s -} - -// SetPlacementStrategy sets the PlacementStrategy field's value. -func (s *UpdateServiceInput) SetPlacementStrategy(v []*PlacementStrategy) *UpdateServiceInput { - s.PlacementStrategy = v - return s -} - -// SetPlatformVersion sets the PlatformVersion field's value. -func (s *UpdateServiceInput) SetPlatformVersion(v string) *UpdateServiceInput { - s.PlatformVersion = &v - return s -} - -// SetPropagateTags sets the PropagateTags field's value. -func (s *UpdateServiceInput) SetPropagateTags(v string) *UpdateServiceInput { - s.PropagateTags = &v - return s -} - -// SetService sets the Service field's value. -func (s *UpdateServiceInput) SetService(v string) *UpdateServiceInput { - s.Service = &v - return s -} - -// SetServiceConnectConfiguration sets the ServiceConnectConfiguration field's value. -func (s *UpdateServiceInput) SetServiceConnectConfiguration(v *ServiceConnectConfiguration) *UpdateServiceInput { - s.ServiceConnectConfiguration = v - return s -} - -// SetServiceRegistries sets the ServiceRegistries field's value. -func (s *UpdateServiceInput) SetServiceRegistries(v []*ServiceRegistry) *UpdateServiceInput { - s.ServiceRegistries = v - return s -} - -// SetTaskDefinition sets the TaskDefinition field's value. -func (s *UpdateServiceInput) SetTaskDefinition(v string) *UpdateServiceInput { - s.TaskDefinition = &v - return s -} - -type UpdateServiceOutput struct { - _ struct{} `type:"structure"` - - // The full description of your service following the update call. - Service *Service `locationName:"service" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateServiceOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateServiceOutput) GoString() string { - return s.String() -} - -// SetService sets the Service field's value. -func (s *UpdateServiceOutput) SetService(v *Service) *UpdateServiceOutput { - s.Service = v - return s -} - -type UpdateServicePrimaryTaskSetInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the service that the task set exists in. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` - - // The short name or full Amazon Resource Name (ARN) of the task set to set - // as the primary task set in the deployment. - // - // PrimaryTaskSet is a required field - PrimaryTaskSet *string `locationName:"primaryTaskSet" type:"string" required:"true"` - - // The short name or full Amazon Resource Name (ARN) of the service that the - // task set exists in. - // - // Service is a required field - Service *string `locationName:"service" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateServicePrimaryTaskSetInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateServicePrimaryTaskSetInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *UpdateServicePrimaryTaskSetInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "UpdateServicePrimaryTaskSetInput"} - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - if s.PrimaryTaskSet == nil { - invalidParams.Add(request.NewErrParamRequired("PrimaryTaskSet")) - } - if s.Service == nil { - invalidParams.Add(request.NewErrParamRequired("Service")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *UpdateServicePrimaryTaskSetInput) SetCluster(v string) *UpdateServicePrimaryTaskSetInput { - s.Cluster = &v - return s -} - -// SetPrimaryTaskSet sets the PrimaryTaskSet field's value. -func (s *UpdateServicePrimaryTaskSetInput) SetPrimaryTaskSet(v string) *UpdateServicePrimaryTaskSetInput { - s.PrimaryTaskSet = &v - return s -} - -// SetService sets the Service field's value. -func (s *UpdateServicePrimaryTaskSetInput) SetService(v string) *UpdateServicePrimaryTaskSetInput { - s.Service = &v - return s -} - -type UpdateServicePrimaryTaskSetOutput struct { - _ struct{} `type:"structure"` - - // The details about the task set. - TaskSet *TaskSet `locationName:"taskSet" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateServicePrimaryTaskSetOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateServicePrimaryTaskSetOutput) GoString() string { - return s.String() -} - -// SetTaskSet sets the TaskSet field's value. -func (s *UpdateServicePrimaryTaskSetOutput) SetTaskSet(v *TaskSet) *UpdateServicePrimaryTaskSetOutput { - s.TaskSet = v - return s -} - -type UpdateTaskProtectionInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the service that the task sets exist in. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` - - // If you set protectionEnabled to true, you can specify the duration for task - // protection in minutes. You can specify a value from 1 minute to up to 2,880 - // minutes (48 hours). During this time, your task will not be terminated by - // scale-in events from Service Auto Scaling or deployments. After this time - // period lapses, protectionEnabled will be reset to false. - // - // If you don’t specify the time, then the task is automatically protected - // for 120 minutes (2 hours). - ExpiresInMinutes *int64 `locationName:"expiresInMinutes" type:"integer"` - - // Specify true to mark a task for protection and false to unset protection, - // making it eligible for termination. - // - // ProtectionEnabled is a required field - ProtectionEnabled *bool `locationName:"protectionEnabled" type:"boolean" required:"true"` - - // A list of up to 10 task IDs or full ARN entries. - // - // Tasks is a required field - Tasks []*string `locationName:"tasks" type:"list" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateTaskProtectionInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateTaskProtectionInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *UpdateTaskProtectionInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "UpdateTaskProtectionInput"} - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - if s.ProtectionEnabled == nil { - invalidParams.Add(request.NewErrParamRequired("ProtectionEnabled")) - } - if s.Tasks == nil { - invalidParams.Add(request.NewErrParamRequired("Tasks")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *UpdateTaskProtectionInput) SetCluster(v string) *UpdateTaskProtectionInput { - s.Cluster = &v - return s -} - -// SetExpiresInMinutes sets the ExpiresInMinutes field's value. -func (s *UpdateTaskProtectionInput) SetExpiresInMinutes(v int64) *UpdateTaskProtectionInput { - s.ExpiresInMinutes = &v - return s -} - -// SetProtectionEnabled sets the ProtectionEnabled field's value. -func (s *UpdateTaskProtectionInput) SetProtectionEnabled(v bool) *UpdateTaskProtectionInput { - s.ProtectionEnabled = &v - return s -} - -// SetTasks sets the Tasks field's value. -func (s *UpdateTaskProtectionInput) SetTasks(v []*string) *UpdateTaskProtectionInput { - s.Tasks = v - return s -} - -type UpdateTaskProtectionOutput struct { - _ struct{} `type:"structure"` - - // Any failures associated with the call. - Failures []*Failure `locationName:"failures" type:"list"` - - // A list of tasks with the following information. - // - // * taskArn: The task ARN. - // - // * protectionEnabled: The protection status of the task. If scale-in protection - // is turned on for a task, the value is true. Otherwise, it is false. - // - // * expirationDate: The epoch time when protection for the task will expire. - ProtectedTasks []*ProtectedTask `locationName:"protectedTasks" type:"list"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateTaskProtectionOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateTaskProtectionOutput) GoString() string { - return s.String() -} - -// SetFailures sets the Failures field's value. -func (s *UpdateTaskProtectionOutput) SetFailures(v []*Failure) *UpdateTaskProtectionOutput { - s.Failures = v - return s -} - -// SetProtectedTasks sets the ProtectedTasks field's value. -func (s *UpdateTaskProtectionOutput) SetProtectedTasks(v []*ProtectedTask) *UpdateTaskProtectionOutput { - s.ProtectedTasks = v - return s -} - -type UpdateTaskSetInput struct { - _ struct{} `type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the cluster that hosts - // the service that the task set is found in. - // - // Cluster is a required field - Cluster *string `locationName:"cluster" type:"string" required:"true"` - - // A floating-point percentage of the desired number of tasks to place and keep - // running in the task set. - Scale *Scale `locationName:"scale" type:"structure"` - - // The short name or full Amazon Resource Name (ARN) of the service that the - // task set is found in. - // - // Service is a required field - Service *string `locationName:"service" type:"string" required:"true"` - - // The short name or full Amazon Resource Name (ARN) of the task set to update. - // - // TaskSet is a required field - TaskSet *string `locationName:"taskSet" type:"string" required:"true"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateTaskSetInput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateTaskSetInput) GoString() string { - return s.String() -} - -// Validate inspects the fields of the type to determine if they are valid. -func (s *UpdateTaskSetInput) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "UpdateTaskSetInput"} - if s.Cluster == nil { - invalidParams.Add(request.NewErrParamRequired("Cluster")) - } - if s.Service == nil { - invalidParams.Add(request.NewErrParamRequired("Service")) - } - if s.TaskSet == nil { - invalidParams.Add(request.NewErrParamRequired("TaskSet")) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil -} - -// SetCluster sets the Cluster field's value. -func (s *UpdateTaskSetInput) SetCluster(v string) *UpdateTaskSetInput { - s.Cluster = &v - return s -} - -// SetScale sets the Scale field's value. -func (s *UpdateTaskSetInput) SetScale(v *Scale) *UpdateTaskSetInput { - s.Scale = v - return s -} - -// SetService sets the Service field's value. -func (s *UpdateTaskSetInput) SetService(v string) *UpdateTaskSetInput { - s.Service = &v - return s -} - -// SetTaskSet sets the TaskSet field's value. -func (s *UpdateTaskSetInput) SetTaskSet(v string) *UpdateTaskSetInput { - s.TaskSet = &v - return s -} - -type UpdateTaskSetOutput struct { - _ struct{} `type:"structure"` - - // Details about the task set. - TaskSet *TaskSet `locationName:"taskSet" type:"structure"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateTaskSetOutput) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s UpdateTaskSetOutput) GoString() string { - return s.String() -} - -// SetTaskSet sets the TaskSet field's value. -func (s *UpdateTaskSetOutput) SetTaskSet(v *TaskSet) *UpdateTaskSetOutput { - s.TaskSet = v - return s -} - -// The Docker and Amazon ECS container agent version information about a container -// instance. -type VersionInfo struct { - _ struct{} `type:"structure"` - - // The Git commit hash for the Amazon ECS container agent build on the amazon-ecs-agent - // (https://github.com/aws/amazon-ecs-agent/commits/master) GitHub repository. - AgentHash *string `locationName:"agentHash" type:"string"` - - // The version number of the Amazon ECS container agent. - AgentVersion *string `locationName:"agentVersion" type:"string"` - - // The Docker version that's running on the container instance. - DockerVersion *string `locationName:"dockerVersion" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s VersionInfo) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s VersionInfo) GoString() string { - return s.String() -} - -// SetAgentHash sets the AgentHash field's value. -func (s *VersionInfo) SetAgentHash(v string) *VersionInfo { - s.AgentHash = &v - return s -} - -// SetAgentVersion sets the AgentVersion field's value. -func (s *VersionInfo) SetAgentVersion(v string) *VersionInfo { - s.AgentVersion = &v - return s -} - -// SetDockerVersion sets the DockerVersion field's value. -func (s *VersionInfo) SetDockerVersion(v string) *VersionInfo { - s.DockerVersion = &v - return s -} - -// A data volume that's used in a task definition. For tasks that use the Amazon -// Elastic File System (Amazon EFS), specify an efsVolumeConfiguration. For -// Windows tasks that use Amazon FSx for Windows File Server file system, specify -// a fsxWindowsFileServerVolumeConfiguration. For tasks that use a Docker volume, -// specify a DockerVolumeConfiguration. For tasks that use a bind mount host -// volume, specify a host and optional sourcePath. For more information, see -// Using Data Volumes in Tasks (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_data_volumes.html). -type Volume struct { - _ struct{} `type:"structure"` - - // This parameter is specified when you use Docker volumes. - // - // Windows containers only support the use of the local driver. To use bind - // mounts, specify the host parameter instead. - // - // Docker volumes aren't supported by tasks run on Fargate. - DockerVolumeConfiguration *DockerVolumeConfiguration `locationName:"dockerVolumeConfiguration" type:"structure"` - - // This parameter is specified when you use bind mount host volumes. The contents - // of the host parameter determine whether your bind mount host volume persists - // on the host container instance and where it's stored. If the host parameter - // is empty, then the Docker daemon assigns a host path for your data volume. - // However, the data isn't guaranteed to persist after the containers that are - // associated with it stop running. - // - // Windows containers can mount whole directories on the same drive as $env:ProgramData. - // Windows containers can't mount directories on a different drive, and mount - // point can't be across drives. For example, you can mount C:\my\path:C:\my\path - // and D:\:D:\, but not D:\my\path:C:\my\path or D:\:C:\my\path. - Host *HostVolumeProperties `locationName:"host" type:"structure"` - - // The name of the volume. Up to 255 letters (uppercase and lowercase), numbers, - // underscores, and hyphens are allowed. This name is referenced in the sourceVolume - // parameter of container definition mountPoints. - // - // This is required wwhen you use an Amazon EFS volume. - Name *string `locationName:"name" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Volume) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s Volume) GoString() string { - return s.String() -} - -// SetDockerVolumeConfiguration sets the DockerVolumeConfiguration field's value. -func (s *Volume) SetDockerVolumeConfiguration(v *DockerVolumeConfiguration) *Volume { - s.DockerVolumeConfiguration = v - return s -} - -// SetHost sets the Host field's value. -func (s *Volume) SetHost(v *HostVolumeProperties) *Volume { - s.Host = v - return s -} - -// SetName sets the Name field's value. -func (s *Volume) SetName(v string) *Volume { - s.Name = &v - return s -} - -// Details on a data volume from another container in the same task definition. -type VolumeFrom struct { - _ struct{} `type:"structure"` - - // If this value is true, the container has read-only access to the volume. - // If this value is false, then the container can write to the volume. The default - // value is false. - ReadOnly *bool `locationName:"readOnly" type:"boolean"` - - // The name of another container within the same task definition to mount volumes - // from. - SourceContainer *string `locationName:"sourceContainer" type:"string"` -} - -// String returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s VolumeFrom) String() string { - return awsutil.Prettify(s) -} - -// GoString returns the string representation. -// -// API parameter values that are decorated as "sensitive" in the API will not -// be included in the string output. The member name will be present, but the -// value will be replaced with "sensitive". -func (s VolumeFrom) GoString() string { - return s.String() -} - -// SetReadOnly sets the ReadOnly field's value. -func (s *VolumeFrom) SetReadOnly(v bool) *VolumeFrom { - s.ReadOnly = &v - return s -} - -// SetSourceContainer sets the SourceContainer field's value. -func (s *VolumeFrom) SetSourceContainer(v string) *VolumeFrom { - s.SourceContainer = &v - return s -} - -const ( - // AgentUpdateStatusPending is a AgentUpdateStatus enum value - AgentUpdateStatusPending = "PENDING" - - // AgentUpdateStatusStaging is a AgentUpdateStatus enum value - AgentUpdateStatusStaging = "STAGING" - - // AgentUpdateStatusStaged is a AgentUpdateStatus enum value - AgentUpdateStatusStaged = "STAGED" - - // AgentUpdateStatusUpdating is a AgentUpdateStatus enum value - AgentUpdateStatusUpdating = "UPDATING" - - // AgentUpdateStatusUpdated is a AgentUpdateStatus enum value - AgentUpdateStatusUpdated = "UPDATED" - - // AgentUpdateStatusFailed is a AgentUpdateStatus enum value - AgentUpdateStatusFailed = "FAILED" -) - -// AgentUpdateStatus_Values returns all elements of the AgentUpdateStatus enum -func AgentUpdateStatus_Values() []string { - return []string{ - AgentUpdateStatusPending, - AgentUpdateStatusStaging, - AgentUpdateStatusStaged, - AgentUpdateStatusUpdating, - AgentUpdateStatusUpdated, - AgentUpdateStatusFailed, - } -} - -const ( - // ApplicationProtocolHttp is a ApplicationProtocol enum value - ApplicationProtocolHttp = "http" - - // ApplicationProtocolHttp2 is a ApplicationProtocol enum value - ApplicationProtocolHttp2 = "http2" - - // ApplicationProtocolGrpc is a ApplicationProtocol enum value - ApplicationProtocolGrpc = "grpc" -) - -// ApplicationProtocol_Values returns all elements of the ApplicationProtocol enum -func ApplicationProtocol_Values() []string { - return []string{ - ApplicationProtocolHttp, - ApplicationProtocolHttp2, - ApplicationProtocolGrpc, - } -} - -const ( - // AssignPublicIpEnabled is a AssignPublicIp enum value - AssignPublicIpEnabled = "ENABLED" - - // AssignPublicIpDisabled is a AssignPublicIp enum value - AssignPublicIpDisabled = "DISABLED" -) - -// AssignPublicIp_Values returns all elements of the AssignPublicIp enum -func AssignPublicIp_Values() []string { - return []string{ - AssignPublicIpEnabled, - AssignPublicIpDisabled, - } -} - -const ( - // CapacityProviderFieldTags is a CapacityProviderField enum value - CapacityProviderFieldTags = "TAGS" -) - -// CapacityProviderField_Values returns all elements of the CapacityProviderField enum -func CapacityProviderField_Values() []string { - return []string{ - CapacityProviderFieldTags, - } -} - -const ( - // CapacityProviderStatusActive is a CapacityProviderStatus enum value - CapacityProviderStatusActive = "ACTIVE" - - // CapacityProviderStatusInactive is a CapacityProviderStatus enum value - CapacityProviderStatusInactive = "INACTIVE" -) - -// CapacityProviderStatus_Values returns all elements of the CapacityProviderStatus enum -func CapacityProviderStatus_Values() []string { - return []string{ - CapacityProviderStatusActive, - CapacityProviderStatusInactive, - } -} - -const ( - // CapacityProviderUpdateStatusDeleteInProgress is a CapacityProviderUpdateStatus enum value - CapacityProviderUpdateStatusDeleteInProgress = "DELETE_IN_PROGRESS" - - // CapacityProviderUpdateStatusDeleteComplete is a CapacityProviderUpdateStatus enum value - CapacityProviderUpdateStatusDeleteComplete = "DELETE_COMPLETE" - - // CapacityProviderUpdateStatusDeleteFailed is a CapacityProviderUpdateStatus enum value - CapacityProviderUpdateStatusDeleteFailed = "DELETE_FAILED" - - // CapacityProviderUpdateStatusUpdateInProgress is a CapacityProviderUpdateStatus enum value - CapacityProviderUpdateStatusUpdateInProgress = "UPDATE_IN_PROGRESS" - - // CapacityProviderUpdateStatusUpdateComplete is a CapacityProviderUpdateStatus enum value - CapacityProviderUpdateStatusUpdateComplete = "UPDATE_COMPLETE" - - // CapacityProviderUpdateStatusUpdateFailed is a CapacityProviderUpdateStatus enum value - CapacityProviderUpdateStatusUpdateFailed = "UPDATE_FAILED" -) - -// CapacityProviderUpdateStatus_Values returns all elements of the CapacityProviderUpdateStatus enum -func CapacityProviderUpdateStatus_Values() []string { - return []string{ - CapacityProviderUpdateStatusDeleteInProgress, - CapacityProviderUpdateStatusDeleteComplete, - CapacityProviderUpdateStatusDeleteFailed, - CapacityProviderUpdateStatusUpdateInProgress, - CapacityProviderUpdateStatusUpdateComplete, - CapacityProviderUpdateStatusUpdateFailed, - } -} - -const ( - // ClusterFieldAttachments is a ClusterField enum value - ClusterFieldAttachments = "ATTACHMENTS" - - // ClusterFieldConfigurations is a ClusterField enum value - ClusterFieldConfigurations = "CONFIGURATIONS" - - // ClusterFieldSettings is a ClusterField enum value - ClusterFieldSettings = "SETTINGS" - - // ClusterFieldStatistics is a ClusterField enum value - ClusterFieldStatistics = "STATISTICS" - - // ClusterFieldTags is a ClusterField enum value - ClusterFieldTags = "TAGS" - - // ClusterFieldDefaults is a ClusterField enum value - ClusterFieldDefaults = "DEFAULTS" -) - -// ClusterField_Values returns all elements of the ClusterField enum -func ClusterField_Values() []string { - return []string{ - ClusterFieldAttachments, - ClusterFieldConfigurations, - ClusterFieldSettings, - ClusterFieldStatistics, - ClusterFieldTags, - ClusterFieldDefaults, - } -} - -const ( - // ClusterSettingNameContainerInsights is a ClusterSettingName enum value - ClusterSettingNameContainerInsights = "containerInsights" -) - -// ClusterSettingName_Values returns all elements of the ClusterSettingName enum -func ClusterSettingName_Values() []string { - return []string{ - ClusterSettingNameContainerInsights, - } -} - -const ( - // CompatibilityEc2 is a Compatibility enum value - CompatibilityEc2 = "EC2" - - // CompatibilityFargate is a Compatibility enum value - CompatibilityFargate = "FARGATE" - - // CompatibilityExternal is a Compatibility enum value - CompatibilityExternal = "EXTERNAL" -) - -// Compatibility_Values returns all elements of the Compatibility enum -func Compatibility_Values() []string { - return []string{ - CompatibilityEc2, - CompatibilityFargate, - CompatibilityExternal, - } -} - -const ( - // ConnectivityConnected is a Connectivity enum value - ConnectivityConnected = "CONNECTED" - - // ConnectivityDisconnected is a Connectivity enum value - ConnectivityDisconnected = "DISCONNECTED" -) - -// Connectivity_Values returns all elements of the Connectivity enum -func Connectivity_Values() []string { - return []string{ - ConnectivityConnected, - ConnectivityDisconnected, - } -} - -const ( - // ContainerConditionStart is a ContainerCondition enum value - ContainerConditionStart = "START" - - // ContainerConditionComplete is a ContainerCondition enum value - ContainerConditionComplete = "COMPLETE" - - // ContainerConditionSuccess is a ContainerCondition enum value - ContainerConditionSuccess = "SUCCESS" - - // ContainerConditionHealthy is a ContainerCondition enum value - ContainerConditionHealthy = "HEALTHY" -) - -// ContainerCondition_Values returns all elements of the ContainerCondition enum -func ContainerCondition_Values() []string { - return []string{ - ContainerConditionStart, - ContainerConditionComplete, - ContainerConditionSuccess, - ContainerConditionHealthy, - } -} - -const ( - // ContainerInstanceFieldTags is a ContainerInstanceField enum value - ContainerInstanceFieldTags = "TAGS" - - // ContainerInstanceFieldContainerInstanceHealth is a ContainerInstanceField enum value - ContainerInstanceFieldContainerInstanceHealth = "CONTAINER_INSTANCE_HEALTH" -) - -// ContainerInstanceField_Values returns all elements of the ContainerInstanceField enum -func ContainerInstanceField_Values() []string { - return []string{ - ContainerInstanceFieldTags, - ContainerInstanceFieldContainerInstanceHealth, - } -} - -const ( - // ContainerInstanceStatusActive is a ContainerInstanceStatus enum value - ContainerInstanceStatusActive = "ACTIVE" - - // ContainerInstanceStatusDraining is a ContainerInstanceStatus enum value - ContainerInstanceStatusDraining = "DRAINING" - - // ContainerInstanceStatusRegistering is a ContainerInstanceStatus enum value - ContainerInstanceStatusRegistering = "REGISTERING" - - // ContainerInstanceStatusDeregistering is a ContainerInstanceStatus enum value - ContainerInstanceStatusDeregistering = "DEREGISTERING" - - // ContainerInstanceStatusRegistrationFailed is a ContainerInstanceStatus enum value - ContainerInstanceStatusRegistrationFailed = "REGISTRATION_FAILED" -) - -// ContainerInstanceStatus_Values returns all elements of the ContainerInstanceStatus enum -func ContainerInstanceStatus_Values() []string { - return []string{ - ContainerInstanceStatusActive, - ContainerInstanceStatusDraining, - ContainerInstanceStatusRegistering, - ContainerInstanceStatusDeregistering, - ContainerInstanceStatusRegistrationFailed, - } -} - -const ( - // DeploymentControllerTypeEcs is a DeploymentControllerType enum value - DeploymentControllerTypeEcs = "ECS" - - // DeploymentControllerTypeCodeDeploy is a DeploymentControllerType enum value - DeploymentControllerTypeCodeDeploy = "CODE_DEPLOY" - - // DeploymentControllerTypeExternal is a DeploymentControllerType enum value - DeploymentControllerTypeExternal = "EXTERNAL" -) - -// DeploymentControllerType_Values returns all elements of the DeploymentControllerType enum -func DeploymentControllerType_Values() []string { - return []string{ - DeploymentControllerTypeEcs, - DeploymentControllerTypeCodeDeploy, - DeploymentControllerTypeExternal, - } -} - -const ( - // DesiredStatusRunning is a DesiredStatus enum value - DesiredStatusRunning = "RUNNING" - - // DesiredStatusPending is a DesiredStatus enum value - DesiredStatusPending = "PENDING" - - // DesiredStatusStopped is a DesiredStatus enum value - DesiredStatusStopped = "STOPPED" -) - -// DesiredStatus_Values returns all elements of the DesiredStatus enum -func DesiredStatus_Values() []string { - return []string{ - DesiredStatusRunning, - DesiredStatusPending, - DesiredStatusStopped, - } -} - -const ( - // DeviceCgroupPermissionRead is a DeviceCgroupPermission enum value - DeviceCgroupPermissionRead = "read" - - // DeviceCgroupPermissionWrite is a DeviceCgroupPermission enum value - DeviceCgroupPermissionWrite = "write" - - // DeviceCgroupPermissionMknod is a DeviceCgroupPermission enum value - DeviceCgroupPermissionMknod = "mknod" -) - -// DeviceCgroupPermission_Values returns all elements of the DeviceCgroupPermission enum -func DeviceCgroupPermission_Values() []string { - return []string{ - DeviceCgroupPermissionRead, - DeviceCgroupPermissionWrite, - DeviceCgroupPermissionMknod, - } -} - -const ( - // ExecuteCommandLoggingNone is a ExecuteCommandLogging enum value - ExecuteCommandLoggingNone = "NONE" - - // ExecuteCommandLoggingDefault is a ExecuteCommandLogging enum value - ExecuteCommandLoggingDefault = "DEFAULT" - - // ExecuteCommandLoggingOverride is a ExecuteCommandLogging enum value - ExecuteCommandLoggingOverride = "OVERRIDE" -) - -// ExecuteCommandLogging_Values returns all elements of the ExecuteCommandLogging enum -func ExecuteCommandLogging_Values() []string { - return []string{ - ExecuteCommandLoggingNone, - ExecuteCommandLoggingDefault, - ExecuteCommandLoggingOverride, - } -} - -const ( - // FirelensConfigurationTypeFluentd is a FirelensConfigurationType enum value - FirelensConfigurationTypeFluentd = "fluentd" - - // FirelensConfigurationTypeFluentbit is a FirelensConfigurationType enum value - FirelensConfigurationTypeFluentbit = "fluentbit" -) - -// FirelensConfigurationType_Values returns all elements of the FirelensConfigurationType enum -func FirelensConfigurationType_Values() []string { - return []string{ - FirelensConfigurationTypeFluentd, - FirelensConfigurationTypeFluentbit, - } -} - -const ( - // HealthStatusHealthy is a HealthStatus enum value - HealthStatusHealthy = "HEALTHY" - - // HealthStatusUnhealthy is a HealthStatus enum value - HealthStatusUnhealthy = "UNHEALTHY" - - // HealthStatusUnknown is a HealthStatus enum value - HealthStatusUnknown = "UNKNOWN" -) - -// HealthStatus_Values returns all elements of the HealthStatus enum -func HealthStatus_Values() []string { - return []string{ - HealthStatusHealthy, - HealthStatusUnhealthy, - HealthStatusUnknown, - } -} - -const ( - // IpcModeHost is a IpcMode enum value - IpcModeHost = "host" - - // IpcModeTask is a IpcMode enum value - IpcModeTask = "task" - - // IpcModeNone is a IpcMode enum value - IpcModeNone = "none" -) - -// IpcMode_Values returns all elements of the IpcMode enum -func IpcMode_Values() []string { - return []string{ - IpcModeHost, - IpcModeTask, - IpcModeNone, - } -} - -const ( - // LaunchTypeEc2 is a LaunchType enum value - LaunchTypeEc2 = "EC2" - - // LaunchTypeFargate is a LaunchType enum value - LaunchTypeFargate = "FARGATE" - - // LaunchTypeExternal is a LaunchType enum value - LaunchTypeExternal = "EXTERNAL" -) - -// LaunchType_Values returns all elements of the LaunchType enum -func LaunchType_Values() []string { - return []string{ - LaunchTypeEc2, - LaunchTypeFargate, - LaunchTypeExternal, - } -} - -const ( - // LogDriverJsonFile is a LogDriver enum value - LogDriverJsonFile = "json-file" - - // LogDriverSyslog is a LogDriver enum value - LogDriverSyslog = "syslog" - - // LogDriverJournald is a LogDriver enum value - LogDriverJournald = "journald" - - // LogDriverGelf is a LogDriver enum value - LogDriverGelf = "gelf" - - // LogDriverFluentd is a LogDriver enum value - LogDriverFluentd = "fluentd" - - // LogDriverAwslogs is a LogDriver enum value - LogDriverAwslogs = "awslogs" - - // LogDriverSplunk is a LogDriver enum value - LogDriverSplunk = "splunk" - - // LogDriverAwsfirelens is a LogDriver enum value - LogDriverAwsfirelens = "awsfirelens" -) - -// LogDriver_Values returns all elements of the LogDriver enum -func LogDriver_Values() []string { - return []string{ - LogDriverJsonFile, - LogDriverSyslog, - LogDriverJournald, - LogDriverGelf, - LogDriverFluentd, - LogDriverAwslogs, - LogDriverSplunk, - LogDriverAwsfirelens, - } -} - -const ( - // ManagedAgentNameExecuteCommandAgent is a ManagedAgentName enum value - ManagedAgentNameExecuteCommandAgent = "ExecuteCommandAgent" -) - -// ManagedAgentName_Values returns all elements of the ManagedAgentName enum -func ManagedAgentName_Values() []string { - return []string{ - ManagedAgentNameExecuteCommandAgent, - } -} - -const ( - // ManagedScalingScalingApproachScalingPolicy is a ManagedScalingScalingApproach enum value - ManagedScalingScalingApproachScalingPolicy = "SCALING_POLICY" - - // ManagedScalingScalingApproachScalingPlan is a ManagedScalingScalingApproach enum value - ManagedScalingScalingApproachScalingPlan = "SCALING_PLAN" -) - -// ManagedScalingScalingApproach_Values returns all elements of the ManagedScalingScalingApproach enum -func ManagedScalingScalingApproach_Values() []string { - return []string{ - ManagedScalingScalingApproachScalingPolicy, - ManagedScalingScalingApproachScalingPlan, - } -} - -const ( - // ManagedScalingStatusEnabled is a ManagedScalingStatus enum value - ManagedScalingStatusEnabled = "ENABLED" - - // ManagedScalingStatusDisabled is a ManagedScalingStatus enum value - ManagedScalingStatusDisabled = "DISABLED" -) - -// ManagedScalingStatus_Values returns all elements of the ManagedScalingStatus enum -func ManagedScalingStatus_Values() []string { - return []string{ - ManagedScalingStatusEnabled, - ManagedScalingStatusDisabled, - } -} - -const ( - // ManagedTerminationProtectionEnabled is a ManagedTerminationProtection enum value - ManagedTerminationProtectionEnabled = "ENABLED" - - // ManagedTerminationProtectionDisabled is a ManagedTerminationProtection enum value - ManagedTerminationProtectionDisabled = "DISABLED" -) - -// ManagedTerminationProtection_Values returns all elements of the ManagedTerminationProtection enum -func ManagedTerminationProtection_Values() []string { - return []string{ - ManagedTerminationProtectionEnabled, - ManagedTerminationProtectionDisabled, - } -} - -const ( - // NetworkModeBridge is a NetworkMode enum value - NetworkModeBridge = "bridge" - - // NetworkModeHost is a NetworkMode enum value - NetworkModeHost = "host" - - // NetworkModeAwsvpc is a NetworkMode enum value - NetworkModeAwsvpc = "awsvpc" - - // NetworkModeNone is a NetworkMode enum value - NetworkModeNone = "none" -) - -// NetworkMode_Values returns all elements of the NetworkMode enum -func NetworkMode_Values() []string { - return []string{ - NetworkModeBridge, - NetworkModeHost, - NetworkModeAwsvpc, - NetworkModeNone, - } -} - -const ( - // PidModeHost is a PidMode enum value - PidModeHost = "host" - - // PidModeTask is a PidMode enum value - PidModeTask = "task" -) - -// PidMode_Values returns all elements of the PidMode enum -func PidMode_Values() []string { - return []string{ - PidModeHost, - PidModeTask, - } -} - -const ( - // PlacementConstraintTypeDistinctInstance is a PlacementConstraintType enum value - PlacementConstraintTypeDistinctInstance = "distinctInstance" - - // PlacementConstraintTypeMemberOf is a PlacementConstraintType enum value - PlacementConstraintTypeMemberOf = "memberOf" -) - -// PlacementConstraintType_Values returns all elements of the PlacementConstraintType enum -func PlacementConstraintType_Values() []string { - return []string{ - PlacementConstraintTypeDistinctInstance, - PlacementConstraintTypeMemberOf, - } -} - -const ( - // PlacementStrategyTypeRandom is a PlacementStrategyType enum value - PlacementStrategyTypeRandom = "random" - - // PlacementStrategyTypeSpread is a PlacementStrategyType enum value - PlacementStrategyTypeSpread = "spread" - - // PlacementStrategyTypeBinpack is a PlacementStrategyType enum value - PlacementStrategyTypeBinpack = "binpack" -) - -// PlacementStrategyType_Values returns all elements of the PlacementStrategyType enum -func PlacementStrategyType_Values() []string { - return []string{ - PlacementStrategyTypeRandom, - PlacementStrategyTypeSpread, - PlacementStrategyTypeBinpack, - } -} - -const ( - // PlatformDeviceTypeGpu is a PlatformDeviceType enum value - PlatformDeviceTypeGpu = "GPU" -) - -// PlatformDeviceType_Values returns all elements of the PlatformDeviceType enum -func PlatformDeviceType_Values() []string { - return []string{ - PlatformDeviceTypeGpu, - } -} - -const ( - // PropagateTagsTaskDefinition is a PropagateTags enum value - PropagateTagsTaskDefinition = "TASK_DEFINITION" - - // PropagateTagsService is a PropagateTags enum value - PropagateTagsService = "SERVICE" - - // PropagateTagsNone is a PropagateTags enum value - PropagateTagsNone = "NONE" -) - -// PropagateTags_Values returns all elements of the PropagateTags enum -func PropagateTags_Values() []string { - return []string{ - PropagateTagsTaskDefinition, - PropagateTagsService, - PropagateTagsNone, - } -} - -const ( - // ProxyConfigurationTypeAppmesh is a ProxyConfigurationType enum value - ProxyConfigurationTypeAppmesh = "APPMESH" -) - -// ProxyConfigurationType_Values returns all elements of the ProxyConfigurationType enum -func ProxyConfigurationType_Values() []string { - return []string{ - ProxyConfigurationTypeAppmesh, - } -} - -const ( - // ResourceTypeGpu is a ResourceType enum value - ResourceTypeGpu = "GPU" - - // ResourceTypeInferenceAccelerator is a ResourceType enum value - ResourceTypeInferenceAccelerator = "InferenceAccelerator" -) - -// ResourceType_Values returns all elements of the ResourceType enum -func ResourceType_Values() []string { - return []string{ - ResourceTypeGpu, - ResourceTypeInferenceAccelerator, - } -} - -const ( - // ScaleUnitPercent is a ScaleUnit enum value - ScaleUnitPercent = "PERCENT" -) - -// ScaleUnit_Values returns all elements of the ScaleUnit enum -func ScaleUnit_Values() []string { - return []string{ - ScaleUnitPercent, - } -} - -const ( - // SchedulingStrategyReplica is a SchedulingStrategy enum value - SchedulingStrategyReplica = "REPLICA" - - // SchedulingStrategyDaemon is a SchedulingStrategy enum value - SchedulingStrategyDaemon = "DAEMON" -) - -// SchedulingStrategy_Values returns all elements of the SchedulingStrategy enum -func SchedulingStrategy_Values() []string { - return []string{ - SchedulingStrategyReplica, - SchedulingStrategyDaemon, - } -} - -const ( - // ScopeTask is a Scope enum value - ScopeTask = "task" - - // ScopeShared is a Scope enum value - ScopeShared = "shared" -) - -// Scope_Values returns all elements of the Scope enum -func Scope_Values() []string { - return []string{ - ScopeTask, - ScopeShared, - } -} - -const ( - // ServiceFieldTags is a ServiceField enum value - ServiceFieldTags = "TAGS" -) - -// ServiceField_Values returns all elements of the ServiceField enum -func ServiceField_Values() []string { - return []string{ - ServiceFieldTags, - } -} - -const ( - // SettingNameServiceLongArnFormat is a SettingName enum value - SettingNameServiceLongArnFormat = "serviceLongArnFormat" - - // SettingNameTaskLongArnFormat is a SettingName enum value - SettingNameTaskLongArnFormat = "taskLongArnFormat" - - // SettingNameContainerInstanceLongArnFormat is a SettingName enum value - SettingNameContainerInstanceLongArnFormat = "containerInstanceLongArnFormat" - - // SettingNameAwsvpcTrunking is a SettingName enum value - SettingNameAwsvpcTrunking = "awsvpcTrunking" - - // SettingNameContainerInsights is a SettingName enum value - SettingNameContainerInsights = "containerInsights" - - // SettingNameFargateVcpulimit is a SettingName enum value - SettingNameFargateVcpulimit = "fargateVCPULimit" - - // SettingNameTagResourceAuthorization is a SettingName enum value - SettingNameTagResourceAuthorization = "tagResourceAuthorization" - - // SettingNameFargateFipsmode is a SettingName enum value - SettingNameFargateFipsmode = "fargateFIPSMode" - - // SettingNameGuardDutyActivate is a SettingName enum value - SettingNameGuardDutyActivate = "guardDutyActivate" - - // SettingNameFargateTaskRetirementWaitPeriod is a SettingName enum value - SettingNameFargateTaskRetirementWaitPeriod = "fargateTaskRetirementWaitPeriod" -) - -// SettingName_Values returns all elements of the SettingName enum -func SettingName_Values() []string { - return []string{ - SettingNameServiceLongArnFormat, - SettingNameTaskLongArnFormat, - SettingNameContainerInstanceLongArnFormat, - SettingNameAwsvpcTrunking, - SettingNameContainerInsights, - SettingNameFargateVcpulimit, - SettingNameTagResourceAuthorization, - SettingNameFargateFipsmode, - SettingNameGuardDutyActivate, - SettingNameFargateTaskRetirementWaitPeriod, - } -} - -const ( - // SortOrderAsc is a SortOrder enum value - SortOrderAsc = "ASC" - - // SortOrderDesc is a SortOrder enum value - SortOrderDesc = "DESC" -) - -// SortOrder_Values returns all elements of the SortOrder enum -func SortOrder_Values() []string { - return []string{ - SortOrderAsc, - SortOrderDesc, - } -} - -const ( - // StabilityStatusSteadyState is a StabilityStatus enum value - StabilityStatusSteadyState = "STEADY_STATE" - - // StabilityStatusStabilizing is a StabilityStatus enum value - StabilityStatusStabilizing = "STABILIZING" -) - -// StabilityStatus_Values returns all elements of the StabilityStatus enum -func StabilityStatus_Values() []string { - return []string{ - StabilityStatusSteadyState, - StabilityStatusStabilizing, - } -} - -const ( - // TargetTypeContainerInstance is a TargetType enum value - TargetTypeContainerInstance = "container-instance" -) - -// TargetType_Values returns all elements of the TargetType enum -func TargetType_Values() []string { - return []string{ - TargetTypeContainerInstance, - } -} - -const ( - // TaskDefinitionFamilyStatusActive is a TaskDefinitionFamilyStatus enum value - TaskDefinitionFamilyStatusActive = "ACTIVE" - - // TaskDefinitionFamilyStatusInactive is a TaskDefinitionFamilyStatus enum value - TaskDefinitionFamilyStatusInactive = "INACTIVE" - - // TaskDefinitionFamilyStatusAll is a TaskDefinitionFamilyStatus enum value - TaskDefinitionFamilyStatusAll = "ALL" -) - -// TaskDefinitionFamilyStatus_Values returns all elements of the TaskDefinitionFamilyStatus enum -func TaskDefinitionFamilyStatus_Values() []string { - return []string{ - TaskDefinitionFamilyStatusActive, - TaskDefinitionFamilyStatusInactive, - TaskDefinitionFamilyStatusAll, - } -} - -const ( - // TaskDefinitionFieldTags is a TaskDefinitionField enum value - TaskDefinitionFieldTags = "TAGS" -) - -// TaskDefinitionField_Values returns all elements of the TaskDefinitionField enum -func TaskDefinitionField_Values() []string { - return []string{ - TaskDefinitionFieldTags, - } -} - -const ( - // TaskDefinitionPlacementConstraintTypeMemberOf is a TaskDefinitionPlacementConstraintType enum value - TaskDefinitionPlacementConstraintTypeMemberOf = "memberOf" -) - -// TaskDefinitionPlacementConstraintType_Values returns all elements of the TaskDefinitionPlacementConstraintType enum -func TaskDefinitionPlacementConstraintType_Values() []string { - return []string{ - TaskDefinitionPlacementConstraintTypeMemberOf, - } -} - -const ( - // TaskDefinitionStatusActive is a TaskDefinitionStatus enum value - TaskDefinitionStatusActive = "ACTIVE" - - // TaskDefinitionStatusInactive is a TaskDefinitionStatus enum value - TaskDefinitionStatusInactive = "INACTIVE" - - // TaskDefinitionStatusDeleteInProgress is a TaskDefinitionStatus enum value - TaskDefinitionStatusDeleteInProgress = "DELETE_IN_PROGRESS" -) - -// TaskDefinitionStatus_Values returns all elements of the TaskDefinitionStatus enum -func TaskDefinitionStatus_Values() []string { - return []string{ - TaskDefinitionStatusActive, - TaskDefinitionStatusInactive, - TaskDefinitionStatusDeleteInProgress, - } -} - -const ( - // TaskFieldTags is a TaskField enum value - TaskFieldTags = "TAGS" -) - -// TaskField_Values returns all elements of the TaskField enum -func TaskField_Values() []string { - return []string{ - TaskFieldTags, - } -} - -const ( - // TaskSetFieldTags is a TaskSetField enum value - TaskSetFieldTags = "TAGS" -) - -// TaskSetField_Values returns all elements of the TaskSetField enum -func TaskSetField_Values() []string { - return []string{ - TaskSetFieldTags, - } -} - -const ( - // TaskStopCodeTaskFailedToStart is a TaskStopCode enum value - TaskStopCodeTaskFailedToStart = "TaskFailedToStart" - - // TaskStopCodeEssentialContainerExited is a TaskStopCode enum value - TaskStopCodeEssentialContainerExited = "EssentialContainerExited" - - // TaskStopCodeUserInitiated is a TaskStopCode enum value - TaskStopCodeUserInitiated = "UserInitiated" - - // TaskStopCodeServiceSchedulerInitiated is a TaskStopCode enum value - TaskStopCodeServiceSchedulerInitiated = "ServiceSchedulerInitiated" - - // TaskStopCodeSpotInterruption is a TaskStopCode enum value - TaskStopCodeSpotInterruption = "SpotInterruption" - - // TaskStopCodeTerminationNotice is a TaskStopCode enum value - TaskStopCodeTerminationNotice = "TerminationNotice" -) - -// TaskStopCode_Values returns all elements of the TaskStopCode enum -func TaskStopCode_Values() []string { - return []string{ - TaskStopCodeTaskFailedToStart, - TaskStopCodeEssentialContainerExited, - TaskStopCodeUserInitiated, - TaskStopCodeServiceSchedulerInitiated, - TaskStopCodeSpotInterruption, - TaskStopCodeTerminationNotice, - } -} - -const ( - // TransportProtocolTcp is a TransportProtocol enum value - TransportProtocolTcp = "tcp" - - // TransportProtocolUdp is a TransportProtocol enum value - TransportProtocolUdp = "udp" -) - -// TransportProtocol_Values returns all elements of the TransportProtocol enum -func TransportProtocol_Values() []string { - return []string{ - TransportProtocolTcp, - TransportProtocolUdp, - } -} - -const ( - // UlimitNameCore is a UlimitName enum value - UlimitNameCore = "core" - - // UlimitNameCpu is a UlimitName enum value - UlimitNameCpu = "cpu" - - // UlimitNameData is a UlimitName enum value - UlimitNameData = "data" - - // UlimitNameFsize is a UlimitName enum value - UlimitNameFsize = "fsize" - - // UlimitNameLocks is a UlimitName enum value - UlimitNameLocks = "locks" - - // UlimitNameMemlock is a UlimitName enum value - UlimitNameMemlock = "memlock" - - // UlimitNameMsgqueue is a UlimitName enum value - UlimitNameMsgqueue = "msgqueue" - - // UlimitNameNice is a UlimitName enum value - UlimitNameNice = "nice" - - // UlimitNameNofile is a UlimitName enum value - UlimitNameNofile = "nofile" - - // UlimitNameNproc is a UlimitName enum value - UlimitNameNproc = "nproc" - - // UlimitNameRss is a UlimitName enum value - UlimitNameRss = "rss" - - // UlimitNameRtprio is a UlimitName enum value - UlimitNameRtprio = "rtprio" - - // UlimitNameRttime is a UlimitName enum value - UlimitNameRttime = "rttime" - - // UlimitNameSigpending is a UlimitName enum value - UlimitNameSigpending = "sigpending" - - // UlimitNameStack is a UlimitName enum value - UlimitNameStack = "stack" -) - -// UlimitName_Values returns all elements of the UlimitName enum -func UlimitName_Values() []string { - return []string{ - UlimitNameCore, - UlimitNameCpu, - UlimitNameData, - UlimitNameFsize, - UlimitNameLocks, - UlimitNameMemlock, - UlimitNameMsgqueue, - UlimitNameNice, - UlimitNameNofile, - UlimitNameNproc, - UlimitNameRss, - UlimitNameRtprio, - UlimitNameRttime, - UlimitNameSigpending, - UlimitNameStack, - } -} diff --git a/ecs-agent/ecs/model/ecs/errors.go b/ecs-agent/ecs/model/ecs/errors.go deleted file mode 100644 index 82d7109d365..00000000000 --- a/ecs-agent/ecs/model/ecs/errors.go +++ /dev/null @@ -1,246 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. -// -// Code generated by [agent/gogenerate/awssdk.go] DO NOT EDIT. - -package ecs - -import ( - "github.com/aws/aws-sdk-go/private/protocol" -) - -const ( - - // ErrCodeAccessDeniedException for service response error code - // "AccessDeniedException". - // - // You don't have authorization to perform the requested action. - ErrCodeAccessDeniedException = "AccessDeniedException" - - // ErrCodeAttributeLimitExceededException for service response error code - // "AttributeLimitExceededException". - // - // You can apply up to 10 custom attributes for each resource. You can view - // the attributes of a resource with ListAttributes. You can remove existing - // attributes on a resource with DeleteAttributes. - ErrCodeAttributeLimitExceededException = "AttributeLimitExceededException" - - // ErrCodeBlockedException for service response error code - // "BlockedException". - // - // Your Amazon Web Services account was blocked. For more information, contact - // Amazon Web Services Support (http://aws.amazon.com/contact-us/). - ErrCodeBlockedException = "BlockedException" - - // ErrCodeClientException for service response error code - // "ClientException". - // - // These errors are usually caused by a client action. This client action might - // be using an action or resource on behalf of a user that doesn't have permissions - // to use the action or resource,. Or, it might be specifying an identifier - // that isn't valid. - ErrCodeClientException = "ClientException" - - // ErrCodeClusterContainsContainerInstancesException for service response error code - // "ClusterContainsContainerInstancesException". - // - // You can't delete a cluster that has registered container instances. First, - // deregister the container instances before you can delete the cluster. For - // more information, see DeregisterContainerInstance. - ErrCodeClusterContainsContainerInstancesException = "ClusterContainsContainerInstancesException" - - // ErrCodeClusterContainsServicesException for service response error code - // "ClusterContainsServicesException". - // - // You can't delete a cluster that contains services. First, update the service - // to reduce its desired task count to 0, and then delete the service. For more - // information, see UpdateService and DeleteService. - ErrCodeClusterContainsServicesException = "ClusterContainsServicesException" - - // ErrCodeClusterContainsTasksException for service response error code - // "ClusterContainsTasksException". - // - // You can't delete a cluster that has active tasks. - ErrCodeClusterContainsTasksException = "ClusterContainsTasksException" - - // ErrCodeClusterNotFoundException for service response error code - // "ClusterNotFoundException". - // - // The specified cluster wasn't found. You can view your available clusters - // with ListClusters. Amazon ECS clusters are Region specific. - ErrCodeClusterNotFoundException = "ClusterNotFoundException" - - // ErrCodeConflictException for service response error code - // "ConflictException". - ErrCodeConflictException = "ConflictException" - - // ErrCodeInvalidParameterException for service response error code - // "InvalidParameterException". - // - // The specified parameter isn't valid. Review the available parameters for - // the API request. - ErrCodeInvalidParameterException = "InvalidParameterException" - - // ErrCodeLimitExceededException for service response error code - // "LimitExceededException". - // - // The limit for the resource was exceeded. - ErrCodeLimitExceededException = "LimitExceededException" - - // ErrCodeMissingVersionException for service response error code - // "MissingVersionException". - // - // Amazon ECS can't determine the current version of the Amazon ECS container - // agent on the container instance and doesn't have enough information to proceed - // with an update. This could be because the agent running on the container - // instance is a previous or custom version that doesn't use our version information. - ErrCodeMissingVersionException = "MissingVersionException" - - // ErrCodeNamespaceNotFoundException for service response error code - // "NamespaceNotFoundException". - // - // The specified namespace wasn't found. - ErrCodeNamespaceNotFoundException = "NamespaceNotFoundException" - - // ErrCodeNoUpdateAvailableException for service response error code - // "NoUpdateAvailableException". - // - // There's no update available for this Amazon ECS container agent. This might - // be because the agent is already running the latest version or because it's - // so old that there's no update path to the current version. - ErrCodeNoUpdateAvailableException = "NoUpdateAvailableException" - - // ErrCodePlatformTaskDefinitionIncompatibilityException for service response error code - // "PlatformTaskDefinitionIncompatibilityException". - // - // The specified platform version doesn't satisfy the required capabilities - // of the task definition. - ErrCodePlatformTaskDefinitionIncompatibilityException = "PlatformTaskDefinitionIncompatibilityException" - - // ErrCodePlatformUnknownException for service response error code - // "PlatformUnknownException". - // - // The specified platform version doesn't exist. - ErrCodePlatformUnknownException = "PlatformUnknownException" - - // ErrCodeResourceInUseException for service response error code - // "ResourceInUseException". - // - // The specified resource is in-use and can't be removed. - ErrCodeResourceInUseException = "ResourceInUseException" - - // ErrCodeResourceNotFoundException for service response error code - // "ResourceNotFoundException". - // - // The specified resource wasn't found. - ErrCodeResourceNotFoundException = "ResourceNotFoundException" - - // ErrCodeServerException for service response error code - // "ServerException". - // - // These errors are usually caused by a server issue. - ErrCodeServerException = "ServerException" - - // ErrCodeServiceNotActiveException for service response error code - // "ServiceNotActiveException". - // - // The specified service isn't active. You can't update a service that's inactive. - // If you have previously deleted a service, you can re-create it with CreateService. - ErrCodeServiceNotActiveException = "ServiceNotActiveException" - - // ErrCodeServiceNotFoundException for service response error code - // "ServiceNotFoundException". - // - // The specified service wasn't found. You can view your available services - // with ListServices. Amazon ECS services are cluster specific and Region specific. - ErrCodeServiceNotFoundException = "ServiceNotFoundException" - - // ErrCodeTargetNotConnectedException for service response error code - // "TargetNotConnectedException". - // - // The execute command cannot run. This error can be caused by any of the following - // configuration issues: - // - // * Incorrect IAM permissions - // - // * The SSM agent is not installed or is not running - // - // * There is an interface Amazon VPC endpoint for Amazon ECS, but there - // is not one for Systems Manager Session Manager - // - // For information about how to troubleshoot the issues, see Troubleshooting - // issues with ECS Exec (https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-exec.html) - // in the Amazon Elastic Container Service Developer Guide. - ErrCodeTargetNotConnectedException = "TargetNotConnectedException" - - // ErrCodeTargetNotFoundException for service response error code - // "TargetNotFoundException". - // - // The specified target wasn't found. You can view your available container - // instances with ListContainerInstances. Amazon ECS container instances are - // cluster-specific and Region-specific. - ErrCodeTargetNotFoundException = "TargetNotFoundException" - - // ErrCodeTaskSetNotFoundException for service response error code - // "TaskSetNotFoundException". - // - // The specified task set wasn't found. You can view your available task sets - // with DescribeTaskSets. Task sets are specific to each cluster, service and - // Region. - ErrCodeTaskSetNotFoundException = "TaskSetNotFoundException" - - // ErrCodeUnsupportedFeatureException for service response error code - // "UnsupportedFeatureException". - // - // The specified task isn't supported in this Region. - ErrCodeUnsupportedFeatureException = "UnsupportedFeatureException" - - // ErrCodeUpdateInProgressException for service response error code - // "UpdateInProgressException". - // - // There's already a current Amazon ECS container agent update in progress on - // the container instance that's specified. If the container agent becomes disconnected - // while it's in a transitional stage, such as PENDING or STAGING, the update - // process can get stuck in that state. However, when the agent reconnects, - // it resumes where it stopped previously. - ErrCodeUpdateInProgressException = "UpdateInProgressException" -) - -var exceptionFromCode = map[string]func(protocol.ResponseMetadata) error{ - "AccessDeniedException": newErrorAccessDeniedException, - "AttributeLimitExceededException": newErrorAttributeLimitExceededException, - "BlockedException": newErrorBlockedException, - "ClientException": newErrorClientException, - "ClusterContainsContainerInstancesException": newErrorClusterContainsContainerInstancesException, - "ClusterContainsServicesException": newErrorClusterContainsServicesException, - "ClusterContainsTasksException": newErrorClusterContainsTasksException, - "ClusterNotFoundException": newErrorClusterNotFoundException, - "ConflictException": newErrorConflictException, - "InvalidParameterException": newErrorInvalidParameterException, - "LimitExceededException": newErrorLimitExceededException, - "MissingVersionException": newErrorMissingVersionException, - "NamespaceNotFoundException": newErrorNamespaceNotFoundException, - "NoUpdateAvailableException": newErrorNoUpdateAvailableException, - "PlatformTaskDefinitionIncompatibilityException": newErrorPlatformTaskDefinitionIncompatibilityException, - "PlatformUnknownException": newErrorPlatformUnknownException, - "ResourceInUseException": newErrorResourceInUseException, - "ResourceNotFoundException": newErrorResourceNotFoundException, - "ServerException": newErrorServerException, - "ServiceNotActiveException": newErrorServiceNotActiveException, - "ServiceNotFoundException": newErrorServiceNotFoundException, - "TargetNotConnectedException": newErrorTargetNotConnectedException, - "TargetNotFoundException": newErrorTargetNotFoundException, - "TaskSetNotFoundException": newErrorTaskSetNotFoundException, - "UnsupportedFeatureException": newErrorUnsupportedFeatureException, - "UpdateInProgressException": newErrorUpdateInProgressException, -} diff --git a/ecs-agent/ecs/model/ecs/service.go b/ecs-agent/ecs/model/ecs/service.go deleted file mode 100644 index 8ae4353fbb6..00000000000 --- a/ecs-agent/ecs/model/ecs/service.go +++ /dev/null @@ -1,122 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. -// -// Code generated by [agent/gogenerate/awssdk.go] DO NOT EDIT. - -package ecs - -import ( - "github.com/aws/aws-sdk-go/aws" - "github.com/aws/aws-sdk-go/aws/client" - "github.com/aws/aws-sdk-go/aws/client/metadata" - "github.com/aws/aws-sdk-go/aws/request" - v4 "github.com/aws/aws-sdk-go/aws/signer/v4" - "github.com/aws/aws-sdk-go/private/protocol" - "github.com/aws/aws-sdk-go/private/protocol/jsonrpc" -) - -// ECS provides the API operation methods for making requests to -// Amazon Elastic Container Service. See this package's package overview docs -// for details on the service. -// -// ECS methods are safe to use concurrently. It is not safe to -// modify mutate any of the struct's properties though. -type ECS struct { - *client.Client -} - -// Used for custom client initialization logic -var initClient func(*client.Client) - -// Used for custom request initialization logic -var initRequest func(*request.Request) - -// Service information constants -const ( - ServiceName = "ecs" // Name of service. - EndpointsID = ServiceName // ID to lookup a service endpoint with. - ServiceID = "ECS" // ServiceID is a unique identifier of a specific service. -) - -// New creates a new instance of the ECS client with a session. -// If additional configuration is needed for the client instance use the optional -// aws.Config parameter to add your extra config. -// -// Example: -// -// mySession := session.Must(session.NewSession()) -// -// // Create a ECS client from just a session. -// svc := ecs.New(mySession) -// -// // Create a ECS client with additional configuration -// svc := ecs.New(mySession, aws.NewConfig().WithRegion("us-west-2")) -func New(p client.ConfigProvider, cfgs ...*aws.Config) *ECS { - c := p.ClientConfig(EndpointsID, cfgs...) - if c.SigningNameDerived || len(c.SigningName) == 0 { - c.SigningName = EndpointsID - // No Fallback - } - return newClient(*c.Config, c.Handlers, c.PartitionID, c.Endpoint, c.SigningRegion, c.SigningName, c.ResolvedRegion) -} - -// newClient creates, initializes and returns a new service client instance. -func newClient(cfg aws.Config, handlers request.Handlers, partitionID, endpoint, signingRegion, signingName, resolvedRegion string) *ECS { - svc := &ECS{ - Client: client.New( - cfg, - metadata.ClientInfo{ - ServiceName: ServiceName, - ServiceID: ServiceID, - SigningName: signingName, - SigningRegion: signingRegion, - PartitionID: partitionID, - Endpoint: endpoint, - APIVersion: "2014-11-13", - ResolvedRegion: resolvedRegion, - JSONVersion: "1.1", - TargetPrefix: "AmazonEC2ContainerServiceV20141113", - }, - handlers, - ), - } - - // Handlers - svc.Handlers.Sign.PushBackNamed(v4.SignRequestHandler) - svc.Handlers.Build.PushBackNamed(jsonrpc.BuildHandler) - svc.Handlers.Unmarshal.PushBackNamed(jsonrpc.UnmarshalHandler) - svc.Handlers.UnmarshalMeta.PushBackNamed(jsonrpc.UnmarshalMetaHandler) - svc.Handlers.UnmarshalError.PushBackNamed( - protocol.NewUnmarshalErrorHandler(jsonrpc.NewUnmarshalTypedError(exceptionFromCode)).NamedHandler(), - ) - - // Run custom client initialization if present - if initClient != nil { - initClient(svc.Client) - } - - return svc -} - -// newRequest creates a new request for a ECS operation and runs any -// custom request initialization. -func (c *ECS) newRequest(op *request.Operation, params, data interface{}) *request.Request { - req := c.NewRequest(op, params, data) - - // Run custom request initialization if present - if initRequest != nil { - initRequest(req) - } - - return req -} diff --git a/ecs-agent/ecs/model/generate.go b/ecs-agent/ecs/model/generate.go deleted file mode 100644 index 8ad4a62735a..00000000000 --- a/ecs-agent/ecs/model/generate.go +++ /dev/null @@ -1,17 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package model - -// codegen tag required by AWS SDK generators -//go:generate go run -tags codegen ../../../ecs-agent/gogenerate/awssdk.go -typesOnly=false -copyright_file ../../../scripts/copyright_file diff --git a/ecs-agent/httpclient/mock/gomock_helpers.go b/ecs-agent/httpclient/mock/gomock_helpers.go deleted file mode 100644 index f0dd46fbf44..00000000000 --- a/ecs-agent/httpclient/mock/gomock_helpers.go +++ /dev/null @@ -1,90 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. - -package mock_http - -import ( - "io/ioutil" - "net/http" - "net/url" - "strings" - - "github.com/golang/mock/gomock" -) - -// Helpers for testing request equality - -type httpMatcher struct { - method string - url string -} - -func NewHTTPSimpleMatcher(method, url string) gomock.Matcher { - return &httpMatcher{method, url} -} - -func (m *httpMatcher) Matches(x interface{}) bool { - req, ok := x.(*http.Request) - if !ok { - return false - } - if req.Method != m.method { - return false - } - u, err := url.Parse(m.url) - if err != nil { - return false - } - if req.URL.String() != u.String() { - return false - } - return true -} - -func SuccessResponse(body string) *http.Response { - return &http.Response{ - Status: "200 OK", - StatusCode: 200, - Proto: "HTTP/1.1", - ProtoMinor: 1, - ProtoMajor: 1, - Body: ioutil.NopCloser(strings.NewReader(body)), - ContentLength: int64(len(body)), - } -} - -func (m *httpMatcher) String() string { - return "HTTP Matcher: " + m.method + " " + m.url -} - -type httpOpMatcher struct { - operation string -} - -func (m *httpOpMatcher) Matches(x interface{}) bool { - req, ok := x.(*http.Request) - if !ok { - return false - } - return req.Header.Get("x-amz-target") == m.operation -} - -func (m *httpOpMatcher) String() string { - return "HTTP Operation matcher: " + m.operation -} - -func NewHTTPOperationMatcher(op string) gomock.Matcher { - return &httpOpMatcher{ - operation: op, - } -} diff --git a/ecs-agent/httpclient/mock/httpclient.go b/ecs-agent/httpclient/mock/httpclient.go deleted file mode 100644 index cf31a882511..00000000000 --- a/ecs-agent/httpclient/mock/httpclient.go +++ /dev/null @@ -1,64 +0,0 @@ -// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"). You may -// not use this file except in compliance with the License. A copy of the -// License is located at -// -// http://aws.amazon.com/apache2.0/ -// -// or in the "license" file accompanying this file. This file is distributed -// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either -// express or implied. See the License for the specific language governing -// permissions and limitations under the License. -// - -// Code generated by MockGen. DO NOT EDIT. -// Source: net/http (interfaces: RoundTripper) - -// Package mock_http is a generated GoMock package. -package mock_http - -import ( - http "net/http" - reflect "reflect" - - gomock "github.com/golang/mock/gomock" -) - -// MockRoundTripper is a mock of RoundTripper interface. -type MockRoundTripper struct { - ctrl *gomock.Controller - recorder *MockRoundTripperMockRecorder -} - -// MockRoundTripperMockRecorder is the mock recorder for MockRoundTripper. -type MockRoundTripperMockRecorder struct { - mock *MockRoundTripper -} - -// NewMockRoundTripper creates a new mock instance. -func NewMockRoundTripper(ctrl *gomock.Controller) *MockRoundTripper { - mock := &MockRoundTripper{ctrl: ctrl} - mock.recorder = &MockRoundTripperMockRecorder{mock} - return mock -} - -// EXPECT returns an object that allows the caller to indicate expected use. -func (m *MockRoundTripper) EXPECT() *MockRoundTripperMockRecorder { - return m.recorder -} - -// RoundTrip mocks base method. -func (m *MockRoundTripper) RoundTrip(arg0 *http.Request) (*http.Response, error) { - m.ctrl.T.Helper() - ret := m.ctrl.Call(m, "RoundTrip", arg0) - ret0, _ := ret[0].(*http.Response) - ret1, _ := ret[1].(error) - return ret0, ret1 -} - -// RoundTrip indicates an expected call of RoundTrip. -func (mr *MockRoundTripperMockRecorder) RoundTrip(arg0 interface{}) *gomock.Call { - mr.mock.ctrl.T.Helper() - return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "RoundTrip", reflect.TypeOf((*MockRoundTripper)(nil).RoundTrip), arg0) -} diff --git a/ecs-agent/logger/field/constants.go b/ecs-agent/logger/field/constants.go index ed3f732fc4f..b3ae496ac64 100644 --- a/ecs-agent/logger/field/constants.go +++ b/ecs-agent/logger/field/constants.go @@ -40,9 +40,6 @@ const ( ServiceName = "ServiceName" TaskProtection = "TaskProtection" ImageID = "imageID" - ImageName = "imageName" - ImageRef = "imageRef" - ImageTARPath = "imageTARPath" ImageNames = "imageNames" ImageSizeBytes = "imageSizeBytes" ImagePulledAt = "imagePulledAt" diff --git a/ecs-agent/netlib/common_test.go b/ecs-agent/netlib/common_test.go deleted file mode 100644 index df29b873186..00000000000 --- a/ecs-agent/netlib/common_test.go +++ /dev/null @@ -1,23 +0,0 @@ -package netlib - -const ( - taskID = "random-task-id" - eniMAC = "f0:5c:89:a3:ab:01" - eniName = "f05c89a3ab01" - eniMAC2 = "f0:5c:89:a3:ab:02" - eniName2 = "f05c89a3ab02" - eniID = "eni-abdf1234" - eniID2 = "eni-abdf12342" - dnsName = "amazon.com" - nameServer = "10.1.0.2" - nameServer2 = "10.2.0.2" - ipv4Addr = "10.1.0.196" - ipv4Addr2 = "10.2.0.196" - ipv6Addr = "2600:1f13:4d9:e611:9009:ac97:1ab4:17d1" - ipv6Addr2 = "2600:1f13:4d9:e611:9009:ac97:1ab4:17d2" - subnetGatewayCIDR = "10.1.0.1/24" - subnetGatewayCIDR2 = "10.2.0.1/24" - netNSNamePattern = "%s-%s" - searchDomainName = "us-west-2.test.compute.internal" - netNSPathDir = "/var/run/netns/" -) diff --git a/ecs-agent/netlib/model/networkinterface/eniattachment.go b/ecs-agent/netlib/model/networkinterface/eniattachment.go index 3ff374e4e7a..347f0714968 100644 --- a/ecs-agent/netlib/model/networkinterface/eniattachment.go +++ b/ecs-agent/netlib/model/networkinterface/eniattachment.go @@ -18,7 +18,7 @@ import ( "sync" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" "github.com/aws/amazon-ecs-agent/ecs-agent/utils/arn" @@ -36,7 +36,7 @@ const ( // ENIAttachment contains the information of the eni attachment type ENIAttachment struct { - attachment.AttachmentInfo + attachmentinfo.AttachmentInfo // AttachmentType is the type of the eni attachment, can either be "task-eni" or "instance-eni" AttachmentType string `json:"attachmentType"` // MACAddress is the mac address of eni @@ -117,13 +117,6 @@ func (eni *ENIAttachment) IsSent() bool { return eni.AttachStatusSent } -// SetAttachedStatus marks the eni status as attached -func (eni *ENIAttachment) SetAttachedStatus() { - eni.guard.Lock() - defer eni.guard.Unlock() - eni.Status = attachment.AttachmentAttached -} - // SetSentStatus marks the eni attached status has been sent func (eni *ENIAttachment) SetSentStatus() { eni.guard.Lock() @@ -157,18 +150,6 @@ func (eni *ENIAttachment) String() string { return eni.stringUnsafe() } -func (eni *ENIAttachment) GetAttachmentARN() string { - eni.guard.RLock() - defer eni.guard.RUnlock() - return eni.AttachmentARN -} - -func (eni *ENIAttachment) GetAttachmentStatus() attachment.AttachmentStatus { - eni.guard.RLock() - defer eni.guard.RUnlock() - return eni.Status -} - // stringUnsafe returns a string representation of the ENI Attachment func (eni *ENIAttachment) stringUnsafe() string { // skip TaskArn field for instance level eni attachment since it won't have a task arn @@ -182,23 +163,3 @@ func (eni *ENIAttachment) stringUnsafe() string { "ENI Attachment: task=%s attachment=%s attachmentType=%s attachmentSent=%t mac=%s status=%s expiresAt=%s", eni.TaskARN, eni.AttachmentARN, eni.AttachmentType, eni.AttachStatusSent, eni.MACAddress, eni.Status.String(), eni.ExpiresAt.Format(time.RFC3339)) } - -func (eni *ENIAttachment) GetAttachmentType() string { - eni.guard.RLock() - defer eni.guard.RUnlock() - - return eni.AttachmentType -} - -func (eni *ENIAttachment) ShouldAttach() bool { - eni.guard.RLock() - defer eni.guard.RUnlock() - return !(eni.Status == attachment.AttachmentAttached) && !eni.AttachStatusSent && !(time.Now().After(eni.ExpiresAt)) -} - -// should notify when attached, and not sent/not expired -func (eni *ENIAttachment) ShouldNotify() bool { - eni.guard.RLock() - defer eni.guard.RUnlock() - return !eni.AttachStatusSent && !(time.Now().After(eni.ExpiresAt)) -} diff --git a/ecs-agent/netlib/model/networkinterface/eniattachment_test.go b/ecs-agent/netlib/model/networkinterface/eniattachment_test.go index 17015019007..96bf056f838 100644 --- a/ecs-agent/netlib/model/networkinterface/eniattachment_test.go +++ b/ecs-agent/netlib/model/networkinterface/eniattachment_test.go @@ -22,7 +22,8 @@ import ( "testing" "time" - "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachment" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/attachmentinfo" + "github.com/aws/amazon-ecs-agent/ecs-agent/api/status" "github.com/stretchr/testify/assert" ) @@ -38,11 +39,11 @@ const ( func TestMarshalUnmarshal(t *testing.T) { expiresAt := time.Now() attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: expiresAt, }, MACAddress: mac, @@ -68,11 +69,11 @@ func TestMarshalUnmarshal(t *testing.T) { func TestMarshalUnmarshalWithAttachmentType(t *testing.T) { expiresAt := time.Now() attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: expiresAt, }, AttachmentType: attachmentType, @@ -100,11 +101,11 @@ func TestMarshalUnmarshalWithAttachmentType(t *testing.T) { func TestStartTimerErrorWhenExpiresAtIsInThePast(t *testing.T) { expiresAt := time.Now().Unix() - 1 attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, MACAddress: mac, @@ -123,11 +124,11 @@ func TestHasExpired(t *testing.T) { } { t.Run(tc.name, func(t *testing.T) { attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(tc.expiresAt, 0), }, MACAddress: mac, @@ -146,10 +147,10 @@ func TestInitialize(t *testing.T) { expiresAt := time.Now().Unix() + 1 attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, MACAddress: mac, @@ -161,10 +162,10 @@ func TestInitialize(t *testing.T) { func TestInitializeExpired(t *testing.T) { expiresAt := time.Now().Unix() - 1 attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, MACAddress: mac, @@ -175,11 +176,11 @@ func TestInitializeExpired(t *testing.T) { func TestInitializeExpiredButAlreadySent(t *testing.T) { expiresAt := time.Now().Unix() - 1 attachment := &ENIAttachment{ - AttachmentInfo: attachment.AttachmentInfo{ + AttachmentInfo: attachmentinfo.AttachmentInfo{ TaskARN: taskARN, AttachmentARN: attachmentARN, AttachStatusSent: attachSent, - Status: attachment.AttachmentNone, + Status: status.AttachmentNone, ExpiresAt: time.Unix(expiresAt, 0), }, MACAddress: mac, diff --git a/ecs-agent/netlib/model/networkinterface/networkinterface.go b/ecs-agent/netlib/model/networkinterface/networkinterface.go index 3ed4a1da313..72667e7d03b 100644 --- a/ecs-agent/netlib/model/networkinterface/networkinterface.go +++ b/ecs-agent/netlib/model/networkinterface/networkinterface.go @@ -24,8 +24,6 @@ import ( "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" "github.com/aws/amazon-ecs-agent/ecs-agent/logger" loggerfield "github.com/aws/amazon-ecs-agent/ecs-agent/logger/field" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/status" - "github.com/aws/aws-sdk-go/aws" "github.com/pkg/errors" ) @@ -55,13 +53,15 @@ type NetworkInterface struct { // InterfaceAssociationProtocol is the type of NetworkInterface, valid value: "default", "vlan" InterfaceAssociationProtocol string `json:",omitempty"` - Index int64 `json:"Index,omitempty"` - UserID uint32 `json:"UserID,omitempty"` - Name string `json:"Name,omitempty"` - DeviceName string `json:"DeviceName,omitempty"` - GuestNetNSName string `json:"GuestNetNSName,omitempty"` - KnownStatus status.NetworkStatus `json:"KnownStatus,omitempty"` - DesiredStatus status.NetworkStatus `json:"DesiredStatus,omitempty"` + Index int64 `json:"Index,omitempty"` + UserID uint32 `json:"UserID,omitempty"` + Name string `json:"Name,omitempty"` + NetNSName string `json:"NetNSName,omitempty"` + NetNSPath string `json:"NetNSPath,omitempty"` + DeviceName string `json:"DeviceName,omitempty"` + GuestNetNSName string `json:"GuestNetNSName,omitempty"` + KnownStatus Status `json:"KnownStatus,omitempty"` + DesiredStatus Status `json:"DesiredStatus,omitempty"` // InterfaceVlanProperties contains information for an interface // that is supposed to be used as a VLAN device @@ -84,10 +84,6 @@ type NetworkInterface struct { ipv4SubnetCIDRBlock string ipv6SubnetCIDRBlock string - // Default denotes whether the interface is responsible - // for handling default route within the netns it resides in. - Default bool - // guard protects access to fields of this struct. guard sync.RWMutex } @@ -372,8 +368,8 @@ type IPV6Address struct { Address string } -// InterfaceFromACS validates the given ACS NetworkInterface information and creates an NetworkInterface object from it. -func InterfaceFromACS(acsENI *ecsacs.ElasticNetworkInterface) (*NetworkInterface, error) { +// ENIFromACS validates the given ACS NetworkInterface information and creates an NetworkInterface object from it. +func ENIFromACS(acsENI *ecsacs.ElasticNetworkInterface) (*NetworkInterface, error) { err := ValidateENI(acsENI) if err != nil { return nil, err @@ -397,6 +393,14 @@ func InterfaceFromACS(acsENI *ecsacs.ElasticNetworkInterface) (*NetworkInterface }) } + // Read NetworkInterface association properties. + var interfaceVlanProperties InterfaceVlanProperties + + if aws.StringValue(acsENI.InterfaceAssociationProtocol) == VLANInterfaceAssociationProtocol { + interfaceVlanProperties.TrunkInterfaceMacAddress = aws.StringValue(acsENI.InterfaceVlanProperties.TrunkInterfaceMacAddress) + interfaceVlanProperties.VlanID = aws.StringValue(acsENI.InterfaceVlanProperties.VlanId) + } + ni := &NetworkInterface{ ID: aws.StringValue(acsENI.Ec2Id), MacAddress: aws.StringValue(acsENI.MacAddress), @@ -405,14 +409,7 @@ func InterfaceFromACS(acsENI *ecsacs.ElasticNetworkInterface) (*NetworkInterface SubnetGatewayIPV4Address: aws.StringValue(acsENI.SubnetGatewayIpv4Address), PrivateDNSName: aws.StringValue(acsENI.PrivateDnsName), InterfaceAssociationProtocol: aws.StringValue(acsENI.InterfaceAssociationProtocol), - } - - // Read NetworkInterface association properties. - if aws.StringValue(acsENI.InterfaceAssociationProtocol) == VLANInterfaceAssociationProtocol { - var interfaceVlanProperties InterfaceVlanProperties - interfaceVlanProperties.TrunkInterfaceMacAddress = aws.StringValue(acsENI.InterfaceVlanProperties.TrunkInterfaceMacAddress) - interfaceVlanProperties.VlanID = aws.StringValue(acsENI.InterfaceVlanProperties.VlanId) - ni.InterfaceVlanProperties = &interfaceVlanProperties + InterfaceVlanProperties: &interfaceVlanProperties, } for _, nameserverIP := range acsENI.DomainNameServers { @@ -473,6 +470,8 @@ func ValidateENI(acsENI *ecsacs.ElasticNetworkInterface) error { // New creates a new NetworkInterface model. func New( acsENI *ecsacs.ElasticNetworkInterface, + netNSName string, + netNSPath string, guestNetNSName string, peerInterface *ecsacs.ElasticNetworkInterface, ) (*NetworkInterface, error) { @@ -502,9 +501,9 @@ func New( // by the common NetworkInterface handler. default: // Acquire the NetworkInterface information from the payload. - networkInterface, err = InterfaceFromACS(acsENI) + networkInterface, err = ENIFromACS(acsENI) if err != nil { - return nil, errors.Wrap(err, "failed to unmarshal interface model") + return nil, errors.Wrap(err, "failed to unmarshal eni") } // Historically, if there is no interface association protocol in the NetworkInterface payload, we assume @@ -515,9 +514,11 @@ func New( } networkInterface.Index = aws.Int64Value(acsENI.Index) - networkInterface.Name = GetInterfaceName(acsENI) - networkInterface.KnownStatus = status.NetworkNone - networkInterface.DesiredStatus = status.NetworkReadyPull + networkInterface.Name = GetENIName(acsENI) + networkInterface.KnownStatus = StatusNone + networkInterface.DesiredStatus = StatusReadyPull + networkInterface.NetNSName = netNSName + networkInterface.NetNSPath = netNSPath networkInterface.GuestNetNSName = guestNetNSName return networkInterface, nil @@ -568,11 +569,11 @@ func (ni *NetworkInterface) IsPrimary() bool { // it was decided that for firecracker platform the files had to be generated for secondary ENIs as well. // Hence the NetworkInterface IsPrimary check was moved from here to warmpool specific APIs. func (ni *NetworkInterface) ShouldGenerateNetworkConfigFiles() bool { - return ni.DesiredStatus == status.NetworkReadyPull + return ni.DesiredStatus == StatusReadyPull } -// GetInterfaceName creates the NetworkInterface name from the NetworkInterface mac address in case it is empty in the ACS payload. -func GetInterfaceName(acsENI *ecsacs.ElasticNetworkInterface) string { +// GetENIName creates the NetworkInterface name from the NetworkInterface mac address in case it is empty in the ACS payload. +func GetENIName(acsENI *ecsacs.ElasticNetworkInterface) string { if acsENI.Name != nil { return aws.StringValue(acsENI.Name) } @@ -644,8 +645,3 @@ func vethPairFromACS( }, nil } - -// NetNSName returns the netns name that the specified network interface will be attached to in a desired task. -func NetNSName(taskID, eniName string) string { - return fmt.Sprintf("%s-%s", taskID, eniName) -} diff --git a/ecs-agent/netlib/model/networkinterface/networkinterface_status.go b/ecs-agent/netlib/model/networkinterface/networkinterface_status.go new file mode 100644 index 00000000000..6b10dde38e5 --- /dev/null +++ b/ecs-agent/netlib/model/networkinterface/networkinterface_status.go @@ -0,0 +1,42 @@ +package networkinterface + +// Status represents the status of an ENI resource. +type Status string + +const ( + // StatusNone is the initial staus of the ENI. + StatusNone Status = "NONE" + // StatusReadyPull indicates that the ENI is ready for downloading resources associated with + // the execution role. This includes container images, task secrets and configs. + StatusReadyPull Status = "READY_PULL" + // StatusReady indicates that the ENI is ready for use by containers in the task. + StatusReady Status = "READY" + // StatusDeleted indicates that the ENI is deleted. + StatusDeleted Status = "DELETED" +) + +var ( + eniStatusOrder = map[Status]int{ + StatusNone: 0, + StatusReadyPull: 1, + StatusReady: 2, + StatusDeleted: 3, + } +) + +func (es Status) String() string { + return string(es) +} + +func (es Status) StatusBackwards(es2 Status) bool { + return eniStatusOrder[es] < eniStatusOrder[es2] +} + +func GetAllStatuses() []Status { + return []Status{ + StatusNone, + StatusReadyPull, + StatusReady, + StatusDeleted, + } +} diff --git a/ecs-agent/netlib/model/networkinterface/networkinterface_test.go b/ecs-agent/netlib/model/networkinterface/networkinterface_test.go new file mode 100644 index 00000000000..241d586119e --- /dev/null +++ b/ecs-agent/netlib/model/networkinterface/networkinterface_test.go @@ -0,0 +1,373 @@ +//go:build unit +// +build unit + +// Copyright Amazon.com Inc. or its affiliates. All Rights Reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"). You may +// not use this file except in compliance with the License. A copy of the +// License is located at +// +// http://aws.amazon.com/apache2.0/ +// +// or in the "license" file accompanying this file. This file is distributed +// on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either +// express or implied. See the License for the specific language governing +// permissions and limitations under the License. + +package networkinterface + +import ( + "net" + "testing" + + "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" + "github.com/aws/aws-sdk-go/aws" + "github.com/pkg/errors" + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" +) + +const ( + defaultDNS = "169.254.169.253" + customDNS = "10.0.0.2" + customSearchDomain = "us-west-2.compute.internal" + + linkName = "eth1" + macAddr = "02:22:ea:8c:81:dc" + ipv4Addr = "1.2.3.4" + ipv4Gw = "1.2.3.1" + ipv4SubnetPrefixLength = "20" + ipv4Subnet = "1.2.0.0" + ipv4AddrWithPrefixLength = ipv4Addr + "/" + ipv4SubnetPrefixLength + ipv4GwWithPrefixLength = ipv4Gw + "/" + ipv4SubnetPrefixLength + ipv4SubnetCIDRBlock = ipv4Subnet + "/" + ipv4SubnetPrefixLength + ipv6Addr = "abcd:dcba:1234:4321::" + ipv6SubnetPrefixLength = "64" + ipv6SubnetCIDRBlock = ipv6Addr + "/" + ipv6SubnetPrefixLength + ipv6AddrWithPrefixLength = ipv6Addr + "/" + ipv6SubnetPrefixLength + vethPeerInterfaceName = "veth1-peer" + v2nVNI = "ABCDE" + v2nDestinationIP = "10.0.2.129" + v2nDnsIP = "10.3.0.2" + v2nDnsSearch = "us-west-2.test.compute.internal" +) + +var ( + testENI = &NetworkInterface{ + ID: "eni-123", + InterfaceAssociationProtocol: DefaultInterfaceAssociationProtocol, + IPV4Addresses: []*IPV4Address{ + { + Primary: true, + Address: ipv4Addr, + }, + }, + IPV6Addresses: []*IPV6Address{ + { + Address: ipv6Addr, + }, + }, + SubnetGatewayIPV4Address: ipv4GwWithPrefixLength, + } + // validNetInterfacesFunc represents a mock of valid response from net.Interfaces() method. + validNetInterfacesFunc = func() ([]net.Interface, error) { + parsedMAC, _ := net.ParseMAC(macAddr) + return []net.Interface{ + net.Interface{ + Name: linkName, + HardwareAddr: parsedMAC, + }, + }, nil + } + // invalidNetInterfacesFunc represents a mock of error response from net.Interfaces() method. + invalidNetInterfacesFunc = func() ([]net.Interface, error) { + return nil, errors.New("failed to find interfaces") + } +) + +func TestIsStandardENI(t *testing.T) { + testCases := []struct { + protocol string + isStandard bool + }{ + { + protocol: "", + isStandard: true, + }, + { + protocol: DefaultInterfaceAssociationProtocol, + isStandard: true, + }, + { + protocol: VLANInterfaceAssociationProtocol, + isStandard: false, + }, + { + protocol: "invalid", + isStandard: false, + }, + } + + for _, tc := range testCases { + t.Run(tc.protocol, func(t *testing.T) { + ni := &NetworkInterface{ + InterfaceAssociationProtocol: tc.protocol, + } + assert.Equal(t, tc.isStandard, ni.IsStandardENI()) + }) + } +} + +func TestGetIPV4Addresses(t *testing.T) { + assert.Equal(t, []string{ipv4Addr}, testENI.GetIPV4Addresses()) +} + +func TestGetIPV6Addresses(t *testing.T) { + assert.Equal(t, []string{ipv6Addr}, testENI.GetIPV6Addresses()) +} + +func TestGetPrimaryIPv4Address(t *testing.T) { + assert.Equal(t, ipv4Addr, testENI.GetPrimaryIPv4Address()) +} + +func TestGetPrimaryIPv4AddressWithPrefixLength(t *testing.T) { + assert.Equal(t, ipv4AddrWithPrefixLength, testENI.GetPrimaryIPv4AddressWithPrefixLength()) +} + +func TestGetIPAddressesWithPrefixLength(t *testing.T) { + assert.Equal(t, []string{ipv4AddrWithPrefixLength, ipv6AddrWithPrefixLength}, testENI.GetIPAddressesWithPrefixLength()) +} + +func TestGetIPv4SubnetPrefixLength(t *testing.T) { + assert.Equal(t, ipv4SubnetPrefixLength, testENI.GetIPv4SubnetPrefixLength()) +} + +func TestGetIPv4SubnetCIDRBlock(t *testing.T) { + assert.Equal(t, ipv4SubnetCIDRBlock, testENI.GetIPv4SubnetCIDRBlock()) +} + +func TestGetIPv6SubnetCIDRBlock(t *testing.T) { + assert.Equal(t, ipv6SubnetCIDRBlock, testENI.GetIPv6SubnetCIDRBlock()) +} + +func TestGetSubnetGatewayIPv4Address(t *testing.T) { + assert.Equal(t, ipv4Gw, testENI.GetSubnetGatewayIPv4Address()) +} + +// TestGetLinkNameSuccess tests the retrieval of ENIs name on the instance. +func TestGetLinkNameSuccess(t *testing.T) { + netInterfaces = validNetInterfacesFunc + ni := &NetworkInterface{ + MacAddress: macAddr, + } + + eniLinkName := ni.GetLinkName() + assert.EqualValues(t, linkName, eniLinkName) +} + +// TestGetLinkNameFailure tests the retrieval of Network Interface Name in case of failure. +func TestGetLinkNameFailure(t *testing.T) { + netInterfaces = invalidNetInterfacesFunc + ni := &NetworkInterface{ + MacAddress: macAddr, + } + + eniLinkName := ni.GetLinkName() + assert.EqualValues(t, "", eniLinkName) +} + +func TestENIToString(t *testing.T) { + expectedStr := `eni id:eni-123, mac: , hostname: , ipv4addresses: [1.2.3.4], ipv6addresses: [abcd:dcba:1234:4321::], dns: [], dns search: [], gateway ipv4: [1.2.3.1/20][]` + assert.Equal(t, expectedStr, testENI.String()) +} + +// TestENIFromACS tests the eni information was correctly read from the acs +func TestENIFromACS(t *testing.T) { + acsENI := getTestACSENI() + eni, err := ENIFromACS(acsENI) + assert.NoError(t, err) + assert.NotNil(t, eni) + assert.Equal(t, aws.StringValue(acsENI.Ec2Id), eni.ID) + assert.Len(t, eni.IPV4Addresses, 1) + assert.Len(t, eni.GetIPV4Addresses(), 1) + assert.Equal(t, aws.StringValue(acsENI.Ipv4Addresses[0].PrivateAddress), eni.IPV4Addresses[0].Address) + assert.Equal(t, aws.BoolValue(acsENI.Ipv4Addresses[0].Primary), eni.IPV4Addresses[0].Primary) + assert.Equal(t, aws.StringValue(acsENI.MacAddress), eni.MacAddress) + assert.Len(t, eni.IPV6Addresses, 1) + assert.Len(t, eni.GetIPV6Addresses(), 1) + assert.Equal(t, aws.StringValue(acsENI.Ipv6Addresses[0].Address), eni.IPV6Addresses[0].Address) + assert.Len(t, eni.DomainNameServers, 2) + assert.Equal(t, defaultDNS, eni.DomainNameServers[0]) + assert.Equal(t, customDNS, eni.DomainNameServers[1]) + assert.Len(t, eni.DomainNameSearchList, 1) + assert.Equal(t, customSearchDomain, eni.DomainNameSearchList[0]) + assert.Equal(t, aws.StringValue(acsENI.PrivateDnsName), eni.PrivateDNSName) +} + +// TestValidateENIFromACS tests the validation of enis from acs +func TestValidateENIFromACS(t *testing.T) { + acsENI := getTestACSENI() + err := ValidateENI(acsENI) + assert.NoError(t, err) + + acsENI.Ipv6Addresses = nil + err = ValidateENI(acsENI) + assert.NoError(t, err) + + acsENI.Ipv4Addresses = nil + err = ValidateENI(acsENI) + assert.Error(t, err) +} + +func TestInvalidENIInterfaceVlanPropertyMissing(t *testing.T) { + acsENI := &ecsacs.ElasticNetworkInterface{ + InterfaceAssociationProtocol: aws.String(VLANInterfaceAssociationProtocol), + AttachmentArn: aws.String("arn"), + Ec2Id: aws.String("ec2id"), + Ipv4Addresses: []*ecsacs.IPv4AddressAssignment{ + { + Primary: aws.Bool(true), + PrivateAddress: aws.String("ipv4"), + }, + }, + SubnetGatewayIpv4Address: aws.String(ipv4GwWithPrefixLength), + Ipv6Addresses: []*ecsacs.IPv6AddressAssignment{ + { + Address: aws.String("ipv6"), + }, + }, + MacAddress: aws.String("mac"), + } + + err := ValidateENI(acsENI) + assert.Error(t, err) + +} + +func TestInvalidENIInvalidInterfaceAssociationProtocol(t *testing.T) { + acsENI := &ecsacs.ElasticNetworkInterface{ + InterfaceAssociationProtocol: aws.String("no-eni"), + AttachmentArn: aws.String("arn"), + Ec2Id: aws.String("ec2id"), + Ipv4Addresses: []*ecsacs.IPv4AddressAssignment{ + { + Primary: aws.Bool(true), + PrivateAddress: aws.String("ipv4"), + }, + }, + SubnetGatewayIpv4Address: aws.String(ipv4GwWithPrefixLength), + Ipv6Addresses: []*ecsacs.IPv6AddressAssignment{ + { + Address: aws.String("ipv6"), + }, + }, + MacAddress: aws.String("mac"), + } + err := ValidateENI(acsENI) + assert.Error(t, err) +} + +func TestInvalidSubnetGatewayAddress(t *testing.T) { + acsENI := getTestACSENI() + acsENI.SubnetGatewayIpv4Address = aws.String(ipv4Addr) + _, err := ENIFromACS(acsENI) + assert.Error(t, err) +} + +func getTestACSENI() *ecsacs.ElasticNetworkInterface { + return &ecsacs.ElasticNetworkInterface{ + AttachmentArn: aws.String("arn"), + Ec2Id: aws.String("ec2id"), + Ipv4Addresses: []*ecsacs.IPv4AddressAssignment{ + { + Primary: aws.Bool(true), + PrivateAddress: aws.String(ipv4Addr), + }, + }, + SubnetGatewayIpv4Address: aws.String(ipv4GwWithPrefixLength), + Ipv6Addresses: []*ecsacs.IPv6AddressAssignment{ + { + Address: aws.String(ipv6Addr)}, + }, + MacAddress: aws.String("mac"), + DomainNameServers: []*string{aws.String(defaultDNS), aws.String(customDNS)}, + DomainName: []*string{aws.String(customSearchDomain)}, + PrivateDnsName: aws.String("ip.region.compute.internal"), + } +} + +// TestV2NTunnelFromACS tests the ENI model created from ACS V2N interface payload. +func TestV2NTunnelFromACS(t *testing.T) { + v2nTunnelACS := &ecsacs.ElasticNetworkInterface{ + DomainNameServers: []*string{ + aws.String(v2nDnsIP), + }, + DomainName: []*string{ + aws.String(v2nDnsSearch), + }, + InterfaceTunnelProperties: &ecsacs.NetworkInterfaceTunnelProperties{ + TunnelId: aws.String(v2nVNI), + InterfaceIpAddress: aws.String(v2nDestinationIP), + }, + } + + // Test success case. + v2nEni, err := v2nTunnelFromACS(v2nTunnelACS) + require.NoError(t, err) + + assert.Equal(t, V2NInterfaceAssociationProtocol, v2nEni.InterfaceAssociationProtocol) + assert.Equal(t, DefaultGeneveInterfaceGateway, v2nEni.SubnetGatewayIPV4Address) + assert.Equal(t, DefaultGeneveInterfaceIPAddress, v2nEni.IPV4Addresses[0].Address) + assert.Equal(t, v2nDnsIP, v2nEni.DomainNameServers[0]) + assert.Equal(t, v2nDnsSearch, v2nEni.DomainNameSearchList[0]) + + assert.Equal(t, v2nVNI, v2nEni.TunnelProperties.ID) + assert.Equal(t, v2nDestinationIP, v2nEni.TunnelProperties.DestinationIPAddress) + + // Test failure cases. + v2nTunnelACS.InterfaceTunnelProperties.TunnelId = nil + _, err = v2nTunnelFromACS(v2nTunnelACS) + require.Error(t, err) + require.Equal(t, "tunnel ID not found in payload", err.Error()) + + v2nTunnelACS.InterfaceTunnelProperties.TunnelId = aws.String(v2nVNI) + v2nTunnelACS.InterfaceTunnelProperties.InterfaceIpAddress = nil + _, err = v2nTunnelFromACS(v2nTunnelACS) + require.Error(t, err) + require.Equal(t, "tunnel interface IP not found in payload", err.Error()) + + v2nTunnelACS.InterfaceTunnelProperties = nil + _, err = v2nTunnelFromACS(v2nTunnelACS) + require.Error(t, err) + assert.Equal(t, "interface tunnel properties not found in payload", err.Error()) +} + +// TestVETHPairFromACS tests the ENI model created from ACS VETH interface payload. +// It tests if the ENI model inherits the DNS config data from the peer interface +// and also verifies that an error is returned if the peer interface is also veth. +func TestVETHPairFromACS(t *testing.T) { + peerInterface := &ecsacs.ElasticNetworkInterface{ + Name: aws.String(vethPeerInterfaceName), + DomainNameServers: []*string{aws.String("10.0.23.2")}, + DomainName: []*string{aws.String("amazon.com")}, + } + + vethACS := &ecsacs.ElasticNetworkInterface{ + InterfaceVethProperties: &ecsacs.NetworkInterfaceVethProperties{ + PeerInterface: aws.String(vethPeerInterfaceName), + }, + } + + vethInterface, err := vethPairFromACS(vethACS, peerInterface) + require.NoError(t, err) + + assert.Equal(t, VETHInterfaceAssociationProtocol, vethInterface.InterfaceAssociationProtocol) + assert.Equal(t, vethPeerInterfaceName, vethInterface.VETHProperties.PeerInterfaceName) + assert.Equal(t, vethInterface.DomainNameServers[0], "10.0.23.2") + assert.Equal(t, vethInterface.DomainNameSearchList[0], "amazon.com") + + peerInterface.InterfaceAssociationProtocol = aws.String(VETHInterfaceAssociationProtocol) + _, err = vethPairFromACS(vethACS, peerInterface) + require.Error(t, err) + assert.Equal(t, "peer interface cannot be veth", err.Error()) +} diff --git a/ecs-agent/netlib/model/tasknetworkconfig/common_test.go b/ecs-agent/netlib/model/tasknetworkconfig/common_test.go index cb0a41cb0bd..35da4a995fc 100644 --- a/ecs-agent/netlib/model/tasknetworkconfig/common_test.go +++ b/ecs-agent/netlib/model/tasknetworkconfig/common_test.go @@ -4,7 +4,6 @@ import ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterfa const ( primaryNetNSName = "primary-netns" - primaryNetNSPath = "primary-path" secondaryNetNSName = "secondary-netns" primaryInterfaceName = "primary-interface" secondaryInterfaceName = "secondary-interface" @@ -34,14 +33,12 @@ func getTestNetworkNamespaces() []*NetworkNamespace { func getTestNetworkInterfaces() []*ni.NetworkInterface { return []*ni.NetworkInterface{ { - Name: secondaryInterfaceName, - Default: false, - Index: 1, + Name: secondaryInterfaceName, + Index: 1, }, { - Name: primaryInterfaceName, - Default: true, - Index: 0, + Name: primaryInterfaceName, + Index: 0, }, } } diff --git a/ecs-agent/netlib/model/tasknetworkconfig/network_namespace.go b/ecs-agent/netlib/model/tasknetworkconfig/network_namespace.go index 2a0ccd085ed..ae6d9103e43 100644 --- a/ecs-agent/netlib/model/tasknetworkconfig/network_namespace.go +++ b/ecs-agent/netlib/model/tasknetworkconfig/network_namespace.go @@ -1,10 +1,8 @@ package tasknetworkconfig import ( - "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/appmesh" "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/status" ) // NetworkNamespace is model representing each network namespace. @@ -21,41 +19,15 @@ type NetworkNamespace struct { // TODO: Add Service Connect model here once it is moved under the netlib package. - KnownState status.NetworkStatus - DesiredState status.NetworkStatus -} - -func NewNetworkNamespace( - netNSName string, - netNSPath string, - index int, - proxyConfig *ecsacs.ProxyConfiguration, - networkInterfaces ...*networkinterface.NetworkInterface) (*NetworkNamespace, error) { - netNS := &NetworkNamespace{ - Name: netNSName, - Path: netNSPath, - Index: index, - NetworkInterfaces: networkInterfaces, - KnownState: status.NetworkNone, - DesiredState: status.NetworkReadyPull, - } - - var err error - if proxyConfig != nil { - netNS.AppMeshConfig, err = appmesh.AppMeshFromACS(proxyConfig) - if err != nil { - return nil, err - } - } - - return netNS, nil + KnownState string + DesiredState string } // GetPrimaryInterface returns the network interface that has the index value of 0 within // the network namespace. func (ns NetworkNamespace) GetPrimaryInterface() *networkinterface.NetworkInterface { for _, ni := range ns.NetworkInterfaces { - if ni.Default { + if ni.Index == 0 { return ni } } diff --git a/ecs-agent/netlib/model/tasknetworkconfig/network_namespace_test.go b/ecs-agent/netlib/model/tasknetworkconfig/network_namespace_test.go index 092d8083a6d..6af1b838658 100644 --- a/ecs-agent/netlib/model/tasknetworkconfig/network_namespace_test.go +++ b/ecs-agent/netlib/model/tasknetworkconfig/network_namespace_test.go @@ -4,6 +4,8 @@ package tasknetworkconfig import ( + "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" + "testing" "github.com/stretchr/testify/assert" @@ -11,29 +13,19 @@ import ( func TestNetworkNamespace_GetPrimaryInterface(t *testing.T) { netns := &NetworkNamespace{ - NetworkInterfaces: getTestNetworkInterfaces(), + NetworkInterfaces: []*networkinterface.NetworkInterface{ + { + Index: 1, + Name: secondaryInterfaceName, + }, + { + Index: 0, + Name: primaryInterfaceName, + }, + }, } assert.Equal(t, primaryInterfaceName, netns.GetPrimaryInterface().Name) netns = &NetworkNamespace{} assert.Empty(t, netns.GetPrimaryInterface()) } - -// TestNewNetworkNamespace tests creation of a new NetworkNamespace object. -func TestNewNetworkNamespace(t *testing.T) { - netIFs := getTestNetworkInterfaces() - netns, err := NewNetworkNamespace( - primaryNetNSName, - primaryNetNSPath, - 0, - nil, - netIFs...) - assert.NoError(t, err) - assert.Equal(t, 2, len(netns.NetworkInterfaces)) - assert.Equal(t, primaryNetNSName, netns.Name) - assert.Equal(t, primaryNetNSPath, netns.Path) - assert.Equal(t, 0, netns.Index) - assert.Empty(t, netns.AppMeshConfig) - assert.Equal(t, *netIFs[0], *netns.NetworkInterfaces[0]) - assert.Equal(t, *netIFs[1], *netns.NetworkInterfaces[1]) -} diff --git a/ecs-agent/netlib/model/tasknetworkconfig/task_network_config.go b/ecs-agent/netlib/model/tasknetworkconfig/task_network_config.go index 1a0caafdab0..61ce6c0ddfb 100644 --- a/ecs-agent/netlib/model/tasknetworkconfig/task_network_config.go +++ b/ecs-agent/netlib/model/tasknetworkconfig/task_network_config.go @@ -1,11 +1,6 @@ package tasknetworkconfig -import ( - "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" - ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" - - "github.com/pkg/errors" -) +import ni "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" // TaskNetworkConfig is the top level network data structure associated with a task. type TaskNetworkConfig struct { @@ -13,20 +8,6 @@ type TaskNetworkConfig struct { NetworkMode string } -func New(networkMode string, netNSs ...*NetworkNamespace) (*TaskNetworkConfig, error) { - if networkMode != ecs.NetworkModeAwsvpc && - networkMode != ecs.NetworkModeBridge && - networkMode != ecs.NetworkModeHost && - networkMode != ecs.NetworkModeNone { - return nil, errors.New("invalid network mode: " + networkMode) - } - - return &TaskNetworkConfig{ - NetworkNamespaces: netNSs, - NetworkMode: networkMode, - }, nil -} - // GetPrimaryInterface returns the interface with index 0 inside the network namespace // with index 0 associated with the task's network config. func (tnc *TaskNetworkConfig) GetPrimaryInterface() *ni.NetworkInterface { diff --git a/ecs-agent/netlib/model/tasknetworkconfig/task_network_config_test.go b/ecs-agent/netlib/model/tasknetworkconfig/task_network_config_test.go index e3c81d26fe1..1e2716df339 100644 --- a/ecs-agent/netlib/model/tasknetworkconfig/task_network_config_test.go +++ b/ecs-agent/netlib/model/tasknetworkconfig/task_network_config_test.go @@ -4,7 +4,6 @@ package tasknetworkconfig import ( - "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" "github.com/stretchr/testify/assert" "testing" @@ -27,42 +26,3 @@ func TestTaskNetworkConfig_GetPrimaryNetNS(t *testing.T) { testNetConfig = &TaskNetworkConfig{} assert.Nil(t, testNetConfig.GetPrimaryNetNS()) } - -// TestNewTaskNetConfig tests creation of TaskNetworkConfig out of -// a given set of NetworkNamespace objects. -func TestNewTaskNetConfig(t *testing.T) { - protos := []string{ - ecs.NetworkModeAwsvpc, - ecs.NetworkModeHost, - ecs.NetworkModeBridge, - ecs.NetworkModeNone, - } - for _, proto := range protos { - _, err := New(proto, nil) - assert.NoError(t, err) - } - - _, err := New("invalid-protocol", nil) - assert.Error(t, err) - - primaryNetNS := "primary-netns" - secondaryNetNS := "secondary-netns" - netNSs := []*NetworkNamespace{ - { - Name: primaryNetNS, - Index: 0, - }, - { - Name: secondaryNetNS, - Index: 1, - }, - } - - taskNetConfig, err := New( - ecs.NetworkModeAwsvpc, - netNSs...) - assert.NoError(t, err) - assert.Equal(t, 2, len(taskNetConfig.NetworkNamespaces)) - assert.Equal(t, *netNSs[0], *taskNetConfig.NetworkNamespaces[0]) - assert.Equal(t, *netNSs[1], *taskNetConfig.NetworkNamespaces[1]) -} diff --git a/ecs-agent/netlib/network_builder.go b/ecs-agent/netlib/network_builder.go deleted file mode 100644 index 053705ff09c..00000000000 --- a/ecs-agent/netlib/network_builder.go +++ /dev/null @@ -1,46 +0,0 @@ -package netlib - -import ( - "context" - - "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/ecscni" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/tasknetworkconfig" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/platform" - - "github.com/pkg/errors" -) - -type NetworkBuilder interface { - BuildTaskNetworkConfiguration(taskID string, taskPayload *ecsacs.Task) (*tasknetworkconfig.TaskNetworkConfig, error) - - Start(ctx context.Context, taskNetConfig *tasknetworkconfig.TaskNetworkConfig) error - - Stop(ctx context.Context, taskNetConfig *tasknetworkconfig.TaskNetworkConfig) error -} - -type networkBuilder struct { - platformAPI platform.API -} - -func NewNetworkBuilder(platformString string) (NetworkBuilder, error) { - pAPI, err := platform.NewPlatform(platformString, ecscni.NewNetNSUtil()) - if err != nil { - return nil, errors.Wrap(err, "failed to instantiate network builder") - } - return &networkBuilder{ - platformAPI: pAPI, - }, nil -} - -func (nb *networkBuilder) BuildTaskNetworkConfiguration(taskID string, taskPayload *ecsacs.Task) (*tasknetworkconfig.TaskNetworkConfig, error) { - return nb.platformAPI.BuildTaskNetworkConfiguration(taskID, taskPayload) -} - -func (nb *networkBuilder) Start(ctx context.Context, netConfig *tasknetworkconfig.TaskNetworkConfig) error { - return nil -} - -func (nb *networkBuilder) Stop(ctx context.Context, netConfig *tasknetworkconfig.TaskNetworkConfig) error { - return nil -} diff --git a/ecs-agent/netlib/network_builder_linux_test.go b/ecs-agent/netlib/network_builder_linux_test.go deleted file mode 100644 index 07ddcd9081c..00000000000 --- a/ecs-agent/netlib/network_builder_linux_test.go +++ /dev/null @@ -1,279 +0,0 @@ -//go:build !windows && unit -// +build !windows,unit - -package netlib - -import ( - "encoding/json" - "fmt" - "testing" - - "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/status" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/tasknetworkconfig" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/platform" - - "github.com/aws/aws-sdk-go/aws" - "github.com/stretchr/testify/require" -) - -func TestNewNetworkBuilder(t *testing.T) { - nbi, err := NewNetworkBuilder(platform.WarmpoolPlatform) - nb := nbi.(*networkBuilder) - require.NoError(t, err) - require.NotNil(t, nb.platformAPI) - - nbi, err = NewNetworkBuilder("invalid-platform") - require.Error(t, err) - require.Nil(t, nbi) -} - -// TestNetworkBuilder_BuildTaskNetworkConfiguration verifies for all known use cases, -// the network builder is able to translate the input task payload into the desired -// network data models. -func TestNetworkBuilder_BuildTaskNetworkConfiguration(t *testing.T) { - t.Run("containerd-default", getTestFunc(getSingleNetNSAWSVPCTestData)) - t.Run("containerd-multi-interface", getTestFunc(getSingleNetNSMultiIfaceAWSVPCTestData)) - t.Run("containerd-multi-netns", getTestFunc(getMultiNetNSMultiIfaceAWSVPCTestData)) -} - -// getTestFunc returns a test function that verifies the capability of the networkBuilder -// to translate a given input task payload into desired network data models. -func getTestFunc(dataGenF func(string) (input *ecsacs.Task, expected tasknetworkconfig.TaskNetworkConfig)) func(*testing.T) { - - return func(t *testing.T) { - // Create a networkBuilder for the warmpool platform. - netBuilder, err := NewNetworkBuilder(platform.WarmpoolPlatform) - require.NoError(t, err) - - // Generate input task payload and a reference to verify the output with. - taskPayload, expectedConfig := dataGenF(taskID) - - // Invoke networkBuilder function for building the task network config. - actualConfig, err := netBuilder.BuildTaskNetworkConfiguration(taskID, taskPayload) - require.NoError(t, err) - - // Convert the obtained output and the reference data into json data to make it - // easier to compare. - expected, err := json.Marshal(expectedConfig) - require.NoError(t, err) - actual, err := json.Marshal(actualConfig) - require.NoError(t, err) - - require.Equal(t, string(expected), string(actual)) - } -} - -// getSingleNetNSAWSVPCTestData returns a task payload and a task network config -// to be used the input and reference result for tests. The reference object will -// has only one network namespace and network interface. -func getSingleNetNSAWSVPCTestData(testTaskID string) (*ecsacs.Task, tasknetworkconfig.TaskNetworkConfig) { - enis, netIfs := getTestInterfacesData() - taskPayload := &ecsacs.Task{ - NetworkMode: aws.String(ecs.NetworkModeAwsvpc), - ElasticNetworkInterfaces: []*ecsacs.ElasticNetworkInterface{enis[0]}, - } - - netNSName := fmt.Sprintf(netNSNamePattern, testTaskID, eniName) - netNSPath := netNSPathDir + netNSName - taskNetConfig := tasknetworkconfig.TaskNetworkConfig{ - NetworkMode: ecs.NetworkModeAwsvpc, - NetworkNamespaces: []*tasknetworkconfig.NetworkNamespace{ - { - Name: netNSName, - Path: netNSPath, - Index: 0, - NetworkInterfaces: []*networkinterface.NetworkInterface{ - &netIfs[0], - }, - KnownState: status.NetworkNone, - DesiredState: status.NetworkReadyPull, - }, - }, - } - - return taskPayload, taskNetConfig -} - -// getSingleNetNSMultiIfaceAWSVPCTestData returns test data for EKS like use cases. -func getSingleNetNSMultiIfaceAWSVPCTestData(testTaskID string) (*ecsacs.Task, tasknetworkconfig.TaskNetworkConfig) { - taskPayload, taskNetConfig := getSingleNetNSAWSVPCTestData(testTaskID) - enis, netIfs := getTestInterfacesData() - secondIFPayload := enis[1] - secondIF := &netIfs[1] - taskPayload.ElasticNetworkInterfaces = append(taskPayload.ElasticNetworkInterfaces, secondIFPayload) - netNS := taskNetConfig.NetworkNamespaces[0] - netNS.NetworkInterfaces = append(netNS.NetworkInterfaces, secondIF) - - return taskPayload, taskNetConfig -} - -// getMultiNetNSMultiIfaceAWSVPCTestData returns test data for multiple netns and net interface cases. -func getMultiNetNSMultiIfaceAWSVPCTestData(testTaskID string) (*ecsacs.Task, tasknetworkconfig.TaskNetworkConfig) { - ifName1 := "primary-eni" - ifName2 := "secondary-eni" - enis, netIfs := getTestInterfacesData() - enis[0].Name = aws.String(ifName1) - enis[1].Name = aws.String(ifName2) - - netIfs[0].Name = ifName1 - netIfs[1].Name = ifName2 - netIfs[1].Default = true - - taskPayload := &ecsacs.Task{ - NetworkMode: aws.String(ecs.NetworkModeAwsvpc), - ElasticNetworkInterfaces: enis, - Containers: []*ecsacs.Container{ - { - NetworkInterfaceNames: []*string{aws.String(ifName1)}, - }, - { - NetworkInterfaceNames: []*string{aws.String(ifName2)}, - }, - { - NetworkInterfaceNames: []*string{aws.String(ifName1)}, - }, - { - NetworkInterfaceNames: []*string{aws.String(ifName2)}, - }, - }, - } - - primaryNetNSName := fmt.Sprintf(netNSNamePattern, testTaskID, ifName1) - primaryNetNSPath := netNSPathDir + primaryNetNSName - secondaryNetNSName := fmt.Sprintf(netNSNamePattern, testTaskID, ifName2) - secondaryNetNSPath := netNSPathDir + secondaryNetNSName - - taskNetConfig := tasknetworkconfig.TaskNetworkConfig{ - NetworkMode: ecs.NetworkModeAwsvpc, - NetworkNamespaces: []*tasknetworkconfig.NetworkNamespace{ - { - Name: primaryNetNSName, - Path: primaryNetNSPath, - Index: 0, - NetworkInterfaces: []*networkinterface.NetworkInterface{ - &netIfs[0], - }, - KnownState: status.NetworkNone, - DesiredState: status.NetworkReadyPull, - }, - { - Name: secondaryNetNSName, - Path: secondaryNetNSPath, - Index: 1, - NetworkInterfaces: []*networkinterface.NetworkInterface{ - &netIfs[1], - }, - KnownState: status.NetworkNone, - DesiredState: status.NetworkReadyPull, - }, - }, - } - - return taskPayload, taskNetConfig -} - -func getTestInterfacesData() ([]*ecsacs.ElasticNetworkInterface, []networkinterface.NetworkInterface) { - // interfacePayloads have multiple interfaces as they are sent by ACS - // that can be used as input data for tests. - interfacePayloads := []*ecsacs.ElasticNetworkInterface{ - { - Ec2Id: aws.String(eniID), - MacAddress: aws.String(eniMAC), - PrivateDnsName: aws.String(dnsName), - DomainNameServers: []*string{aws.String(nameServer)}, - Index: aws.Int64(0), - Ipv4Addresses: []*ecsacs.IPv4AddressAssignment{ - { - Primary: aws.Bool(true), - PrivateAddress: aws.String(ipv4Addr), - }, - }, - Ipv6Addresses: []*ecsacs.IPv6AddressAssignment{ - { - Address: aws.String(ipv6Addr), - }, - }, - SubnetGatewayIpv4Address: aws.String(subnetGatewayCIDR), - InterfaceAssociationProtocol: aws.String(networkinterface.DefaultInterfaceAssociationProtocol), - DomainName: []*string{aws.String(searchDomainName)}, - }, - { - Ec2Id: aws.String(eniID2), - MacAddress: aws.String(eniMAC2), - PrivateDnsName: aws.String(dnsName), - DomainNameServers: []*string{aws.String(nameServer2)}, - Index: aws.Int64(1), - Ipv4Addresses: []*ecsacs.IPv4AddressAssignment{ - { - Primary: aws.Bool(true), - PrivateAddress: aws.String(ipv4Addr2), - }, - }, - Ipv6Addresses: []*ecsacs.IPv6AddressAssignment{ - { - Address: aws.String(ipv6Addr2), - }, - }, - SubnetGatewayIpv4Address: aws.String(subnetGatewayCIDR2), - InterfaceAssociationProtocol: aws.String(networkinterface.DefaultInterfaceAssociationProtocol), - DomainName: []*string{aws.String(searchDomainName)}, - }, - } - - networkInterfaces := []networkinterface.NetworkInterface{ - { - ID: eniID, - MacAddress: eniMAC, - Name: eniName, - IPV4Addresses: []*networkinterface.IPV4Address{ - { - Primary: true, - Address: ipv4Addr, - }, - }, - IPV6Addresses: []*networkinterface.IPV6Address{ - { - Address: ipv6Addr, - }, - }, - SubnetGatewayIPV4Address: subnetGatewayCIDR, - DomainNameServers: []string{nameServer}, - DomainNameSearchList: []string{searchDomainName}, - PrivateDNSName: dnsName, - InterfaceAssociationProtocol: networkinterface.DefaultInterfaceAssociationProtocol, - Index: int64(0), - Default: true, - KnownStatus: status.NetworkNone, - DesiredStatus: status.NetworkReadyPull, - }, - { - ID: eniID2, - MacAddress: eniMAC2, - Name: eniName2, - IPV4Addresses: []*networkinterface.IPV4Address{ - { - Primary: true, - Address: ipv4Addr2, - }, - }, - IPV6Addresses: []*networkinterface.IPV6Address{ - { - Address: ipv6Addr2, - }, - }, - SubnetGatewayIPV4Address: subnetGatewayCIDR2, - DomainNameServers: []string{nameServer2}, - DomainNameSearchList: []string{searchDomainName}, - PrivateDNSName: dnsName, - InterfaceAssociationProtocol: networkinterface.DefaultInterfaceAssociationProtocol, - Index: int64(1), - KnownStatus: status.NetworkNone, - DesiredStatus: status.NetworkReadyPull, - }, - } - - return interfacePayloads, networkInterfaces -} diff --git a/ecs-agent/netlib/platform/api.go b/ecs-agent/netlib/platform/api.go deleted file mode 100644 index 0e6f4f7b152..00000000000 --- a/ecs-agent/netlib/platform/api.go +++ /dev/null @@ -1,33 +0,0 @@ -package platform - -import ( - "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/tasknetworkconfig" -) - -// API declares a set of methods that requires platform specific implementations. -type API interface { - // BuildTaskNetworkConfiguration translates network data in task payload sent by ACS - // into the task network configuration data structure internal to the agent. - BuildTaskNetworkConfiguration( - taskID string, - taskPayload *ecsacs.Task) (*tasknetworkconfig.TaskNetworkConfig, error) - - // CreateNetNS creates a network namespace with the specified name. - CreateNetNS(netNSName string) error - - // DeleteNetNS deletes the specified network namespace. - DeleteNetNS(netnsName string) error - - // CreateDNSConfig creates the following DNS config files depending on the - // task network configuration: - // 1. resolv.conf - // 2. hosts - // 3. hostname - // These files are then copied into desired locations so that containers will - // have access to the accurate DNS configuration information. - CreateDNSConfig(taskNetConfig *tasknetworkconfig.TaskNetworkConfig) error - - // GetNetNSPath returns the path of a network namespace. - GetNetNSPath(netNSName string) string -} diff --git a/ecs-agent/netlib/platform/common_linux.go b/ecs-agent/netlib/platform/common_linux.go deleted file mode 100644 index ae44b780f66..00000000000 --- a/ecs-agent/netlib/platform/common_linux.go +++ /dev/null @@ -1,207 +0,0 @@ -//go:build !windows -// +build !windows - -package platform - -import ( - "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/ecs_client/model/ecs" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/ecscni" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/networkinterface" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/tasknetworkconfig" - "github.com/aws/aws-sdk-go/aws" - "github.com/pkg/errors" -) - -const ( - // Identifiers for each platform we support. - WarmpoolDebugPlatform = "ec2-debug-warmpool" - FirecrackerDebugPlatform = "ec2-debug-firecracker" - WarmpoolPlatform = "warmpool" - FirecrackerPlatform = "firecracker" - - // indexHighValue is a placeholder value used while finding - // interface with lowest index in from the ACS payload. - // It is assigned 100 because it is an unrealistically high - // value for interface index. - indexHighValue = 100 -) - -// common will be embedded within every implementation of the platform API. -// It contains all fields and methods that can be commonly used by all -// platforms. -type common struct { - nsUtil ecscni.NetNSUtil -} - -// NewPlatform creates an implementation of the platform API depending on the -// platform type where the agent is executing. -func NewPlatform( - platformString string, - nsUtil ecscni.NetNSUtil) (API, error) { - commonPlatform := common{ - nsUtil: nsUtil, - } - - // TODO: implement remaining platforms - FoF, ECS on EC2. - switch platformString { - case WarmpoolPlatform: - return &containerd{ - common: commonPlatform, - }, nil - } - return nil, errors.New("invalid platform: " + platformString) -} - -// BuildTaskNetworkConfiguration translates network data in task payload sent by ACS -// into the task network configuration data structure internal to the agent. -func (c *common) BuildTaskNetworkConfiguration( - taskID string, - taskPayload *ecsacs.Task) (*tasknetworkconfig.TaskNetworkConfig, error) { - mode := aws.StringValue(taskPayload.NetworkMode) - var netNSs []*tasknetworkconfig.NetworkNamespace - var err error - switch mode { - case ecs.NetworkModeAwsvpc: - netNSs, err = c.buildAWSVPCNetworkNamespaces(taskID, taskPayload) - if err != nil { - return nil, errors.Wrap(err, "failed to translate network configuration") - } - case ecs.NetworkModeBridge: - return nil, errors.New("not implemented") - case ecs.NetworkModeHost: - return nil, errors.New("not implemented") - case ecs.NetworkModeNone: - return nil, errors.New("not implemented") - default: - return nil, errors.New("invalid network mode: " + mode) - } - - return &tasknetworkconfig.TaskNetworkConfig{ - NetworkNamespaces: netNSs, - NetworkMode: mode, - }, nil -} - -func (c *common) GetNetNSPath(netNSName string) string { - return c.nsUtil.GetNetNSPath(netNSName) -} - -// buildAWSVPCNetworkNamespaces returns list of NetworkNamespace which will be used to -// create the task's network configuration. All cases except those for FoF is covered by -// this method. FoF requires a separate specific implementation because the network setup -// is different due to the presence of the microVM. -// Use cases covered by this method are: -// 1. Single interface, network namespace (the only externally available config). -// 2. Single netns, multiple interfaces (For a non-managed multi-ENI experience. Eg EKS use case). -// 3. Multiple netns, multiple interfaces (future use case for internal customer who need -// a managed multi-ENI experience). -func (c *common) buildAWSVPCNetworkNamespaces(taskID string, - taskPayload *ecsacs.Task) ([]*tasknetworkconfig.NetworkNamespace, error) { - if len(taskPayload.ElasticNetworkInterfaces) == 0 { - return nil, errors.New("interfaces list cannot be empty") - } - // If task payload has only one interface, the network configuration is - // straight forward. It will have only one network namespace containing - // the corresponding network interface. - // Empty Name fields in network interface names indicate that all - // interfaces share the same network namespace. This use case is - // utilized by certain internal teams like EKS on Fargate. - if len(taskPayload.ElasticNetworkInterfaces) == 1 || - aws.StringValue(taskPayload.ElasticNetworkInterfaces[0].Name) == "" { - primaryNetNS, err := c.buildSingleNSNetConfig(taskID, - 0, - taskPayload.ElasticNetworkInterfaces, - taskPayload.ProxyConfiguration) - if err != nil { - return nil, err - } - - return []*tasknetworkconfig.NetworkNamespace{primaryNetNS}, nil - } - - // Create a map for easier lookup of ENIs by their names. - ifNameMap := make(map[string]*ecsacs.ElasticNetworkInterface, len(taskPayload.ElasticNetworkInterfaces)) - for _, iface := range taskPayload.ElasticNetworkInterfaces { - ifNameMap[networkinterface.GetInterfaceName(iface)] = iface - } - - // Proxy configuration is not supported yet in a multi-ENI / multi-NetNS task. - if taskPayload.ProxyConfiguration != nil { - return nil, errors.New("unexpected proxy config found") - } - - // The number of network namespaces required to create depends on the - // number of unique interface names list across all container definitions - // in the task payload. Meaning if two containers are linked with the same - // set of network interface names, both those containers share the same namespace. - // If not, they reside in two different namespaces. Also, an interface can only - // belong to one NetworkNamespace object. - - var netNSs []*tasknetworkconfig.NetworkNamespace - nsIndex := 0 - // Loop through each container definition and their network interfaces. - for _, container := range taskPayload.Containers { - // ifaces holds all interfaces associated with a particular container. - var ifaces []*ecsacs.ElasticNetworkInterface - for _, ifNameP := range container.NetworkInterfaceNames { - ifName := aws.StringValue(ifNameP) - if iface := ifNameMap[ifName]; iface != nil { - ifaces = append(ifaces, iface) - // Remove ENI from map to indicate that the ENI is assigned to - // a namespace. - delete(ifNameMap, ifName) - } else { - // If the ENI does not exist in the lookup map, it means the ENI - // is already assigned to a namespace. The container will be run - // in the same namespace. - break - } - } - - if len(ifaces) == 0 { - continue - } - - netNS, err := c.buildSingleNSNetConfig(taskID, nsIndex, ifaces, nil) - if err != nil { - return nil, err - } - netNSs = append(netNSs, netNS) - nsIndex += 1 - } - - return netNSs, nil -} - -func (c *common) buildSingleNSNetConfig( - taskID string, - index int, - networkInterfaces []*ecsacs.ElasticNetworkInterface, - proxyConfig *ecsacs.ProxyConfiguration) (*tasknetworkconfig.NetworkNamespace, error) { - var primaryIF *networkinterface.NetworkInterface - var ifaces []*networkinterface.NetworkInterface - lowestIdx := int64(indexHighValue) - for _, ni := range networkInterfaces { - iface, err := networkinterface.New(ni, "", nil) - if err != nil { - return nil, err - } - if aws.Int64Value(ni.Index) < lowestIdx { - primaryIF = iface - lowestIdx = aws.Int64Value(ni.Index) - } - ifaces = append(ifaces, iface) - } - - primaryIF.Default = true - netNSName := networkinterface.NetNSName(taskID, primaryIF.Name) - netNSPath := c.GetNetNSPath(netNSName) - - return tasknetworkconfig.NewNetworkNamespace( - netNSName, - netNSPath, - index, - proxyConfig, - ifaces...) -} diff --git a/ecs-agent/netlib/platform/common_linux_test.go b/ecs-agent/netlib/platform/common_linux_test.go deleted file mode 100644 index eeae1ffd379..00000000000 --- a/ecs-agent/netlib/platform/common_linux_test.go +++ /dev/null @@ -1,18 +0,0 @@ -//go:build !windows && unit -// +build !windows,unit - -package platform - -import ( - "github.com/stretchr/testify/assert" - - "testing" -) - -func TestNewPlatform(t *testing.T) { - _, err := NewPlatform(WarmpoolPlatform, nil) - assert.NoError(t, err) - - _, err = NewPlatform("invalid-platform", nil) - assert.Error(t, err) -} diff --git a/ecs-agent/netlib/platform/containerd_linux.go b/ecs-agent/netlib/platform/containerd_linux.go deleted file mode 100644 index 7e08e62c7f1..00000000000 --- a/ecs-agent/netlib/platform/containerd_linux.go +++ /dev/null @@ -1,31 +0,0 @@ -package platform - -import ( - "context" - - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/tasknetworkconfig" -) - -// containerd implements platform API methods for non-firecrakcer infrastructure. -type containerd struct { - common -} - -func (c *containerd) CreateNetNS(netNSName string) error { - return nil -} - -func (c *containerd) ConfigureNamespaces( - ctx context.Context, - netNamespaces []*tasknetworkconfig.NetworkNamespace, - networkMode string) error { - return nil -} - -func (c *containerd) DeleteNetNS(netnsName string) error { - return nil -} - -func (c *containerd) CreateDNSConfig(taskNetConfig *tasknetworkconfig.TaskNetworkConfig) error { - return nil -} diff --git a/ecs-agent/netlib/platform/containerd_windows.go b/ecs-agent/netlib/platform/containerd_windows.go deleted file mode 100644 index 5c4403580b5..00000000000 --- a/ecs-agent/netlib/platform/containerd_windows.go +++ /dev/null @@ -1,42 +0,0 @@ -//go:build windows -// +build windows - -package platform - -import ( - "github.com/aws/amazon-ecs-agent/ecs-agent/acs/model/ecsacs" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/ecscni" - "github.com/aws/amazon-ecs-agent/ecs-agent/netlib/model/tasknetworkconfig" -) - -type containerd struct { - nsUtil ecscni.NetNSUtil -} - -func NewPlatform( - platformString string, - nsUtil ecscni.NetNSUtil) (API, error) { - return nil, nil -} - -func (c *containerd) BuildTaskNetworkConfiguration( - taskID string, - taskPayload *ecsacs.Task) (*tasknetworkconfig.TaskNetworkConfig, error) { - return nil, nil -} - -func (c *containerd) CreateNetNS(netNSName string) error { - return nil -} - -func (c *containerd) DeleteNetNS(netnsName string) error { - return nil -} - -func (c *containerd) CreateDNSConfig(taskNetConfig *tasknetworkconfig.TaskNetworkConfig) error { - return nil -} - -func (c *containerd) GetNetNSPath(netNSName string) string { - return "" -} diff --git a/ecs-agent/utils/utils.go b/ecs-agent/utils/utils.go index fa4581a5d30..7ac89d29750 100644 --- a/ecs-agent/utils/utils.go +++ b/ecs-agent/utils/utils.go @@ -12,10 +12,7 @@ // permissions and limitations under the License. package utils -import ( - "reflect" - "strconv" -) +import "reflect" func ZeroOrNil(obj interface{}) bool { value := reflect.ValueOf(obj) @@ -38,14 +35,3 @@ func ZeroOrNil(obj interface{}) bool { } return false } - -// Uint16SliceToStringSlice converts a slice of type uint16 to a slice of type -// *string. It uses strconv.Itoa on each element -func Uint16SliceToStringSlice(slice []uint16) []*string { - stringSlice := make([]*string, len(slice)) - for i, el := range slice { - str := strconv.Itoa(int(el)) - stringSlice[i] = &str - } - return stringSlice -} diff --git a/ecs-agent/utils/utils_test.go b/ecs-agent/utils/utils_test.go index bcbd390b210..2ffecf4fae0 100644 --- a/ecs-agent/utils/utils_test.go +++ b/ecs-agent/utils/utils_test.go @@ -13,7 +13,6 @@ package utils import ( - "strconv" "testing" "github.com/stretchr/testify/assert" @@ -60,32 +59,3 @@ func TestZeroOrNil(t *testing.T) { } } - -// TestUint16SliceToStringSlice tests the utils method Uint16SliceToStringSlice -// By taking in a slice of untyped 16 bit ints, asserting the util function -// returns the correct size of array, and asserts their equality. -// This is done by re-converting the string into a uint16. -func TestUint16SliceToStringSlice(t *testing.T) { - testCases := []struct { - param []uint16 - expected int - name string - }{ - {nil, 0, "Nil argument"}, - {[]uint16{0, 1, 2, 3}, 4, "Basic set"}, - {[]uint16{65535}, 1, "Max Value"}, - } - - for _, tc := range testCases { - t.Run(tc.name, func(t *testing.T) { - output := Uint16SliceToStringSlice(tc.param) - assert.Equal(t, tc.expected, len(output), tc.name) - for idx, num := range tc.param { - reconverted, err := strconv.Atoi(*output[idx]) - assert.NoError(t, err) - assert.Equal(t, num, uint16(reconverted)) - } - - }) - } -} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers.go deleted file mode 100644 index 36a915efea8..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/handlers.go +++ /dev/null @@ -1,232 +0,0 @@ -package corehandlers - -import ( - "bytes" - "fmt" - "io/ioutil" - "net/http" - "net/url" - "regexp" - "strconv" - "time" - - "github.com/aws/aws-sdk-go/aws" - "github.com/aws/aws-sdk-go/aws/awserr" - "github.com/aws/aws-sdk-go/aws/credentials" - "github.com/aws/aws-sdk-go/aws/request" -) - -// Interface for matching types which also have a Len method. -type lener interface { - Len() int -} - -// BuildContentLengthHandler builds the content length of a request based on the body, -// or will use the HTTPRequest.Header's "Content-Length" if defined. If unable -// to determine request body length and no "Content-Length" was specified it will panic. -// -// The Content-Length will only be added to the request if the length of the body -// is greater than 0. If the body is empty or the current `Content-Length` -// header is <= 0, the header will also be stripped. -var BuildContentLengthHandler = request.NamedHandler{Name: "core.BuildContentLengthHandler", Fn: func(r *request.Request) { - var length int64 - - if slength := r.HTTPRequest.Header.Get("Content-Length"); slength != "" { - length, _ = strconv.ParseInt(slength, 10, 64) - } else { - if r.Body != nil { - var err error - length, err = aws.SeekerLen(r.Body) - if err != nil { - r.Error = awserr.New(request.ErrCodeSerialization, "failed to get request body's length", err) - return - } - } - } - - if length > 0 { - r.HTTPRequest.ContentLength = length - r.HTTPRequest.Header.Set("Content-Length", fmt.Sprintf("%d", length)) - } else { - r.HTTPRequest.ContentLength = 0 - r.HTTPRequest.Header.Del("Content-Length") - } -}} - -var reStatusCode = regexp.MustCompile(`^(\d{3})`) - -// ValidateReqSigHandler is a request handler to ensure that the request's -// signature doesn't expire before it is sent. This can happen when a request -// is built and signed significantly before it is sent. Or significant delays -// occur when retrying requests that would cause the signature to expire. -var ValidateReqSigHandler = request.NamedHandler{ - Name: "core.ValidateReqSigHandler", - Fn: func(r *request.Request) { - // Unsigned requests are not signed - if r.Config.Credentials == credentials.AnonymousCredentials { - return - } - - signedTime := r.Time - if !r.LastSignedAt.IsZero() { - signedTime = r.LastSignedAt - } - - // 5 minutes to allow for some clock skew/delays in transmission. - // Would be improved with aws/aws-sdk-go#423 - if signedTime.Add(5 * time.Minute).After(time.Now()) { - return - } - - fmt.Println("request expired, resigning") - r.Sign() - }, -} - -// SendHandler is a request handler to send service request using HTTP client. -var SendHandler = request.NamedHandler{ - Name: "core.SendHandler", - Fn: func(r *request.Request) { - sender := sendFollowRedirects - if r.DisableFollowRedirects { - sender = sendWithoutFollowRedirects - } - - if request.NoBody == r.HTTPRequest.Body { - // Strip off the request body if the NoBody reader was used as a - // place holder for a request body. This prevents the SDK from - // making requests with a request body when it would be invalid - // to do so. - // - // Use a shallow copy of the http.Request to ensure the race condition - // of transport on Body will not trigger - reqOrig, reqCopy := r.HTTPRequest, *r.HTTPRequest - reqCopy.Body = nil - r.HTTPRequest = &reqCopy - defer func() { - r.HTTPRequest = reqOrig - }() - } - - var err error - r.HTTPResponse, err = sender(r) - if err != nil { - handleSendError(r, err) - } - }, -} - -func sendFollowRedirects(r *request.Request) (*http.Response, error) { - return r.Config.HTTPClient.Do(r.HTTPRequest) -} - -func sendWithoutFollowRedirects(r *request.Request) (*http.Response, error) { - transport := r.Config.HTTPClient.Transport - if transport == nil { - transport = http.DefaultTransport - } - - return transport.RoundTrip(r.HTTPRequest) -} - -func handleSendError(r *request.Request, err error) { - // Prevent leaking if an HTTPResponse was returned. Clean up - // the body. - if r.HTTPResponse != nil { - r.HTTPResponse.Body.Close() - } - // Capture the case where url.Error is returned for error processing - // response. e.g. 301 without location header comes back as string - // error and r.HTTPResponse is nil. Other URL redirect errors will - // comeback in a similar method. - if e, ok := err.(*url.Error); ok && e.Err != nil { - if s := reStatusCode.FindStringSubmatch(e.Err.Error()); s != nil { - code, _ := strconv.ParseInt(s[1], 10, 64) - r.HTTPResponse = &http.Response{ - StatusCode: int(code), - Status: http.StatusText(int(code)), - Body: ioutil.NopCloser(bytes.NewReader([]byte{})), - } - return - } - } - if r.HTTPResponse == nil { - // Add a dummy request response object to ensure the HTTPResponse - // value is consistent. - r.HTTPResponse = &http.Response{ - StatusCode: int(0), - Status: http.StatusText(int(0)), - Body: ioutil.NopCloser(bytes.NewReader([]byte{})), - } - } - // Catch all request errors, and let the default retrier determine - // if the error is retryable. - r.Error = awserr.New(request.ErrCodeRequestError, "send request failed", err) - - // Override the error with a context canceled error, if that was canceled. - ctx := r.Context() - select { - case <-ctx.Done(): - r.Error = awserr.New(request.CanceledErrorCode, - "request context canceled", ctx.Err()) - r.Retryable = aws.Bool(false) - default: - } -} - -// ValidateResponseHandler is a request handler to validate service response. -var ValidateResponseHandler = request.NamedHandler{Name: "core.ValidateResponseHandler", Fn: func(r *request.Request) { - if r.HTTPResponse.StatusCode == 0 || r.HTTPResponse.StatusCode >= 300 { - // this may be replaced by an UnmarshalError handler - r.Error = awserr.New("UnknownError", "unknown error", r.Error) - } -}} - -// AfterRetryHandler performs final checks to determine if the request should -// be retried and how long to delay. -var AfterRetryHandler = request.NamedHandler{ - Name: "core.AfterRetryHandler", - Fn: func(r *request.Request) { - // If one of the other handlers already set the retry state - // we don't want to override it based on the service's state - if r.Retryable == nil || aws.BoolValue(r.Config.EnforceShouldRetryCheck) { - r.Retryable = aws.Bool(r.ShouldRetry(r)) - } - - if r.WillRetry() { - r.RetryDelay = r.RetryRules(r) - - if sleepFn := r.Config.SleepDelay; sleepFn != nil { - // Support SleepDelay for backwards compatibility and testing - sleepFn(r.RetryDelay) - } else if err := aws.SleepWithContext(r.Context(), r.RetryDelay); err != nil { - r.Error = awserr.New(request.CanceledErrorCode, - "request context canceled", err) - r.Retryable = aws.Bool(false) - return - } - - // when the expired token exception occurs the credentials - // need to be expired locally so that the next request to - // get credentials will trigger a credentials refresh. - if r.IsErrorExpired() { - r.Config.Credentials.Expire() - } - - r.RetryCount++ - r.Error = nil - } - }} - -// ValidateEndpointHandler is a request handler to validate a request had the -// appropriate Region and Endpoint set. Will set r.Error if the endpoint or -// region is not valid. -var ValidateEndpointHandler = request.NamedHandler{Name: "core.ValidateEndpointHandler", Fn: func(r *request.Request) { - if r.ClientInfo.SigningRegion == "" && aws.StringValue(r.Config.Region) == "" { - r.Error = aws.ErrMissingRegion - } else if r.ClientInfo.Endpoint == "" { - // Was any endpoint provided by the user, or one was derived by the - // SDK's endpoint resolver? - r.Error = aws.ErrMissingEndpoint - } -}} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/param_validator.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/param_validator.go deleted file mode 100644 index 7d50b1557cc..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/param_validator.go +++ /dev/null @@ -1,17 +0,0 @@ -package corehandlers - -import "github.com/aws/aws-sdk-go/aws/request" - -// ValidateParametersHandler is a request handler to validate the input parameters. -// Validating parameters only has meaning if done prior to the request being sent. -var ValidateParametersHandler = request.NamedHandler{Name: "core.ValidateParametersHandler", Fn: func(r *request.Request) { - if !r.ParamsFilled() { - return - } - - if v, ok := r.Params.(request.Validator); ok { - if err := v.Validate(); err != nil { - r.Error = err - } - } -}} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/user_agent.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/user_agent.go deleted file mode 100644 index ab69c7a6f38..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/corehandlers/user_agent.go +++ /dev/null @@ -1,37 +0,0 @@ -package corehandlers - -import ( - "os" - "runtime" - - "github.com/aws/aws-sdk-go/aws" - "github.com/aws/aws-sdk-go/aws/request" -) - -// SDKVersionUserAgentHandler is a request handler for adding the SDK Version -// to the user agent. -var SDKVersionUserAgentHandler = request.NamedHandler{ - Name: "core.SDKVersionUserAgentHandler", - Fn: request.MakeAddToUserAgentHandler(aws.SDKName, aws.SDKVersion, - runtime.Version(), runtime.GOOS, runtime.GOARCH), -} - -const execEnvVar = `AWS_EXECUTION_ENV` -const execEnvUAKey = `exec-env` - -// AddHostExecEnvUserAgentHander is a request handler appending the SDK's -// execution environment to the user agent. -// -// If the environment variable AWS_EXECUTION_ENV is set, its value will be -// appended to the user agent string. -var AddHostExecEnvUserAgentHander = request.NamedHandler{ - Name: "core.AddHostExecEnvUserAgentHander", - Fn: func(r *request.Request) { - v := os.Getenv(execEnvVar) - if len(v) == 0 { - return - } - - request.AddToUserAgent(r, execEnvUAKey+"/"+v) - }, -} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/credentials/ec2rolecreds/ec2_role_provider.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/credentials/ec2rolecreds/ec2_role_provider.go deleted file mode 100644 index 92af5b7250a..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/credentials/ec2rolecreds/ec2_role_provider.go +++ /dev/null @@ -1,188 +0,0 @@ -package ec2rolecreds - -import ( - "bufio" - "encoding/json" - "fmt" - "strings" - "time" - - "github.com/aws/aws-sdk-go/aws" - "github.com/aws/aws-sdk-go/aws/awserr" - "github.com/aws/aws-sdk-go/aws/client" - "github.com/aws/aws-sdk-go/aws/credentials" - "github.com/aws/aws-sdk-go/aws/ec2metadata" - "github.com/aws/aws-sdk-go/aws/request" - "github.com/aws/aws-sdk-go/internal/sdkuri" -) - -// ProviderName provides a name of EC2Role provider -const ProviderName = "EC2RoleProvider" - -// A EC2RoleProvider retrieves credentials from the EC2 service, and keeps track if -// those credentials are expired. -// -// Example how to configure the EC2RoleProvider with custom http Client, Endpoint -// or ExpiryWindow -// -// p := &ec2rolecreds.EC2RoleProvider{ -// // Pass in a custom timeout to be used when requesting -// // IAM EC2 Role credentials. -// Client: ec2metadata.New(sess, aws.Config{ -// HTTPClient: &http.Client{Timeout: 10 * time.Second}, -// }), -// -// // Do not use early expiry of credentials. If a non zero value is -// // specified the credentials will be expired early -// ExpiryWindow: 0, -// } -type EC2RoleProvider struct { - credentials.Expiry - - // Required EC2Metadata client to use when connecting to EC2 metadata service. - Client *ec2metadata.EC2Metadata - - // ExpiryWindow will allow the credentials to trigger refreshing prior to - // the credentials actually expiring. This is beneficial so race conditions - // with expiring credentials do not cause request to fail unexpectedly - // due to ExpiredTokenException exceptions. - // - // So a ExpiryWindow of 10s would cause calls to IsExpired() to return true - // 10 seconds before the credentials are actually expired. - // - // If ExpiryWindow is 0 or less it will be ignored. - ExpiryWindow time.Duration -} - -// NewCredentials returns a pointer to a new Credentials object wrapping -// the EC2RoleProvider. Takes a ConfigProvider to create a EC2Metadata client. -// The ConfigProvider is satisfied by the session.Session type. -func NewCredentials(c client.ConfigProvider, options ...func(*EC2RoleProvider)) *credentials.Credentials { - p := &EC2RoleProvider{ - Client: ec2metadata.New(c), - } - - for _, option := range options { - option(p) - } - - return credentials.NewCredentials(p) -} - -// NewCredentialsWithClient returns a pointer to a new Credentials object wrapping -// the EC2RoleProvider. Takes a EC2Metadata client to use when connecting to EC2 -// metadata service. -func NewCredentialsWithClient(client *ec2metadata.EC2Metadata, options ...func(*EC2RoleProvider)) *credentials.Credentials { - p := &EC2RoleProvider{ - Client: client, - } - - for _, option := range options { - option(p) - } - - return credentials.NewCredentials(p) -} - -// Retrieve retrieves credentials from the EC2 service. -// Error will be returned if the request fails, or unable to extract -// the desired credentials. -func (m *EC2RoleProvider) Retrieve() (credentials.Value, error) { - return m.RetrieveWithContext(aws.BackgroundContext()) -} - -// RetrieveWithContext retrieves credentials from the EC2 service. -// Error will be returned if the request fails, or unable to extract -// the desired credentials. -func (m *EC2RoleProvider) RetrieveWithContext(ctx credentials.Context) (credentials.Value, error) { - credsList, err := requestCredList(ctx, m.Client) - if err != nil { - return credentials.Value{ProviderName: ProviderName}, err - } - - if len(credsList) == 0 { - return credentials.Value{ProviderName: ProviderName}, awserr.New("EmptyEC2RoleList", "empty EC2 Role list", nil) - } - credsName := credsList[0] - - roleCreds, err := requestCred(ctx, m.Client, credsName) - if err != nil { - return credentials.Value{ProviderName: ProviderName}, err - } - - m.SetExpiration(roleCreds.Expiration, m.ExpiryWindow) - - return credentials.Value{ - AccessKeyID: roleCreds.AccessKeyID, - SecretAccessKey: roleCreds.SecretAccessKey, - SessionToken: roleCreds.Token, - ProviderName: ProviderName, - }, nil -} - -// A ec2RoleCredRespBody provides the shape for unmarshaling credential -// request responses. -type ec2RoleCredRespBody struct { - // Success State - Expiration time.Time - AccessKeyID string - SecretAccessKey string - Token string - - // Error state - Code string - Message string -} - -const iamSecurityCredsPath = "iam/security-credentials/" - -// requestCredList requests a list of credentials from the EC2 service. -// If there are no credentials, or there is an error making or receiving the request -func requestCredList(ctx aws.Context, client *ec2metadata.EC2Metadata) ([]string, error) { - resp, err := client.GetMetadataWithContext(ctx, iamSecurityCredsPath) - if err != nil { - return nil, awserr.New("EC2RoleRequestError", "no EC2 instance role found", err) - } - - credsList := []string{} - s := bufio.NewScanner(strings.NewReader(resp)) - for s.Scan() { - credsList = append(credsList, s.Text()) - } - - if err := s.Err(); err != nil { - return nil, awserr.New(request.ErrCodeSerialization, - "failed to read EC2 instance role from metadata service", err) - } - - return credsList, nil -} - -// requestCred requests the credentials for a specific credentials from the EC2 service. -// -// If the credentials cannot be found, or there is an error reading the response -// and error will be returned. -func requestCred(ctx aws.Context, client *ec2metadata.EC2Metadata, credsName string) (ec2RoleCredRespBody, error) { - resp, err := client.GetMetadataWithContext(ctx, sdkuri.PathJoin(iamSecurityCredsPath, credsName)) - if err != nil { - return ec2RoleCredRespBody{}, - awserr.New("EC2RoleRequestError", - fmt.Sprintf("failed to get %s EC2 instance role credentials", credsName), - err) - } - - respCreds := ec2RoleCredRespBody{} - if err := json.NewDecoder(strings.NewReader(resp)).Decode(&respCreds); err != nil { - return ec2RoleCredRespBody{}, - awserr.New(request.ErrCodeSerialization, - fmt.Sprintf("failed to decode %s EC2 instance role credentials", credsName), - err) - } - - if respCreds.Code != "Success" { - // If an error code was returned something failed requesting the role. - return ec2RoleCredRespBody{}, awserr.New(respCreds.Code, respCreds.Message, nil) - } - - return respCreds, nil -} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/credentials/endpointcreds/provider.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/credentials/endpointcreds/provider.go deleted file mode 100644 index 785f30d8e6c..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/credentials/endpointcreds/provider.go +++ /dev/null @@ -1,210 +0,0 @@ -// Package endpointcreds provides support for retrieving credentials from an -// arbitrary HTTP endpoint. -// -// The credentials endpoint Provider can receive both static and refreshable -// credentials that will expire. Credentials are static when an "Expiration" -// value is not provided in the endpoint's response. -// -// Static credentials will never expire once they have been retrieved. The format -// of the static credentials response: -// { -// "AccessKeyId" : "MUA...", -// "SecretAccessKey" : "/7PC5om....", -// } -// -// Refreshable credentials will expire within the "ExpiryWindow" of the Expiration -// value in the response. The format of the refreshable credentials response: -// { -// "AccessKeyId" : "MUA...", -// "SecretAccessKey" : "/7PC5om....", -// "Token" : "AQoDY....=", -// "Expiration" : "2016-02-25T06:03:31Z" -// } -// -// Errors should be returned in the following format and only returned with 400 -// or 500 HTTP status codes. -// { -// "code": "ErrorCode", -// "message": "Helpful error message." -// } -package endpointcreds - -import ( - "encoding/json" - "time" - - "github.com/aws/aws-sdk-go/aws" - "github.com/aws/aws-sdk-go/aws/awserr" - "github.com/aws/aws-sdk-go/aws/client" - "github.com/aws/aws-sdk-go/aws/client/metadata" - "github.com/aws/aws-sdk-go/aws/credentials" - "github.com/aws/aws-sdk-go/aws/request" - "github.com/aws/aws-sdk-go/private/protocol/json/jsonutil" -) - -// ProviderName is the name of the credentials provider. -const ProviderName = `CredentialsEndpointProvider` - -// Provider satisfies the credentials.Provider interface, and is a client to -// retrieve credentials from an arbitrary endpoint. -type Provider struct { - staticCreds bool - credentials.Expiry - - // Requires a AWS Client to make HTTP requests to the endpoint with. - // the Endpoint the request will be made to is provided by the aws.Config's - // Endpoint value. - Client *client.Client - - // ExpiryWindow will allow the credentials to trigger refreshing prior to - // the credentials actually expiring. This is beneficial so race conditions - // with expiring credentials do not cause request to fail unexpectedly - // due to ExpiredTokenException exceptions. - // - // So a ExpiryWindow of 10s would cause calls to IsExpired() to return true - // 10 seconds before the credentials are actually expired. - // - // If ExpiryWindow is 0 or less it will be ignored. - ExpiryWindow time.Duration - - // Optional authorization token value if set will be used as the value of - // the Authorization header of the endpoint credential request. - AuthorizationToken string -} - -// NewProviderClient returns a credentials Provider for retrieving AWS credentials -// from arbitrary endpoint. -func NewProviderClient(cfg aws.Config, handlers request.Handlers, endpoint string, options ...func(*Provider)) credentials.Provider { - p := &Provider{ - Client: client.New( - cfg, - metadata.ClientInfo{ - ServiceName: "CredentialsEndpoint", - Endpoint: endpoint, - }, - handlers, - ), - } - - p.Client.Handlers.Unmarshal.PushBack(unmarshalHandler) - p.Client.Handlers.UnmarshalError.PushBack(unmarshalError) - p.Client.Handlers.Validate.Clear() - p.Client.Handlers.Validate.PushBack(validateEndpointHandler) - - for _, option := range options { - option(p) - } - - return p -} - -// NewCredentialsClient returns a pointer to a new Credentials object -// wrapping the endpoint credentials Provider. -func NewCredentialsClient(cfg aws.Config, handlers request.Handlers, endpoint string, options ...func(*Provider)) *credentials.Credentials { - return credentials.NewCredentials(NewProviderClient(cfg, handlers, endpoint, options...)) -} - -// IsExpired returns true if the credentials retrieved are expired, or not yet -// retrieved. -func (p *Provider) IsExpired() bool { - if p.staticCreds { - return false - } - return p.Expiry.IsExpired() -} - -// Retrieve will attempt to request the credentials from the endpoint the Provider -// was configured for. And error will be returned if the retrieval fails. -func (p *Provider) Retrieve() (credentials.Value, error) { - return p.RetrieveWithContext(aws.BackgroundContext()) -} - -// RetrieveWithContext will attempt to request the credentials from the endpoint the Provider -// was configured for. And error will be returned if the retrieval fails. -func (p *Provider) RetrieveWithContext(ctx credentials.Context) (credentials.Value, error) { - resp, err := p.getCredentials(ctx) - if err != nil { - return credentials.Value{ProviderName: ProviderName}, - awserr.New("CredentialsEndpointError", "failed to load credentials", err) - } - - if resp.Expiration != nil { - p.SetExpiration(*resp.Expiration, p.ExpiryWindow) - } else { - p.staticCreds = true - } - - return credentials.Value{ - AccessKeyID: resp.AccessKeyID, - SecretAccessKey: resp.SecretAccessKey, - SessionToken: resp.Token, - ProviderName: ProviderName, - }, nil -} - -type getCredentialsOutput struct { - Expiration *time.Time - AccessKeyID string - SecretAccessKey string - Token string -} - -type errorOutput struct { - Code string `json:"code"` - Message string `json:"message"` -} - -func (p *Provider) getCredentials(ctx aws.Context) (*getCredentialsOutput, error) { - op := &request.Operation{ - Name: "GetCredentials", - HTTPMethod: "GET", - } - - out := &getCredentialsOutput{} - req := p.Client.NewRequest(op, nil, out) - req.SetContext(ctx) - req.HTTPRequest.Header.Set("Accept", "application/json") - if authToken := p.AuthorizationToken; len(authToken) != 0 { - req.HTTPRequest.Header.Set("Authorization", authToken) - } - - return out, req.Send() -} - -func validateEndpointHandler(r *request.Request) { - if len(r.ClientInfo.Endpoint) == 0 { - r.Error = aws.ErrMissingEndpoint - } -} - -func unmarshalHandler(r *request.Request) { - defer r.HTTPResponse.Body.Close() - - out := r.Data.(*getCredentialsOutput) - if err := json.NewDecoder(r.HTTPResponse.Body).Decode(&out); err != nil { - r.Error = awserr.New(request.ErrCodeSerialization, - "failed to decode endpoint credentials", - err, - ) - } -} - -func unmarshalError(r *request.Request) { - defer r.HTTPResponse.Body.Close() - - var errOut errorOutput - err := jsonutil.UnmarshalJSONError(&errOut, r.HTTPResponse.Body) - if err != nil { - r.Error = awserr.NewRequestFailure( - awserr.New(request.ErrCodeSerialization, - "failed to decode error message", err), - r.HTTPResponse.StatusCode, - r.RequestID, - ) - return - } - - // Response body format is not consistent between metadata endpoints. - // Grab the error message as a string and include that as the source error - r.Error = awserr.New(errOut.Code, errOut.Message, nil) -} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/defaults/defaults.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/defaults/defaults.go deleted file mode 100644 index 23bb639e018..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/defaults/defaults.go +++ /dev/null @@ -1,207 +0,0 @@ -// Package defaults is a collection of helpers to retrieve the SDK's default -// configuration and handlers. -// -// Generally this package shouldn't be used directly, but session.Session -// instead. This package is useful when you need to reset the defaults -// of a session or service client to the SDK defaults before setting -// additional parameters. -package defaults - -import ( - "fmt" - "net" - "net/http" - "net/url" - "os" - "time" - - "github.com/aws/aws-sdk-go/aws" - "github.com/aws/aws-sdk-go/aws/awserr" - "github.com/aws/aws-sdk-go/aws/corehandlers" - "github.com/aws/aws-sdk-go/aws/credentials" - "github.com/aws/aws-sdk-go/aws/credentials/ec2rolecreds" - "github.com/aws/aws-sdk-go/aws/credentials/endpointcreds" - "github.com/aws/aws-sdk-go/aws/ec2metadata" - "github.com/aws/aws-sdk-go/aws/endpoints" - "github.com/aws/aws-sdk-go/aws/request" - "github.com/aws/aws-sdk-go/internal/shareddefaults" -) - -// A Defaults provides a collection of default values for SDK clients. -type Defaults struct { - Config *aws.Config - Handlers request.Handlers -} - -// Get returns the SDK's default values with Config and handlers pre-configured. -func Get() Defaults { - cfg := Config() - handlers := Handlers() - cfg.Credentials = CredChain(cfg, handlers) - - return Defaults{ - Config: cfg, - Handlers: handlers, - } -} - -// Config returns the default configuration without credentials. -// To retrieve a config with credentials also included use -// `defaults.Get().Config` instead. -// -// Generally you shouldn't need to use this method directly, but -// is available if you need to reset the configuration of an -// existing service client or session. -func Config() *aws.Config { - return aws.NewConfig(). - WithCredentials(credentials.AnonymousCredentials). - WithRegion(os.Getenv("AWS_REGION")). - WithHTTPClient(http.DefaultClient). - WithMaxRetries(aws.UseServiceDefaultRetries). - WithLogger(aws.NewDefaultLogger()). - WithLogLevel(aws.LogOff). - WithEndpointResolver(endpoints.DefaultResolver()) -} - -// Handlers returns the default request handlers. -// -// Generally you shouldn't need to use this method directly, but -// is available if you need to reset the request handlers of an -// existing service client or session. -func Handlers() request.Handlers { - var handlers request.Handlers - - handlers.Validate.PushBackNamed(corehandlers.ValidateEndpointHandler) - handlers.Validate.AfterEachFn = request.HandlerListStopOnError - handlers.Build.PushBackNamed(corehandlers.SDKVersionUserAgentHandler) - handlers.Build.PushBackNamed(corehandlers.AddHostExecEnvUserAgentHander) - handlers.Build.AfterEachFn = request.HandlerListStopOnError - handlers.Sign.PushBackNamed(corehandlers.BuildContentLengthHandler) - handlers.Send.PushBackNamed(corehandlers.ValidateReqSigHandler) - handlers.Send.PushBackNamed(corehandlers.SendHandler) - handlers.AfterRetry.PushBackNamed(corehandlers.AfterRetryHandler) - handlers.ValidateResponse.PushBackNamed(corehandlers.ValidateResponseHandler) - - return handlers -} - -// CredChain returns the default credential chain. -// -// Generally you shouldn't need to use this method directly, but -// is available if you need to reset the credentials of an -// existing service client or session's Config. -func CredChain(cfg *aws.Config, handlers request.Handlers) *credentials.Credentials { - return credentials.NewCredentials(&credentials.ChainProvider{ - VerboseErrors: aws.BoolValue(cfg.CredentialsChainVerboseErrors), - Providers: CredProviders(cfg, handlers), - }) -} - -// CredProviders returns the slice of providers used in -// the default credential chain. -// -// For applications that need to use some other provider (for example use -// different environment variables for legacy reasons) but still fall back -// on the default chain of providers. This allows that default chaint to be -// automatically updated -func CredProviders(cfg *aws.Config, handlers request.Handlers) []credentials.Provider { - return []credentials.Provider{ - &credentials.EnvProvider{}, - &credentials.SharedCredentialsProvider{Filename: "", Profile: ""}, - RemoteCredProvider(*cfg, handlers), - } -} - -const ( - httpProviderAuthorizationEnvVar = "AWS_CONTAINER_AUTHORIZATION_TOKEN" - httpProviderEnvVar = "AWS_CONTAINER_CREDENTIALS_FULL_URI" -) - -// RemoteCredProvider returns a credentials provider for the default remote -// endpoints such as EC2 or ECS Roles. -func RemoteCredProvider(cfg aws.Config, handlers request.Handlers) credentials.Provider { - if u := os.Getenv(httpProviderEnvVar); len(u) > 0 { - return localHTTPCredProvider(cfg, handlers, u) - } - - if uri := os.Getenv(shareddefaults.ECSCredsProviderEnvVar); len(uri) > 0 { - u := fmt.Sprintf("%s%s", shareddefaults.ECSContainerCredentialsURI, uri) - return httpCredProvider(cfg, handlers, u) - } - - return ec2RoleProvider(cfg, handlers) -} - -var lookupHostFn = net.LookupHost - -func isLoopbackHost(host string) (bool, error) { - ip := net.ParseIP(host) - if ip != nil { - return ip.IsLoopback(), nil - } - - // Host is not an ip, perform lookup - addrs, err := lookupHostFn(host) - if err != nil { - return false, err - } - for _, addr := range addrs { - if !net.ParseIP(addr).IsLoopback() { - return false, nil - } - } - - return true, nil -} - -func localHTTPCredProvider(cfg aws.Config, handlers request.Handlers, u string) credentials.Provider { - var errMsg string - - parsed, err := url.Parse(u) - if err != nil { - errMsg = fmt.Sprintf("invalid URL, %v", err) - } else { - host := aws.URLHostname(parsed) - if len(host) == 0 { - errMsg = "unable to parse host from local HTTP cred provider URL" - } else if isLoopback, loopbackErr := isLoopbackHost(host); loopbackErr != nil { - errMsg = fmt.Sprintf("failed to resolve host %q, %v", host, loopbackErr) - } else if !isLoopback { - errMsg = fmt.Sprintf("invalid endpoint host, %q, only loopback hosts are allowed.", host) - } - } - - if len(errMsg) > 0 { - if cfg.Logger != nil { - cfg.Logger.Log("Ignoring, HTTP credential provider", errMsg, err) - } - return credentials.ErrorProvider{ - Err: awserr.New("CredentialsEndpointError", errMsg, err), - ProviderName: endpointcreds.ProviderName, - } - } - - return httpCredProvider(cfg, handlers, u) -} - -func httpCredProvider(cfg aws.Config, handlers request.Handlers, u string) credentials.Provider { - return endpointcreds.NewProviderClient(cfg, handlers, u, - func(p *endpointcreds.Provider) { - p.ExpiryWindow = 5 * time.Minute - p.AuthorizationToken = os.Getenv(httpProviderAuthorizationEnvVar) - }, - ) -} - -func ec2RoleProvider(cfg aws.Config, handlers request.Handlers) credentials.Provider { - resolver := cfg.EndpointResolver - if resolver == nil { - resolver = endpoints.DefaultResolver() - } - - e, _ := resolver.EndpointFor(endpoints.Ec2metadataServiceID, "") - return &ec2rolecreds.EC2RoleProvider{ - Client: ec2metadata.NewClient(cfg, handlers, e.URL, e.SigningRegion), - ExpiryWindow: 5 * time.Minute, - } -} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/defaults/shared_config.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/defaults/shared_config.go deleted file mode 100644 index ca0ee1dcc78..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/defaults/shared_config.go +++ /dev/null @@ -1,27 +0,0 @@ -package defaults - -import ( - "github.com/aws/aws-sdk-go/internal/shareddefaults" -) - -// SharedCredentialsFilename returns the SDK's default file path -// for the shared credentials file. -// -// Builds the shared config file path based on the OS's platform. -// -// - Linux/Unix: $HOME/.aws/credentials -// - Windows: %USERPROFILE%\.aws\credentials -func SharedCredentialsFilename() string { - return shareddefaults.SharedCredentialsFilename() -} - -// SharedConfigFilename returns the SDK's default file path for -// the shared config file. -// -// Builds the shared config file path based on the OS's platform. -// -// - Linux/Unix: $HOME/.aws/config -// - Windows: %USERPROFILE%\.aws\config -func SharedConfigFilename() string { - return shareddefaults.SharedConfigFilename() -} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/api.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/api.go deleted file mode 100644 index 69fa63dc08f..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/api.go +++ /dev/null @@ -1,250 +0,0 @@ -package ec2metadata - -import ( - "encoding/json" - "fmt" - "net/http" - "strconv" - "strings" - "time" - - "github.com/aws/aws-sdk-go/aws" - "github.com/aws/aws-sdk-go/aws/awserr" - "github.com/aws/aws-sdk-go/aws/request" - "github.com/aws/aws-sdk-go/internal/sdkuri" -) - -// getToken uses the duration to return a token for EC2 metadata service, -// or an error if the request failed. -func (c *EC2Metadata) getToken(ctx aws.Context, duration time.Duration) (tokenOutput, error) { - op := &request.Operation{ - Name: "GetToken", - HTTPMethod: "PUT", - HTTPPath: "/latest/api/token", - } - - var output tokenOutput - req := c.NewRequest(op, nil, &output) - req.SetContext(ctx) - - // remove the fetch token handler from the request handlers to avoid infinite recursion - req.Handlers.Sign.RemoveByName(fetchTokenHandlerName) - - // Swap the unmarshalMetadataHandler with unmarshalTokenHandler on this request. - req.Handlers.Unmarshal.Swap(unmarshalMetadataHandlerName, unmarshalTokenHandler) - - ttl := strconv.FormatInt(int64(duration/time.Second), 10) - req.HTTPRequest.Header.Set(ttlHeader, ttl) - - err := req.Send() - - // Errors with bad request status should be returned. - if err != nil { - err = awserr.NewRequestFailure( - awserr.New(req.HTTPResponse.Status, http.StatusText(req.HTTPResponse.StatusCode), err), - req.HTTPResponse.StatusCode, req.RequestID) - } - - return output, err -} - -// GetMetadata uses the path provided to request information from the EC2 -// instance metadata service. The content will be returned as a string, or -// error if the request failed. -func (c *EC2Metadata) GetMetadata(p string) (string, error) { - return c.GetMetadataWithContext(aws.BackgroundContext(), p) -} - -// GetMetadataWithContext uses the path provided to request information from the EC2 -// instance metadata service. The content will be returned as a string, or -// error if the request failed. -func (c *EC2Metadata) GetMetadataWithContext(ctx aws.Context, p string) (string, error) { - op := &request.Operation{ - Name: "GetMetadata", - HTTPMethod: "GET", - HTTPPath: sdkuri.PathJoin("/latest/meta-data", p), - } - output := &metadataOutput{} - - req := c.NewRequest(op, nil, output) - - req.SetContext(ctx) - - err := req.Send() - return output.Content, err -} - -// GetUserData returns the userdata that was configured for the service. If -// there is no user-data setup for the EC2 instance a "NotFoundError" error -// code will be returned. -func (c *EC2Metadata) GetUserData() (string, error) { - return c.GetUserDataWithContext(aws.BackgroundContext()) -} - -// GetUserDataWithContext returns the userdata that was configured for the service. If -// there is no user-data setup for the EC2 instance a "NotFoundError" error -// code will be returned. -func (c *EC2Metadata) GetUserDataWithContext(ctx aws.Context) (string, error) { - op := &request.Operation{ - Name: "GetUserData", - HTTPMethod: "GET", - HTTPPath: "/latest/user-data", - } - - output := &metadataOutput{} - req := c.NewRequest(op, nil, output) - req.SetContext(ctx) - - err := req.Send() - return output.Content, err -} - -// GetDynamicData uses the path provided to request information from the EC2 -// instance metadata service for dynamic data. The content will be returned -// as a string, or error if the request failed. -func (c *EC2Metadata) GetDynamicData(p string) (string, error) { - return c.GetDynamicDataWithContext(aws.BackgroundContext(), p) -} - -// GetDynamicDataWithContext uses the path provided to request information from the EC2 -// instance metadata service for dynamic data. The content will be returned -// as a string, or error if the request failed. -func (c *EC2Metadata) GetDynamicDataWithContext(ctx aws.Context, p string) (string, error) { - op := &request.Operation{ - Name: "GetDynamicData", - HTTPMethod: "GET", - HTTPPath: sdkuri.PathJoin("/latest/dynamic", p), - } - - output := &metadataOutput{} - req := c.NewRequest(op, nil, output) - req.SetContext(ctx) - - err := req.Send() - return output.Content, err -} - -// GetInstanceIdentityDocument retrieves an identity document describing an -// instance. Error is returned if the request fails or is unable to parse -// the response. -func (c *EC2Metadata) GetInstanceIdentityDocument() (EC2InstanceIdentityDocument, error) { - return c.GetInstanceIdentityDocumentWithContext(aws.BackgroundContext()) -} - -// GetInstanceIdentityDocumentWithContext retrieves an identity document describing an -// instance. Error is returned if the request fails or is unable to parse -// the response. -func (c *EC2Metadata) GetInstanceIdentityDocumentWithContext(ctx aws.Context) (EC2InstanceIdentityDocument, error) { - resp, err := c.GetDynamicDataWithContext(ctx, "instance-identity/document") - if err != nil { - return EC2InstanceIdentityDocument{}, - awserr.New("EC2MetadataRequestError", - "failed to get EC2 instance identity document", err) - } - - doc := EC2InstanceIdentityDocument{} - if err := json.NewDecoder(strings.NewReader(resp)).Decode(&doc); err != nil { - return EC2InstanceIdentityDocument{}, - awserr.New(request.ErrCodeSerialization, - "failed to decode EC2 instance identity document", err) - } - - return doc, nil -} - -// IAMInfo retrieves IAM info from the metadata API -func (c *EC2Metadata) IAMInfo() (EC2IAMInfo, error) { - return c.IAMInfoWithContext(aws.BackgroundContext()) -} - -// IAMInfoWithContext retrieves IAM info from the metadata API -func (c *EC2Metadata) IAMInfoWithContext(ctx aws.Context) (EC2IAMInfo, error) { - resp, err := c.GetMetadataWithContext(ctx, "iam/info") - if err != nil { - return EC2IAMInfo{}, - awserr.New("EC2MetadataRequestError", - "failed to get EC2 IAM info", err) - } - - info := EC2IAMInfo{} - if err := json.NewDecoder(strings.NewReader(resp)).Decode(&info); err != nil { - return EC2IAMInfo{}, - awserr.New(request.ErrCodeSerialization, - "failed to decode EC2 IAM info", err) - } - - if info.Code != "Success" { - errMsg := fmt.Sprintf("failed to get EC2 IAM Info (%s)", info.Code) - return EC2IAMInfo{}, - awserr.New("EC2MetadataError", errMsg, nil) - } - - return info, nil -} - -// Region returns the region the instance is running in. -func (c *EC2Metadata) Region() (string, error) { - return c.RegionWithContext(aws.BackgroundContext()) -} - -// RegionWithContext returns the region the instance is running in. -func (c *EC2Metadata) RegionWithContext(ctx aws.Context) (string, error) { - ec2InstanceIdentityDocument, err := c.GetInstanceIdentityDocumentWithContext(ctx) - if err != nil { - return "", err - } - // extract region from the ec2InstanceIdentityDocument - region := ec2InstanceIdentityDocument.Region - if len(region) == 0 { - return "", awserr.New("EC2MetadataError", "invalid region received for ec2metadata instance", nil) - } - // returns region - return region, nil -} - -// Available returns if the application has access to the EC2 Metadata service. -// Can be used to determine if application is running within an EC2 Instance and -// the metadata service is available. -func (c *EC2Metadata) Available() bool { - return c.AvailableWithContext(aws.BackgroundContext()) -} - -// AvailableWithContext returns if the application has access to the EC2 Metadata service. -// Can be used to determine if application is running within an EC2 Instance and -// the metadata service is available. -func (c *EC2Metadata) AvailableWithContext(ctx aws.Context) bool { - if _, err := c.GetMetadataWithContext(ctx, "instance-id"); err != nil { - return false - } - - return true -} - -// An EC2IAMInfo provides the shape for unmarshaling -// an IAM info from the metadata API -type EC2IAMInfo struct { - Code string - LastUpdated time.Time - InstanceProfileArn string - InstanceProfileID string -} - -// An EC2InstanceIdentityDocument provides the shape for unmarshaling -// an instance identity document -type EC2InstanceIdentityDocument struct { - DevpayProductCodes []string `json:"devpayProductCodes"` - MarketplaceProductCodes []string `json:"marketplaceProductCodes"` - AvailabilityZone string `json:"availabilityZone"` - PrivateIP string `json:"privateIp"` - Version string `json:"version"` - Region string `json:"region"` - InstanceID string `json:"instanceId"` - BillingProducts []string `json:"billingProducts"` - InstanceType string `json:"instanceType"` - AccountID string `json:"accountId"` - PendingTime time.Time `json:"pendingTime"` - ImageID string `json:"imageId"` - KernelID string `json:"kernelId"` - RamdiskID string `json:"ramdiskId"` - Architecture string `json:"architecture"` -} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/service.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/service.go deleted file mode 100644 index df63bade104..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/service.go +++ /dev/null @@ -1,245 +0,0 @@ -// Package ec2metadata provides the client for making API calls to the -// EC2 Metadata service. -// -// This package's client can be disabled completely by setting the environment -// variable "AWS_EC2_METADATA_DISABLED=true". This environment variable set to -// true instructs the SDK to disable the EC2 Metadata client. The client cannot -// be used while the environment variable is set to true, (case insensitive). -// -// The endpoint of the EC2 IMDS client can be configured via the environment -// variable, AWS_EC2_METADATA_SERVICE_ENDPOINT when creating the client with a -// Session. See aws/session#Options.EC2IMDSEndpoint for more details. -package ec2metadata - -import ( - "bytes" - "io" - "net/http" - "net/url" - "os" - "strconv" - "strings" - "time" - - "github.com/aws/aws-sdk-go/aws" - "github.com/aws/aws-sdk-go/aws/awserr" - "github.com/aws/aws-sdk-go/aws/client" - "github.com/aws/aws-sdk-go/aws/client/metadata" - "github.com/aws/aws-sdk-go/aws/corehandlers" - "github.com/aws/aws-sdk-go/aws/request" -) - -const ( - // ServiceName is the name of the service. - ServiceName = "ec2metadata" - disableServiceEnvVar = "AWS_EC2_METADATA_DISABLED" - - // Headers for Token and TTL - ttlHeader = "x-aws-ec2-metadata-token-ttl-seconds" - tokenHeader = "x-aws-ec2-metadata-token" - - // Named Handler constants - fetchTokenHandlerName = "FetchTokenHandler" - unmarshalMetadataHandlerName = "unmarshalMetadataHandler" - unmarshalTokenHandlerName = "unmarshalTokenHandler" - enableTokenProviderHandlerName = "enableTokenProviderHandler" - - // TTL constants - defaultTTL = 21600 * time.Second - ttlExpirationWindow = 30 * time.Second -) - -// A EC2Metadata is an EC2 Metadata service Client. -type EC2Metadata struct { - *client.Client -} - -// New creates a new instance of the EC2Metadata client with a session. -// This client is safe to use across multiple goroutines. -// -// -// Example: -// // Create a EC2Metadata client from just a session. -// svc := ec2metadata.New(mySession) -// -// // Create a EC2Metadata client with additional configuration -// svc := ec2metadata.New(mySession, aws.NewConfig().WithLogLevel(aws.LogDebugHTTPBody)) -func New(p client.ConfigProvider, cfgs ...*aws.Config) *EC2Metadata { - c := p.ClientConfig(ServiceName, cfgs...) - return NewClient(*c.Config, c.Handlers, c.Endpoint, c.SigningRegion) -} - -// NewClient returns a new EC2Metadata client. Should be used to create -// a client when not using a session. Generally using just New with a session -// is preferred. -// -// Will remove the URL path from the endpoint provided to ensure the EC2 IMDS -// client is able to communicate with the EC2 IMDS API. -// -// If an unmodified HTTP client is provided from the stdlib default, or no client -// the EC2RoleProvider's EC2Metadata HTTP client's timeout will be shortened. -// To disable this set Config.EC2MetadataDisableTimeoutOverride to false. Enabled by default. -func NewClient(cfg aws.Config, handlers request.Handlers, endpoint, signingRegion string, opts ...func(*client.Client)) *EC2Metadata { - if !aws.BoolValue(cfg.EC2MetadataDisableTimeoutOverride) && httpClientZero(cfg.HTTPClient) { - // If the http client is unmodified and this feature is not disabled - // set custom timeouts for EC2Metadata requests. - cfg.HTTPClient = &http.Client{ - // use a shorter timeout than default because the metadata - // service is local if it is running, and to fail faster - // if not running on an ec2 instance. - Timeout: 1 * time.Second, - } - // max number of retries on the client operation - cfg.MaxRetries = aws.Int(2) - } - - if u, err := url.Parse(endpoint); err == nil { - // Remove path from the endpoint since it will be added by requests. - // This is an artifact of the SDK adding `/latest` to the endpoint for - // EC2 IMDS, but this is now moved to the operation definition. - u.Path = "" - u.RawPath = "" - endpoint = u.String() - } - - svc := &EC2Metadata{ - Client: client.New( - cfg, - metadata.ClientInfo{ - ServiceName: ServiceName, - ServiceID: ServiceName, - Endpoint: endpoint, - APIVersion: "latest", - }, - handlers, - ), - } - - // token provider instance - tp := newTokenProvider(svc, defaultTTL) - - // NamedHandler for fetching token - svc.Handlers.Sign.PushBackNamed(request.NamedHandler{ - Name: fetchTokenHandlerName, - Fn: tp.fetchTokenHandler, - }) - // NamedHandler for enabling token provider - svc.Handlers.Complete.PushBackNamed(request.NamedHandler{ - Name: enableTokenProviderHandlerName, - Fn: tp.enableTokenProviderHandler, - }) - - svc.Handlers.Unmarshal.PushBackNamed(unmarshalHandler) - svc.Handlers.UnmarshalError.PushBack(unmarshalError) - svc.Handlers.Validate.Clear() - svc.Handlers.Validate.PushBack(validateEndpointHandler) - - // Disable the EC2 Metadata service if the environment variable is set. - // This short-circuits the service's functionality to always fail to send - // requests. - if strings.ToLower(os.Getenv(disableServiceEnvVar)) == "true" { - svc.Handlers.Send.SwapNamed(request.NamedHandler{ - Name: corehandlers.SendHandler.Name, - Fn: func(r *request.Request) { - r.HTTPResponse = &http.Response{ - Header: http.Header{}, - } - r.Error = awserr.New( - request.CanceledErrorCode, - "EC2 IMDS access disabled via "+disableServiceEnvVar+" env var", - nil) - }, - }) - } - - // Add additional options to the service config - for _, option := range opts { - option(svc.Client) - } - return svc -} - -func httpClientZero(c *http.Client) bool { - return c == nil || (c.Transport == nil && c.CheckRedirect == nil && c.Jar == nil && c.Timeout == 0) -} - -type metadataOutput struct { - Content string -} - -type tokenOutput struct { - Token string - TTL time.Duration -} - -// unmarshal token handler is used to parse the response of a getToken operation -var unmarshalTokenHandler = request.NamedHandler{ - Name: unmarshalTokenHandlerName, - Fn: func(r *request.Request) { - defer r.HTTPResponse.Body.Close() - var b bytes.Buffer - if _, err := io.Copy(&b, r.HTTPResponse.Body); err != nil { - r.Error = awserr.NewRequestFailure(awserr.New(request.ErrCodeSerialization, - "unable to unmarshal EC2 metadata response", err), r.HTTPResponse.StatusCode, r.RequestID) - return - } - - v := r.HTTPResponse.Header.Get(ttlHeader) - data, ok := r.Data.(*tokenOutput) - if !ok { - return - } - - data.Token = b.String() - // TTL is in seconds - i, err := strconv.ParseInt(v, 10, 64) - if err != nil { - r.Error = awserr.NewRequestFailure(awserr.New(request.ParamFormatErrCode, - "unable to parse EC2 token TTL response", err), r.HTTPResponse.StatusCode, r.RequestID) - return - } - t := time.Duration(i) * time.Second - data.TTL = t - }, -} - -var unmarshalHandler = request.NamedHandler{ - Name: unmarshalMetadataHandlerName, - Fn: func(r *request.Request) { - defer r.HTTPResponse.Body.Close() - var b bytes.Buffer - if _, err := io.Copy(&b, r.HTTPResponse.Body); err != nil { - r.Error = awserr.NewRequestFailure(awserr.New(request.ErrCodeSerialization, - "unable to unmarshal EC2 metadata response", err), r.HTTPResponse.StatusCode, r.RequestID) - return - } - - if data, ok := r.Data.(*metadataOutput); ok { - data.Content = b.String() - } - }, -} - -func unmarshalError(r *request.Request) { - defer r.HTTPResponse.Body.Close() - var b bytes.Buffer - - if _, err := io.Copy(&b, r.HTTPResponse.Body); err != nil { - r.Error = awserr.NewRequestFailure( - awserr.New(request.ErrCodeSerialization, "unable to unmarshal EC2 metadata error response", err), - r.HTTPResponse.StatusCode, r.RequestID) - return - } - - // Response body format is not consistent between metadata endpoints. - // Grab the error message as a string and include that as the source error - r.Error = awserr.NewRequestFailure( - awserr.New("EC2MetadataError", "failed to make EC2Metadata request\n"+b.String(), nil), - r.HTTPResponse.StatusCode, r.RequestID) -} - -func validateEndpointHandler(r *request.Request) { - if r.ClientInfo.Endpoint == "" { - r.Error = aws.ErrMissingEndpoint - } -} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/token_provider.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/token_provider.go deleted file mode 100644 index 4b29f190bf9..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/aws/ec2metadata/token_provider.go +++ /dev/null @@ -1,93 +0,0 @@ -package ec2metadata - -import ( - "net/http" - "sync/atomic" - "time" - - "github.com/aws/aws-sdk-go/aws/awserr" - "github.com/aws/aws-sdk-go/aws/credentials" - "github.com/aws/aws-sdk-go/aws/request" -) - -// A tokenProvider struct provides access to EC2Metadata client -// and atomic instance of a token, along with configuredTTL for it. -// tokenProvider also provides an atomic flag to disable the -// fetch token operation. -// The disabled member will use 0 as false, and 1 as true. -type tokenProvider struct { - client *EC2Metadata - token atomic.Value - configuredTTL time.Duration - disabled uint32 -} - -// A ec2Token struct helps use of token in EC2 Metadata service ops -type ec2Token struct { - token string - credentials.Expiry -} - -// newTokenProvider provides a pointer to a tokenProvider instance -func newTokenProvider(c *EC2Metadata, duration time.Duration) *tokenProvider { - return &tokenProvider{client: c, configuredTTL: duration} -} - -// fetchTokenHandler fetches token for EC2Metadata service client by default. -func (t *tokenProvider) fetchTokenHandler(r *request.Request) { - - // short-circuits to insecure data flow if tokenProvider is disabled. - if v := atomic.LoadUint32(&t.disabled); v == 1 { - return - } - - if ec2Token, ok := t.token.Load().(ec2Token); ok && !ec2Token.IsExpired() { - r.HTTPRequest.Header.Set(tokenHeader, ec2Token.token) - return - } - - output, err := t.client.getToken(r.Context(), t.configuredTTL) - - if err != nil { - - // change the disabled flag on token provider to true, - // when error is request timeout error. - if requestFailureError, ok := err.(awserr.RequestFailure); ok { - switch requestFailureError.StatusCode() { - case http.StatusForbidden, http.StatusNotFound, http.StatusMethodNotAllowed: - atomic.StoreUint32(&t.disabled, 1) - case http.StatusBadRequest: - r.Error = requestFailureError - } - - // Check if request timed out while waiting for response - if e, ok := requestFailureError.OrigErr().(awserr.Error); ok { - if e.Code() == request.ErrCodeRequestError { - atomic.StoreUint32(&t.disabled, 1) - } - } - } - return - } - - newToken := ec2Token{ - token: output.Token, - } - newToken.SetExpiration(time.Now().Add(output.TTL), ttlExpirationWindow) - t.token.Store(newToken) - - // Inject token header to the request. - if ec2Token, ok := t.token.Load().(ec2Token); ok { - r.HTTPRequest.Header.Set(tokenHeader, ec2Token.token) - } -} - -// enableTokenProviderHandler enables the token provider -func (t *tokenProvider) enableTokenProviderHandler(r *request.Request) { - // If the error code status is 401, we enable the token provider - if e, ok := r.Error.(awserr.RequestFailure); ok && e != nil && - e.StatusCode() == http.StatusUnauthorized { - t.token.Store(ec2Token{}) - atomic.StoreUint32(&t.disabled, 0) - } -} diff --git a/ecs-agent/vendor/github.com/aws/aws-sdk-go/internal/sdkuri/path.go b/ecs-agent/vendor/github.com/aws/aws-sdk-go/internal/sdkuri/path.go deleted file mode 100644 index 38ea61afeaa..00000000000 --- a/ecs-agent/vendor/github.com/aws/aws-sdk-go/internal/sdkuri/path.go +++ /dev/null @@ -1,23 +0,0 @@ -package sdkuri - -import ( - "path" - "strings" -) - -// PathJoin will join the elements of the path delimited by the "/" -// character. Similar to path.Join with the exception the trailing "/" -// character is preserved if present. -func PathJoin(elems ...string) string { - if len(elems) == 0 { - return "" - } - - hasTrailing := strings.HasSuffix(elems[len(elems)-1], "/") - str := path.Join(elems...) - if hasTrailing && str != "/" { - str += "/" - } - - return str -} diff --git a/ecs-agent/vendor/modules.txt b/ecs-agent/vendor/modules.txt index e3a98da0c71..49f19242207 100644 --- a/ecs-agent/vendor/modules.txt +++ b/ecs-agent/vendor/modules.txt @@ -35,12 +35,7 @@ github.com/aws/aws-sdk-go/aws/awserr github.com/aws/aws-sdk-go/aws/awsutil github.com/aws/aws-sdk-go/aws/client github.com/aws/aws-sdk-go/aws/client/metadata -github.com/aws/aws-sdk-go/aws/corehandlers github.com/aws/aws-sdk-go/aws/credentials -github.com/aws/aws-sdk-go/aws/credentials/ec2rolecreds -github.com/aws/aws-sdk-go/aws/credentials/endpointcreds -github.com/aws/aws-sdk-go/aws/defaults -github.com/aws/aws-sdk-go/aws/ec2metadata github.com/aws/aws-sdk-go/aws/endpoints github.com/aws/aws-sdk-go/aws/request github.com/aws/aws-sdk-go/aws/signer/v4 @@ -49,7 +44,6 @@ github.com/aws/aws-sdk-go/internal/ini github.com/aws/aws-sdk-go/internal/sdkio github.com/aws/aws-sdk-go/internal/sdkmath github.com/aws/aws-sdk-go/internal/sdkrand -github.com/aws/aws-sdk-go/internal/sdkuri github.com/aws/aws-sdk-go/internal/shareddefaults github.com/aws/aws-sdk-go/internal/strings github.com/aws/aws-sdk-go/internal/sync/singleflight