SHOW SERVICE INSTANCES IN SERVICE and SHOW SERVICE CONTAINERS IN SERVICE commands: New columns in output (Preview)¶

Attention

This behavior change is in the 2025_02 bundle.

For the current status of the bundle, refer to Bundle History.

When this behavior change bundle is enabled, the output of the SHOW SERVICE INSTANCES IN SERVICE command includes the following new columns:

Column name	Description
SERVICE_STATUS	One of the following values, which indicates the current status of the service: `PENDING` `RUNNING` `FAILED` `DONE` `SUSPENDING` `SUSPENDED` `DELETING` `DELETED` `INTERNAL_ERROR` Note that the value in this column is the same as the `status` column in the output of the DESCRIBE SERVICE.

Column name

Description

SERVICE_STATUS

One of the following values, which indicates the current status of the service:

PENDING
RUNNING
FAILED
DONE
SUSPENDING
SUSPENDED
DELETING
DELETED
INTERNAL_ERROR

Note that the value in this column is the same as the status column in the output of the DESCRIBE SERVICE.

The output of the SHOW SERVICE CONTAINERS IN SERVICE command includes the following new columns:

Column name	Description
SERVICE_STATUS	One of the following values, which indicates the current status of the service: `PENDING` `RUNNING` `FAILED` `DONE` `SUSPENDING` `SUSPENDED` `DELETING` `DELETED` `INTERNAL_ERROR` Note that the value in this column is the same as the `status` column in the output of the DESCRIBE SERVICE command.
INSTANCE_STATUS	One of the following values, which indicates the current status of the service instance: `PENDING`: The service instance is currently being deployed and is not yet ready to serve requests. `READY`: All containers in the service instance are ready; the service instance is ready to serve requests. `FAILED`: At least one container in the service instance has exited with a failure. `TERMINATING`: The service instance is in the process of termination and will be removed after the process is complete. `SUCCEEDED`: The service is a job service and all containers in the service instance have terminated successfully. Note that for a given service instance, as identified by the `instance_id` column, the value in the `instance_status` column matches the value in the `status` column in the output of the SHOW SERVICE INSTANCES IN SERVICE command.

Column name

Description

SERVICE_STATUS

One of the following values, which indicates the current status of the service:

PENDING
RUNNING
FAILED
DONE
SUSPENDING
SUSPENDED
DELETING
DELETED
INTERNAL_ERROR

Note that the value in this column is the same as the status column in the output of the DESCRIBE SERVICE command.

INSTANCE_STATUS

One of the following values, which indicates the current status of the service instance:

PENDING: The service instance is currently being deployed and is not yet ready to serve requests.
READY: All containers in the service instance are ready; the service instance is ready to serve requests.
FAILED: At least one container in the service instance has exited with a failure.
TERMINATING: The service instance is in the process of termination and will be removed after the process is complete.
SUCCEEDED: The service is a job service and all containers in the service instance have terminated successfully.

Note that for a given service instance, as identified by the instance_id column, the value in the instance_status column matches the value in the status column in the output of the SHOW SERVICE INSTANCES IN SERVICE command.

Also, note the following changes in the rows returned by these commands:

During a service suspension:

Before the change:

When you suspend a service, the output of the SHOW SERVICE INSTANCES IN SERVICE and SHOW SERVICE CONTAINERS IN SERVICE commands do not include the service being suspended.

After the change:

The output includes the service being suspended. In the row for this service, the service_status column has the value SUSPENDING and the instance_status column has the value TERMINATING.
After a service suspension:

Before the change:

The output of the SHOW SERVICE INSTANCES IN SERVICE and SHOW SERVICE CONTAINERS IN SERVICE commands do not include suspended service.

After the change:

The output includes a single row with the value SUSPENDED in the service_status and NULL in all other columns.
During a service upgrade:
Before the change:
- The output of the SHOW SERVICE CONTAINERS IN SERVICE command included containers being shut down (containers that would to be restarted with a new image). For these containers, the value in the status column is READY.
- The output of the SHOW SERVICE INSTANCES IN SERVICE command includes service instances with TERMINATING in the status column. This information is not included in the output of the SHOW SERVICE CONTAINERS IN SERVICE command.
After the change:

The output of the SHOW SERVICE CONTAINERS IN SERVICE command includes instances being shut down. These rows have the value TERMINATING in the instance_status and status columns.

Ref: 1915