Skip to content

ContainerService

Source code in docs_src/capo_lightsail/types/container_service.py
class ContainerService(TypedDict, closed=True):
    container_service_name: NotRequired[
        "capo_lightsail.types.container_service_name.ContainerServiceName"
    ]
    """<p>The name of the container service.</p>"""
    arn: NotRequired["capo_lightsail.types.non_empty_string.NonEmptyString"]
    """<p>The Amazon Resource Name (ARN) of the container service.</p>"""
    created_at: NotRequired["capo_lightsail.types.iso_date.IsoDate"]
    """<p>The timestamp when the container service was created.</p>"""
    location: NotRequired["capo_lightsail.types.resource_location.ResourceLocation"]
    """<p>An object that describes the location of the container service, such as the Amazon Web Services Region and Availability Zone.</p>"""
    resource_type: NotRequired["capo_lightsail.types.resource_type.ResourceType"]
    """<p>The Lightsail resource type of the container service.</p>"""
    tags: NotRequired["capo_lightsail.types.tag_list.TagList"]
    """<p>The tag keys and optional values for the resource. For more information about tags in Lightsail, see the <a href="https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-tags">Amazon Lightsail Developer Guide</a>.</p>"""
    power: NotRequired[
        "capo_lightsail.types.container_service_power_name.ContainerServicePowerName"
    ]
    """<p>The power specification of the container service.</p> <p>The power specifies the amount of RAM, the number of vCPUs, and the base price of the container service.</p>"""
    power_id: NotRequired["capo_lightsail.types.string.string"]
    """<p>The ID of the power of the container service.</p>"""
    state: NotRequired[
        "capo_lightsail.types.container_service_state.ContainerServiceState"
    ]
    """<p>The current state of the container service.</p> <p>The following container service states are possible:</p> <ul> <li> <p> <code>PENDING</code> - The container service is being created.</p> </li> <li> <p> <code>READY</code> - The container service is running but it does not have an active container deployment.</p> </li> <li> <p> <code>DEPLOYING</code> - The container service is launching a container deployment.</p> </li> <li> <p> <code>RUNNING</code> - The container service is running and it has an active container deployment.</p> </li> <li> <p> <code>UPDATING</code> - The container service capacity or its custom domains are being updated.</p> </li> <li> <p> <code>DELETING</code> - The container service is being deleted.</p> </li> <li> <p> <code>DISABLED</code> - The container service is disabled, and its active deployment and containers, if any, are shut down.</p> </li> </ul>"""
    state_detail: NotRequired[
        "capo_lightsail.types.container_service_state_detail.ContainerServiceStateDetail"
    ]
    """<p>An object that describes the current state of the container service.</p> <note> <p>The state detail is populated only when a container service is in a <code>PENDING</code>, <code>DEPLOYING</code>, or <code>UPDATING</code> state.</p> </note>"""
    scale: NotRequired[
        "capo_lightsail.types.container_service_scale.ContainerServiceScale"
    ]
    """<p>The scale specification of the container service.</p> <p>The scale specifies the allocated compute nodes of the container service.</p>"""
    current_deployment: NotRequired[
        "capo_lightsail.types.container_service_deployment.ContainerServiceDeployment"
    ]
    """<p>An object that describes the current container deployment of the container service.</p>"""
    next_deployment: NotRequired[
        "capo_lightsail.types.container_service_deployment.ContainerServiceDeployment"
    ]
    """<p>An object that describes the next deployment of the container service.</p> <p>This value is <code>null</code> when there is no deployment in a <code>pending</code> state.</p>"""
    is_disabled: NotRequired["capo_lightsail.types.boolean.boolean"]
    """<p>A Boolean value indicating whether the container service is disabled.</p>"""
    principal_arn: NotRequired["capo_lightsail.types.string.string"]
    """<p>The principal ARN of the container service.</p> <p>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.</p>"""
    private_domain_name: NotRequired["capo_lightsail.types.string.string"]
    """<p>The private domain name of the container service.</p> <p>The private domain name is accessible only by other resources within the default virtual private cloud (VPC) of your Lightsail account.</p>"""
    public_domain_names: NotRequired[
        "capo_lightsail.types.container_service_public_domains.ContainerServicePublicDomains"
    ]
    """<p>The public domain name of the container service, such as <code>example.com</code> and <code>www.example.com</code>.</p> <p>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.</p> <p>If you don't specify public domain names, then you can use the default domain of the container service.</p> <important> <p>You must create and validate an SSL/TLS certificate before you can use public domain names with your container service. Use the <code>CreateCertificate</code> action to create a certificate for the public domain names you want to use with your container service.</p> </important> <p>See <code>CreateContainerService</code> or <code>UpdateContainerService</code> for information about how to specify public domain names for your Lightsail container service.</p>"""
    url: NotRequired["capo_lightsail.types.string.string"]
    """<p>The publicly accessible URL of the container service.</p> <p>If no public endpoint is specified in the <code>currentDeployment</code>, this URL returns a 404 response.</p>"""
    private_registry_access: NotRequired[
        "capo_lightsail.types.private_registry_access.PrivateRegistryAccess"
    ]
    """<p>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.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-container-service-ecr-private-repo-access">Configuring access to an Amazon ECR private repository for an Amazon Lightsail container service</a> in the <i>Amazon Lightsail Developer Guide</i>.</p>"""

arn instance-attribute

arn: NotRequired[NonEmptyString]

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

container_service_name instance-attribute

container_service_name: NotRequired[ContainerServiceName]

The name of the container service.

created_at instance-attribute

created_at: NotRequired[IsoDate]

The timestamp when the container service was created.

current_deployment instance-attribute

current_deployment: NotRequired[ContainerServiceDeployment]

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

is_disabled instance-attribute

is_disabled: NotRequired[boolean]

A Boolean value indicating whether the container service is disabled.

location instance-attribute

location: NotRequired[ResourceLocation]

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

next_deployment instance-attribute

next_deployment: NotRequired[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 instance-attribute

power: NotRequired[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.

power_id instance-attribute

power_id: NotRequired[string]

The ID of the power of the container service.

principal_arn instance-attribute

principal_arn: NotRequired[string]

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.

private_domain_name instance-attribute

private_domain_name: NotRequired[string]

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.

private_registry_access instance-attribute

private_registry_access: NotRequired[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.

public_domain_names instance-attribute

public_domain_names: NotRequired[ContainerServicePublicDomains]

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.

resource_type instance-attribute

resource_type: NotRequired[ResourceType]

The Lightsail resource type of the container service.

scale instance-attribute

scale: NotRequired[ContainerServiceScale]

The scale specification of the container service.

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

state instance-attribute

state: NotRequired[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.

state_detail instance-attribute

state_detail: NotRequired[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 instance-attribute

tags: NotRequired[TagList]

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

url instance-attribute

url: NotRequired[string]

The publicly accessible URL of the container service.

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