OCI Compute API

openapi: 3.1.0
info:
  title: Oracle OCI Compute 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
externalDocs:
  description: OCI Compute Service Documentation
  url: https://docs.oracle.com/en-us/iaas/Content/Compute/Concepts/computeoverview.htm
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
tags:
- name: Console Connections
  description: Manage instance console connections for troubleshooting
- name: Images
  description: Manage compute images used to launch instances
- name: Instances
  description: Manage compute instances including launch, terminate, and lifecycle operations
- name: Shapes
  description: List available compute shapes that define CPU, memory, and networking resources
- name: VNIC Attachments
  description: Manage virtual network interface card attachments for instances
- name: Volume Attachments
  description: Manage block volume attachments for instances
security:
- ociRequestSigning: []
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
  /shapes:
    get:
      operationId: listShapes
      summary: Oracle List Shapes
      description: >-
        Lists the shapes that can be used to launch an instance within the
        specified compartment. Shapes determine the number of CPUs, amount of
        memory, and other resources allocated to an instance. You can filter
        the list by compatibility with a specific image.
      tags:
      - Shapes
      parameters:
      - $ref: '#/components/parameters/compartmentId'
      - name: availabilityDomain
        in: query
        description: >-
          The name of the availability domain. If not specified, shapes
          across all availability domains in the compartment are listed.
        schema:
          type: string
        example: example_value
      - name: imageId
        in: query
        description: >-
          The OCID of an image. If specified, only shapes compatible with the
          image are returned.
        schema:
          type: string
        example: '500123'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/page'
      responses:
        '200':
          description: The list of shapes
          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:
 

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