> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Instances

Lists Oracle Cloud instances.

<Note>
  External Documentation

  To learn more, visit the [Oracle Cloud documentation](https://docs.oracle.com/en-us/iaas/api/#/en/iaas/20160918/Instances/ListInstances).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                          |
  | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Compartment OCID | The OCID of the compartment.                                                                                                                                                                                         |
  | Display Name     | A filter to return only resources that match the given display name exactly.                                                                                                                                         |
  | Lifecycle State  | A filter to only return resources that match the given lifecycle state.                                                                                                                                              |
  | Limit            | For list pagination. The maximum number of results per page, or items to return in a paginated "List" call.                                                                                                          |
  | Page             | For list pagination. The value of the `opc-next-page` response header from the previous "List".                                                                                                                      |
  | Sort By          | The field to sort by. You can provide one sort order (`sortOrder`). Default order for<br />TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME<br />sort order is case sensitive. |
  | Sort Order       | The sort order to use, either ascending (`ASC`) or descending (`DESC`).                                                                                                                                              |
</div>

## Example Output

```json theme={"dark"}
[
	{
		"availabilityDomain": "<string>",
		"capacityReservationId": null,
		"compartmentId": "<string>",
		"clusterPlacementGroupId": null,
		"dedicatedVmHostId": null,
		"definedTags": {
			"Oracle-Tags": {
				"CreatedBy": "<string>",
				"CreatedOn": "2021-10-07T21:28:03"
			}
		},
		"securityAttributes": {},
		"securityAttributesState": "<string>",
		"displayName": "<string>",
		"extendedMetadata": {},
		"faultDomain": "<string>",
		"freeformTags": {},
		"id": "<string>",
		"imageId": "<string>",
		"ipxeScript": null,
		"launchMode": "<string>",
		"launchOptions": {
			"bootVolumeType": "<string>",
			"firmware": "<string>",
			"networkType": "<string>",
			"remoteDataVolumeType": "<string>",
			"isPvEncryptionInTransitEnabled": true,
			"isEncryptionInTransitEnabled": null,
			"isConsistentVolumeNamingEnabled": true
		},
		"instanceOptions": {
			"areLegacyImdsEndpointsDisabled": true
		},
		"availabilityConfig": {
			"isLiveMigrationPreferred": null,
			"recoveryAction": "<string>"
		},
		"preemptibleInstanceConfig": null,
		"lifecycleState": "<string>",
		"metadata": {},
		"region": "<string>",
		"shape": "<string>",
		"shapeConfig": {
			"ocpus": 999.3,
			"memoryInGBs": 830.56,
			"baselineOcpuUtilization": null,
			"processorDescription": "<string>",
			"networkingBandwidthInGbps": 838.14,
			"maxVnicAttachments": 314,
			"gpus": 676,
			"gpuDescription": null,
			"localDisks": 123,
			"localDisksTotalSizeInGBs": null,
			"localDiskDescription": null,
			"vcpus": 854
		},
		"isCrossNumaNode": false,
		"sourceDetails": {
			"sourceType": "<string>",
			"bootVolumeSizeInGBs": null,
			"imageId": "<string>",
			"kmsKeyId": null,
			"bootVolumeVpusPerGB": null,
			"instanceSourceImageFilterDetails": null
		},
		"systemTags": {
			"orcl-cloud": {
				"free-tier-retained": "<string>"
			}
		},
		"timeCreated": "2023-11-01T10:35:13",
		"agentConfig": {
			"isMonitoringDisabled": false,
			"isManagementDisabled": true,
			"areAllPluginsDisabled": false,
			"pluginsConfig": null
		},
		"timeMaintenanceRebootDue": null,
		"timeStopScheduled": null,
		"preferredMaintenanceAction": null,
		"platformConfig": null,
		"instanceConfigurationId": null,
		"licensingConfigs": null,
		"computeHostGroupId": null
	}
]
```

## Workflow Library Example

[Reset All Oracle Cloud Instances](https://library.blinkops.com/workflows/reset-all-oracle-cloud-instances)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/reset-all-oracle-cloud-instances/canvas" />
</div>