Oracle Instances API

Manage compute instances including launch, terminate, and lifecycle operations

OpenAPI Specification

oracle-instances-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Oracle OCI Compute Console Connections Instances API
  description: The Oracle Cloud Infrastructure Compute API provides REST endpoints for managing compute instances, shapes, and images. You can launch and manage virtual machine (VM) and bare metal instances, query available compute shapes, list and manage custom images, and configure instance console connections. All API requests require OCI request signing for authentication.
  version: '20160918'
  contact:
    name: Oracle Cloud Infrastructure Support
    url: https://support.oracle.com
  license:
    name: Oracle Technology Network License Agreement
    url: https://www.oracle.com/downloads/licenses/oracle-oci-api-license.html
  termsOfService: https://www.oracle.com/legal/terms.html
servers:
- url: https://iaas.{region}.oraclecloud.com/20160918
  description: OCI Compute API regional endpoint
  variables:
    region:
      description: The OCI region identifier (e.g., us-ashburn-1, us-phoenix-1, eu-frankfurt-1, ap-tokyo-1)
      default: us-ashburn-1
      enum:
      - us-ashburn-1
      - us-phoenix-1
      - us-chicago-1
      - us-sanjose-1
      - ca-toronto-1
      - ca-montreal-1
      - eu-frankfurt-1
      - eu-amsterdam-1
      - eu-zurich-1
      - eu-madrid-1
      - uk-london-1
      - ap-tokyo-1
      - ap-osaka-1
      - ap-seoul-1
      - ap-mumbai-1
      - ap-sydney-1
      - ap-melbourne-1
      - sa-saopaulo-1
      - me-jeddah-1
      - af-johannesburg-1
security:
- ociRequestSigning: []
tags:
- name: Instances
  description: Manage compute instances including launch, terminate, and lifecycle operations
