Oracle Platforms

Oracle Platforms Blockstorage API

The blockstorage API from Oracle Platforms — 33 operation(s) for blockstorage.

GitHub OpenAPI
Business capability
IT Infrastructure Management BC-600.50

Operations 60

GET /blockVolumeReplicas ListBlockVolumeReplicas #
GET /blockVolumeReplicas/{blockVolumeReplicaId} GetBlockVolumeReplica #
GET /bootVolumeBackups ListBootVolumeBackups #
POST /bootVolumeBackups CreateBootVolumeBackup #
DELETE /bootVolumeBackups/{bootVolumeBackupId} DeleteBootVolumeBackup #
GET /bootVolumeBackups/{bootVolumeBackupId} GetBootVolumeBackup #
PUT /bootVolumeBackups/{bootVolumeBackupId} UpdateBootVolumeBackup #
POST /bootVolumeBackups/{bootVolumeBackupId}/actions/changeCompartment ChangeBootVolumeBackupCompartment #
POST /bootVolumeBackups/{bootVolumeBackupId}/actions/copy CreateBootVolumeBackupCopy #
GET /bootVolumeReplicas ListBootVolumeReplicas #
GET /bootVolumeReplicas/{bootVolumeReplicaId} GetBootVolumeReplica #
GET /bootVolumes ListBootVolumes #
POST /bootVolumes CreateBootVolume #
DELETE /bootVolumes/{bootVolumeId} DeleteBootVolume #
GET /bootVolumes/{bootVolumeId} GetBootVolume #
PUT /bootVolumes/{bootVolumeId} UpdateBootVolume #
POST /bootVolumes/{bootVolumeId}/actions/changeCompartment ChangeBootVolumeCompartment #
DELETE /bootVolumes/{bootVolumeId}/kmsKey DeleteBootVolumeKmsKey #
GET /bootVolumes/{bootVolumeId}/kmsKey GetBootVolumeKmsKey #
PUT /bootVolumes/{bootVolumeId}/kmsKey UpdateBootVolumeKmsKey #
GET /volumeBackupPolicies ListVolumeBackupPolicies #
POST /volumeBackupPolicies CreateVolumeBackupPolicy #
DELETE /volumeBackupPolicies/{policyId} DeleteVolumeBackupPolicy #
GET /volumeBackupPolicies/{policyId} GetVolumeBackupPolicy #
PUT /volumeBackupPolicies/{policyId} UpdateVolumeBackupPolicy #
GET /volumeBackupPolicyAssignments GetVolumeBackupPolicyAssetAssignment #
POST /volumeBackupPolicyAssignments CreateVolumeBackupPolicyAssignment #
DELETE /volumeBackupPolicyAssignments/{policyAssignmentId} DeleteVolumeBackupPolicyAssignment #
GET /volumeBackupPolicyAssignments/{policyAssignmentId} GetVolumeBackupPolicyAssignment #
GET /volumeBackups ListVolumeBackups #
POST /volumeBackups CreateVolumeBackup #
DELETE /volumeBackups/{volumeBackupId} DeleteVolumeBackup #
GET /volumeBackups/{volumeBackupId} GetVolumeBackup #
PUT /volumeBackups/{volumeBackupId} UpdateVolumeBackup #
POST /volumeBackups/{volumeBackupId}/actions/changeCompartment ChangeVolumeBackupCompartment #
POST /volumeBackups/{volumeBackupId}/actions/copy CreateVolumeBackupCopy #
GET /volumeGroupBackups ListVolumeGroupBackups #
POST /volumeGroupBackups CreateVolumeGroupBackup #
DELETE /volumeGroupBackups/{volumeGroupBackupId} DeleteVolumeGroupBackup #
GET /volumeGroupBackups/{volumeGroupBackupId} GetVolumeGroupBackup #
PUT /volumeGroupBackups/{volumeGroupBackupId} UpdateVolumeGroupBackup #
POST /volumeGroupBackups/{volumeGroupBackupId}/actions/changeCompartment ChangeVolumeGroupBackupCompartment #
POST /volumeGroupBackups/{volumeGroupBackupId}/actions/copy CreateVolumeGroupBackupCopy #
GET /volumeGroupReplicas Lists the volume group replicas in the specified compartment. #
GET /volumeGroupReplicas/{volumeGroupReplicaId} Gets information for the specified volume group replica. #
GET /volumeGroups ListVolumeGroups #
POST /volumeGroups CreateVolumeGroup #
DELETE /volumeGroups/{volumeGroupId} DeleteVolumeGroup #
GET /volumeGroups/{volumeGroupId} GetVolumeGroup #
PUT /volumeGroups/{volumeGroupId} UpdateVolumeGroup #
POST /volumeGroups/{volumeGroupId}/actions/changeCompartment ChangeVolumeGroupCompartment #
GET /volumes ListVolumes #
POST /volumes CreateVolume #
DELETE /volumes/{volumeId} DeleteVolume #
GET /volumes/{volumeId} GetVolume #
PUT /volumes/{volumeId} UpdateVolume #
POST /volumes/{volumeId}/actions/changeCompartment ChangeVolumeCompartment #
DELETE /volumes/{volumeId}/kmsKey DeleteVolumeKmsKey #
GET /volumes/{volumeId}/kmsKey GetVolumeKmsKey #
PUT /volumes/{volumeId}/kmsKey UpdateVolumeKmsKey #

