Amazonka.Lightsail.Types.ContainerService

Documentation

data ContainerService

Describes an Amazon Lightsail container service.

See: newContainerService smart constructor.

Constructors

ContainerService'

Fields

• arn :: Maybe Text

  The Amazon Resource Name (ARN) of the container service.

• containerServiceName :: Maybe Text

  The name of the container service.

• createdAt :: Maybe POSIX

  The timestamp when the container service was created.

• currentDeployment :: Maybe ContainerServiceDeployment

  An object that describes the current container deployment of the container service.

• isDisabled :: Maybe Bool

  A Boolean value indicating whether the container service is disabled.

• location :: Maybe ResourceLocation

  An object that describes the location of the container service, such as the Amazon Web Services Region and Availability Zone.

• nextDeployment :: Maybe ContainerServiceDeployment

  An object that describes the next deployment of the container service.

  This value is null when there is no deployment in a pending state.

• power :: Maybe ContainerServicePowerName

  The power specification of the container service.

  The power specifies the amount of RAM, the number of vCPUs, and the base price of the container service.

• powerId :: Maybe Text

  The ID of the power of the container service.

• principalArn :: Maybe Text

  The principal ARN of the container service.

  The principal ARN can be used to create a trust relationship between your standard Amazon Web Services account and your Lightsail container service. This allows you to give your service permission to access resources in your standard Amazon Web Services account.

• privateDomainName :: Maybe Text

  The private domain name of the container service.

  The private domain name is accessible only by other resources within the default virtual private cloud (VPC) of your Lightsail account.

• privateRegistryAccess :: Maybe PrivateRegistryAccess

  An object that describes the configuration for the container service to access private container image repositories, such as Amazon Elastic Container Registry (Amazon ECR) private repositories.

  For more information, see Configuring access to an Amazon ECR private repository for an Amazon Lightsail container service in the Amazon Lightsail Developer Guide.

• publicDomainNames :: Maybe (HashMap Text [Text])

  The public domain name of the container service, such as example.com and www.example.com.

  You can specify up to four public domain names for a container service. The domain names that you specify are used when you create a deployment with a container configured as the public endpoint of your container service.

  If you don't specify public domain names, then you can use the default domain of the container service.

  You must create and validate an SSL/TLS certificate before you can use public domain names with your container service. Use the CreateCertificate action to create a certificate for the public domain names you want to use with your container service.

  See CreateContainerService or UpdateContainerService for information about how to specify public domain names for your Lightsail container service.

• resourceType :: Maybe ResourceType

  The Lightsail resource type of the container service (i.e., ContainerService).

• scale :: Maybe Natural

  The scale specification of the container service.

  The scale specifies the allocated compute nodes of the container service.

• state :: Maybe ContainerServiceState

  The current state of the container service.

  The following container service states are possible:

  • PENDING - The container service is being created.
  • READY - The container service is running but it does not have an active container deployment.
  • DEPLOYING - The container service is launching a container deployment.
  • RUNNING - The container service is running and it has an active container deployment.
  • UPDATING - The container service capacity or its custom domains are being updated.
  • DELETING - The container service is being deleted.
  • DISABLED - The container service is disabled, and its active deployment and containers, if any, are shut down.
• stateDetail :: Maybe ContainerServiceStateDetail

  An object that describes the current state of the container service.

  The state detail is populated only when a container service is in a PENDING, DEPLOYING, or UPDATING state.

• tags :: Maybe [Tag]

  The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide.

• url :: Maybe Text

  The publicly accessible URL of the container service.

  If no public endpoint is specified in the currentDeployment, this URL returns a 404 response.

Instances

FromJSON ContainerService

Defined in Amazonka.Lightsail.Types.ContainerService

Methods

parseJSON :: Value -> Parser ContainerService

parseJSONList :: Value -> Parser [ContainerService]

Generic ContainerService

Defined in Amazonka.Lightsail.Types.ContainerService

Associated Types

type Rep ContainerService :: Type -> Type

Methods

from :: ContainerService -> Rep ContainerService x

to :: Rep ContainerService x -> ContainerService

Read ContainerService

Defined in Amazonka.Lightsail.Types.ContainerService

Methods

readsPrec :: Int -> ReadS ContainerService

readList :: ReadS [ContainerService]

readPrec :: ReadPrec ContainerService

readListPrec :: ReadPrec [ContainerService]

Show ContainerService

Defined in Amazonka.Lightsail.Types.ContainerService

Methods

showsPrec :: Int -> ContainerService -> ShowS

show :: ContainerService -> String

showList :: [ContainerService] -> ShowS

NFData ContainerService

Defined in Amazonka.Lightsail.Types.ContainerService

Methods

rnf :: ContainerService -> ()

Eq ContainerService

