Skip to content

ECSClient#

Index > ECS > ECSClient

Auto-generated documentation for ECS type annotations stubs module mypy-boto3-ecs.

ECSClient#

Type annotations and code completion for boto3.client("ecs"). boto3 documentation

# ECSClient usage example

from boto3.session import Session
from mypy_boto3_ecs.client import ECSClient

def get_ecs_client() -> ECSClient:
    return Session().client("ecs")

Exceptions#

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("ecs").exceptions structure.

# Exceptions.exceptions usage example

client = boto3.client("ecs")

try:
    do_something(client)
except (
    client.exceptions.AccessDeniedException,
    client.exceptions.AttributeLimitExceededException,
    client.exceptions.BlockedException,
    client.exceptions.ClientError,
    client.exceptions.ClientException,
    client.exceptions.ClusterContainsContainerInstancesException,
    client.exceptions.ClusterContainsServicesException,
    client.exceptions.ClusterContainsTasksException,
    client.exceptions.ClusterNotFoundException,
    client.exceptions.ConflictException,
    client.exceptions.InvalidParameterException,
    client.exceptions.LimitExceededException,
    client.exceptions.MissingVersionException,
    client.exceptions.NamespaceNotFoundException,
    client.exceptions.NoUpdateAvailableException,
    client.exceptions.PlatformTaskDefinitionIncompatibilityException,
    client.exceptions.PlatformUnknownException,
    client.exceptions.ResourceInUseException,
    client.exceptions.ResourceNotFoundException,
    client.exceptions.ServerException,
    client.exceptions.ServiceNotActiveException,
    client.exceptions.ServiceNotFoundException,
    client.exceptions.TargetNotConnectedException,
    client.exceptions.TargetNotFoundException,
    client.exceptions.TaskSetNotFoundException,
    client.exceptions.UnsupportedFeatureException,
    client.exceptions.UpdateInProgressException,
) as e:
    print(e)
# Exceptions.exceptions type checking example

from mypy_boto3_ecs.client import Exceptions

def handle_error(exc: Exceptions.AccessDeniedException) -> None:
    ...

Methods#

can_paginate#

Type annotations and code completion for boto3.client("ecs").can_paginate method. boto3 documentation

# can_paginate method definition

def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

generate_presigned_url#

Type annotations and code completion for boto3.client("ecs").generate_presigned_url method. boto3 documentation

# generate_presigned_url method definition

def generate_presigned_url(
    self,
    ClientMethod: str,
    Params: Mapping[str, Any] = ...,
    ExpiresIn: int = 3600,
    HttpMethod: str = ...,
) -> str:
    ...

create_capacity_provider#

Creates a new capacity provider.

Type annotations and code completion for boto3.client("ecs").create_capacity_provider method. boto3 documentation

# create_capacity_provider method definition

def create_capacity_provider(
    self,
    *,
    name: str,
    autoScalingGroupProvider: AutoScalingGroupProviderTypeDef,  # (1)
    tags: Sequence[TagTypeDef] = ...,  # (2)
) -> CreateCapacityProviderResponseTypeDef:  # (3)
    ...
  1. See AutoScalingGroupProviderTypeDef
  2. See Sequence[TagTypeDef]
  3. See CreateCapacityProviderResponseTypeDef
# create_capacity_provider method usage example with argument unpacking

kwargs: CreateCapacityProviderRequestTypeDef = {  # (1)
    "name": ...,
    "autoScalingGroupProvider": ...,
}

parent.create_capacity_provider(**kwargs)
  1. See CreateCapacityProviderRequestTypeDef

create_cluster#

Creates a new Amazon ECS cluster.

Type annotations and code completion for boto3.client("ecs").create_cluster method. boto3 documentation

# create_cluster method definition

def create_cluster(
    self,
    *,
    clusterName: str = ...,
    tags: Sequence[TagTypeDef] = ...,  # (1)
    settings: Sequence[ClusterSettingTypeDef] = ...,  # (2)
    configuration: ClusterConfigurationTypeDef = ...,  # (3)
    capacityProviders: Sequence[str] = ...,
    defaultCapacityProviderStrategy: Sequence[CapacityProviderStrategyItemTypeDef] = ...,  # (4)
    serviceConnectDefaults: ClusterServiceConnectDefaultsRequestTypeDef = ...,  # (5)
) -> CreateClusterResponseTypeDef:  # (6)
    ...
  1. See Sequence[TagTypeDef]
  2. See Sequence[ClusterSettingTypeDef]
  3. See ClusterConfigurationTypeDef
  4. See Sequence[CapacityProviderStrategyItemTypeDef]
  5. See ClusterServiceConnectDefaultsRequestTypeDef
  6. See CreateClusterResponseTypeDef
# create_cluster method usage example with argument unpacking

kwargs: CreateClusterRequestTypeDef = {  # (1)
    "clusterName": ...,
}

parent.create_cluster(**kwargs)
  1. See CreateClusterRequestTypeDef

create_service#

Runs and maintains your desired number of tasks from a specified task definition.

Type annotations and code completion for boto3.client("ecs").create_service method. boto3 documentation

# create_service method definition

def create_service(
    self,
    *,
    serviceName: str,
    cluster: str = ...,
    taskDefinition: str = ...,
    availabilityZoneRebalancing: AvailabilityZoneRebalancingType = ...,  # (1)
    loadBalancers: Sequence[LoadBalancerTypeDef] = ...,  # (2)
    serviceRegistries: Sequence[ServiceRegistryTypeDef] = ...,  # (3)
    desiredCount: int = ...,
    clientToken: str = ...,
    launchType: LaunchTypeType = ...,  # (4)
    capacityProviderStrategy: Sequence[CapacityProviderStrategyItemTypeDef] = ...,  # (5)
    platformVersion: str = ...,
    role: str = ...,
    deploymentConfiguration: DeploymentConfigurationUnionTypeDef = ...,  # (6)
    placementConstraints: Sequence[PlacementConstraintTypeDef] = ...,  # (7)
    placementStrategy: Sequence[PlacementStrategyTypeDef] = ...,  # (8)
    networkConfiguration: NetworkConfigurationUnionTypeDef = ...,  # (9)
    healthCheckGracePeriodSeconds: int = ...,
    schedulingStrategy: SchedulingStrategyType = ...,  # (10)
    deploymentController: DeploymentControllerTypeDef = ...,  # (11)
    tags: Sequence[TagTypeDef] = ...,  # (12)
    enableECSManagedTags: bool = ...,
    propagateTags: PropagateTagsType = ...,  # (13)
    enableExecuteCommand: bool = ...,
    serviceConnectConfiguration: ServiceConnectConfigurationUnionTypeDef = ...,  # (14)
    volumeConfigurations: Sequence[ServiceVolumeConfigurationUnionTypeDef] = ...,  # (15)
    vpcLatticeConfigurations: Sequence[VpcLatticeConfigurationTypeDef] = ...,  # (16)
) -> CreateServiceResponseTypeDef:  # (17)
    ...
  1. See AvailabilityZoneRebalancingType
  2. See Sequence[LoadBalancerTypeDef]
  3. See Sequence[ServiceRegistryTypeDef]
  4. See LaunchTypeType
  5. See Sequence[CapacityProviderStrategyItemTypeDef]
  6. See DeploymentConfigurationUnionTypeDef
  7. See Sequence[PlacementConstraintTypeDef]
  8. See Sequence[PlacementStrategyTypeDef]
  9. See NetworkConfigurationUnionTypeDef
  10. See SchedulingStrategyType
  11. See DeploymentControllerTypeDef
  12. See Sequence[TagTypeDef]
  13. See PropagateTagsType
  14. See ServiceConnectConfigurationUnionTypeDef
  15. See Sequence[ServiceVolumeConfigurationUnionTypeDef]
  16. See Sequence[VpcLatticeConfigurationTypeDef]
  17. See CreateServiceResponseTypeDef
