A container group definition that represents a scalable set of identical containers running as a distributed service
Properties
| Name | Type | Required | Description |
|---|---|---|---|
| autostart_policy | bool | ✅ | Defines whether containers in this group should automatically start when deployed (true) or require manual starting (false) |
| container | Container | ✅ | Represents a container with its configuration and resource requirements. |
| country_codes | List[CountryCode] | ✅ | List of country codes where container instances are permitted to run. When not specified or empty, containers may run in any available region. |
| create_time | str | ✅ | ISO 8601 timestamp when this container group was initially created |
| current_state | ContainerGroupState | ✅ | Represents the operational state of a container group during its lifecycle, including timing information, status, and instance distribution metrics. This state captures the current execution status, start and finish times, and provides visibility into the operational health across instances. |
| display_name | str | ✅ | The display-friendly name of the resource. |
| id_ | str | ✅ | The container group identifier. |
| name | str | ✅ | The container group name. |
| organization_name | str | ✅ | The organization name. |
| pending_change | bool | ✅ | Indicates whether a configuration change has been requested but not yet applied to all containers in the group |
| priority | ContainerGroupPriority | ✅ | Specifies the priority level for container group execution, which determines resource allocation and scheduling precedence. |
| project_name | str | ✅ | The project name. |
| replicas | int | ✅ | The container group replicas. |
| restart_policy | ContainerRestartPolicy | ✅ | Specifies the policy for restarting containers when they exit or fail. |
| scaling_actions | List[ContainerGroupScalingAction] | ✅ | List of scaling actions configurations |
| scheduled_scaling_enabled | bool | ✅ | Indicates if scheduled scaling is enabled |
| update_time | str | ✅ | ISO 8601 timestamp when this container group was last updated |
| version | int | ✅ | Incremental version number that increases with each configuration change to the container group |
| liveness_probe | ContainerGroupLivenessProbe | ❌ | Defines a liveness probe for container groups that determines when to restart a container if it becomes unhealthy |
| networking | ContainerGroupNetworkingConfiguration | ❌ | Network configuration for container groups that defines connectivity, routing, and access control settings |
| queue_autoscaler | QueueBasedAutoscalerConfiguration | ❌ | Defines configuration for automatically scaling container instances based on queue length. The autoscaler monitors a queue and adjusts the number of running replicas to maintain the desired queue length. |
| queue_connection | ContainerGroupQueueConnection | ❌ | Configuration for connecting a container group to a message queue system, enabling asynchronous communication between services. |
| readiness_probe | ContainerGroupReadinessProbe | ❌ | Defines how to check if a container is ready to serve traffic. The readiness probe determines whether the container's application is ready to accept traffic. If the readiness probe fails, the container is considered not ready and traffic will not be sent to it. |
| readme | str | ❌ | |
| startup_probe | ContainerGroupStartupProbe | ❌ | Defines a probe that checks if a container application has started successfully. Startup probes help prevent applications from being prematurely marked as unhealthy during initialization. The probe can use HTTP requests, TCP connections, gRPC calls, or shell commands to determine startup status. |