Defined in Amazonka.Lightsail.Types.ContainerService

Methods

(==) :: ContainerService -> ContainerService -> Bool

(/=) :: ContainerService -> ContainerService -> Bool

Hashable ContainerService

Defined in Amazonka.Lightsail.Types.ContainerService

Methods

hashWithSalt :: Int -> ContainerService -> Int

hash :: ContainerService -> Int

type Rep ContainerService

Defined in Amazonka.Lightsail.Types.ContainerService

type Rep ContainerService = D1 ('MetaData "ContainerService" "Amazonka.Lightsail.Types.ContainerService" "amazonka-lightsail-2.0-77hvsZhtZFxFduYae8QaN0" 'False) (C1 ('MetaCons "ContainerService'" 'PrefixI 'True) ((((S1 ('MetaSel ('Just "arn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "containerServiceName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "createdAt") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe POSIX)) :*: S1 ('MetaSel ('Just "currentDeployment") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ContainerServiceDeployment)))) :*: ((S1 ('MetaSel ('Just "isDisabled") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "location") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ResourceLocation))) :*: (S1 ('MetaSel ('Just "nextDeployment") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ContainerServiceDeployment)) :*: (S1 ('MetaSel ('Just "power") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ContainerServicePowerName)) :*: S1 ('MetaSel ('Just "powerId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))))) :*: (((S1 ('MetaSel ('Just "principalArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "privateDomainName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "privateRegistryAccess") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe PrivateRegistryAccess)) :*: (S1 ('MetaSel ('Just "publicDomainNames") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe (HashMap Text [Text]))) :*: S1 ('MetaSel ('Just "resourceType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ResourceType))))) :*: ((S1 ('MetaSel ('Just "scale") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "state") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ContainerServiceState))) :*: (S1 ('MetaSel ('Just "stateDetail") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ContainerServiceStateDetail)) :*: (S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Tag])) :*: S1 ('MetaSel ('Just "url") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))))))

newContainerService :: ContainerService

Create a value of ContainerService 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:arn:ContainerService', containerService_arn - The Amazon Resource Name (ARN) of the container service.

$sel:containerServiceName:ContainerService', containerService_containerServiceName - The name of the container service.

ContainerService, containerService_createdAt - The timestamp when the container service was created.

$sel:currentDeployment:ContainerService', containerService_currentDeployment - An object that describes the current container deployment of the container service.

$sel:isDisabled:ContainerService', containerService_isDisabled - A Boolean value indicating whether the container service is disabled.

$sel:location:ContainerService', containerService_location - An object that describes the location of the container service, such as the Amazon Web Services Region and Availability Zone.

$sel:nextDeployment:ContainerService', containerService_nextDeployment - An object that describes the next deployment of the container service.

This value is null when there is no deployment in a pending state.

$sel:power:ContainerService', containerService_power - The power specification of the container service.

The power specifies the amount of RAM, the number of vCPUs, and the base price of the container service.

$sel:powerId:ContainerService', containerService_powerId - The ID of the power of the container service.

$sel:principalArn:ContainerService', containerService_principalArn - The principal ARN of the container service.

The principal ARN can be used to create a trust relationship between your standard Amazon Web Services account and your Lightsail container service. This allows you to give your service permission to access resources in your standard Amazon Web Services account.

$sel:privateDomainName:ContainerService', containerService_privateDomainName - The private domain name of the container service.

The private domain name is accessible only by other resources within the default virtual private cloud (VPC) of your Lightsail account.

$sel:privateRegistryAccess:ContainerService', containerService_privateRegistryAccess - An object that describes the configuration for the container service to access private container image repositories, such as Amazon Elastic Container Registry (Amazon ECR) private repositories.

For more information, see Configuring access to an Amazon ECR private repository for an Amazon Lightsail container service in the Amazon Lightsail Developer Guide.

$sel:publicDomainNames:ContainerService', containerService_publicDomainNames - The public domain name of the container service, such as example.com and www.example.com.

You can specify up to four public domain names for a container service. The domain names that you specify are used when you create a deployment with a container configured as the public endpoint of your container service.

If you don't specify public domain names, then you can use the default domain of the container service.

You must create and validate an SSL/TLS certificate before you can use public domain names with your container service. Use the CreateCertificate action to create a certificate for the public domain names you want to use with your container service.

See CreateContainerService or UpdateContainerService for information about how to specify public domain names for your Lightsail container service.

$sel:resourceType:ContainerService', containerService_resourceType - The Lightsail resource type of the container service (i.e., ContainerService).

$sel:scale:ContainerService', containerService_scale - The scale specification of the container service.

The scale specifies the allocated compute nodes of the container service.

ContainerService, containerService_state - The current state of the container service.

The following container service states are possible:

• PENDING - The container service is being created.
• READY - The container service is running but it does not have an active container deployment.
• DEPLOYING - The container service is launching a container deployment.
• RUNNING - The container service is running and it has an active container deployment.
• UPDATING - The container service capacity or its custom domains are being updated.
• DELETING - The container service is being deleted.
• DISABLED - The container service is disabled, and its active deployment and containers, if any, are shut down.

$sel:stateDetail:ContainerService', containerService_stateDetail - An object that describes the current state of the container service.

The state detail is populated only when a container service is in a PENDING, DEPLOYING, or UPDATING state.

$sel:tags:ContainerService', containerService_tags - The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide.

$sel:url:ContainerService', containerService_url - The publicly accessible URL of the container service.

If no public endpoint is specified in the currentDeployment, this URL returns a 404 response.

containerService_arn :: Lens' ContainerService (Maybe Text)

The Amazon Resource Name (ARN) of the container service.

containerService_containerServiceName :: Lens' ContainerService (Maybe Text)

The name of the container service.

containerService_createdAt :: Lens' ContainerService (Maybe UTCTime)

The timestamp when the container service was created.

containerService_currentDeployment :: Lens' ContainerService (Maybe ContainerServiceDeployment)

An object that describes the current container deployment of the container service.

containerService_isDisabled :: Lens' ContainerService (Maybe Bool)

A Boolean value indicating whether the container service is disabled.

containerService_location :: Lens' ContainerService (Maybe ResourceLocation)

An object that describes the location of the container service, such as the Amazon Web Services Region and Availability Zone.

containerService_nextDeployment :: Lens' ContainerService (Maybe ContainerServiceDeployment)

An object that describes the next deployment of the container service.

This value is null when there is no deployment in a pending state.

containerService_power :: Lens' ContainerService (Maybe ContainerServicePowerName)

The power specification of the container service.

The power specifies the amount of RAM, the number of vCPUs, and the base price of the container service.

containerService_powerId :: Lens' ContainerService (Maybe Text)

The ID of the power of the container service.

containerService_principalArn :: Lens' ContainerService (Maybe Text)

The principal ARN of the container service.

The principal ARN can be used to create a trust relationship between your standard Amazon Web Services account and your Lightsail container service. This allows you to give your service permission to access resources in your standard Amazon Web Services account.

containerService_privateDomainName :: Lens' ContainerService (Maybe Text)

The private domain name of the container service.

The private domain name is accessible only by other resources within the default virtual private cloud (VPC) of your Lightsail account.

containerService_privateRegistryAccess :: Lens' ContainerService (Maybe PrivateRegistryAccess)

An object that describes the configuration for the container service to access private container image repositories, such as Amazon Elastic Container Registry (Amazon ECR) private repositories.

For more information, see Configuring access to an Amazon ECR private repository for an Amazon Lightsail container service in the Amazon Lightsail Developer Guide.

containerService_publicDomainNames :: Lens' ContainerService (Maybe (HashMap Text [Text]))

The public domain name of the container service, such as example.com and www.example.com.

You can specify up to four public domain names for a container service. The domain names that you specify are used when you create a deployment with a container configured as the public endpoint of your container service.

If you don't specify public domain names, then you can use the default domain of the container service.

You must create and validate an SSL/TLS certificate before you can use public domain names with your container service. Use the CreateCertificate action to create a certificate for the public domain names you want to use with your container service.

See CreateContainerService or UpdateContainerService for information about how to specify public domain names for your Lightsail container service.

containerService_resourceType :: Lens' ContainerService (Maybe ResourceType)

The Lightsail resource type of the container service (i.e., ContainerService).

containerService_scale :: Lens' ContainerService (Maybe Natural)

The scale specification of the container service.

The scale specifies the allocated compute nodes of the container service.

containerService_state :: Lens' ContainerService (Maybe ContainerServiceState)

The current state of the container service.

The following container service states are possible:

• PENDING - The container service is being created.
• READY - The container service is running but it does not have an active container deployment.
• DEPLOYING - The container service is launching a container deployment.
• RUNNING - The container service is running and it has an active container deployment.
• UPDATING - The container service capacity or its custom domains are being updated.
• DELETING - The container service is being deleted.
• DISABLED - The container service is disabled, and its active deployment and containers, if any, are shut down.

containerService_stateDetail :: Lens' ContainerService (Maybe ContainerServiceStateDetail)

An object that describes the current state of the container service.

The state detail is populated only when a container service is in a PENDING, DEPLOYING, or UPDATING state.

containerService_tags :: Lens' ContainerService (Maybe [Tag])

The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide.

containerService_url :: Lens' ContainerService (Maybe Text)

The publicly accessible URL of the container service.

If no public endpoint is specified in the currentDeployment, this URL returns a 404 response.