paths:
  /instances:
    get:
      operationId: listInstances
      summary: Oracle List Instances
      description: Lists the instances in the specified compartment and the specified availability domain. You can filter the results by specifying an instance display name or lifecycle state.
      tags:
      - Instances
      parameters:
      - $ref: '#/components/parameters/compartmentId'
      - name: availabilityDomain
        in: query
        description: The name of the availability domain (e.g., Uocm:PHX-AD-1). If not specified, returns instances across all availability domains in the compartment.
        schema:
          type: string
        example: example_value
      - name: displayName
        in: query
        description: A filter to return only resources that match the given display name exactly
        schema:
          type: string
        example: example_value
      - name: lifecycleState
        in: query
        description: A filter to return only instances that match the given lifecycle state
        schema:
          $ref: '#/components/schemas/InstanceLifecycleState'
        example: example_value
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/sortBy'
      - $ref: '#/components/parameters/sortOrder'
      responses:
        '200':
          description: The list of instances
          headers:
            opc-next-page:
              description: For pagination. When this header appears in the response, additional pages of results remain.
              schema:
                type: string
            opc-request-id:
              description: Unique Oracle-assigned identifier for the request
              schema:
                type: string
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Instance'
              examples:
                Listinstances200Example:
                  summary: Default listInstances 200 response
                  x-microcks-default: true
                  value:
                  - id: abc123
                    compartmentId: '500123'
                    availabilityDomain: example_value
                    faultDomain: example_value
                    displayName: example_value
                    shape: example_value
                    shapeConfig:
                      ocpus: 42.5
                      memoryInGBs: 42.5
                      baselineOcpuUtilization: BASELINE_1_8
                      processorDescription: example_value
                      networkingBandwidthInGbps: 42.5
                      maxVnicAttachments: 10
                      gpus: 10
                      gpuDescription: example_value
                      localDisks: 10
                      localDisksTotalSizeInGBs: 42.5
                      vcpus: 10
                    region: example_value
                    imageId: '500123'
                    sourceDetails:
                      sourceType: image
                      imageId: '500123'
                      bootVolumeId: '500123'
                      bootVolumeSizeInGBs: 10
                      bootVolumeVpusPerGB: 10
                    lifecycleState: MOVING
                    timeCreated: '2026-01-15T10:30:00Z'
                    metadata: example_value
                    extendedMetadata: example_value
                    launchMode: NATIVE
                    launchOptions:
                      bootVolumeType: ISCSI
                      firmware: BIOS
                      networkType: E1000
                      remoteDataVolumeType: ISCSI
                      isPvEncryptionInTransitEnabled: true
                      isConsistentVolumeNamingEnabled: true
                    agentConfig:
                      isMonitoringDisabled: true
                      isManagementDisabled: true
                      areAllPluginsDisabled: true
                      pluginsConfig: {}
                    availabilityConfig:
                      isLiveMigrationPreferred: true
                      recoveryAction: RESTORE_INSTANCE
                    platformConfig:
                      type: AMD_MILAN_BM
                      isSecureBootEnabled: true
                      isTrustedPlatformModuleEnabled: true
                      isMeasuredBootEnabled: true
                      isMemoryEncryptionEnabled: true
                    timeMaintenanceRebootDue: '2026-01-15T10:30:00Z'
                    capacityReservationId: '500123'
                    dedicatedVmHostId: '500123'
                    isCrossNumaNode: true
                    definedTags: {}
                    freeformTags: {}
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: launchInstance
      summary: Oracle Launch an Instance
      description: Creates a new instance in the specified compartment and the specified availability domain. For general information about instances, see Overview of the Compute Service. The instance is launched with the specified image, shape, and networking configuration.
      tags:
      - Instances
      parameters:
      - $ref: '#/components/parameters/opcRetryToken'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LaunchInstanceDetails'
            examples:
              LaunchinstanceRequestExample:
                summary: Default launchInstance request
                x-microcks-default: true
                value:
                  compartmentId: '500123'
                  availabilityDomain: example_value
                  displayName: example_value
                  shape: example_value
                  shapeConfig:
                    ocpus: 42.5
                    memoryInGBs: 42.5
                    baselineOcpuUtilization: BASELINE_1_8
                    nvmes: 10
                  sourceDetails:
                    sourceType: image
                    imageId: '500123'
                    bootVolumeId: '500123'
                    bootVolumeSizeInGBs: 10
                    bootVolumeVpusPerGB: 10
                  createVnicDetails:
                    subnetId: '500123'
                    displayName: example_value
                    assignPublicIp: true
                    assignPrivateDnsRecord: true
                    privateIp: example_value
                    hostnameLabel: example_value
                    nsgIds:
                    - {}
                    skipSourceDestCheck: true
                  metadata: example_value
                  extendedMetadata: example_value
                  faultDomain: example_value
                  launchOptions:
                    bootVolumeType: ISCSI
                    firmware: BIOS
                    networkType: E1000
                    remoteDataVolumeType: ISCSI
                    isPvEncryptionInTransitEnabled: true
                    isConsistentVolumeNamingEnabled: true
                  agentConfig:
                    isMonitoringDisabled: true
                    isManagementDisabled: true
                    areAllPluginsDisabled: true
                    pluginsConfig:
                    - {}
                  availabilityConfig:
                    isLiveMigrationPreferred: true
                    recoveryAction: RESTORE_INSTANCE
                  platformConfig:
                    type: AMD_MILAN_BM
                    isSecureBootEnabled: true
                    isTrustedPlatformModuleEnabled: true
                    isMeasuredBootEnabled: true
                    isMemoryEncryptionEnabled: true
                  isPvEncryptionInTransitEnabled: true
                  capacityReservationId: '500123'
                  dedicatedVmHostId: '500123'
                  definedTags: {}
                  freeformTags: {}
      responses:
        '200':
          description: The instance was launched successfully
          headers:
            etag:
              description: Entity tag for the instance resource
              schema:
                type: string
            opc-request-id:
              description: Unique Oracle-assigned identifier for the request
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Instance'
              examples:
                Launchinstance200Example:
                  summary: Default launchInstance 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    compartmentId: '500123'
                    availabilityDomain: example_value
                    faultDomain: example_value
                    displayName: example_value
                    shape: example_value
                    shapeConfig:
                      ocpus: 42.5
                      memoryInGBs: 42.5
                      baselineOcpuUtilization: BASELINE_1_8
                      processorDescription: example_value
                      networkingBandwidthInGbps: 42.5
                      maxVnicAttachments: 10
                      gpus: 10
                      gpuDescription: example_value
                      localDisks: 10
                      localDisksTotalSizeInGBs: 42.5
                      vcpus: 10
                    region: example_value
                    imageId: '500123'
                    sourceDetails:
                      sourceType: image
                      imageId: '500123'
                      bootVolumeId: '500123'
                      bootVolumeSizeInGBs: 10
                      bootVolumeVpusPerGB: 10
                    lifecycleState: MOVING
                    timeCreated: '2026-01-15T10:30:00Z'
                    metadata: example_value
                    extendedMetadata: example_value
                    launchMode: NATIVE
                    launchOptions:
                      bootVolumeType: ISCSI
                      firmware: BIOS
                      networkType: E1000
                      remoteDataVolumeType: ISCSI
                      isPvEncryptionInTransitEnabled: true
                      isConsistentVolumeNamingEnabled: true
                    agentConfig:
                      isMonitoringDisabled: true
                      isManagementDisabled: true
                      areAllPluginsDisabled: true
                      pluginsConfig:
                      - {}
                    availabilityConfig:
                      isLiveMigrationPreferred: true
                      recoveryAction: RESTORE_INSTANCE
                    platformConfig:
                      type: AMD_MILAN_BM
                      isSecureBootEnabled: true
                      isTrustedPlatformModuleEnabled: true
                      isMeasuredBootEnabled: true
                      isMemoryEncryptionEnabled: true
                    timeMaintenanceRebootDue: '2026-01-15T10:30:00Z'
                    capacityReservationId: '500123'
                    dedicatedVmHostId: '500123'
                    isCrossNumaNode: true
                    definedTags: {}
                    freeformTags: {}
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /instances/{instanceId}:
    get:
      operationId: getInstance
      summary: Oracle Get an Instance
      description: Gets information about the specified instance, including its current lifecycle state, shape, image, networking details, and metadata.
      tags:
      - Instances
      parameters:
      - $ref: '#/components/parameters/instanceId'
      responses:
        '200':
          description: The instance details
          headers:
            etag:
              description: Entity tag for the instance resource
              schema:
                type: string
            opc-request-id:
              description: Unique Oracle-assigned identifier for the request
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Instance'
              examples:
                Getinstance200Example:
                  summary: Default getInstance 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    compartmentId: '500123'
                    availabilityDomain: example_value
                    faultDomain: example_value
                    displayName: example_value
                    shape: example_value
                    shapeConfig:
                      ocpus: 42.5
                      memoryInGBs: 42.5
                      baselineOcpuUtilization: BASELINE_1_8
                      processorDescription: example_value
                      networkingBandwidthInGbps: 42.5
                      maxVnicAttachments: 10
                      gpus: 10
                      gpuDescription: example_value
                      localDisks: 10
                      localDisksTotalSizeInGBs: 42.5
                      vcpus: 10
                    region: example_value
                    imageId: '500123'
                    sourceDetails:
                      sourceType: image
                      imageId: '500123'
                      bootVolumeId: '500123'
                      bootVolumeSizeInGBs: 10
                      bootVolumeVpusPerGB: 10
                    lifecycleState: MOVING
                    timeCreated: '2026-01-15T10:30:00Z'
                    metadata: example_value
                    extendedMetadata: example_value
                    launchMode: NATIVE
                    launchOptions:
                      bootVolumeType: ISCSI
                      firmware: BIOS
                      networkType: E1000
                      remoteDataVolumeType: ISCSI
                      isPvEncryptionInTransitEnabled: true
                      isConsistentVolumeNamingEnabled: true
                    agentConfig:
                      isMonitoringDisabled: true
                      isManagementDisabled: true
                      areAllPluginsDisabled: true
                      pluginsConfig:
                      - {}
                    availabilityConfig:
                      isLiveMigrationPreferred: true
                      recoveryAction: RESTORE_INSTANCE
                    platformConfig:
                      type: AMD_MILAN_BM
                      isSecureBootEnabled: true
                      isTrustedPlatformModuleEnabled: true
                      isMeasuredBootEnabled: true
                      isMemoryEncryptionEnabled: true
                    timeMaintenanceRebootDue: '2026-01-15T10:30:00Z'
                    capacityReservationId: '500123'
                    dedicatedVmHostId: '500123'
                    isCrossNumaNode: true
                    definedTags: {}
                    freeformTags: {}
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: updateInstance
      summary: Oracle Update an Instance
      description: Updates certain fields on the specified instance. Fields that are not provided in the request will not be updated. You can update the display name, defined tags, freeform tags, shape, and metadata.
      tags:
      - Instances
      parameters:
      - $ref: '#/components/parameters/instanceId'
      - $ref: '#/components/parameters/ifMatch'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateInstanceDetails'
            examples:
              UpdateinstanceRequestExample:
                summary: Default updateInstance request
                x-microcks-default: true
                value:
                  displayName: example_value
                  shape: example_value
                  shapeConfig:
                    ocpus: 42.5
                    memoryInGBs: 42.5
                    baselineOcpuUtilization: BASELINE_1_8
                    nvmes: 10
                  metadata: example_value
                  extendedMetadata: example_value
                  agentConfig:
                    isMonitoringDisabled: true
                    isManagementDisabled: true
                    areAllPluginsDisabled: true
                    pluginsConfig:
                    - {}
                  availabilityConfig:
                    isLiveMigrationPreferred: true
                    recoveryAction: RESTORE_INSTANCE
                  faultDomain: example_value
                  definedTags: {}
                  freeformTags: {}
      responses:
        '200':
          description: The instance was updated successfully
          headers:
            etag:
              description: Entity tag for the updated instance resource
              schema:
                type: string
            opc-request-id:
              description: Unique Oracle-assigned identifier for the request
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Instance'
              examples:
                Updateinstance200Example:
                  summary: Default updateInstance 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    compartmentId: '500123'
                    availabilityDomain: example_value
                    faultDomain: example_value
                    displayName: example_value
                    shape: example_value
                    shapeConfig:
                      ocpus: 42.5
                      memoryInGBs: 42.5
                      baselineOcpuUtilization: BASELINE_1_8
                      processorDescription: example_value
                      networkingBandwidthInGbps: 42.5
                      maxVnicAttachments: 10
                      gpus: 10
                      gpuDescription: example_value
                      localDisks: 10
                      localDisksTotalSizeInGBs: 42.5
                      vcpus: 10
                    region: example_value
                    imageId: '500123'
                    sourceDetails:
                      sourceType: image
                      imageId: '500123'
                      bootVolumeId: '500123'
                      bootVolumeSizeInGBs: 10
                      bootVolumeVpusPerGB: 10
                    lifecycleState: MOVING
                    timeCreated: '2026-01-15T10:30:00Z'
                    metadata: example_value
                    extendedMetadata: example_value
                    launchMode: NATIVE
                    launchOptions:
                      bootVolumeType: ISCSI
                      firmware: BIOS
                      networkType: E1000
                      remoteDataVolumeType: ISCSI
                      isPvEncryptionInTransitEnabled: true
                      isConsistentVolumeNamingEnabled: true
                    agentConfig:
                      isMonitoringDisabled: true
                      isManagementDisabled: true
                      areAllPluginsDisabled: true
                      pluginsConfig:
                      - {}
                    availabilityConfig:
                      isLiveMigrationPreferred: true
                      recoveryAction: RESTORE_INSTANCE
                    platformConfig:
                      type: AMD_MILAN_BM
                      isSecureBootEnabled: true
                      isTrustedPlatformModuleEnabled: true
                      isMeasuredBootEnabled: true
                      isMemoryEncryptionEnabled: true
                    timeMaintenanceRebootDue: '2026-01-15T10:30:00Z'
                    capacityReservationId: '500123'
                    dedicatedVmHostId: '500123'
                    isCrossNumaNode: true
                    definedTags: {}
                    freeformTags: {}
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '412':
          $ref: '#/components/responses/PreconditionFailed'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: terminateInstance
      summary: Oracle Terminate an Instance
      description: Permanently terminates (deletes) the specified instance. Any attached VNICs and volumes are automatically detached when the instance terminates. You can optionally choose to preserve the boot volume associated with the instance.
      tags:
      - Instances
      parameters:
      - $ref: '#/components/parameters/instanceId'
      - $ref: '#/components/parameters/ifMatch'
      - name: preserveBootVolume
        in: query
        description: Specifies whether to delete or preserve the boot volume when terminating an instance. Defaults to false (delete the boot volume).
        schema:
          type: boolean
          default: false
        example: true
      - name: preserveDataVolumesCreatedAtLaunch
        in: query
        description: Specifies whether to delete or preserve data volumes created during launch when terminating an instance. Defaults to true (preserve).
        schema:
          type: boolean
          default: true
        example: true
      responses:
        '204':
          description: The instance is being terminated
          headers:
            opc-request-id:
              description: Unique Oracle-assigned identifier for the request
              schema:
                type: string
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '412':
          $ref: '#/components/responses/PreconditionFailed'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /instances/{instanceId}/actions/{action}:
    post:
      operationId: instanceAction
      summary: Oracle Perform an Action on an Instance
      description: Performs an action on the specified instance, such as starting, stopping, resetting, or soft-resetting the instance. The STOP action is equivalent to pressing the power button. The SOFTRESET action gracefully reboots the instance by sending an ACPI shutdown and then powering back on.
      tags:
      - Instances
      parameters:
      - $ref: '#/components/parameters/instanceId'
      - name: action
        in: path
        required: true
        description: The action to perform on the instance
        schema:
          type: string
          enum:
          - STOP
          - START
          - SOFTRESET
          - RESET
          - SOFTSTOP
          - SENDDIAGNOSTICINTERRUPT
          - DIAGNOSTICREBOOT
          - REBOOTMIGRATE
        example: STOP
      - $ref: '#/components/parameters/ifMatch'
      responses:
        '200':
          description: The action was performed on the instance
          headers:
            etag:
              description: Entity tag for the instance resource
              schema:
                type: string
            opc-request-id:
              description: Unique Oracle-assigned identifier for the request
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Instance'
              examples:
                Instanceaction200Example:
                  summary: Default instanceAction 200 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    compartmentId: '500123'
                    availabilityDomain: example_value
                    faultDomain: example_value
                    displayName: example_value
                    shape: example_value
                    shapeConfig:
                      ocpus: 42.5
                      memoryInGBs: 42.5
                      baselineOcpuUtilization: BASELINE_1_8
                      processorDescription: example_value
                      networkingBandwidthInGbps: 42.5
                      maxVnicAttachments: 10
                      gpus: 10
                      gpuDescription: example_value
                      localDisks: 10
                      localDisksTotalSizeInGBs: 42.5
                      vcpus: 10
                    region: example_value
                    imageId: '500123'
                    sourceDetails:
                      sourceType: image
                      imageId: '500123'
                      bootVolumeId: '500123'
                      bootVolumeSizeInGBs: 10
                      bootVolumeVpusPerGB: 10
                    lifecycleState: MOVING
                    timeCreated: '2026-01-15T10:30:00Z'
                    metadata: example_value
                    extendedMetadata: example_value
                    launchMode: NATIVE
                    launchOptions:
                      bootVolumeType: ISCSI
                      firmware: BIOS
                      networkType: E1000
                      remoteDataVolumeType: ISCSI
                      isPvEncryptionInTransitEnabled: true
                      isConsistentVolumeNamingEnabled: true
                    agentConfig:
                      isMonitoringDisabled: true
                      isManagementDisabled: true
                      areAllPluginsDisabled: true
                      pluginsConfig:
                      - {}
                    availabilityConfig:
                      isLiveMigrationPreferred: true
                      recoveryAction: RESTORE_INSTANCE
                    platformConfig:
                      type: AMD_MILAN_BM
                      isSecureBootEnabled: true
                      isTrustedPlatformModuleEnabled: true
                      isMeasuredBootEnabled: true
                      isMemoryEncryptionEnabled: true
                    timeMaintenanceRebootDue: '2026-01-15T10:30:00Z'
                    capacityReservationId: '500123'
                    dedicatedVmHostId: '500123'
                    isCrossNumaNode: true
                    definedTags: {}
                    freeformTags: {}
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '412':
          $ref: '#/components/responses/PreconditionFailed'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    PlatformConfig:
      type: object
      description: The platform configuration for the instance. Includes settings for Secure Boot, measured boot, and trusted platform module.
      properties:
        type:
          type: string
          description: The type of platform configuration
          enum:
          - AMD_MILAN_BM
          - AMD_MILAN_BM_GPU
          - AMD_ROME_BM
          - AMD_ROME_BM_GPU
          - AMD_VM
          - GENERIC_BM
          - INTEL_ICELAKE_BM
          - INTEL_SKYLAKE_BM
          - INTEL_VM
          example: AMD_MILAN_BM
        isSecureBootEnabled:
          type: boolean
          description: Whether Secure Boot is enabled on the instance
          example: true
        isTrustedPlatformModuleEnabled:
          type: boolean
          description: Whether the Trusted Platform Module (TPM) is enabled
          example: true
        isMeasuredBootEnabled:
          type: boolean
          description: Whether the Measured Boot feature is enabled
          example: true
        isMemoryEncryptionEnabled:
          type: boolean
          description: Whether AMD memory encryption is enabled
          example: true
    InstanceAgentPluginConfigDetails:
      type: object
      description: Configuration details for an Oracle Cloud Agent plugin
      required:
      - name
      - desiredState
      properties:
        name:
          type: string
          description: The plugin name (e.g., Vulnerability Scanning, Bastion)
          example: Example Title
        desiredState:
          type: string
          description: Whether the plugin should be enabled or disabled
          enum:
          - ENABLED
          - DISABLED
          example: ENABLED
    InstanceLifecycleState:
      type: string
      description: The lifecycle state of a compute instance
      enum:
      - MOVING
      - PROVISIONING
      - RUNNING
      - STARTING
      - STOPPING
      - STOPPED
      - CREATING_IMAGE
      - TERMINATING
      - TERMINATED
    LaunchInstancePlatformConfig:
      type: object
      description: The platform configuration for launching an instance
      properties:
        type:
          type: string
          description: The type of platform configuration
          enum:
          - AMD_MILAN_BM
          - AMD_MILAN_BM_GPU
          - AMD_ROME_BM
          - AMD_ROME_BM_GPU
          - AMD_VM
          - GENERIC_BM
          - INTEL_ICELAKE_BM
          - INTEL_SKYLAKE_BM
          - INTEL_VM
          example: AMD_MILAN_BM
     

# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle/refs/heads/main/openapi/oracle-instances-api-openapi.yml