2021/04/01 - Amazon Lightsail - 4 updated api methods
Changes - This release adds support for state detail for Amazon Lightsail container services.
{'containerService': {'state': {'DEPLOYING'},
'stateDetail': {'code': 'CREATING_SYSTEM_RESOURCES | '
'CREATING_NETWORK_INFRASTRUCTURE '
'| PROVISIONING_CERTIFICATE | '
'PROVISIONING_SERVICE | '
'CREATING_DEPLOYMENT | '
'EVALUATING_HEALTH_CHECK | '
'ACTIVATING_DEPLOYMENT | '
'CERTIFICATE_LIMIT_EXCEEDED | '
'UNKNOWN_ERROR',
'message': 'string'}}}
Creates an Amazon Lightsail container service.
A Lightsail container service is a compute resource to which you can deploy containers. For more information, see Container services in Amazon Lightsail in the Lightsail Dev Guide .
See also: AWS API Documentation
Request Syntax
client.create_container_service(
serviceName='string',
power='nano'|'micro'|'small'|'medium'|'large'|'xlarge',
scale=123,
tags=[
{
'key': 'string',
'value': 'string'
},
],
publicDomainNames={
'string': [
'string',
]
},
deployment={
'containers': {
'string': {
'image': 'string',
'command': [
'string',
],
'environment': {
'string': 'string'
},
'ports': {
'string': 'HTTP'|'HTTPS'|'TCP'|'UDP'
}
}
},
'publicEndpoint': {
'containerName': 'string',
'containerPort': 123,
'healthCheck': {
'healthyThreshold': 123,
'unhealthyThreshold': 123,
'timeoutSeconds': 123,
'intervalSeconds': 123,
'path': 'string',
'successCodes': 'string'
}
}
}
)
string
[REQUIRED]
The name for the container service.
The name that you specify for your container service will make up part of its default domain. The default domain of a container service is typically https://<ServiceName>.<RandomGUID>.<AWSRegion>.cs.amazonlightsail.com . If the name of your container service is container-service-1 , and it's located in the US East (Ohio) AWS region (us-east-2 ), then the domain for your container service will be like the following example: https://container-service-1.ur4EXAMPLE2uq.us-east-2.cs.amazonlightsail.com
The following are the requirements for container service names:
Must be unique within each AWS Region in your Lightsail account.
Must contain 1 to 63 characters.
Must contain only alphanumeric characters and hyphens.
A hyphen (-) can separate words but cannot be at the start or end of the name.
string
[REQUIRED]
The power specification for the container service.
The power specifies the amount of memory, vCPUs, and base monthly cost of each node of the container service. The power and scale of a container service makes up its configured capacity. To determine the monthly price of your container service, multiply the base price of the power with the scale (the number of nodes) of the service.
Use the GetContainerServicePowers action to get a list of power options that you can specify using this parameter, and their base monthly cost.
integer
[REQUIRED]
The scale specification for the container service.
The scale specifies the allocated compute nodes of the container service. The power and scale of a container service makes up its configured capacity. To determine the monthly price of your container service, multiply the base price of the power with the scale (the number of nodes) of the service.
list
The tag keys and optional values for the container service.
For more information about tags in Lightsail, see the Lightsail Dev Guide .
(dict) --
Describes a tag key and optional value assigned to an Amazon Lightsail resource.
For more information about tags in Lightsail, see the Lightsail Dev Guide .
key (string) --
The key of the tag.
Constraints: Tag keys accept a maximum of 128 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @
value (string) --
The value of the tag.
Constraints: Tag values accept a maximum of 256 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @
dict
The public domain names to use with 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.
Warning
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.
You can specify public domain names using a string to array map as shown in the example later on this page.
(string) --
(list) --
(string) --
dict
An object that describes a deployment for the container service.
A deployment specifies the containers that will be launched on the container service and their settings, such as the ports to open, the environment variables to apply, and the launch command to run. It also specifies the container that will serve as the public endpoint of the deployment and its settings, such as the HTTP or HTTPS port to use, and the health check configuration.
containers (dict) --
An object that describes the configuration for the containers of the deployment.
(string) --
(dict) --
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) --
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (: ). For example, :container-service-1.mystaticwebsite.1 . Container images sourced from a public registry like Docker Hub don't start with a colon. For example, nginx:latest or nginx .
command (list) --
The launch command for the container.
(string) --
environment (dict) --
The environment variables of the container.
(string) --
(string) --
ports (dict) --
The open firewall ports of the container.
(string) --
(string) --
publicEndpoint (dict) --
An object that describes the endpoint of the deployment.
containerName (string) -- [REQUIRED]
The name of the container for the endpoint.
containerPort (integer) -- [REQUIRED]
The port of the container to which traffic is forwarded to.
healthCheck (dict) --
An object that describes the health check configuration of the container.
healthyThreshold (integer) --
The number of consecutive health checks successes required before moving the container to the Healthy state. The default value is 2 .
unhealthyThreshold (integer) --
The number of consecutive health check failures required before moving the container to the Unhealthy state. The default value is 2 .
timeoutSeconds (integer) --
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is 2 .
intervalSeconds (integer) --
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is 5 .
path (string) --
The path on the container on which to perform the health check. The default value is / .
successCodes (string) --
The HTTP codes to use when checking for a successful response from a container. You can specify values between 200 and 499.
dict
Response Syntax
{
'containerService': {
'containerServiceName': 'string',
'arn': 'string',
'createdAt': datetime(2015, 1, 1),
'location': {
'availabilityZone': 'string',
'regionName': 'us-east-1'|'us-east-2'|'us-west-1'|'us-west-2'|'eu-west-1'|'eu-west-2'|'eu-west-3'|'eu-central-1'|'ca-central-1'|'ap-south-1'|'ap-southeast-1'|'ap-southeast-2'|'ap-northeast-1'|'ap-northeast-2'
},
'resourceType': 'ContainerService'|'Instance'|'StaticIp'|'KeyPair'|'InstanceSnapshot'|'Domain'|'PeeredVpc'|'LoadBalancer'|'LoadBalancerTlsCertificate'|'Disk'|'DiskSnapshot'|'RelationalDatabase'|'RelationalDatabaseSnapshot'|'ExportSnapshotRecord'|'CloudFormationStackRecord'|'Alarm'|'ContactMethod'|'Distribution'|'Certificate',
'tags': [
{
'key': 'string',
'value': 'string'
},
],
'power': 'nano'|'micro'|'small'|'medium'|'large'|'xlarge',
'powerId': 'string',
'state': 'PENDING'|'READY'|'RUNNING'|'UPDATING'|'DELETING'|'DISABLED'|'DEPLOYING',
'stateDetail': {
'code': 'CREATING_SYSTEM_RESOURCES'|'CREATING_NETWORK_INFRASTRUCTURE'|'PROVISIONING_CERTIFICATE'|'PROVISIONING_SERVICE'|'CREATING_DEPLOYMENT'|'EVALUATING_HEALTH_CHECK'|'ACTIVATING_DEPLOYMENT'|'CERTIFICATE_LIMIT_EXCEEDED'|'UNKNOWN_ERROR',
'message': 'string'
},
'scale': 123,
'currentDeployment': {
'version': 123,
'state': 'ACTIVATING'|'ACTIVE'|'INACTIVE'|'FAILED',
'containers': {
'string': {
'image': 'string',
'command': [
'string',
],
'environment': {
'string': 'string'
},
'ports': {
'string': 'HTTP'|'HTTPS'|'TCP'|'UDP'
}
}
},
'publicEndpoint': {
'containerName': 'string',
'containerPort': 123,
'healthCheck': {
'healthyThreshold': 123,
'unhealthyThreshold': 123,
'timeoutSeconds': 123,
'intervalSeconds': 123,
'path': 'string',
'successCodes': 'string'
}
},
'createdAt': datetime(2015, 1, 1)
},
'nextDeployment': {
'version': 123,
'state': 'ACTIVATING'|'ACTIVE'|'INACTIVE'|'FAILED',
'containers': {
'string': {
'image': 'string',
'command': [
'string',
],
'environment': {
'string': 'string'
},
'ports': {
'string': 'HTTP'|'HTTPS'|'TCP'|'UDP'
}
}
},
'publicEndpoint': {
'containerName': 'string',
'containerPort': 123,
'healthCheck': {
'healthyThreshold': 123,
'unhealthyThreshold': 123,
'timeoutSeconds': 123,
'intervalSeconds': 123,
'path': 'string',
'successCodes': 'string'
}
},
'createdAt': datetime(2015, 1, 1)
},
'isDisabled': True|False,
'principalArn': 'string',
'privateDomainName': 'string',
'publicDomainNames': {
'string': [
'string',
]
},
'url': 'string'
}
}
Response Structure
(dict) --
containerService (dict) --
An object that describes a container service.
containerServiceName (string) --
The name of the container service.
arn (string) --
The Amazon Resource Name (ARN) of the container service.
createdAt (datetime) --
The timestamp when the container service was created.
location (dict) --
An object that describes the location of the container service, such as the AWS Region and Availability Zone.
availabilityZone (string) --
The Availability Zone. Follows the format us-east-2a (case-sensitive).
regionName (string) --
The AWS Region name.
resourceType (string) --
The Lightsail resource type of the container service (i.e., ContainerService ).
tags (list) --
The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Lightsail Dev Guide .
(dict) --
Describes a tag key and optional value assigned to an Amazon Lightsail resource.
For more information about tags in Lightsail, see the Lightsail Dev Guide .
key (string) --
The key of the tag.
Constraints: Tag keys accept a maximum of 128 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @
value (string) --
The value of the tag.
Constraints: Tag values accept a maximum of 256 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @
power (string) --
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 (string) --
The ID of the power of the container service.
state (string) --
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 (dict) --
An object that describes the current state of the container service.
Note
The state detail is populated only when a container service is in a PENDING , DEPLOYING , or UPDATING state.
code (string) --
The state code of the container service.
The following state codes are possible:
The following state codes are possible if your container service is in a DEPLOYING or UPDATING state:
CREATING_SYSTEM_RESOURCES - The system resources for your container service are being created.
CREATING_NETWORK_INFRASTRUCTURE - The network infrastructure for your container service are being created.
PROVISIONING_CERTIFICATE - The SSL/TLS certificate for your container service is being created.
PROVISIONING_SERVICE - Your container service is being provisioned.
CREATING_DEPLOYMENT - Your deployment is being created on your container service.
EVALUATING_HEALTH_CHECK - The health of your deployment is being evaluated.
ACTIVATING_DEPLOYMENT - Your deployment is being activated.
The following state codes are possible if your container service is in a PENDING state:
CERTIFICATE_LIMIT_EXCEEDED - The SSL/TLS certificate required for your container service exceeds the maximum number of certificates allowed for your account.
UNKNOWN_ERROR - An error was experienced when your container service was being created.
message (string) --
A message that provides more information for the state code.
Note
The state detail is populated only when a container service is in a PENDING , DEPLOYING , or UPDATING state.
scale (integer) --
The scale specification of the container service.
The scale specifies the allocated compute nodes of the container service.
currentDeployment (dict) --
An object that describes the current container deployment of the container service.
version (integer) --
The version number of the deployment.
state (string) --
The state of the deployment.
A deployment can be in one of the following states:
Activating - The deployment is being created.
Active - The deployment was successfully created, and it's currently running on the container service. The container service can have only one deployment in an active state at a time.
Inactive - The deployment was previously successfully created, but it is not currently running on the container service.
Failed - The deployment failed. Use the GetContainerLog action to view the log events for the containers in the deployment to try to determine the reason for the failure.
containers (dict) --
An object that describes the configuration for the containers of the deployment.
(string) --
(dict) --
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) --
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (: ). For example, :container-service-1.mystaticwebsite.1 . Container images sourced from a public registry like Docker Hub don't start with a colon. For example, nginx:latest or nginx .
command (list) --
The launch command for the container.
(string) --
environment (dict) --
The environment variables of the container.
(string) --
(string) --
ports (dict) --
The open firewall ports of the container.
(string) --
(string) --
publicEndpoint (dict) --
An object that describes the endpoint of the deployment.
containerName (string) --
The name of the container entry of the deployment that the endpoint configuration applies to.
containerPort (integer) --
The port of the specified container to which traffic is forwarded to.
healthCheck (dict) --
An object that describes the health check configuration of the container.
healthyThreshold (integer) --
The number of consecutive health checks successes required before moving the container to the Healthy state. The default value is 2 .
unhealthyThreshold (integer) --
The number of consecutive health check failures required before moving the container to the Unhealthy state. The default value is 2 .
timeoutSeconds (integer) --
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is 2 .
intervalSeconds (integer) --
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is 5 .
path (string) --
The path on the container on which to perform the health check. The default value is / .
successCodes (string) --
The HTTP codes to use when checking for a successful response from a container. You can specify values between 200 and 499.
createdAt (datetime) --
The timestamp when the deployment was created.
nextDeployment (dict) --
An object that describes the next deployment of the container service.
This value is null when there is no deployment in a pending state.
version (integer) --
The version number of the deployment.
state (string) --
The state of the deployment.
A deployment can be in one of the following states:
Activating - The deployment is being created.
Active - The deployment was successfully created, and it's currently running on the container service. The container service can have only one deployment in an active state at a time.
Inactive - The deployment was previously successfully created, but it is not currently running on the container service.
Failed - The deployment failed. Use the GetContainerLog action to view the log events for the containers in the deployment to try to determine the reason for the failure.
containers (dict) --
An object that describes the configuration for the containers of the deployment.
(string) --
(dict) --
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) --
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (: ). For example, :container-service-1.mystaticwebsite.1 . Container images sourced from a public registry like Docker Hub don't start with a colon. For example, nginx:latest or nginx .
command (list) --
The launch command for the container.
(string) --
environment (dict) --
The environment variables of the container.
(string) --
(string) --
ports (dict) --
The open firewall ports of the container.
(string) --
(string) --
publicEndpoint (dict) --
An object that describes the endpoint of the deployment.
containerName (string) --
The name of the container entry of the deployment that the endpoint configuration applies to.
containerPort (integer) --
The port of the specified container to which traffic is forwarded to.
healthCheck (dict) --
An object that describes the health check configuration of the container.
healthyThreshold (integer) --
The number of consecutive health checks successes required before moving the container to the Healthy state. The default value is 2 .
unhealthyThreshold (integer) --
The number of consecutive health check failures required before moving the container to the Unhealthy state. The default value is 2 .
timeoutSeconds (integer) --
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is 2 .
intervalSeconds (integer) --
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is 5 .
path (string) --
The path on the container on which to perform the health check. The default value is / .
successCodes (string) --
The HTTP codes to use when checking for a successful response from a container. You can specify values between 200 and 499.
createdAt (datetime) --
The timestamp when the deployment was created.
isDisabled (boolean) --
A Boolean value indicating whether the container service is disabled.
principalArn (string) --
The principal ARN of the container service.
The principal ARN can be used to create a trust relationship between your standard AWS account and your Lightsail container service. This allows you to give your service permission to access resources in your standard AWS account.
privateDomainName (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.
publicDomainNames (dict) --
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.
Warning
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.
(string) --
(list) --
(string) --
url (string) --
The publicly accessible URL of the container service.
If no public endpoint is specified in the currentDeployment , this URL returns a 404 response.
{'containerService': {'state': {'DEPLOYING'},
'stateDetail': {'code': 'CREATING_SYSTEM_RESOURCES | '
'CREATING_NETWORK_INFRASTRUCTURE '
'| PROVISIONING_CERTIFICATE | '
'PROVISIONING_SERVICE | '
'CREATING_DEPLOYMENT | '
'EVALUATING_HEALTH_CHECK | '
'ACTIVATING_DEPLOYMENT | '
'CERTIFICATE_LIMIT_EXCEEDED | '
'UNKNOWN_ERROR',
'message': 'string'}}}
Creates a deployment for your Amazon Lightsail container service.
A deployment specifies the containers that will be launched on the container service and their settings, such as the ports to open, the environment variables to apply, and the launch command to run. It also specifies the container that will serve as the public endpoint of the deployment and its settings, such as the HTTP or HTTPS port to use, and the health check configuration.
You can deploy containers to your container service using container images from a public registry like Docker Hub, or from your local machine. For more information, see Creating container images for your Amazon Lightsail container services in the Lightsail Dev Guide .
See also: AWS API Documentation
Request Syntax
client.create_container_service_deployment(
serviceName='string',
containers={
'string': {
'image': 'string',
'command': [
'string',
],
'environment': {
'string': 'string'
},
'ports': {
'string': 'HTTP'|'HTTPS'|'TCP'|'UDP'
}
}
},
publicEndpoint={
'containerName': 'string',
'containerPort': 123,
'healthCheck': {
'healthyThreshold': 123,
'unhealthyThreshold': 123,
'timeoutSeconds': 123,
'intervalSeconds': 123,
'path': 'string',
'successCodes': 'string'
}
}
)
string
[REQUIRED]
The name of the container service for which to create the deployment.
dict
An object that describes the settings of the containers that will be launched on the container service.
(string) --
(dict) --
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) --
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (: ). For example, :container-service-1.mystaticwebsite.1 . Container images sourced from a public registry like Docker Hub don't start with a colon. For example, nginx:latest or nginx .
command (list) --
The launch command for the container.
(string) --
environment (dict) --
The environment variables of the container.
(string) --
(string) --
ports (dict) --
The open firewall ports of the container.
(string) --
(string) --
dict
An object that describes the settings of the public endpoint for the container service.
containerName (string) -- [REQUIRED]
The name of the container for the endpoint.
containerPort (integer) -- [REQUIRED]
The port of the container to which traffic is forwarded to.
healthCheck (dict) --
An object that describes the health check configuration of the container.
healthyThreshold (integer) --
The number of consecutive health checks successes required before moving the container to the Healthy state. The default value is 2 .
unhealthyThreshold (integer) --
The number of consecutive health check failures required before moving the container to the Unhealthy state. The default value is 2 .
timeoutSeconds (integer) --
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is 2 .
intervalSeconds (integer) --
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is 5 .
path (string) --
The path on the container on which to perform the health check. The default value is / .
successCodes (string) --
The HTTP codes to use when checking for a successful response from a container. You can specify values between 200 and 499.
dict
Response Syntax
{
'containerService': {
'containerServiceName': 'string',
'arn': 'string',
'createdAt': datetime(2015, 1, 1),
'location': {
'availabilityZone': 'string',
'regionName': 'us-east-1'|'us-east-2'|'us-west-1'|'us-west-2'|'eu-west-1'|'eu-west-2'|'eu-west-3'|'eu-central-1'|'ca-central-1'|'ap-south-1'|'ap-southeast-1'|'ap-southeast-2'|'ap-northeast-1'|'ap-northeast-2'
},
'resourceType': 'ContainerService'|'Instance'|'StaticIp'|'KeyPair'|'InstanceSnapshot'|'Domain'|'PeeredVpc'|'LoadBalancer'|'LoadBalancerTlsCertificate'|'Disk'|'DiskSnapshot'|'RelationalDatabase'|'RelationalDatabaseSnapshot'|'ExportSnapshotRecord'|'CloudFormationStackRecord'|'Alarm'|'ContactMethod'|'Distribution'|'Certificate',
'tags': [
{
'key': 'string',
'value': 'string'
},
],
'power': 'nano'|'micro'|'small'|'medium'|'large'|'xlarge',
'powerId': 'string',
'state': 'PENDING'|'READY'|'RUNNING'|'UPDATING'|'DELETING'|'DISABLED'|'DEPLOYING',
'stateDetail': {
'code': 'CREATING_SYSTEM_RESOURCES'|'CREATING_NETWORK_INFRASTRUCTURE'|'PROVISIONING_CERTIFICATE'|'PROVISIONING_SERVICE'|'CREATING_DEPLOYMENT'|'EVALUATING_HEALTH_CHECK'|'ACTIVATING_DEPLOYMENT'|'CERTIFICATE_LIMIT_EXCEEDED'|'UNKNOWN_ERROR',
'message': 'string'
},
'scale': 123,
'currentDeployment': {
'version': 123,
'state': 'ACTIVATING'|'ACTIVE'|'INACTIVE'|'FAILED',
'containers': {
'string': {
'image': 'string',
'command': [
'string',
],
'environment': {
'string': 'string'
},
'ports': {
'string': 'HTTP'|'HTTPS'|'TCP'|'UDP'
}
}
},
'publicEndpoint': {
'containerName': 'string',
'containerPort': 123,
'healthCheck': {
'healthyThreshold': 123,
'unhealthyThreshold': 123,
'timeoutSeconds': 123,
'intervalSeconds': 123,
'path': 'string',
'successCodes': 'string'
}
},
'createdAt': datetime(2015, 1, 1)
},
'nextDeployment': {
'version': 123,
'state': 'ACTIVATING'|'ACTIVE'|'INACTIVE'|'FAILED',
'containers': {
'string': {
'image': 'string',
'command': [
'string',
],
'environment': {
'string': 'string'
},
'ports': {
'string': 'HTTP'|'HTTPS'|'TCP'|'UDP'
}
}
},
'publicEndpoint': {
'containerName': 'string',
'containerPort': 123,
'healthCheck': {
'healthyThreshold': 123,
'unhealthyThreshold': 123,
'timeoutSeconds': 123,
'intervalSeconds': 123,
'path': 'string',
'successCodes': 'string'
}
},
'createdAt': datetime(2015, 1, 1)
},
'isDisabled': True|False,
'principalArn': 'string',
'privateDomainName': 'string',
'publicDomainNames': {
'string': [
'string',
]
},
'url': 'string'
}
}
Response Structure
(dict) --
containerService (dict) --
An object that describes a container service.
containerServiceName (string) --
The name of the container service.
arn (string) --
The Amazon Resource Name (ARN) of the container service.
createdAt (datetime) --
The timestamp when the container service was created.
location (dict) --
An object that describes the location of the container service, such as the AWS Region and Availability Zone.
availabilityZone (string) --
The Availability Zone. Follows the format us-east-2a (case-sensitive).
regionName (string) --
The AWS Region name.
resourceType (string) --
The Lightsail resource type of the container service (i.e., ContainerService ).
tags (list) --
The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Lightsail Dev Guide .
(dict) --
Describes a tag key and optional value assigned to an Amazon Lightsail resource.
For more information about tags in Lightsail, see the Lightsail Dev Guide .
key (string) --
The key of the tag.
Constraints: Tag keys accept a maximum of 128 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @
value (string) --
The value of the tag.
Constraints: Tag values accept a maximum of 256 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @
power (string) --
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 (string) --
The ID of the power of the container service.
state (string) --
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 (dict) --
An object that describes the current state of the container service.
Note
The state detail is populated only when a container service is in a PENDING , DEPLOYING , or UPDATING state.
code (string) --
The state code of the container service.
The following state codes are possible:
The following state codes are possible if your container service is in a DEPLOYING or UPDATING state:
CREATING_SYSTEM_RESOURCES - The system resources for your container service are being created.
CREATING_NETWORK_INFRASTRUCTURE - The network infrastructure for your container service are being created.
PROVISIONING_CERTIFICATE - The SSL/TLS certificate for your container service is being created.
PROVISIONING_SERVICE - Your container service is being provisioned.
CREATING_DEPLOYMENT - Your deployment is being created on your container service.
EVALUATING_HEALTH_CHECK - The health of your deployment is being evaluated.
ACTIVATING_DEPLOYMENT - Your deployment is being activated.
The following state codes are possible if your container service is in a PENDING state:
CERTIFICATE_LIMIT_EXCEEDED - The SSL/TLS certificate required for your container service exceeds the maximum number of certificates allowed for your account.
UNKNOWN_ERROR - An error was experienced when your container service was being created.
message (string) --
A message that provides more information for the state code.
Note
The state detail is populated only when a container service is in a PENDING , DEPLOYING , or UPDATING state.
scale (integer) --
The scale specification of the container service.
The scale specifies the allocated compute nodes of the container service.
currentDeployment (dict) --
An object that describes the current container deployment of the container service.
version (integer) --
The version number of the deployment.
state (string) --
The state of the deployment.
A deployment can be in one of the following states:
Activating - The deployment is being created.
Active - The deployment was successfully created, and it's currently running on the container service. The container service can have only one deployment in an active state at a time.
Inactive - The deployment was previously successfully created, but it is not currently running on the container service.
Failed - The deployment failed. Use the GetContainerLog action to view the log events for the containers in the deployment to try to determine the reason for the failure.
containers (dict) --
An object that describes the configuration for the containers of the deployment.
(string) --
(dict) --
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) --
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (: ). For example, :container-service-1.mystaticwebsite.1 . Container images sourced from a public registry like Docker Hub don't start with a colon. For example, nginx:latest or nginx .
command (list) --
The launch command for the container.
(string) --
environment (dict) --
The environment variables of the container.
(string) --
(string) --
ports (dict) --
The open firewall ports of the container.
(string) --
(string) --
publicEndpoint (dict) --
An object that describes the endpoint of the deployment.
containerName (string) --
The name of the container entry of the deployment that the endpoint configuration applies to.
containerPort (integer) --
The port of the specified container to which traffic is forwarded to.
healthCheck (dict) --
An object that describes the health check configuration of the container.
healthyThreshold (integer) --
The number of consecutive health checks successes required before moving the container to the Healthy state. The default value is 2 .
unhealthyThreshold (integer) --
The number of consecutive health check failures required before moving the container to the Unhealthy state. The default value is 2 .
timeoutSeconds (integer) --
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is 2 .
intervalSeconds (integer) --
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is 5 .
path (string) --
The path on the container on which to perform the health check. The default value is / .
successCodes (string) --
The HTTP codes to use when checking for a successful response from a container. You can specify values between 200 and 499.
createdAt (datetime) --
The timestamp when the deployment was created.
nextDeployment (dict) --
An object that describes the next deployment of the container service.
This value is null when there is no deployment in a pending state.
version (integer) --
The version number of the deployment.
state (string) --
The state of the deployment.
A deployment can be in one of the following states:
Activating - The deployment is being created.
Active - The deployment was successfully created, and it's currently running on the container service. The container service can have only one deployment in an active state at a time.
Inactive - The deployment was previously successfully created, but it is not currently running on the container service.
Failed - The deployment failed. Use the GetContainerLog action to view the log events for the containers in the deployment to try to determine the reason for the failure.
containers (dict) --
An object that describes the configuration for the containers of the deployment.
(string) --
(dict) --
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) --
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (: ). For example, :container-service-1.mystaticwebsite.1 . Container images sourced from a public registry like Docker Hub don't start with a colon. For example, nginx:latest or nginx .
command (list) --
The launch command for the container.
(string) --
environment (dict) --
The environment variables of the container.
(string) --
(string) --
ports (dict) --
The open firewall ports of the container.
(string) --
(string) --
publicEndpoint (dict) --
An object that describes the endpoint of the deployment.
containerName (string) --
The name of the container entry of the deployment that the endpoint configuration applies to.
containerPort (integer) --
The port of the specified container to which traffic is forwarded to.
healthCheck (dict) --
An object that describes the health check configuration of the container.
healthyThreshold (integer) --
The number of consecutive health checks successes required before moving the container to the Healthy state. The default value is 2 .
unhealthyThreshold (integer) --
The number of consecutive health check failures required before moving the container to the Unhealthy state. The default value is 2 .
timeoutSeconds (integer) --
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is 2 .
intervalSeconds (integer) --
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is 5 .
path (string) --
The path on the container on which to perform the health check. The default value is / .
successCodes (string) --
The HTTP codes to use when checking for a successful response from a container. You can specify values between 200 and 499.
createdAt (datetime) --
The timestamp when the deployment was created.
isDisabled (boolean) --
A Boolean value indicating whether the container service is disabled.
principalArn (string) --
The principal ARN of the container service.
The principal ARN can be used to create a trust relationship between your standard AWS account and your Lightsail container service. This allows you to give your service permission to access resources in your standard AWS account.
privateDomainName (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.
publicDomainNames (dict) --
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.
Warning
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.
(string) --
(list) --
(string) --
url (string) --
The publicly accessible URL of the container service.
If no public endpoint is specified in the currentDeployment , this URL returns a 404 response.
{'containerServices': {'state': {'DEPLOYING'},
'stateDetail': {'code': 'CREATING_SYSTEM_RESOURCES | '
'CREATING_NETWORK_INFRASTRUCTURE '
'| PROVISIONING_CERTIFICATE | '
'PROVISIONING_SERVICE | '
'CREATING_DEPLOYMENT | '
'EVALUATING_HEALTH_CHECK | '
'ACTIVATING_DEPLOYMENT | '
'CERTIFICATE_LIMIT_EXCEEDED | '
'UNKNOWN_ERROR',
'message': 'string'}}}
Returns information about one or more of your Amazon Lightsail container services.
See also: AWS API Documentation
Request Syntax
client.get_container_services(
serviceName='string'
)
string
The name of the container service for which to return information.
When omitted, the response includes all of your container services in the AWS Region where the request is made.
dict
Response Syntax
{
'containerServices': [
{
'containerServiceName': 'string',
'arn': 'string',
'createdAt': datetime(2015, 1, 1),
'location': {
'availabilityZone': 'string',
'regionName': 'us-east-1'|'us-east-2'|'us-west-1'|'us-west-2'|'eu-west-1'|'eu-west-2'|'eu-west-3'|'eu-central-1'|'ca-central-1'|'ap-south-1'|'ap-southeast-1'|'ap-southeast-2'|'ap-northeast-1'|'ap-northeast-2'
},
'resourceType': 'ContainerService'|'Instance'|'StaticIp'|'KeyPair'|'InstanceSnapshot'|'Domain'|'PeeredVpc'|'LoadBalancer'|'LoadBalancerTlsCertificate'|'Disk'|'DiskSnapshot'|'RelationalDatabase'|'RelationalDatabaseSnapshot'|'ExportSnapshotRecord'|'CloudFormationStackRecord'|'Alarm'|'ContactMethod'|'Distribution'|'Certificate',
'tags': [
{
'key': 'string',
'value': 'string'
},
],
'power': 'nano'|'micro'|'small'|'medium'|'large'|'xlarge',
'powerId': 'string',
'state': 'PENDING'|'READY'|'RUNNING'|'UPDATING'|'DELETING'|'DISABLED'|'DEPLOYING',
'stateDetail': {
'code': 'CREATING_SYSTEM_RESOURCES'|'CREATING_NETWORK_INFRASTRUCTURE'|'PROVISIONING_CERTIFICATE'|'PROVISIONING_SERVICE'|'CREATING_DEPLOYMENT'|'EVALUATING_HEALTH_CHECK'|'ACTIVATING_DEPLOYMENT'|'CERTIFICATE_LIMIT_EXCEEDED'|'UNKNOWN_ERROR',
'message': 'string'
},
'scale': 123,
'currentDeployment': {
'version': 123,
'state': 'ACTIVATING'|'ACTIVE'|'INACTIVE'|'FAILED',
'containers': {
'string': {
'image': 'string',
'command': [
'string',
],
'environment': {
'string': 'string'
},
'ports': {
'string': 'HTTP'|'HTTPS'|'TCP'|'UDP'
}
}
},
'publicEndpoint': {
'containerName': 'string',
'containerPort': 123,
'healthCheck': {
'healthyThreshold': 123,
'unhealthyThreshold': 123,
'timeoutSeconds': 123,
'intervalSeconds': 123,
'path': 'string',
'successCodes': 'string'
}
},
'createdAt': datetime(2015, 1, 1)
},
'nextDeployment': {
'version': 123,
'state': 'ACTIVATING'|'ACTIVE'|'INACTIVE'|'FAILED',
'containers': {
'string': {
'image': 'string',
'command': [
'string',
],
'environment': {
'string': 'string'
},
'ports': {
'string': 'HTTP'|'HTTPS'|'TCP'|'UDP'
}
}
},
'publicEndpoint': {
'containerName': 'string',
'containerPort': 123,
'healthCheck': {
'healthyThreshold': 123,
'unhealthyThreshold': 123,
'timeoutSeconds': 123,
'intervalSeconds': 123,
'path': 'string',
'successCodes': 'string'
}
},
'createdAt': datetime(2015, 1, 1)
},
'isDisabled': True|False,
'principalArn': 'string',
'privateDomainName': 'string',
'publicDomainNames': {
'string': [
'string',
]
},
'url': 'string'
},
]
}
Response Structure
(dict) --
containerServices (list) --
An array of objects that describe one or more container services.
(dict) --
Describes an Amazon Lightsail container service.
containerServiceName (string) --
The name of the container service.
arn (string) --
The Amazon Resource Name (ARN) of the container service.
createdAt (datetime) --
The timestamp when the container service was created.
location (dict) --
An object that describes the location of the container service, such as the AWS Region and Availability Zone.
availabilityZone (string) --
The Availability Zone. Follows the format us-east-2a (case-sensitive).
regionName (string) --
The AWS Region name.
resourceType (string) --
The Lightsail resource type of the container service (i.e., ContainerService ).
tags (list) --
The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Lightsail Dev Guide .
(dict) --
Describes a tag key and optional value assigned to an Amazon Lightsail resource.
For more information about tags in Lightsail, see the Lightsail Dev Guide .
key (string) --
The key of the tag.
Constraints: Tag keys accept a maximum of 128 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @
value (string) --
The value of the tag.
Constraints: Tag values accept a maximum of 256 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @
power (string) --
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 (string) --
The ID of the power of the container service.
state (string) --
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 (dict) --
An object that describes the current state of the container service.
Note
The state detail is populated only when a container service is in a PENDING , DEPLOYING , or UPDATING state.
code (string) --
The state code of the container service.
The following state codes are possible:
The following state codes are possible if your container service is in a DEPLOYING or UPDATING state:
CREATING_SYSTEM_RESOURCES - The system resources for your container service are being created.
CREATING_NETWORK_INFRASTRUCTURE - The network infrastructure for your container service are being created.
PROVISIONING_CERTIFICATE - The SSL/TLS certificate for your container service is being created.
PROVISIONING_SERVICE - Your container service is being provisioned.
CREATING_DEPLOYMENT - Your deployment is being created on your container service.
EVALUATING_HEALTH_CHECK - The health of your deployment is being evaluated.
ACTIVATING_DEPLOYMENT - Your deployment is being activated.
The following state codes are possible if your container service is in a PENDING state:
CERTIFICATE_LIMIT_EXCEEDED - The SSL/TLS certificate required for your container service exceeds the maximum number of certificates allowed for your account.
UNKNOWN_ERROR - An error was experienced when your container service was being created.
message (string) --
A message that provides more information for the state code.
Note
The state detail is populated only when a container service is in a PENDING , DEPLOYING , or UPDATING state.
scale (integer) --
The scale specification of the container service.
The scale specifies the allocated compute nodes of the container service.
currentDeployment (dict) --
An object that describes the current container deployment of the container service.
version (integer) --
The version number of the deployment.
state (string) --
The state of the deployment.
A deployment can be in one of the following states:
Activating - The deployment is being created.
Active - The deployment was successfully created, and it's currently running on the container service. The container service can have only one deployment in an active state at a time.
Inactive - The deployment was previously successfully created, but it is not currently running on the container service.
Failed - The deployment failed. Use the GetContainerLog action to view the log events for the containers in the deployment to try to determine the reason for the failure.
containers (dict) --
An object that describes the configuration for the containers of the deployment.
(string) --
(dict) --
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) --
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (: ). For example, :container-service-1.mystaticwebsite.1 . Container images sourced from a public registry like Docker Hub don't start with a colon. For example, nginx:latest or nginx .
command (list) --
The launch command for the container.
(string) --
environment (dict) --
The environment variables of the container.
(string) --
(string) --
ports (dict) --
The open firewall ports of the container.
(string) --
(string) --
publicEndpoint (dict) --
An object that describes the endpoint of the deployment.
containerName (string) --
The name of the container entry of the deployment that the endpoint configuration applies to.
containerPort (integer) --
The port of the specified container to which traffic is forwarded to.
healthCheck (dict) --
An object that describes the health check configuration of the container.
healthyThreshold (integer) --
The number of consecutive health checks successes required before moving the container to the Healthy state. The default value is 2 .
unhealthyThreshold (integer) --
The number of consecutive health check failures required before moving the container to the Unhealthy state. The default value is 2 .
timeoutSeconds (integer) --
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is 2 .
intervalSeconds (integer) --
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is 5 .
path (string) --
The path on the container on which to perform the health check. The default value is / .
successCodes (string) --
The HTTP codes to use when checking for a successful response from a container. You can specify values between 200 and 499.
createdAt (datetime) --
The timestamp when the deployment was created.
nextDeployment (dict) --
An object that describes the next deployment of the container service.
This value is null when there is no deployment in a pending state.
version (integer) --
The version number of the deployment.
state (string) --
The state of the deployment.
A deployment can be in one of the following states:
Activating - The deployment is being created.
Active - The deployment was successfully created, and it's currently running on the container service. The container service can have only one deployment in an active state at a time.
Inactive - The deployment was previously successfully created, but it is not currently running on the container service.
Failed - The deployment failed. Use the GetContainerLog action to view the log events for the containers in the deployment to try to determine the reason for the failure.
containers (dict) --
An object that describes the configuration for the containers of the deployment.
(string) --
(dict) --
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) --
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (: ). For example, :container-service-1.mystaticwebsite.1 . Container images sourced from a public registry like Docker Hub don't start with a colon. For example, nginx:latest or nginx .
command (list) --
The launch command for the container.
(string) --
environment (dict) --
The environment variables of the container.
(string) --
(string) --
ports (dict) --
The open firewall ports of the container.
(string) --
(string) --
publicEndpoint (dict) --
An object that describes the endpoint of the deployment.
containerName (string) --
The name of the container entry of the deployment that the endpoint configuration applies to.
containerPort (integer) --
The port of the specified container to which traffic is forwarded to.
healthCheck (dict) --
An object that describes the health check configuration of the container.
healthyThreshold (integer) --
The number of consecutive health checks successes required before moving the container to the Healthy state. The default value is 2 .
unhealthyThreshold (integer) --
The number of consecutive health check failures required before moving the container to the Unhealthy state. The default value is 2 .
timeoutSeconds (integer) --
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is 2 .
intervalSeconds (integer) --
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is 5 .
path (string) --
The path on the container on which to perform the health check. The default value is / .
successCodes (string) --
The HTTP codes to use when checking for a successful response from a container. You can specify values between 200 and 499.
createdAt (datetime) --
The timestamp when the deployment was created.
isDisabled (boolean) --
A Boolean value indicating whether the container service is disabled.
principalArn (string) --
The principal ARN of the container service.
The principal ARN can be used to create a trust relationship between your standard AWS account and your Lightsail container service. This allows you to give your service permission to access resources in your standard AWS account.
privateDomainName (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.
publicDomainNames (dict) --
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.
Warning
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.
(string) --
(list) --
(string) --
url (string) --
The publicly accessible URL of the container service.
If no public endpoint is specified in the currentDeployment , this URL returns a 404 response.
{'containerService': {'state': {'DEPLOYING'},
'stateDetail': {'code': 'CREATING_SYSTEM_RESOURCES | '
'CREATING_NETWORK_INFRASTRUCTURE '
'| PROVISIONING_CERTIFICATE | '
'PROVISIONING_SERVICE | '
'CREATING_DEPLOYMENT | '
'EVALUATING_HEALTH_CHECK | '
'ACTIVATING_DEPLOYMENT | '
'CERTIFICATE_LIMIT_EXCEEDED | '
'UNKNOWN_ERROR',
'message': 'string'}}}
Updates the configuration of your Amazon Lightsail container service, such as its power, scale, and public domain names.
See also: AWS API Documentation
Request Syntax
client.update_container_service(
serviceName='string',
power='nano'|'micro'|'small'|'medium'|'large'|'xlarge',
scale=123,
isDisabled=True|False,
publicDomainNames={
'string': [
'string',
]
}
)
string
[REQUIRED]
The name of the container service to update.
string
The power for the container service.
The power specifies the amount of memory, vCPUs, and base monthly cost of each node of the container service. The power and scale of a container service makes up its configured capacity. To determine the monthly price of your container service, multiply the base price of the power with the scale (the number of nodes) of the service.
Use the GetContainerServicePowers action to view the specifications of each power option.
integer
The scale for the container service.
The scale specifies the allocated compute nodes of the container service. The power and scale of a container service makes up its configured capacity. To determine the monthly price of your container service, multiply the base price of the power with the scale (the number of nodes) of the service.
boolean
A Boolean value to indicate whether the container service is disabled.
dict
The public domain names to use with 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.
Warning
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.
You can specify public domain names using a string to array map as shown in the example later on this page.
(string) --
(list) --
(string) --
dict
Response Syntax
{
'containerService': {
'containerServiceName': 'string',
'arn': 'string',
'createdAt': datetime(2015, 1, 1),
'location': {
'availabilityZone': 'string',
'regionName': 'us-east-1'|'us-east-2'|'us-west-1'|'us-west-2'|'eu-west-1'|'eu-west-2'|'eu-west-3'|'eu-central-1'|'ca-central-1'|'ap-south-1'|'ap-southeast-1'|'ap-southeast-2'|'ap-northeast-1'|'ap-northeast-2'
},
'resourceType': 'ContainerService'|'Instance'|'StaticIp'|'KeyPair'|'InstanceSnapshot'|'Domain'|'PeeredVpc'|'LoadBalancer'|'LoadBalancerTlsCertificate'|'Disk'|'DiskSnapshot'|'RelationalDatabase'|'RelationalDatabaseSnapshot'|'ExportSnapshotRecord'|'CloudFormationStackRecord'|'Alarm'|'ContactMethod'|'Distribution'|'Certificate',
'tags': [
{
'key': 'string',
'value': 'string'
},
],
'power': 'nano'|'micro'|'small'|'medium'|'large'|'xlarge',
'powerId': 'string',
'state': 'PENDING'|'READY'|'RUNNING'|'UPDATING'|'DELETING'|'DISABLED'|'DEPLOYING',
'stateDetail': {
'code': 'CREATING_SYSTEM_RESOURCES'|'CREATING_NETWORK_INFRASTRUCTURE'|'PROVISIONING_CERTIFICATE'|'PROVISIONING_SERVICE'|'CREATING_DEPLOYMENT'|'EVALUATING_HEALTH_CHECK'|'ACTIVATING_DEPLOYMENT'|'CERTIFICATE_LIMIT_EXCEEDED'|'UNKNOWN_ERROR',
'message': 'string'
},
'scale': 123,
'currentDeployment': {
'version': 123,
'state': 'ACTIVATING'|'ACTIVE'|'INACTIVE'|'FAILED',
'containers': {
'string': {
'image': 'string',
'command': [
'string',
],
'environment': {
'string': 'string'
},
'ports': {
'string': 'HTTP'|'HTTPS'|'TCP'|'UDP'
}
}
},
'publicEndpoint': {
'containerName': 'string',
'containerPort': 123,
'healthCheck': {
'healthyThreshold': 123,
'unhealthyThreshold': 123,
'timeoutSeconds': 123,
'intervalSeconds': 123,
'path': 'string',
'successCodes': 'string'
}
},
'createdAt': datetime(2015, 1, 1)
},
'nextDeployment': {
'version': 123,
'state': 'ACTIVATING'|'ACTIVE'|'INACTIVE'|'FAILED',
'containers': {
'string': {
'image': 'string',
'command': [
'string',
],
'environment': {
'string': 'string'
},
'ports': {
'string': 'HTTP'|'HTTPS'|'TCP'|'UDP'
}
}
},
'publicEndpoint': {
'containerName': 'string',
'containerPort': 123,
'healthCheck': {
'healthyThreshold': 123,
'unhealthyThreshold': 123,
'timeoutSeconds': 123,
'intervalSeconds': 123,
'path': 'string',
'successCodes': 'string'
}
},
'createdAt': datetime(2015, 1, 1)
},
'isDisabled': True|False,
'principalArn': 'string',
'privateDomainName': 'string',
'publicDomainNames': {
'string': [
'string',
]
},
'url': 'string'
}
}
Response Structure
(dict) --
containerService (dict) --
An object that describes a container service.
containerServiceName (string) --
The name of the container service.
arn (string) --
The Amazon Resource Name (ARN) of the container service.
createdAt (datetime) --
The timestamp when the container service was created.
location (dict) --
An object that describes the location of the container service, such as the AWS Region and Availability Zone.
availabilityZone (string) --
The Availability Zone. Follows the format us-east-2a (case-sensitive).
regionName (string) --
The AWS Region name.
resourceType (string) --
The Lightsail resource type of the container service (i.e., ContainerService ).
tags (list) --
The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Lightsail Dev Guide .
(dict) --
Describes a tag key and optional value assigned to an Amazon Lightsail resource.
For more information about tags in Lightsail, see the Lightsail Dev Guide .
key (string) --
The key of the tag.
Constraints: Tag keys accept a maximum of 128 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @
value (string) --
The value of the tag.
Constraints: Tag values accept a maximum of 256 letters, numbers, spaces in UTF-8, or the following characters: + - = . _ : / @
power (string) --
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 (string) --
The ID of the power of the container service.
state (string) --
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 (dict) --
An object that describes the current state of the container service.
Note
The state detail is populated only when a container service is in a PENDING , DEPLOYING , or UPDATING state.
code (string) --
The state code of the container service.
The following state codes are possible:
The following state codes are possible if your container service is in a DEPLOYING or UPDATING state:
CREATING_SYSTEM_RESOURCES - The system resources for your container service are being created.
CREATING_NETWORK_INFRASTRUCTURE - The network infrastructure for your container service are being created.
PROVISIONING_CERTIFICATE - The SSL/TLS certificate for your container service is being created.
PROVISIONING_SERVICE - Your container service is being provisioned.
CREATING_DEPLOYMENT - Your deployment is being created on your container service.
EVALUATING_HEALTH_CHECK - The health of your deployment is being evaluated.
ACTIVATING_DEPLOYMENT - Your deployment is being activated.
The following state codes are possible if your container service is in a PENDING state:
CERTIFICATE_LIMIT_EXCEEDED - The SSL/TLS certificate required for your container service exceeds the maximum number of certificates allowed for your account.
UNKNOWN_ERROR - An error was experienced when your container service was being created.
message (string) --
A message that provides more information for the state code.
Note
The state detail is populated only when a container service is in a PENDING , DEPLOYING , or UPDATING state.
scale (integer) --
The scale specification of the container service.
The scale specifies the allocated compute nodes of the container service.
currentDeployment (dict) --
An object that describes the current container deployment of the container service.
version (integer) --
The version number of the deployment.
state (string) --
The state of the deployment.
A deployment can be in one of the following states:
Activating - The deployment is being created.
Active - The deployment was successfully created, and it's currently running on the container service. The container service can have only one deployment in an active state at a time.
Inactive - The deployment was previously successfully created, but it is not currently running on the container service.
Failed - The deployment failed. Use the GetContainerLog action to view the log events for the containers in the deployment to try to determine the reason for the failure.
containers (dict) --
An object that describes the configuration for the containers of the deployment.
(string) --
(dict) --
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) --
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (: ). For example, :container-service-1.mystaticwebsite.1 . Container images sourced from a public registry like Docker Hub don't start with a colon. For example, nginx:latest or nginx .
command (list) --
The launch command for the container.
(string) --
environment (dict) --
The environment variables of the container.
(string) --
(string) --
ports (dict) --
The open firewall ports of the container.
(string) --
(string) --
publicEndpoint (dict) --
An object that describes the endpoint of the deployment.
containerName (string) --
The name of the container entry of the deployment that the endpoint configuration applies to.
containerPort (integer) --
The port of the specified container to which traffic is forwarded to.
healthCheck (dict) --
An object that describes the health check configuration of the container.
healthyThreshold (integer) --
The number of consecutive health checks successes required before moving the container to the Healthy state. The default value is 2 .
unhealthyThreshold (integer) --
The number of consecutive health check failures required before moving the container to the Unhealthy state. The default value is 2 .
timeoutSeconds (integer) --
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is 2 .
intervalSeconds (integer) --
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is 5 .
path (string) --
The path on the container on which to perform the health check. The default value is / .
successCodes (string) --
The HTTP codes to use when checking for a successful response from a container. You can specify values between 200 and 499.
createdAt (datetime) --
The timestamp when the deployment was created.
nextDeployment (dict) --
An object that describes the next deployment of the container service.
This value is null when there is no deployment in a pending state.
version (integer) --
The version number of the deployment.
state (string) --
The state of the deployment.
A deployment can be in one of the following states:
Activating - The deployment is being created.
Active - The deployment was successfully created, and it's currently running on the container service. The container service can have only one deployment in an active state at a time.
Inactive - The deployment was previously successfully created, but it is not currently running on the container service.
Failed - The deployment failed. Use the GetContainerLog action to view the log events for the containers in the deployment to try to determine the reason for the failure.
containers (dict) --
An object that describes the configuration for the containers of the deployment.
(string) --
(dict) --
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) --
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (: ). For example, :container-service-1.mystaticwebsite.1 . Container images sourced from a public registry like Docker Hub don't start with a colon. For example, nginx:latest or nginx .
command (list) --
The launch command for the container.
(string) --
environment (dict) --
The environment variables of the container.
(string) --
(string) --
ports (dict) --
The open firewall ports of the container.
(string) --
(string) --
publicEndpoint (dict) --
An object that describes the endpoint of the deployment.
containerName (string) --
The name of the container entry of the deployment that the endpoint configuration applies to.
containerPort (integer) --
The port of the specified container to which traffic is forwarded to.
healthCheck (dict) --
An object that describes the health check configuration of the container.
healthyThreshold (integer) --
The number of consecutive health checks successes required before moving the container to the Healthy state. The default value is 2 .
unhealthyThreshold (integer) --
The number of consecutive health check failures required before moving the container to the Unhealthy state. The default value is 2 .
timeoutSeconds (integer) --
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is 2 .
intervalSeconds (integer) --
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is 5 .
path (string) --
The path on the container on which to perform the health check. The default value is / .
successCodes (string) --
The HTTP codes to use when checking for a successful response from a container. You can specify values between 200 and 499.
createdAt (datetime) --
The timestamp when the deployment was created.
isDisabled (boolean) --
A Boolean value indicating whether the container service is disabled.
principalArn (string) --
The principal ARN of the container service.
The principal ARN can be used to create a trust relationship between your standard AWS account and your Lightsail container service. This allows you to give your service permission to access resources in your standard AWS account.
privateDomainName (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.
publicDomainNames (dict) --
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.
Warning
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.
(string) --
(list) --
(string) --
url (string) --
The publicly accessible URL of the container service.
If no public endpoint is specified in the currentDeployment , this URL returns a 404 response.