# create_service method usage example with argument unpacking

kwargs: CreateServiceRequestTypeDef = {  # (1)
    "serviceName": ...,
}

parent.create_service(**kwargs)
  1. See CreateServiceRequestTypeDef

create_task_set#

Create a task set in the specified cluster and service.

Type annotations and code completion for boto3.client("ecs").create_task_set method. boto3 documentation

# create_task_set method definition

def create_task_set(
    self,
    *,
    service: str,
    cluster: str,
    taskDefinition: str,
    externalId: str = ...,
    networkConfiguration: NetworkConfigurationUnionTypeDef = ...,  # (1)
    loadBalancers: Sequence[LoadBalancerTypeDef] = ...,  # (2)
    serviceRegistries: Sequence[ServiceRegistryTypeDef] = ...,  # (3)
    launchType: LaunchTypeType = ...,  # (4)
    capacityProviderStrategy: Sequence[CapacityProviderStrategyItemTypeDef] = ...,  # (5)
    platformVersion: str = ...,
    scale: ScaleTypeDef = ...,  # (6)
    clientToken: str = ...,
    tags: Sequence[TagTypeDef] = ...,  # (7)
) -> CreateTaskSetResponseTypeDef:  # (8)
    ...
  1. See NetworkConfigurationUnionTypeDef
  2. See Sequence[LoadBalancerTypeDef]
  3. See Sequence[ServiceRegistryTypeDef]
  4. See LaunchTypeType
  5. See Sequence[CapacityProviderStrategyItemTypeDef]
  6. See ScaleTypeDef
  7. See Sequence[TagTypeDef]
  8. See CreateTaskSetResponseTypeDef
# create_task_set method usage example with argument unpacking

kwargs: CreateTaskSetRequestTypeDef = {  # (1)
    "service": ...,
    "cluster": ...,
    "taskDefinition": ...,
}

parent.create_task_set(**kwargs)
  1. See CreateTaskSetRequestTypeDef

delete_account_setting#

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

Type annotations and code completion for boto3.client("ecs").delete_account_setting method. boto3 documentation

# delete_account_setting method definition

def delete_account_setting(
    self,
    *,
    name: SettingNameType,  # (1)
    principalArn: str = ...,
) -> DeleteAccountSettingResponseTypeDef:  # (2)
    ...
  1. See SettingNameType
  2. See DeleteAccountSettingResponseTypeDef
# delete_account_setting method usage example with argument unpacking

kwargs: DeleteAccountSettingRequestTypeDef = {  # (1)
    "name": ...,
}

parent.delete_account_setting(**kwargs)
  1. See DeleteAccountSettingRequestTypeDef

delete_attributes#

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

Type annotations and code completion for boto3.client("ecs").delete_attributes method. boto3 documentation

# delete_attributes method definition

def delete_attributes(
    self,
    *,
    attributes: Sequence[AttributeTypeDef],  # (1)
    cluster: str = ...,
) -> DeleteAttributesResponseTypeDef:  # (2)
    ...
  1. See Sequence[AttributeTypeDef]
  2. See DeleteAttributesResponseTypeDef
# delete_attributes method usage example with argument unpacking

kwargs: DeleteAttributesRequestTypeDef = {  # (1)
    "attributes": ...,
}

parent.delete_attributes(**kwargs)
  1. See DeleteAttributesRequestTypeDef

delete_capacity_provider#

Deletes the specified capacity provider.

Type annotations and code completion for boto3.client("ecs").delete_capacity_provider method. boto3 documentation

# delete_capacity_provider method definition

def delete_capacity_provider(
    self,
    *,
    capacityProvider: str,
) -> DeleteCapacityProviderResponseTypeDef:  # (1)
    ...
  1. See DeleteCapacityProviderResponseTypeDef
# delete_capacity_provider method usage example with argument unpacking

kwargs: DeleteCapacityProviderRequestTypeDef = {  # (1)
    "capacityProvider": ...,
}

parent.delete_capacity_provider(**kwargs)
  1. See DeleteCapacityProviderRequestTypeDef

delete_cluster#

Deletes the specified cluster.

Type annotations and code completion for boto3.client("ecs").delete_cluster method. boto3 documentation

# delete_cluster method definition

def delete_cluster(
    self,
    *,
    cluster: str,
) -> DeleteClusterResponseTypeDef:  # (1)
    ...
  1. See DeleteClusterResponseTypeDef
# delete_cluster method usage example with argument unpacking

kwargs: DeleteClusterRequestTypeDef = {  # (1)
    "cluster": ...,
}

parent.delete_cluster(**kwargs)
  1. See DeleteClusterRequestTypeDef

delete_service#

Deletes a specified service within a cluster.

Type annotations and code completion for boto3.client("ecs").delete_service method. boto3 documentation

# delete_service method definition

def delete_service(
    self,
    *,
    service: str,
    cluster: str = ...,
    force: bool = ...,
) -> DeleteServiceResponseTypeDef:  # (1)
    ...
  1. See DeleteServiceResponseTypeDef
# delete_service method usage example with argument unpacking

kwargs: DeleteServiceRequestTypeDef = {  # (1)
    "service": ...,
}

parent.delete_service(**kwargs)
  1. See DeleteServiceRequestTypeDef

delete_task_definitions#

Deletes one or more task definitions.

Type annotations and code completion for boto3.client("ecs").delete_task_definitions method. boto3 documentation

# delete_task_definitions method definition

def delete_task_definitions(
    self,
    *,
    taskDefinitions: Sequence[str],
) -> DeleteTaskDefinitionsResponseTypeDef:  # (1)
    ...
  1. See DeleteTaskDefinitionsResponseTypeDef
# delete_task_definitions method usage example with argument unpacking

kwargs: DeleteTaskDefinitionsRequestTypeDef = {  # (1)
    "taskDefinitions": ...,
}

parent.delete_task_definitions(**kwargs)
  1. See DeleteTaskDefinitionsRequestTypeDef

delete_task_set#

Deletes a specified task set within a service.

Type annotations and code completion for boto3.client("ecs").delete_task_set method. boto3 documentation

# delete_task_set method definition

def delete_task_set(
    self,
    *,
    cluster: str,
    service: str,
    taskSet: str,
    force: bool = ...,
) -> DeleteTaskSetResponseTypeDef:  # (1)
    ...
  1. See DeleteTaskSetResponseTypeDef
# delete_task_set method usage example with argument unpacking

kwargs: DeleteTaskSetRequestTypeDef = {  # (1)
    "cluster": ...,
    "service": ...,
    "taskSet": ...,
}

parent.delete_task_set(**kwargs)
  1. See DeleteTaskSetRequestTypeDef

deregister_container_instance#

Deregisters an Amazon ECS container instance from the specified cluster.

Type annotations and code completion for boto3.client("ecs").deregister_container_instance method. boto3 documentation

# deregister_container_instance method definition

