ListDedicatedVmHosts

GET {{baseUrl}}/dedicatedVmHosts?availabilityDomain=officia sed&compartmentId={{compartment_ocid}}&lifecycleState=DELETING&displayName=amet ut&instanceShapeName=officia sed&limit=801&page=laboris proident officia tempor&sortBy=TIMECREATED&sortOrder=DESC&remainingMemoryInGBsGreaterThanOrEqualTo=52418552.54707795&remainingOcpusGreaterThanOrEqualTo=52418552.54707795

Returns the list of dedicated virtual machine hosts that match the specified criteria in the specified compartment.

You can limit the list by specifying a dedicated virtual machine host display name. The list will include all the identically-named dedicated virtual machine hosts in the compartment.

Request Params

KeyDatatypeRequiredDescription
availabilityDomainstringThe name of the availability domain.

Example: Uocm:PHX-AD-1 | | compartmentId | string | | (Required) The OCID of the compartment. | | lifecycleState | string | | A filter to only return resources that match the given lifecycle state. | | displayName | string | | A filter to return only resources that match the given display name exactly. | | instanceShapeName | string | | The name for the instance's shape. | | limit | number | | 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.

Example: 50 | | 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. | | sortBy | string | | The field to sort by. You can provide one sort order (sortOrder). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive.

Note: In general, some "List" operations (for example, ListInstances) let you optionally filter by availability domain if the scope of the resource type is within a single availability domain. If you call one of these "List" operations without specifying an availability domain, the resources are grouped by availability domain, then sorted. | | sortOrder | string | | The sort order to use, either ascending (ASC) or descending (DESC). The DISPLAYNAME sort order is case sensitive. | | remainingMemoryInGBsGreaterThanOrEqualTo | string | | The remaining memory of the dedicated VM host, in GBs. | | remainingOcpusGreaterThanOrEqualTo | string | | The available OCPUs of the dedicated VM host. |

HEADERS

KeyDatatypeRequiredDescription
opc-request-idstringUnique identifier for the request.
If you need to contact Oracle about a particular request, please provide the request ID.
Datestring(Required) Current Date
Authorizationstring(Required) Signature Authentication on Authorization header

RESPONSES

status: OK

[{"availabilityDomain":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"compartmentId":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"dedicatedVmHostShape":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"displayName":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"id":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"lifecycleState":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"timeCreated":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"remainingOcpus":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"totalOcpus":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"faultDomain":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"remainingMemoryInGBs":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"totalMemoryInGBs":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"availabilityDomain":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"compartmentId":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"dedicatedVmHostShape":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"displayName":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"id":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"lifecycleState":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"timeCreated":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"remainingOcpus":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"totalOcpus":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"faultDomain":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"remainingMemoryInGBs":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"totalMemoryInGBs":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}]