dedicated_vm_host_instance_shapes
Creates, updates, deletes, gets or lists a dedicated_vm_host_instance_shapes resource.
Overview​
| Name | dedicated_vm_host_instance_shapes |
| Type | Resource |
| Id | oci.compute.dedicated_vm_host_instance_shapes |
Fields​
The following fields are returned by SELECT queries:
- list
The shape used to launch instances associated with the dedicated VM host.<br />
| Name | Datatype | Description |
|---|---|---|
availabilityDomain | string | The shape's availability domain. |
instanceShapeName | string | The name of the virtual machine instance shapes that can be launched on a dedicated VM host. |
supportedCapabilities | object | Specifies the capabilities that the Dedicated Virtual Machine Host (DVMH) Shape or Virtual Machine Instance Shape could support. |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | compartmentId, region | availabilityDomain, dedicatedVmHostShape, limit, page, opc-request-id | Lists the shapes that can be used to launch a virtual machine instance on a dedicated virtual machine host within the specified compartment.<br />You can filter the list by compatibility with a specific dedicated virtual machine host shape.<br /> |
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 |
|---|---|---|
compartmentId | string | The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the compartment. |
region | string | OCI region identifier (e.g. us-ashburn-1, ap-sydney-1); resolves from OCI_REGION when not supplied in the query. (default: us-ashburn-1, x-stackQL-envVar: OCI_REGION) |
availabilityDomain | string | The name of the availability domain. Example: Uocm:PHX-AD-1 |
dedicatedVmHostShape | string | Dedicated VM host shape name |
limit | integer | For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). Example: 50 |
opc-request-id | string | Unique identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
page | string | For list pagination. The value of the opc-next-page response header from the previous "List" call. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). |
SELECT examples​
- list
Lists the shapes that can be used to launch a virtual machine instance on a dedicated virtual machine host within the specified compartment.<br />You can filter the list by compatibility with a specific dedicated virtual machine host shape.<br />
SELECT
availabilityDomain,
instanceShapeName,
supportedCapabilities
FROM oci.compute.dedicated_vm_host_instance_shapes
WHERE compartmentId = '{{ compartmentId }}' -- required
AND region = '{{ region }}' -- required
AND availabilityDomain = '{{ availabilityDomain }}'
AND dedicatedVmHostShape = '{{ dedicatedVmHostShape }}'
AND limit = '{{ limit }}'
AND page = '{{ page }}'
AND opc-request-id = '{{ opc-request-id }}'
;