def deregister_container_instance(
    self,
    *,
    containerInstance: str,
    cluster: str = ...,
    force: bool = ...,
) -> DeregisterContainerInstanceResponseTypeDef:  # (1)
    ...
  1. See DeregisterContainerInstanceResponseTypeDef
# deregister_container_instance method usage example with argument unpacking

kwargs: DeregisterContainerInstanceRequestTypeDef = {  # (1)
    "containerInstance": ...,
}

parent.deregister_container_instance(**kwargs)
  1. See DeregisterContainerInstanceRequestTypeDef

deregister_task_definition#

Deregisters the specified task definition by family and revision.

Type annotations and code completion for boto3.client("ecs").deregister_task_definition method. boto3 documentation

# deregister_task_definition method definition

def deregister_task_definition(
    self,
    *,
    taskDefinition: str,
) -> DeregisterTaskDefinitionResponseTypeDef:  # (1)
    ...
  1. See DeregisterTaskDefinitionResponseTypeDef
# deregister_task_definition method usage example with argument unpacking

kwargs: DeregisterTaskDefinitionRequestTypeDef = {  # (1)
    "taskDefinition": ...,
}

parent.deregister_task_definition(**kwargs)
  1. See DeregisterTaskDefinitionRequestTypeDef

describe_capacity_providers#

Describes one or more of your capacity providers.

Type annotations and code completion for boto3.client("ecs").describe_capacity_providers method. boto3 documentation

# describe_capacity_providers method definition

def describe_capacity_providers(
    self,
    *,
    capacityProviders: Sequence[str] = ...,
    include: Sequence[CapacityProviderFieldType] = ...,  # (1)
    maxResults: int = ...,
    nextToken: str = ...,
) -> DescribeCapacityProvidersResponseTypeDef:  # (2)
    ...
  1. See Sequence[Literal['TAGS']]
  2. See DescribeCapacityProvidersResponseTypeDef
# describe_capacity_providers method usage example with argument unpacking

kwargs: DescribeCapacityProvidersRequestTypeDef = {  # (1)
    "capacityProviders": ...,
}

parent.describe_capacity_providers(**kwargs)
  1. See DescribeCapacityProvidersRequestTypeDef

describe_clusters#

Describes one or more of your clusters.

Type annotations and code completion for boto3.client("ecs").describe_clusters method. boto3 documentation

# describe_clusters method definition

def describe_clusters(
    self,
    *,
    clusters: Sequence[str] = ...,
    include: Sequence[ClusterFieldType] = ...,  # (1)
) -> DescribeClustersResponseTypeDef:  # (2)
    ...
  1. See Sequence[ClusterFieldType]
  2. See DescribeClustersResponseTypeDef
# describe_clusters method usage example with argument unpacking

kwargs: DescribeClustersRequestTypeDef = {  # (1)
    "clusters": ...,
}

parent.describe_clusters(**kwargs)
  1. See DescribeClustersRequestTypeDef

describe_container_instances#

Describes one or more container instances.

Type annotations and code completion for boto3.client("ecs").describe_container_instances method. boto3 documentation

# describe_container_instances method definition

def describe_container_instances(
    self,
    *,
    containerInstances: Sequence[str],
    cluster: str = ...,
    include: Sequence[ContainerInstanceFieldType] = ...,  # (1)
) -> DescribeContainerInstancesResponseTypeDef:  # (2)
    ...
  1. See Sequence[ContainerInstanceFieldType]
  2. See DescribeContainerInstancesResponseTypeDef
# describe_container_instances method usage example with argument unpacking

kwargs: DescribeContainerInstancesRequestTypeDef = {  # (1)
    "containerInstances": ...,
}

parent.describe_container_instances(**kwargs)
  1. See DescribeContainerInstancesRequestTypeDef

describe_service_deployments#

Describes one or more of your service deployments.

Type annotations and code completion for boto3.client("ecs").describe_service_deployments method. boto3 documentation

# describe_service_deployments method definition

def describe_service_deployments(
    self,
    *,
    serviceDeploymentArns: Sequence[str],
) -> DescribeServiceDeploymentsResponseTypeDef:  # (1)
    ...
  1. See DescribeServiceDeploymentsResponseTypeDef
# describe_service_deployments method usage example with argument unpacking

kwargs: DescribeServiceDeploymentsRequestTypeDef = {  # (1)
    "serviceDeploymentArns": ...,
}

parent.describe_service_deployments(**kwargs)
  1. See DescribeServiceDeploymentsRequestTypeDef

describe_service_revisions#

Describes one or more service revisions.

Type annotations and code completion for boto3.client("ecs").describe_service_revisions method. boto3 documentation

# describe_service_revisions method definition

def describe_service_revisions(
    self,
    *,
    serviceRevisionArns: Sequence[str],
) -> DescribeServiceRevisionsResponseTypeDef:  # (1)
    ...
  1. See DescribeServiceRevisionsResponseTypeDef
# describe_service_revisions method usage example with argument unpacking

kwargs: DescribeServiceRevisionsRequestTypeDef = {  # (1)
    "serviceRevisionArns": ...,
}

parent.describe_service_revisions(**kwargs)
  1. See DescribeServiceRevisionsRequestTypeDef

describe_services#

Describes the specified services running in your cluster.

Type annotations and code completion for boto3.client("ecs").describe_services method. boto3 documentation

# describe_services method definition

def describe_services(
    self,
    *,
    services: Sequence[str],
    cluster: str = ...,
    include: Sequence[ServiceFieldType] = ...,  # (1)
) -> DescribeServicesResponseTypeDef:  # (2)
    ...
  1. See Sequence[Literal['TAGS']]
  2. See DescribeServicesResponseTypeDef
# describe_services method usage example with argument unpacking

kwargs: DescribeServicesRequestTypeDef = {  # (1)
    "services": ...,
}

parent.describe_services(**kwargs)
  1. See DescribeServicesRequestTypeDef

describe_task_definition#

Describes a task definition.

Type annotations and code completion for boto3.client("ecs").describe_task_definition method. boto3 documentation

# describe_task_definition method definition

def describe_task_definition(
    self,
    *,
    taskDefinition: str,
    include: Sequence[TaskDefinitionFieldType] = ...,  # (1)
) -> DescribeTaskDefinitionResponseTypeDef:  # (2)
    ...
  1. See Sequence[Literal['TAGS']]
  2. See DescribeTaskDefinitionResponseTypeDef
# describe_task_definition method usage example with argument unpacking

kwargs: DescribeTaskDefinitionRequestTypeDef = {  # (1)
    "taskDefinition": ...,
}

parent.describe_task_definition(**kwargs)
  1. See DescribeTaskDefinitionRequestTypeDef

describe_task_sets#

Describes the task sets in the specified cluster and service.

Type annotations and code completion for boto3.client("ecs").describe_task_sets method. boto3 documentation

# describe_task_sets method definition

def describe_task_sets(
    self,
    *,
    cluster: str,
    service: str,
    taskSets: Sequence[str] = ...,
    include: Sequence[TaskSetFieldType] = ...,  # (1)
) -> DescribeTaskSetsResponseTypeDef:  # (2)
    ...
  1. See Sequence[Literal['TAGS']]
  2. See DescribeTaskSetsResponseTypeDef
# describe_task_sets method usage example with argument unpacking

kwargs: DescribeTaskSetsRequestTypeDef = {  # (1)
    "cluster": ...,
    "service": ...,
}

