ultra_servers_by_reserved_capacities
Creates, updates, deletes, gets or lists a ultra_servers_by_reserved_capacities resource.
Overview
| Name | ultra_servers_by_reserved_capacities |
| Type | Resource |
| Id | aws.sagemaker.ultra_servers_by_reserved_capacities |
Fields
The following fields are returned by SELECT queries:
- list_ultra_servers_by_reserved_capacity
| Name | Datatype | Description |
|---|---|---|
availability_zone | string | The name of the Availability Zone where the UltraServer is provisioned. (pattern: <code>[a-z]+-[0-9a-z-]+</code>) |
available_instance_count | integer | The number of instances currently available for use in this UltraServer. |
available_spare_instance_count | integer | The number of available spare instances in the UltraServer. |
configured_spare_instance_count | integer | The number of spare instances configured for this UltraServer to provide enhanced resiliency. |
health_status | string | The overall health status of the UltraServer. (OK, Impaired, Insufficient-Data) |
in_use_instance_count | integer | The number of instances currently in use in this UltraServer. |
instance_type | string | The Amazon EC2 instance type used in the UltraServer. (ml.p4d.24xlarge, ml.p5.48xlarge, ml.p5e.48xlarge, ml.p5en.48xlarge, ml.trn1.32xlarge, ml.trn2.48xlarge, ml.p6-b200.48xlarge, ml.p4de.24xlarge, ml.p6e-gb200.36xlarge, ml.p5.4xlarge, ml.p6-b300.48xlarge) |
total_instance_count | integer | The total number of instances in this UltraServer. |
ultra_server_id | string | The unique identifier for the UltraServer. (pattern: <code>(?!\s*$).+</code>) |
ultra_server_type | string | The type of UltraServer, such as ml.u-p6e-gb200x72. (pattern: <code>ml.[a-z0-9-.]+</code>) |
unhealthy_instance_count | integer | The number of instances in this UltraServer that are currently in an unhealthy state. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list_ultra_servers_by_reserved_capacity | select | region | Lists all UltraServers that are part of a specified reserved capacity. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- list_ultra_servers_by_reserved_capacity
Lists all UltraServers that are part of a specified reserved capacity.
SELECT
availability_zone,
available_instance_count,
available_spare_instance_count,
configured_spare_instance_count,
health_status,
in_use_instance_count,
instance_type,
total_instance_count,
ultra_server_id,
ultra_server_type,
unhealthy_instance_count
FROM aws.sagemaker.ultra_servers_by_reserved_capacities
WHERE region = '{{ region }}' -- required
;