Documentation

📖
Documentation
https://docs.oracle.com/en-us/iaas/api/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/iaas/latest/
📖
Authentication
https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/oracle-platforms/refs/heads/main/rate-limits/oracle-platforms-rate-limits.yml
📖
APIReference
https://docs.oracle.com/en-us/iaas/Content/API/Concepts/apiref.htm
📖
Documentation
https://docs.oracle.com/en/cloud/paas/autonomous-database/adbsa/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database/latest/
📖
Documentation
https://docs.oracle.com/en/cloud/paas/integration-cloud/
📖
APIReference
https://docs.oracle.com/en/cloud/paas/integration-cloud/rest-api/
📖
Documentation
https://docs.oracle.com/en/cloud/paas/content-cloud/rest-api-documents/
📖
Documentation
https://docs.oracle.com/en/cloud/paas/analytics-cloud/
📖
APIReference
https://docs.oracle.com/en/cloud/paas/analytics-cloud/acapi/
📖
Documentation
https://docs.oracle.com/en-us/iaas/data-science/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-science/latest/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/oracle-platforms/refs/heads/main/openapi/oracle-platforms-blockstorage-api-openapi.yml

Other Resources

🔗
SDKs
https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdks.htm
🔗
Pricing
https://www.oracle.com/cloud/price-list.html
🔗
SDKs
https://github.com/oracle/content-management-sdk

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/oracle-platforms-blockstorage-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

oracle-platforms-blockstorage-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  x-provenance:
    method: harvested
    first_party: true
    publisher: Oracle
    source: https://docs.oracle.com/en-us/iaas/api/specs/8839cf1f6cfca996dd92bc573c2a7c14db20e7f5d6e244c7d62365fa9d770623.yaml
    harvested: '2026-08-27'
    note: Published by Oracle as the contract for the Core Services API (iaas) OCI service and stored verbatim; API Evangelist added only this provenance block. Wired to the "Oracle Cloud Infrastructure (OCI) REST API" entry in apis.yml.
  x-evidence:
  - url: https://docs.oracle.com/en-us/iaas/api/specs/index.json
    what: Oracle's own machine-readable index of every OCI service specification (HTTP 200)
  - url: https://docs.oracle.com/en-us/iaas/api/specs/8839cf1f6cfca996dd92bc573c2a7c14db20e7f5d6e244c7d62365fa9d770623.yaml
    what: the harvested document for Core Services API (HTTP 200)
  description: 'Use the Core Services API to manage resources such as virtual cloud networks (VCNs),

    compute instances, and block storage volumes. For more information, see the console

    documentation for the [Networking](/iaas/Content/Network/Concepts/overview.htm),

    [Compute](/iaas/Content/Compute/Concepts/computeoverview.htm), and

    [Block Volume](/iaas/Content/Block/Concepts/overview.htm) services.

    The required permissions are documented in the

    [Details for the Core Services](/iaas/Content/Identity/Reference/corepolicyreference.htm) article.

    '
  license:
    name: Oracle Corporation
  title: Core Services Blockstorage API
  version: '20160918'