parent.describe_task_sets(**kwargs)
  1. See DescribeTaskSetsRequestTypeDef

describe_tasks#

Describes a specified task or tasks.

Type annotations and code completion for boto3.client("ecs").describe_tasks method. boto3 documentation

# describe_tasks method definition

def describe_tasks(
    self,
    *,
    tasks: Sequence[str],
    cluster: str = ...,
    include: Sequence[TaskFieldType] = ...,  # (1)
) -> DescribeTasksResponseTypeDef:  # (2)
    ...
  1. See Sequence[Literal['TAGS']]
  2. See DescribeTasksResponseTypeDef
# describe_tasks method usage example with argument unpacking

kwargs: DescribeTasksRequestTypeDef = {  # (1)
    "tasks": ...,
}

parent.describe_tasks(**kwargs)
  1. See DescribeTasksRequestTypeDef

discover_poll_endpoint#

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

Type annotations and code completion for boto3.client("ecs").discover_poll_endpoint method. boto3 documentation

# discover_poll_endpoint method definition

def discover_poll_endpoint(
    self,
    *,
    containerInstance: str = ...,
    cluster: str = ...,
) -> DiscoverPollEndpointResponseTypeDef:  # (1)
    ...
  1. See DiscoverPollEndpointResponseTypeDef
# discover_poll_endpoint method usage example with argument unpacking

kwargs: DiscoverPollEndpointRequestTypeDef = {  # (1)
    "containerInstance": ...,
}

parent.discover_poll_endpoint(**kwargs)
  1. See DiscoverPollEndpointRequestTypeDef

execute_command#

Runs a command remotely on a container within a task.

Type annotations and code completion for boto3.client("ecs").execute_command method. boto3 documentation

# execute_command method definition

def execute_command(
    self,
    *,
    command: str,
    interactive: bool,
    task: str,
    cluster: str = ...,
    container: str = ...,
) -> ExecuteCommandResponseTypeDef:  # (1)
    ...
  1. See ExecuteCommandResponseTypeDef
# execute_command method usage example with argument unpacking

kwargs: ExecuteCommandRequestTypeDef = {  # (1)
    "command": ...,
    "interactive": ...,
    "task": ...,
}

parent.execute_command(**kwargs)
  1. See ExecuteCommandRequestTypeDef

get_task_protection#

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

Type annotations and code completion for boto3.client("ecs").get_task_protection method. boto3 documentation

# get_task_protection method definition

def get_task_protection(
    self,
    *,
    cluster: str,
    tasks: Sequence[str] = ...,
) -> GetTaskProtectionResponseTypeDef:  # (1)
    ...
  1. See GetTaskProtectionResponseTypeDef
# get_task_protection method usage example with argument unpacking

kwargs: GetTaskProtectionRequestTypeDef = {  # (1)
    "cluster": ...,
}

parent.get_task_protection(**kwargs)
  1. See GetTaskProtectionRequestTypeDef

list_account_settings#

Lists the account settings for a specified principal.

Type annotations and code completion for boto3.client("ecs").list_account_settings method. boto3 documentation

# list_account_settings method definition

def list_account_settings(
    self,
    *,
    name: SettingNameType = ...,  # (1)
    value: str = ...,
    principalArn: str = ...,
    effectiveSettings: bool = ...,
    nextToken: str = ...,
    maxResults: int = ...,
) -> ListAccountSettingsResponseTypeDef:  # (2)
    ...
  1. See SettingNameType
  2. See ListAccountSettingsResponseTypeDef
# list_account_settings method usage example with argument unpacking

kwargs: ListAccountSettingsRequestTypeDef = {  # (1)
    "name": ...,
}

parent.list_account_settings(**kwargs)
  1. See ListAccountSettingsRequestTypeDef

list_attributes#

Lists the attributes for Amazon ECS resources within a specified target type and cluster.

Type annotations and code completion for boto3.client("ecs").list_attributes method. boto3 documentation

# list_attributes method definition

def list_attributes(
    self,
    *,
    targetType: TargetTypeType,  # (1)
    cluster: str = ...,
    attributeName: str = ...,
    attributeValue: str = ...,
    nextToken: str = ...,
    maxResults: int = ...,
) -> ListAttributesResponseTypeDef:  # (2)
    ...
  1. See TargetTypeType
  2. See ListAttributesResponseTypeDef
# list_attributes method usage example with argument unpacking

kwargs: ListAttributesRequestTypeDef = {  # (1)
    "targetType": ...,
}

parent.list_attributes(**kwargs)
  1. See ListAttributesRequestTypeDef

list_clusters#

Returns a list of existing clusters.

Type annotations and code completion for boto3.client("ecs").list_clusters method. boto3 documentation

# list_clusters method definition

def list_clusters(
    self,
    *,
    nextToken: str = ...,
    maxResults: int = ...,
) -> ListClustersResponseTypeDef:  # (1)
    ...
  1. See ListClustersResponseTypeDef
# list_clusters method usage example with argument unpacking

kwargs: ListClustersRequestTypeDef = {  # (1)
    "nextToken": ...,
}

parent.list_clusters(**kwargs)
  1. See ListClustersRequestTypeDef

list_container_instances#

Returns a list of container instances in a specified cluster.

Type annotations and code completion for boto3.client("ecs").list_container_instances method. boto3 documentation

# list_container_instances method definition

def list_container_instances(
    self,
    *,
    cluster: str = ...,
    filter: str = ...,
    nextToken: str = ...,
    maxResults: int = ...,
    status: ContainerInstanceStatusType = ...,  # (1)
) -> ListContainerInstancesResponseTypeDef:  # (2)
    ...
  1. See ContainerInstanceStatusType
  2. See ListContainerInstancesResponseTypeDef
# list_container_instances method usage example with argument unpacking

kwargs: ListContainerInstancesRequestTypeDef = {  # (1)
    "cluster": ...,
}

parent.list_container_instances(**kwargs)
  1. See ListContainerInstancesRequestTypeDef

list_service_deployments#

This operation lists all the service deployments that meet the specified filter criteria.

Type annotations and code completion for boto3.client("ecs").list_service_deployments method. boto3 documentation

# list_service_deployments method definition

def list_service_deployments(
    self,
    *,
    service: str,
    cluster: str = ...,
    status: Sequence[ServiceDeploymentStatusType] = ...,  # (1)
    createdAt: CreatedAtTypeDef = ...,  # (2)
    nextToken: str = ...,
    maxResults: int = ...,
) -> ListServiceDeploymentsResponseTypeDef:  # (3)
    ...
  1. See Sequence[ServiceDeploymentStatusType]
  2. See CreatedAtTypeDef
  3. See ListServiceDeploymentsResponseTypeDef
# list_service_deployments method usage example with argument unpacking

kwargs: ListServiceDeploymentsRequestTypeDef = {  # (1)
    "service": ...,
}

parent.list_service_deployments(**kwargs)
  1. See ListServiceDeploymentsRequestTypeDef

list_services#

Returns a list of services.

Type annotations and code completion for boto3.client("ecs").list_services method. boto3 documentation

# list_services method definition

def list_services(
    self,
    *,
    cluster: str = ...,
    nextToken: str = ...,
    maxResults: int = ...,
    launchType: LaunchTypeType = ...,  # (1)
    schedulingStrategy: SchedulingStrategyType = ...,  # (2)
) -> ListServicesResponseTypeDef:  # (3)
    ...
  1. See LaunchTypeType
  2. See SchedulingStrategyType
  3. See ListServicesResponseTypeDef
