Oracle File Storage API

openapi: 3.2.0
info:
  description: 'Use the File Storage service API to manage file systems, mount targets, and snapshots.

    For more information, see [Overview of File Storage](/iaas/Content/File/Concepts/filestorageoverview.htm).

    '
  license:
    name: Oracle Corporation
  title: File Storage API
  version: '20171215'
  x-provenance:
    method: harvested
    first_party: true
    publisher: Oracle
    source: https://docs.oracle.com/en-us/iaas/api/specs/03910bbbf4069eae795fb5379eac310de31b96fcdda714cbe4aa8c55b597c9ae.yaml
    harvested: '2026-08-04'
    note: Published by Oracle as the contract for the File Storage API OCI service and stored verbatim; API Evangelist added only this provenance block.
  x-evidence:
  - url: https://docs.oracle.com/en-us/iaas/api/specs/index.json
    what: Oracle's own index of every OCI service specification
  - url: https://docs.oracle.com/en-us/iaas/api/specs/03910bbbf4069eae795fb5379eac310de31b96fcdda714cbe4aa8c55b597c9ae.yaml
    what: the harvested document for File Storage API
servers:
- url: /20171215
tags:
- name: fileStorage
paths:
  /exportSets:
    get:
      description: 'Lists the export set resources in the specified compartment.

        '
      operationId: ListExportSets
      parameters:
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/AvailabilityDomainQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/DisplayNameQueryParam'
      - $ref: '#/components/parameters/LifecycleStateQueryParam'
      - $ref: '#/components/parameters/OcidQueryParam'
      - $ref: '#/components/parameters/ExportSetSortByQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      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/ExportSetSummary'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: ListExportSets
      tags:
      - fileStorage
      x-example: 'GET /20171215/exportSets?compartmentId=<var>&lt;compartmentId&gt;</var>&availabilityDomain=<var>&lt;availabilityDomain&gt;</var>

        Host: filestorage.us-phoenix-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
  /exportSets/{exportSetId}:
    get:
      description: Gets the specified export set's information.
      operationId: GetExportSet
      parameters:
      - $ref: '#/components/parameters/ExportSetIdPathParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The export set 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/ExportSet'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: GetExportSet
      tags:
      - fileStorage
      x-example: 'GET /20171215/exportSets/<var>&lt;exportSetId&gt;</var>

        Host: filestorage.us-phoenix-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
    put:
      description: Updates the specified export set's information.
      operationId: UpdateExportSet
      parameters:
      - $ref: '#/components/parameters/ExportSetIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The export set 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/ExportSet'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: UpdateExportSet
      tags:
      - fileStorage
      x-example: "PUT /20171215/exportSets/<var>&lt;exportSetId&gt;</var>\nHost: filestorage.us-phoenix-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n{\n  \"displayName\": \"mount-target-5-new-exportset\"\n}\n"
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateExportSetDetails'
        description: Details object for updating an export set.
        required: true
  /exports:
    get:
      description: 'Lists export resources by compartment, file system, or export

        set. You must specify an export set ID, a file system ID, and

        / or a compartment ID.

        '
      operationId: ListExports
      parameters:
      - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/ExportSetOptionalQueryParam'
      - $ref: '#/components/parameters/FileSystemOptionalQueryParam'
      - $ref: '#/components/parameters/LifecycleStateQueryParam'
      - $ref: '#/components/parameters/OcidQueryParam'
      - $ref: '#/components/parameters/ExportSortByQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      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/ExportSummary'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: ListExports
      tags:
      - fileStorage
      x-example: "GET /20171215/exports?compartmentId=<var>&lt;compartmentId&gt;</var>\nHost: filestorage.us-phoenix-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n{\n  \"exportSetId\" : \"ocid1.exportset.oc1..<var>&lt;unique_ID&gt;</var>\"\n}\n"
    post:
      description: 'Creates a new export in the specified export set, path, and

        file system.

        '
      operationId: CreateExport
      parameters:
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The export was 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/Export'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: CreateExport
      tags:
      - fileStorage
      x-example: "POST /20171215/exports\nHost: filestorage.us-phoenix-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n{\n    \"exportOptions\": [\n        {\n          \"source\": \"10.0.0.0/16\",\n          \"requirePrivilegedSourcePort\": true,\n          \"access\": \"READ_WRITE\",\n          \"identitySquash\": \"NONE\",\n          \"anonymousUid\": 0,\n          \"anonymousGid\": 0\n        }\n    ]\n  \"exportSetId\" : \"ocid1.exportset.oc1..<var>&lt;unique_ID&gt;</var>\",\n  \"fileSystemId\" : \"ocid1.filesystem.oc1..<var>&lt;unique_ID&gt;</var>\",\n  \"path\" : \"/files-5\"\n}\n"
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateExportDetails'
        description: Details for creating a new export.
        required: true
  /exports/{exportId}:
    delete:
      description: 'Deletes the specified export.

        '
      operationId: DeleteExport
      parameters:
      - $ref: '#/components/parameters/ExportIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      - $ref: '#/components/parameters/OverrideLocksQueryParameter'
      responses:
        204:
          description: The export 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
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: DeleteExport
      tags:
      - fileStorage
      x-example: 'DELETE /20171215/exports/<var>&lt;exportId&gt;</var>

        Host: filestorage.us-phoenix-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
      x-related-resource: '#/definitions/Export'
    get:
      description: Gets the specified export's information.
      operationId: GetExport
      parameters:
      - $ref: '#/components/parameters/ExportIdPathParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The export 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/Export'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: GetExport
      tags:
      - fileStorage
      x-example: 'GET /20171215/exports/<var>&lt;exportSetId&gt;</var>

        Host: filestorage.us-phoenix-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
    put:
      description: Updates the specified export's information.
      operationId: UpdateExport
      parameters:
      - $ref: '#/components/parameters/ExportIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      - $ref: '#/components/parameters/OverrideLocksQueryParameter'
      responses:
        200:
          description: The export 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/Export'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: UpdateExport
      tags:
      - fileStorage
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateExportDetails'
        description: Details object for updating an export.
        required: true
  /exports/{exportId}/actions/addLock:
    post:
      description: Adds a lock to a resource.
      operationId: AddExportLock
      parameters:
      - $ref: '#/components/parameters/ExportIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: Lock is added.
          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/Export'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Adds a lock to a resource.
      tags:
      - fileStorage
      x-related-resource: '#/definitions/Export'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceLock'
        description: The details to be updated for the AddLock.
        required: true
  /exports/{exportId}/actions/removeLock:
    post:
      description: Removes a lock to a resource.
      operationId: RemoveExportLock
      parameters:
      - $ref: '#/components/parameters/ExportIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: Lock is removed.
          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/Export'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Removes a lock to a resource.
      tags:
      - fileStorage
      x-related-resource: '#/definitions/Export'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceLock'
        description: The details to be updated for the RemoveLock.
        required: true
  /fileSystems:
    get:
      description: 'Lists the file system resources in the specified compartment, or by the specified compartment and

        file system snapshot policy.

        '
      operationId: ListFileSystems
      parameters:
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/AvailabilityDomainQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/DisplayNameQueryParam'
      - $ref: '#/components/parameters/LifecycleStateQueryParam'
      - $ref: '#/components/parameters/OcidQueryParam'
      - $ref: '#/components/parameters/sourceSnapshotIdQueryParam'
      - $ref: '#/components/parameters/parentFileSystemIdQueryParam'
      - $ref: '#/components/parameters/FilesystemSnapshotPolicyIdListFsOptionalQueryParam'
      - $ref: '#/components/parameters/FileSystemSortByQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      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/FileSystemSummary'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: ListFileSystems
      tags:
      - fileStorage
      x-example: 'GET /20171215/fileSystems?compartmentId=<var>&lt;compartmentId&gt;</var>&availabilityDomain=<var>&lt;availabilityDomain&gt;</var>

        Host: filestorage.us-phoenix-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
    post:
      description: 'Creates a new file system in the specified compartment and

        availability domain. Instances can mount file systems in

        another availability domain, but doing so might increase

        latency when compared to mounting instances in the same

        availability domain.


        After you create a file system, you can associate it with a mount

        target. Instances can then mount the file system by connecting to the

        mount target''s IP address. You can associate a file system with

        more than one mount target at a time.


        For information about access control and compartments, see

        [Overview of the IAM Service](/Content/Identity/Concepts/overview.htm).


        For information about Network Security Groups access control, see

        [Network Security Groups](/Content/Network/Concepts/networksecuritygroups.htm).


        For information about availability domains, see [Regions and

        Availability Domains](/Content/General/Concepts/regions.htm).

        To get a list of availability domains, use the

        `ListAvailabilityDomains` operation in the Identity and Access

        Management Service API.


        All Oracle Cloud Infrastructure resources, including

        file systems, get an Oracle-assigned, unique ID called an Oracle

        Cloud Identifier ([OCID](/Content/General/Concepts/identifiers.htm)).

        When you create a resource, you can find its OCID in the response.

        You can also retrieve a resource''s OCID by using a List API operation on that resource

        type or by viewing the resource in the Console.

        '
      operationId: CreateFileSystem
      parameters:
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The file system was 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/FileSystem'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: CreateFileSystem
      tags:
      - fileStorage
      x-example: "POST /20171215/fileSystems\nHost: filestorage.us-phoenix-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n{\n  \"availabilityDomain\" : \"pWEh:PHX-AD-2\",\n  \"compartmentId\" : \"ocid1.compartment.oc1..<var>&lt;unique_ID&gt;</var>\",\n  \"displayName\" : \"media-files-1\"\n}\n"
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFileSystemDetails'
        description: Details for creating a new file system.
        required: true
  /fileSystems/{fileSystemId}:
    delete:
      description: 'Deletes the specified file system. Before you delete the file system,

        verify that no remaining export resources still reference it. Deleting a

        file system also deletes all of its snapshots.

        '
      operationId: DeleteFileSystem
      parameters:
      - $ref: '#/components/parameters/FileSystemIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      - $ref: '#/components/parameters/OverrideLocksQueryParameter'
      - $ref: '#/components/parameters/CanDetachChildFileSystemQueryParam'
      responses:
        204:
          description: The file system 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
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: DeleteFileSystem
      tags:
      - fileStorage
      x-example: 'DELETE /20171215/fileSystems/<var>&lt;fileSystemId&gt;</var>

        &canDetachChildFileSystem=<var>&lt;canDetachChildFileSystem&gt;</var>

        Host: filestorage.us-phoenix-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
      x-related-resource: '#/definitions/FileSystem'
    get:
      description: Gets the specified file system's information.
      operationId: GetFileSystem
      parameters:
      - $ref: '#/components/parameters/FileSystemIdPathParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The file system 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/FileSystem'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: GetFileSystem
      tags:
      - fileStorage
      x-example: 'GET /20171215/fileSystems/<var>&lt;fileSystemId&gt;</var>

        Host: filestorage.us-phoenix-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
    put:
      description: 'Updates the specified file system''s information.

        You can use this operation to rename a file system.

        '
      operationId: UpdateFileSystem
      parameters:
      - $ref: '#/components/parameters/FileSystemIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      - $ref: '#/components/parameters/OverrideLocksQueryParameter'
      responses:
        200:
          description: The file system 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/FileSystem'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: UpdateFileSystem
      tags:
      - fileStorage
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFileSystemDetails'
        description: Details object for updating a file system.
        required: true
  /fileSystems/{fileSystemId}/actions/addLock:
    post:
      description: Adds a lock to a resource.
      operationId: AddFileSystemLock
      parameters:
      - $ref: '#/components/parameters/FileSystemIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: Lock is added.
          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/FileSystem'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/respon

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