servers:
- url: /20160918
tags:
- name: blockstorage
paths:
  /blockVolumeReplicas:
    get:
      description: 'Lists the block volume replicas in the specified compartment and availability domain.

        '
      operationId: ListBlockVolumeReplicas
      parameters:
      - $ref: '#/components/parameters/RequiredAvailabilityDomainQueryParam'
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/FilterByDisplayNameQueryParam'
      - $ref: '#/components/parameters/SortByQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - description: 'A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.

          '
        in: query
        name: lifecycleState
        required: false
        x-obmcs-enumref: '#/definitions/BlockVolumeReplica/lifecycleState'
        schema:
          type: string
      responses:
        200:
          description: The list is being retrieved.
          headers:
            opc-next-page:
              description: 'For list pagination. When this header appears in the response, additional pages

                of results remain. For important details about how pagination works, see

                [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/BlockVolumeReplica'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: ListBlockVolumeReplicas
      tags:
      - blockstorage
  /blockVolumeReplicas/{blockVolumeReplicaId}:
    get:
      description: Gets information for the specified block volume replica.
      operationId: GetBlockVolumeReplica
      parameters:
      - $ref: '#/components/parameters/BlockVolumeReplicaIdPathParam'
      responses:
        200:
          description: The block volume replica's information has been retrieved.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockVolumeReplica'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: GetBlockVolumeReplica
      tags:
      - blockstorage
  /bootVolumeBackups:
    get:
      description: 'Lists the boot volume backups in the specified compartment. You can filter the results by boot volume.

        '
      operationId: ListBootVolumeBackups
      parameters:
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/BootVolumeIdQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/FilterByDisplayNameQueryParam'
      - $ref: '#/components/parameters/FilterBySourceBootVolumeBackupIdQueryParam'
      - $ref: '#/components/parameters/SortByQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - description: 'A filter to only return resources that match the given lifecycle state. The state value is

          case-insensitive.

          '
        in: query
        name: lifecycleState
        required: false
        x-obmcs-enumref: '#/definitions/BootVolumeBackup/lifecycleState'
        schema:
          type: string
      responses:
        200:
          description: The list is being retrieved.
          headers:
            opc-next-page:
              description: 'For list pagination. When this header appears in the response, additional pages

                of results remain. For important details about how pagination works, see

                [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/BootVolumeBackup'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: ListBootVolumeBackups
      tags:
      - blockstorage
    post:
      description: 'Creates a new boot volume backup of the specified boot volume. For general information about boot volume backups,

        see [Overview of Boot Volume Backups](/iaas/Content/Block/Concepts/bootvolumebackups.htm)


        When the request is received, the backup object is in a REQUEST_RECEIVED state.

        When the data is imaged, it goes into a CREATING state.

        After the backup is fully uploaded to the cloud, it goes into an AVAILABLE state.

        '
      operationId: CreateBootVolumeBackup
      parameters:
      - $ref: '#/components/parameters/RetryTokenHeader'
      responses:
        200:
          description: The boot volume backup is being created.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BootVolumeBackup'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: CreateBootVolumeBackup
      tags:
      - blockstorage
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBootVolumeBackupDetails'
        description: Request to create a new backup of given boot volume.
        required: true
  /bootVolumeBackups/{bootVolumeBackupId}:
    delete:
      description: Deletes a boot volume backup.
      operationId: DeleteBootVolumeBackup
      parameters:
      - $ref: '#/components/parameters/BootVolumeBackupIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      responses:
        204:
          description: The boot volume backup is being deleted.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: DeleteBootVolumeBackup
      tags:
      - blockstorage
    get:
      description: Gets information for the specified boot volume backup.
      operationId: GetBootVolumeBackup
      parameters:
      - $ref: '#/components/parameters/BootVolumeBackupIdPathParam'
      responses:
        200:
          description: The boot volume backup was retrieved.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BootVolumeBackup'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: GetBootVolumeBackup
      tags:
      - blockstorage
    put:
      description: 'Updates the display name for the specified boot volume backup.

        Avoid entering confidential information.

        '
      operationId: UpdateBootVolumeBackup
      parameters:
      - $ref: '#/components/parameters/BootVolumeBackupIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      responses:
        200:
          description: The boot volume backup was updated.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BootVolumeBackup'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: UpdateBootVolumeBackup
      tags:
      - blockstorage
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateBootVolumeBackupDetails'
        description: Update boot volume backup fields
        required: true
  /bootVolumeBackups/{bootVolumeBackupId}/actions/changeCompartment:
    post:
      description: 'Moves a boot volume backup into a different compartment within the same tenancy.

        For information about moving resources between compartments,

        see [Moving Resources to a Different Compartment](/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes).

        '
      operationId: ChangeBootVolumeBackupCompartment
      parameters:
      - $ref: '#/components/parameters/BootVolumeBackupIdPathParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        204:
          description: The BootVolume Backup Compartment Details is being changed.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: ChangeBootVolumeBackupCompartment
      tags:
      - blockstorage
      x-related-resource: '#/definitions/BootVolumeBackup'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeBootVolumeBackupCompartmentDetails'
        description: Request to change the compartment of given boot volume backup.
        required: true
  /bootVolumeBackups/{bootVolumeBackupId}/actions/copy:
    post:
      description: 'Creates a boot volume backup copy in specified region. For general information about volume backups,

        see [Overview of Boot Volume Backups](/iaas/Content/Block/Concepts/bootvolumebackups.htm)

        '
      operationId: CopyBootVolumeBackup
      parameters:
      - $ref: '#/components/parameters/BootVolumeBackupIdPathParam'
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The boot volume backup copy is being created in specified region.
          headers:
            content-location:
              description: 'Location of the resource.

                '
              schema:
                type: string
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            location:
              description: 'Location of the resource.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
            opc-work-request-id:
              description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the work request.

                Use [GetWorkRequest](/api/#/en/workrequests/latest/WorkRequest/GetWorkRequest)

                with this ID to track the status of the request.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BootVolumeBackup'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: CreateBootVolumeBackupCopy
      tags:
      - blockstorage
      x-related-resource: '#/definitions/BootVolumeBackup'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CopyBootVolumeBackupDetails'
        description: Request to create a cross-region copy of given boot volume backup.
        required: true
  /bootVolumeReplicas:
    get:
      description: 'Lists the boot volume replicas in the specified compartment and availability domain.

        '
      operationId: ListBootVolumeReplicas
      parameters:
      - $ref: '#/components/parameters/RequiredAvailabilityDomainQueryParam'
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/FilterByDisplayNameQueryParam'
      - $ref: '#/components/parameters/SortByQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - description: 'A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.

          '
        in: query
        name: lifecycleState
        required: false
        x-obmcs-enumref: '#/definitions/BootVolumeReplica/lifecycleState'
        schema:
          type: string
      responses:
        200:
          description: The list is being retrieved.
          headers:
            opc-next-page:
              description: 'For list pagination. When this header appears in the response, additional pages

                of results remain. For important details about how pagination works, see

                [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/BootVolumeReplica'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: ListBootVolumeReplicas
      tags:
      - blockstorage
  /bootVolumeReplicas/{bootVolumeReplicaId}:
    get:
      description: Gets information for the specified boot volume replica.
      operationId: GetBootVolumeReplica
      parameters:
      - $ref: '#/components/parameters/BootVolumeReplicaIdPathParam'
      responses:
        200:
          description: The boot volume replica's information has been retrieved.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BootVolumeReplica'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: GetBootVolumeReplica
      tags:
      - blockstorage
  /bootVolumes:
    get:
      description: 'Lists the boot volumes in the specified compartment and availability domain.

        '
      operationId: ListBootVolumes
      parameters:
      - $ref: '#/components/parameters/RequiredAvailabilityDomainQueryParam'
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/VolumeGroupIdQueryParam'
      responses:
        200:
          description: The list is being retrieved.
          headers:
            opc-next-page:
              description: 'For list pagination. When this header appears in the response, additional pages

                of results remain. For important details about how pagination works, see

                [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/BootVolume'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: ListBootVolumes
      tags:
      - blockstorage
    post:
      description: 'Creates a new boot volume in the specified compartment from an existing boot volume or a boot volume backup.

        For general information about boot volumes, see [Boot Volumes](/iaas/Content/Block/Concepts/bootvolumes.htm).

        You may optionally specify a *display name* for the volume, which is simply a friendly name or

        description. It does not have to be unique, and you can change it. Avoid entering confidential information.

        '
      operationId: CreateBootVolume
      parameters:
      - $ref: '#/components/parameters/RetryTokenHeader'
      responses:
        200:
          description: The boot volume is being created.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BootVolume'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: CreateBootVolume
      tags:
      - blockstorage
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBootVolumeDetails'
        description: Request to create a new boot volume.
        required: true
  /bootVolumes/{bootVolumeId}:
    delete:
      description: 'Deletes the specified boot volume. The volume cannot have an active connection to an instance.

        To disconnect the boot volume from a connected instance, see

        [Disconnecting From a Boot Volume](/iaas/Content/Block/Tasks/deletingbootvolume.htm).

        **Warning:** All data on the boot volume will be permanently lost when the boot volume is deleted.

        '
      operationId: DeleteBootVolume
      parameters:
      - $ref: '#/components/parameters/BootVolumeIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      responses:
        204:
          description: The boot volume is being deleted.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/412'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: DeleteBootVolume
      tags:
      - blockstorage
    get:
      description: Gets information for the specified boot volume.
      operationId: GetBootVolume
      parameters:
      - $ref: '#/components/parameters/BootVolumeIdPathParam'
      responses:
        200:
          description: The boot volume's information has been retrieved.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BootVolume'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: GetBootVolume
      tags:
      - blockstorage
    put:
      description: Updates the specified boot volume's display name, defined tags, and free-form tags.
      operationId: UpdateBootVolume
      parameters:
      - $ref: '#/components/parameters/BootVolumeIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      responses:
        200:
          description: The boot volume was updated.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BootVolume'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: UpdateBootVolume
      tags:
      - blockstorage
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateBootVolumeDetails'
        description: Update boot volume's display name.
        required: true
  /bootVolumes/{bootVolumeId}/actions/changeCompartment:
    post:
      description: 'Moves a boot volume into a different compartment within the same tenancy.

        For information about moving resources between compartments,

        see [Moving Resources to a Different Compartment](/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes).

        '
      operationId: ChangeBootVolumeCompartment
      parameters:
      - $ref: '#/components/parameters/BootVolumeIdPathParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        204:
          description: The BootVolume Compartment Details is being changed
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: ChangeBootVolumeCompartment
      tags:
      - blockstorage
      x-related-resource: '#/definitions/BootVolume'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeBootVolumeCompartmentDetails'
        description: Request to change the compartment of given boot volume.
        required: true
  /bootVolumes/{bootVolumeId}/kmsKey:
    delete:
      description: 'Removes the specified boot volume''s assigned Vault Service encryption key.

        '
      operationId: DeleteBootVolumeKmsKey
      parameters:
      - $ref: '#/components/parameters/BootVolumeIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      responses:
        204:
          description: 'The boot volume''s assigned Vault service encryption key is being removed and replaced with an Oracle-managed encryption key.

            '
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/compone

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