# list_services method usage example with argument unpacking

kwargs: ListServicesRequestTypeDef = {  # (1)
    "cluster": ...,
}

parent.list_services(**kwargs)
  1. See ListServicesRequestTypeDef

list_services_by_namespace#

This operation lists all of the services that are associated with a Cloud Map namespace.

Type annotations and code completion for boto3.client("ecs").list_services_by_namespace method. boto3 documentation

# list_services_by_namespace method definition

def list_services_by_namespace(
    self,
    *,
    namespace: str,
    nextToken: str = ...,
    maxResults: int = ...,
) -> ListServicesByNamespaceResponseTypeDef:  # (1)
    ...
  1. See ListServicesByNamespaceResponseTypeDef
# list_services_by_namespace method usage example with argument unpacking

kwargs: ListServicesByNamespaceRequestTypeDef = {  # (1)
    "namespace": ...,
}

parent.list_services_by_namespace(**kwargs)
  1. See ListServicesByNamespaceRequestTypeDef

list_tags_for_resource#

List the tags for an Amazon ECS resource.

Type annotations and code completion for boto3.client("ecs").list_tags_for_resource method. boto3 documentation

# list_tags_for_resource method definition

def list_tags_for_resource(
    self,
    *,
    resourceArn: str,
) -> ListTagsForResourceResponseTypeDef:  # (1)
    ...
  1. See ListTagsForResourceResponseTypeDef
# list_tags_for_resource method usage example with argument unpacking

kwargs: ListTagsForResourceRequestTypeDef = {  # (1)
    "resourceArn": ...,
}

parent.list_tags_for_resource(**kwargs)
  1. See ListTagsForResourceRequestTypeDef

list_task_definition_families#

Returns a list of task definition families that are registered to your account.

Type annotations and code completion for boto3.client("ecs").list_task_definition_families method. boto3 documentation

# list_task_definition_families method definition

def list_task_definition_families(
    self,
    *,
    familyPrefix: str = ...,
    status: TaskDefinitionFamilyStatusType = ...,  # (1)
    nextToken: str = ...,
    maxResults: int = ...,
) -> ListTaskDefinitionFamiliesResponseTypeDef:  # (2)
    ...
  1. See TaskDefinitionFamilyStatusType
  2. See ListTaskDefinitionFamiliesResponseTypeDef
# list_task_definition_families method usage example with argument unpacking

kwargs: ListTaskDefinitionFamiliesRequestTypeDef = {  # (1)
    "familyPrefix": ...,
}

parent.list_task_definition_families(**kwargs)
  1. See ListTaskDefinitionFamiliesRequestTypeDef

list_task_definitions#

Returns a list of task definitions that are registered to your account.

Type annotations and code completion for boto3.client("ecs").list_task_definitions method. boto3 documentation

# list_task_definitions method definition

def list_task_definitions(
    self,
    *,
    familyPrefix: str = ...,
    status: TaskDefinitionStatusType = ...,  # (1)
    sort: SortOrderType = ...,  # (2)
    nextToken: str = ...,
    maxResults: int = ...,
) -> ListTaskDefinitionsResponseTypeDef:  # (3)
    ...
  1. See TaskDefinitionStatusType
  2. See SortOrderType
  3. See ListTaskDefinitionsResponseTypeDef
# list_task_definitions method usage example with argument unpacking

kwargs: ListTaskDefinitionsRequestTypeDef = {  # (1)
    "familyPrefix": ...,
}

parent.list_task_definitions(**kwargs)
  1. See ListTaskDefinitionsRequestTypeDef

list_tasks#

Returns a list of tasks.

Type annotations and code completion for boto3.client("ecs").list_tasks method. boto3 documentation

# list_tasks method definition

def list_tasks(
    self,
    *,
    cluster: str = ...,
    containerInstance: str = ...,
    family: str = ...,
    nextToken: str = ...,
    maxResults: int = ...,
    startedBy: str = ...,
    serviceName: str = ...,
    desiredStatus: DesiredStatusType = ...,  # (1)
    launchType: LaunchTypeType = ...,  # (2)
) -> ListTasksResponseTypeDef:  # (3)
    ...
  1. See DesiredStatusType
  2. See LaunchTypeType
  3. See ListTasksResponseTypeDef
# list_tasks method usage example with argument unpacking

kwargs: ListTasksRequestTypeDef = {  # (1)
    "cluster": ...,
}

parent.list_tasks(**kwargs)
  1. See ListTasksRequestTypeDef

put_account_setting#

Modifies an account setting.

Type annotations and code completion for boto3.client("ecs").put_account_setting method. boto3 documentation

# put_account_setting method definition

def put_account_setting(
    self,
    *,
    name: SettingNameType,  # (1)
    value: str,
    principalArn: str = ...,
) -> PutAccountSettingResponseTypeDef:  # (2)
    ...
  1. See SettingNameType
  2. See PutAccountSettingResponseTypeDef
# put_account_setting method usage example with argument unpacking

kwargs: PutAccountSettingRequestTypeDef = {  # (1)
    "name": ...,
    "value": ...,
}

parent.put_account_setting(**kwargs)
  1. See PutAccountSettingRequestTypeDef

put_account_setting_default#

Modifies an account setting for all users on an account for whom no individual account setting has been specified.

Type annotations and code completion for boto3.client("ecs").put_account_setting_default method. boto3 documentation

# put_account_setting_default method definition

def put_account_setting_default(
    self,
    *,
    name: SettingNameType,  # (1)
    value: str,
) -> PutAccountSettingDefaultResponseTypeDef:  # (2)
    ...
  1. See SettingNameType
  2. See PutAccountSettingDefaultResponseTypeDef
# put_account_setting_default method usage example with argument unpacking

kwargs: PutAccountSettingDefaultRequestTypeDef = {  # (1)
    "name": ...,
    "value": ...,
}

parent.put_account_setting_default(**kwargs)
  1. See PutAccountSettingDefaultRequestTypeDef

put_attributes#

Create or update an attribute on an Amazon ECS resource.

Type annotations and code completion for boto3.client("ecs").put_attributes method. boto3 documentation

# put_attributes method definition

def put_attributes(
    self,
    *,
    attributes: Sequence[AttributeTypeDef],  # (1)
    cluster: str = ...,
) -> PutAttributesResponseTypeDef:  # (2)
    ...
  1. See Sequence[AttributeTypeDef]
  2. See PutAttributesResponseTypeDef
# put_attributes method usage example with argument unpacking

kwargs: PutAttributesRequestTypeDef = {  # (1)
    "attributes": ...,
}

parent.put_attributes(**kwargs)
  1. See PutAttributesRequestTypeDef

put_cluster_capacity_providers#

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

Type annotations and code completion for boto3.client("ecs").put_cluster_capacity_providers method. boto3 documentation

# put_cluster_capacity_providers method definition

def put_cluster_capacity_providers(
    self,
    *,
    cluster: str,
    capacityProviders: Sequence[str],
    defaultCapacityProviderStrategy: Sequence[CapacityProviderStrategyItemTypeDef],  # (1)
) -> PutClusterCapacityProvidersResponseTypeDef:  # (2)
    ...
  1. See Sequence[CapacityProviderStrategyItemTypeDef]
  2. See PutClusterCapacityProvidersResponseTypeDef
# put_cluster_capacity_providers method usage example with argument unpacking

