amazonka-ecs-2.0: Amazon EC2 Container Service SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.ECS.DescribeContainerInstances

Description

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

Synopsis

Creating a Request

data DescribeContainerInstances Source #

See: newDescribeContainerInstances smart constructor.

Constructors

DescribeContainerInstances' 

Fields

  • cluster :: Maybe Text

    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.

  • include :: Maybe [ContainerInstanceField]

    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.

  • containerInstances :: [Text]

    A list of up to 100 container instance IDs or full Amazon Resource Name (ARN) entries.

Instances

Instances details
ToJSON DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

ToHeaders DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

ToPath DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

ToQuery DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

AWSRequest DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

Generic DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

Associated Types

type Rep DescribeContainerInstances :: Type -> Type #

Read DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

Show DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

NFData DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

Eq DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

Hashable DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

type AWSResponse DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

type Rep DescribeContainerInstances Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

type Rep DescribeContainerInstances = D1 ('MetaData "DescribeContainerInstances" "Amazonka.ECS.DescribeContainerInstances" "amazonka-ecs-2.0-3xFxVqi9x5nBZ44jBEC5G8" 'False) (C1 ('MetaCons "DescribeContainerInstances'" 'PrefixI 'True) (S1 ('MetaSel ('Just "cluster") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "include") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [ContainerInstanceField])) :*: S1 ('MetaSel ('Just "containerInstances") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Text]))))

newDescribeContainerInstances :: DescribeContainerInstances Source #

Create a value of DescribeContainerInstances with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:cluster:DescribeContainerInstances', describeContainerInstances_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.

$sel:include:DescribeContainerInstances', describeContainerInstances_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.

DescribeContainerInstances, describeContainerInstances_containerInstances - A list of up to 100 container instance IDs or full Amazon Resource Name (ARN) entries.

Request Lenses

describeContainerInstances_cluster :: Lens' DescribeContainerInstances (Maybe Text) Source #

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.

describeContainerInstances_include :: Lens' DescribeContainerInstances (Maybe [ContainerInstanceField]) Source #

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.

describeContainerInstances_containerInstances :: Lens' DescribeContainerInstances [Text] Source #

A list of up to 100 container instance IDs or full Amazon Resource Name (ARN) entries.

Destructuring the Response

data DescribeContainerInstancesResponse Source #

Constructors

DescribeContainerInstancesResponse' 

Fields

Instances

Instances details
Generic DescribeContainerInstancesResponse Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

Associated Types

type Rep DescribeContainerInstancesResponse :: Type -> Type #

Read DescribeContainerInstancesResponse Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

Show DescribeContainerInstancesResponse Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

NFData DescribeContainerInstancesResponse Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

Eq DescribeContainerInstancesResponse Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

type Rep DescribeContainerInstancesResponse Source # 
Instance details

Defined in Amazonka.ECS.DescribeContainerInstances

type Rep DescribeContainerInstancesResponse = D1 ('MetaData "DescribeContainerInstancesResponse" "Amazonka.ECS.DescribeContainerInstances" "amazonka-ecs-2.0-3xFxVqi9x5nBZ44jBEC5G8" 'False) (C1 ('MetaCons "DescribeContainerInstancesResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "containerInstances") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [ContainerInstance])) :*: (S1 ('MetaSel ('Just "failures") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Failure])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newDescribeContainerInstancesResponse Source #

Create a value of DescribeContainerInstancesResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

DescribeContainerInstances, describeContainerInstancesResponse_containerInstances - The list of container instances.

$sel:failures:DescribeContainerInstancesResponse', describeContainerInstancesResponse_failures - Any failures associated with the call.

$sel:httpStatus:DescribeContainerInstancesResponse', describeContainerInstancesResponse_httpStatus - The response's http status code.

Response Lenses