kwargs: PutClusterCapacityProvidersRequestTypeDef = {  # (1)
    "cluster": ...,
    "capacityProviders": ...,
    "defaultCapacityProviderStrategy": ...,
}

parent.put_cluster_capacity_providers(**kwargs)
  1. See PutClusterCapacityProvidersRequestTypeDef

register_container_instance#

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

Type annotations and code completion for boto3.client("ecs").register_container_instance method. boto3 documentation

# register_container_instance method definition

def register_container_instance(
    self,
    *,
    cluster: str = ...,
    instanceIdentityDocument: str = ...,
    instanceIdentityDocumentSignature: str = ...,
    totalResources: Sequence[ResourceUnionTypeDef] = ...,  # (1)
    versionInfo: VersionInfoTypeDef = ...,  # (2)
    containerInstanceArn: str = ...,
    attributes: Sequence[AttributeTypeDef] = ...,  # (3)
    platformDevices: Sequence[PlatformDeviceTypeDef] = ...,  # (4)
    tags: Sequence[TagTypeDef] = ...,  # (5)
) -> RegisterContainerInstanceResponseTypeDef:  # (6)
    ...
  1. See Sequence[ResourceUnionTypeDef]
  2. See VersionInfoTypeDef
  3. See Sequence[AttributeTypeDef]
  4. See Sequence[PlatformDeviceTypeDef]
  5. See Sequence[TagTypeDef]
  6. See RegisterContainerInstanceResponseTypeDef
# register_container_instance method usage example with argument unpacking

kwargs: RegisterContainerInstanceRequestTypeDef = {  # (1)
    "cluster": ...,
}

parent.register_container_instance(**kwargs)
  1. See RegisterContainerInstanceRequestTypeDef

register_task_definition#

Registers a new task definition from the supplied family and containerDefinitions.

Type annotations and code completion for boto3.client("ecs").register_task_definition method. boto3 documentation

# register_task_definition method definition

def register_task_definition(
    self,
    *,
    family: str,
    containerDefinitions: Sequence[ContainerDefinitionUnionTypeDef],  # (1)
    taskRoleArn: str = ...,
    executionRoleArn: str = ...,
    networkMode: NetworkModeType = ...,  # (2)
    volumes: Sequence[VolumeUnionTypeDef] = ...,  # (3)
    placementConstraints: Sequence[TaskDefinitionPlacementConstraintTypeDef] = ...,  # (4)
    requiresCompatibilities: Sequence[CompatibilityType] = ...,  # (5)
    cpu: str = ...,
    memory: str = ...,
    tags: Sequence[TagTypeDef] = ...,  # (6)
    pidMode: PidModeType = ...,  # (7)
    ipcMode: IpcModeType = ...,  # (8)
    proxyConfiguration: ProxyConfigurationUnionTypeDef = ...,  # (9)
    inferenceAccelerators: Sequence[InferenceAcceleratorTypeDef] = ...,  # (10)
    ephemeralStorage: EphemeralStorageTypeDef = ...,  # (11)
    runtimePlatform: RuntimePlatformTypeDef = ...,  # (12)
    enableFaultInjection: bool = ...,
) -> RegisterTaskDefinitionResponseTypeDef:  # (13)
    ...
  1. See Sequence[ContainerDefinitionUnionTypeDef]
  2. See NetworkModeType
  3. See Sequence[VolumeUnionTypeDef]
  4. See Sequence[TaskDefinitionPlacementConstraintTypeDef]
  5. See Sequence[CompatibilityType]
  6. See Sequence[TagTypeDef]
  7. See PidModeType
  8. See IpcModeType
  9. See ProxyConfigurationUnionTypeDef
  10. See Sequence[InferenceAcceleratorTypeDef]
  11. See EphemeralStorageTypeDef
  12. See RuntimePlatformTypeDef
  13. See RegisterTaskDefinitionResponseTypeDef
# register_task_definition method usage example with argument unpacking

kwargs: RegisterTaskDefinitionRequestTypeDef = {  # (1)
    "family": ...,
    "containerDefinitions": ...,
}

parent.register_task_definition(**kwargs)
  1. See RegisterTaskDefinitionRequestTypeDef

run_task#

Starts a new task using the specified task definition.

Type annotations and code completion for boto3.client("ecs").run_task method. boto3 documentation

# run_task method definition

def run_task(
    self,
    *,
    taskDefinition: str,
    capacityProviderStrategy: Sequence[CapacityProviderStrategyItemTypeDef] = ...,  # (1)
    cluster: str = ...,
    count: int = ...,
    enableECSManagedTags: bool = ...,
    enableExecuteCommand: bool = ...,
    group: str = ...,
    launchType: LaunchTypeType = ...,  # (2)
    networkConfiguration: NetworkConfigurationUnionTypeDef = ...,  # (3)
    overrides: TaskOverrideUnionTypeDef = ...,  # (4)
    placementConstraints: Sequence[PlacementConstraintTypeDef] = ...,  # (5)
    placementStrategy: Sequence[PlacementStrategyTypeDef] = ...,  # (6)
    platformVersion: str = ...,
    propagateTags: PropagateTagsType = ...,  # (7)
    referenceId: str = ...,
    startedBy: str = ...,
    tags: Sequence[TagTypeDef] = ...,  # (8)
    clientToken: str = ...,
    volumeConfigurations: Sequence[TaskVolumeConfigurationTypeDef] = ...,  # (9)
) -> RunTaskResponseTypeDef:  # (10)
    ...
  1. See Sequence[CapacityProviderStrategyItemTypeDef]
  2. See LaunchTypeType
  3. See NetworkConfigurationUnionTypeDef
  4. See TaskOverrideUnionTypeDef
  5. See Sequence[PlacementConstraintTypeDef]
  6. See Sequence[PlacementStrategyTypeDef]
  7. See PropagateTagsType
  8. See Sequence[TagTypeDef]
  9. See Sequence[TaskVolumeConfigurationTypeDef]
  10. See RunTaskResponseTypeDef
# run_task method usage example with argument unpacking

kwargs: RunTaskRequestTypeDef = {  # (1)
    "taskDefinition": ...,
}

parent.run_task(**kwargs)
  1. See RunTaskRequestTypeDef

start_task#

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

Type annotations and code completion for boto3.client("ecs").start_task method. boto3 documentation

# start_task method definition

def start_task(
    self,
    *,
    containerInstances: Sequence[str],
    taskDefinition: str,
    cluster: str = ...,
    enableECSManagedTags: bool = ...,
    enableExecuteCommand: bool = ...,
    group: str = ...,
    networkConfiguration: NetworkConfigurationUnionTypeDef = ...,  # (1)
    overrides: TaskOverrideUnionTypeDef = ...,  # (2)
    propagateTags: PropagateTagsType = ...,  # (3)
    referenceId: str = ...,
    startedBy: str = ...,
    tags: Sequence[TagTypeDef] = ...,  # (4)
    volumeConfigurations: Sequence[TaskVolumeConfigurationTypeDef] = ...,  # (5)
) -> StartTaskResponseTypeDef:  # (6)
    ...
  1. See NetworkConfigurationUnionTypeDef
  2. See TaskOverrideUnionTypeDef
  3. See PropagateTagsType
  4. See Sequence[TagTypeDef]
  5. See Sequence[TaskVolumeConfigurationTypeDef]
  6. See StartTaskResponseTypeDef
# start_task method usage example with argument unpacking

kwargs: StartTaskRequestTypeDef = {  # (1)
    "containerInstances": ...,
    "taskDefinition": ...,
}

parent.start_task(**kwargs)
  1. See StartTaskRequestTypeDef

stop_task#

Stops a running task.

Type annotations and code completion for boto3.client("ecs").stop_task method. boto3 documentation

# stop_task method definition

def stop_task(
    self,
    *,
    task: str,
    cluster: str = ...,
    reason: str = ...,
) -> StopTaskResponseTypeDef:  # (1)
    ...
  1. See StopTaskResponseTypeDef
# stop_task method usage example with argument unpacking

kwargs: StopTaskRequestTypeDef = {  # (1)
    "task": ...,
}

parent.stop_task(**kwargs)
  1. See StopTaskRequestTypeDef

submit_attachment_state_changes#

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

Type annotations and code completion for boto3.client("ecs").submit_attachment_state_changes method. boto3 documentation

# submit_attachment_state_changes method definition

def submit_attachment_state_changes(
    self,
    *,
    attachments: Sequence[AttachmentStateChangeTypeDef],  # (1)
    cluster: str = ...,
) -> SubmitAttachmentStateChangesResponseTypeDef:  # (2)
    ...
  1. See Sequence[AttachmentStateChangeTypeDef]
  2. See SubmitAttachmentStateChangesResponseTypeDef
# submit_attachment_state_changes method usage example with argument unpacking

kwargs: SubmitAttachmentStateChangesRequestTypeDef = {  # (1)
    "attachments": ...,
}

parent.submit_attachment_state_changes(**kwargs)
  1. See SubmitAttachmentStateChangesRequestTypeDef

submit_container_state_change#

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

Type annotations and code completion for boto3.client("ecs").submit_container_state_change method. boto3 documentation

# submit_container_state_change method definition

def submit_container_state_change(
    self,
    *,
    cluster: str = ...,
    task: str = ...,
    containerName: str = ...,
    runtimeId: str = ...,
    status: str = ...,
    exitCode: int = ...,
    reason: str = ...,
    networkBindings: Sequence[NetworkBindingTypeDef] = ...,  # (1)
) -> SubmitContainerStateChangeResponseTypeDef:  # (2)
    ...
  1. See Sequence[NetworkBindingTypeDef]
  2. See SubmitContainerStateChangeResponseTypeDef
# submit_container_state_change method usage example with argument unpacking

kwargs: SubmitContainerStateChangeRequestTypeDef = {  # (1)
    "cluster": ...,
}

parent.submit_container_state_change(**kwargs)
  1. See SubmitContainerStateChangeRequestTypeDef

submit_task_state_change#

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

Type annotations and code completion for boto3.client("ecs").submit_task_state_change method. boto3 documentation

# submit_task_state_change method definition

def submit_task_state_change(
    self,
    *,
    cluster: str = ...,
    task: str = ...,
    status: str = ...,
    reason: str = ...,
    containers: Sequence[ContainerStateChangeTypeDef] = ...,  # (1)
    attachments: Sequence[AttachmentStateChangeTypeDef] = ...,  # (2)
    managedAgents: Sequence[ManagedAgentStateChangeTypeDef] = ...,  # (3)
    pullStartedAt: TimestampTypeDef = ...,
    pullStoppedAt: TimestampTypeDef = ...,
    executionStoppedAt: TimestampTypeDef = ...,
) -> SubmitTaskStateChangeResponseTypeDef:  # (4)
    ...
  1. See Sequence[ContainerStateChangeTypeDef]
  2. See Sequence[AttachmentStateChangeTypeDef]
  3. See Sequence[ManagedAgentStateChangeTypeDef]
  4. See SubmitTaskStateChangeResponseTypeDef
# submit_task_state_change method usage example with argument unpacking

kwargs: SubmitTaskStateChangeRequestTypeDef = {  # (1)
    "cluster": ...,
}

parent.submit_task_state_change(**kwargs)
  1. See SubmitTaskStateChangeRequestTypeDef

tag_resource#

Associates the specified tags to a resource with the specified resourceArn.

Type annotations and code completion for boto3.client("ecs").tag_resource method. boto3 documentation

# tag_resource method definition

def tag_resource(
    self,
    *,
    resourceArn: str,
    tags: Sequence[TagTypeDef],  # (1)
) -> Dict[str, Any]:
    ...
  1. See Sequence[TagTypeDef]
# tag_resource method usage example with argument unpacking

kwargs: TagResourceRequestTypeDef = {  # (1)
    "resourceArn": ...,
    "tags": ...,
}

parent.tag_resource(**kwargs)
  1. See TagResourceRequestTypeDef

untag_resource#

Deletes specified tags from a resource.

Type annotations and code completion for boto3.client("ecs").untag_resource method. boto3 documentation

# untag_resource method definition

def untag_resource(
    self,
    *,
    resourceArn: str,
    tagKeys: Sequence[str],
) -> Dict[str, Any]:
    ...
# untag_resource method usage example with argument unpacking

kwargs: UntagResourceRequestTypeDef = {  # (1)
    "resourceArn": ...,
    "tagKeys": ...,
}

parent.untag_resource(**kwargs)
  1. See UntagResourceRequestTypeDef

update_capacity_provider#

Modifies the parameters for a capacity provider.

Type annotations and code completion for boto3.client("ecs").update_capacity_provider method. boto3 documentation

# update_capacity_provider method definition

def update_capacity_provider(
    self,
    *,
    name: str,
    autoScalingGroupProvider: AutoScalingGroupProviderUpdateTypeDef,  # (1)
) -> UpdateCapacityProviderResponseTypeDef:  # (2)
    ...
  1. See AutoScalingGroupProviderUpdateTypeDef
  2. See UpdateCapacityProviderResponseTypeDef
# update_capacity_provider method usage example with argument unpacking

kwargs: UpdateCapacityProviderRequestTypeDef = {  # (1)
    "name": ...,
    "autoScalingGroupProvider": ...,
}

parent.update_capacity_provider(**kwargs)
  1. See UpdateCapacityProviderRequestTypeDef

update_cluster#

Updates the cluster.

Type annotations and code completion for boto3.client("ecs").update_cluster method. boto3 documentation

# update_cluster method definition

def update_cluster(
    self,
    *,
    cluster: str,
    settings: Sequence[ClusterSettingTypeDef] = ...,  # (1)
    configuration: ClusterConfigurationTypeDef = ...,  # (2)
    serviceConnectDefaults: ClusterServiceConnectDefaultsRequestTypeDef = ...,  # (3)
) -> UpdateClusterResponseTypeDef:  # (4)
    ...
  1. See Sequence[ClusterSettingTypeDef]
  2. See ClusterConfigurationTypeDef
  3. See ClusterServiceConnectDefaultsRequestTypeDef
  4. See UpdateClusterResponseTypeDef
# update_cluster method usage example with argument unpacking

kwargs: UpdateClusterRequestTypeDef = {  # (1)
    "cluster": ...,
}

parent.update_cluster(**kwargs)
  1. See UpdateClusterRequestTypeDef

update_cluster_settings#

Modifies the settings to use for a cluster.

Type annotations and code completion for boto3.client("ecs").update_cluster_settings method. boto3 documentation

# update_cluster_settings method definition

def update_cluster_settings(
    self,
    *,
    cluster: str,
    settings: Sequence[ClusterSettingTypeDef],  # (1)
) -> UpdateClusterSettingsResponseTypeDef:  # (2)
    ...
  1. See Sequence[ClusterSettingTypeDef]
  2. See UpdateClusterSettingsResponseTypeDef
# update_cluster_settings method usage example with argument unpacking

kwargs: UpdateClusterSettingsRequestTypeDef = {  # (1)
    "cluster": ...,
    "settings": ...,
}

parent.update_cluster_settings(**kwargs)
  1. See UpdateClusterSettingsRequestTypeDef

update_container_agent#

Updates the Amazon ECS container agent on a specified container instance.

Type annotations and code completion for boto3.client("ecs").update_container_agent method. boto3 documentation

# update_container_agent method definition

def update_container_agent(
    self,
    *,
    containerInstance: str,
    cluster: str = ...,
) -> UpdateContainerAgentResponseTypeDef:  # (1)
    ...
  1. See UpdateContainerAgentResponseTypeDef
# update_container_agent method usage example with argument unpacking

kwargs: UpdateContainerAgentRequestTypeDef = {  # (1)
    "containerInstance": ...,
}

parent.update_container_agent(**kwargs)
  1. See UpdateContainerAgentRequestTypeDef

update_container_instances_state#

Modifies the status of an Amazon ECS container instance.

Type annotations and code completion for boto3.client("ecs").update_container_instances_state method. boto3 documentation

# update_container_instances_state method definition

def update_container_instances_state(
    self,
    *,
    containerInstances: Sequence[str],
    status: ContainerInstanceStatusType,  # (1)
    cluster: str = ...,
) -> UpdateContainerInstancesStateResponseTypeDef:  # (2)
    ...
  1. See ContainerInstanceStatusType
  2. See UpdateContainerInstancesStateResponseTypeDef
# update_container_instances_state method usage example with argument unpacking

kwargs: UpdateContainerInstancesStateRequestTypeDef = {  # (1)
    "containerInstances": ...,
    "status": ...,
}

parent.update_container_instances_state(**kwargs)
  1. See UpdateContainerInstancesStateRequestTypeDef

update_service#

Modifies the parameters of a service.

Type annotations and code completion for boto3.client("ecs").update_service method. boto3 documentation

# update_service method definition

def update_service(
    self,
    *,
    service: str,
    cluster: str = ...,
    desiredCount: int = ...,
    taskDefinition: str = ...,
    capacityProviderStrategy: Sequence[CapacityProviderStrategyItemTypeDef] = ...,  # (1)
    deploymentConfiguration: DeploymentConfigurationUnionTypeDef = ...,  # (2)
    availabilityZoneRebalancing: AvailabilityZoneRebalancingType = ...,  # (3)
    networkConfiguration: NetworkConfigurationUnionTypeDef = ...,  # (4)
    placementConstraints: Sequence[PlacementConstraintTypeDef] = ...,  # (5)
    placementStrategy: Sequence[PlacementStrategyTypeDef] = ...,  # (6)
    platformVersion: str = ...,
    forceNewDeployment: bool = ...,
    healthCheckGracePeriodSeconds: int = ...,
    enableExecuteCommand: bool = ...,
    enableECSManagedTags: bool = ...,
    loadBalancers: Sequence[LoadBalancerTypeDef] = ...,  # (7)
    propagateTags: PropagateTagsType = ...,  # (8)
    serviceRegistries: Sequence[ServiceRegistryTypeDef] = ...,  # (9)
    serviceConnectConfiguration: ServiceConnectConfigurationUnionTypeDef = ...,  # (10)
    volumeConfigurations: Sequence[ServiceVolumeConfigurationUnionTypeDef] = ...,  # (11)
    vpcLatticeConfigurations: Sequence[VpcLatticeConfigurationTypeDef] = ...,  # (12)
) -> UpdateServiceResponseTypeDef:  # (13)
    ...
  1. See Sequence[CapacityProviderStrategyItemTypeDef]
  2. See DeploymentConfigurationUnionTypeDef
  3. See AvailabilityZoneRebalancingType
  4. See NetworkConfigurationUnionTypeDef
  5. See Sequence[PlacementConstraintTypeDef]
  6. See Sequence[PlacementStrategyTypeDef]
  7. See Sequence[LoadBalancerTypeDef]
  8. See PropagateTagsType
  9. See Sequence[ServiceRegistryTypeDef]
  10. See ServiceConnectConfigurationUnionTypeDef
  11. See Sequence[ServiceVolumeConfigurationUnionTypeDef]
  12. See Sequence[VpcLatticeConfigurationTypeDef]
  13. See UpdateServiceResponseTypeDef
# update_service method usage example with argument unpacking

kwargs: UpdateServiceRequestTypeDef = {  # (1)
    "service": ...,
}

parent.update_service(**kwargs)
  1. See UpdateServiceRequestTypeDef

update_service_primary_task_set#

Modifies which task set in a service is the primary task set.

Type annotations and code completion for boto3.client("ecs").update_service_primary_task_set method. boto3 documentation

# update_service_primary_task_set method definition

def update_service_primary_task_set(
    self,
    *,
    cluster: str,
    service: str,
    primaryTaskSet: str,
) -> UpdateServicePrimaryTaskSetResponseTypeDef:  # (1)
    ...
  1. See UpdateServicePrimaryTaskSetResponseTypeDef
# update_service_primary_task_set method usage example with argument unpacking

kwargs: UpdateServicePrimaryTaskSetRequestTypeDef = {  # (1)
    "cluster": ...,
    "service": ...,
    "primaryTaskSet": ...,
}

parent.update_service_primary_task_set(**kwargs)
  1. See UpdateServicePrimaryTaskSetRequestTypeDef

update_task_protection#

Updates the protection status of a task.

Type annotations and code completion for boto3.client("ecs").update_task_protection method. boto3 documentation

# update_task_protection method definition

def update_task_protection(
    self,
    *,
    cluster: str,
    tasks: Sequence[str],
    protectionEnabled: bool,
    expiresInMinutes: int = ...,
) -> UpdateTaskProtectionResponseTypeDef:  # (1)
    ...
  1. See UpdateTaskProtectionResponseTypeDef
# update_task_protection method usage example with argument unpacking

kwargs: UpdateTaskProtectionRequestTypeDef = {  # (1)
    "cluster": ...,
    "tasks": ...,
    "protectionEnabled": ...,
}

parent.update_task_protection(**kwargs)
  1. See UpdateTaskProtectionRequestTypeDef

update_task_set#

Modifies a task set.

Type annotations and code completion for boto3.client("ecs").update_task_set method. boto3 documentation

# update_task_set method definition

def update_task_set(
    self,
    *,
    cluster: str,
    service: str,
    taskSet: str,
    scale: ScaleTypeDef,  # (1)
) -> UpdateTaskSetResponseTypeDef:  # (2)
    ...
  1. See ScaleTypeDef
  2. See UpdateTaskSetResponseTypeDef
# update_task_set method usage example with argument unpacking

kwargs: UpdateTaskSetRequestTypeDef = {  # (1)
    "cluster": ...,
    "service": ...,
    "taskSet": ...,
    "scale": ...,
}

parent.update_task_set(**kwargs)
  1. See UpdateTaskSetRequestTypeDef

get_paginator#

Type annotations and code completion for boto3.client("ecs").get_paginator method with overloads.

get_waiter#

Type annotations and code completion for boto3.client("ecs").get_waiter method with overloads.