Oracle Object Storage API

openapi: 3.2.0
info:
  title: Oracle Object Storage API
  version: '20160918'
  license:
    name: Oracle Corporation
  description: 'Operations tagged objectStorage across 2 of this provider''s published API definitions: oci-objectstorage-openapi.yaml, oci-s3objectstorage-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://127.0.0.1/
tags:
- name: objectStorage
paths:
  /n/:
    get:
      description: 'Each Oracle Cloud Infrastructure tenant is assigned one unique and uneditable Object Storage namespace. The namespace

        is a system-generated string assigned during account creation. For some older tenancies, the namespace string may be

        the tenancy name in all lower-case letters. You cannot edit a namespace.


        GetNamespace returns the name of the Object Storage namespace for the user making the request.

        If an optional compartmentId query parameter is provided, GetNamespace returns the namespace name of the corresponding

        tenancy, provided the user has access to it.

        '
      operationId: GetNamespace
      parameters:
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      - $ref: '#/components/parameters/OptionalCompartmentIdQueryParam'
      responses:
        200:
          description: The requesting user's Object Storage namespace string.
          content:
            application/json:
              schema:
                pattern: '[A-Za-z][A-Za-z0-9\\-_\\.]+'
                type: string
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        408:
          $ref: '#/components/responses/RequestTimeout'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: GET Namespace Name
      tags:
      - objectStorage
      x-example: 'GET /n/ HTTP/1.1

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

        connection: keep-alive

        accept-encoding: gzip, deflate

        accept: */*

        user-agent: python-requests/2.11.0

        date: Fri, 12 Aug 2016 22:42:15 GMT

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

        '
      x-related-resource: '#/definitions/Namespace'
  /n/{namespaceName}:
    get:
      description: 'Gets the metadata for the Object Storage namespace, which contains defaultS3CompartmentId and

        defaultSwiftCompartmentId.


        Any user with the OBJECTSTORAGE_NAMESPACE_READ permission will be able to see the current metadata. If you are

        not authorized, talk to an administrator. If you are an administrator who needs to write policies

        to give users access, see

        [Getting Started with Policies](/Content/Identity/Concepts/policygetstarted.htm).

        '
      operationId: GetNamespaceMetadata
      parameters:
      - $ref: '#/components/parameters/NamespacePathParam'
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      responses:
        200:
          description: The default metadata.
          headers:
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NamespaceMetadata'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        404:
          $ref: '#/components/responses/NotAuthorizedOrNotFound'
        408:
          $ref: '#/components/responses/RequestTimeout'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: GET Namespace Metadata
      tags:
      - objectStorage
      x-example: 'GET /n/<var>&lt;namespace_metadata&gt;</var> HTTP/1.1

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

        connection: keep-alive

        accept-encoding: gzip, deflate

        accept: */*

        user-agent: python-requests/2.11.0

        date: Fri, 12 Aug 2016 22:42:15 GMT

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

        '
      x-related-resource: '#/definitions/Namespace'
    put:
      description: 'By default, buckets created using the Amazon S3 Compatibility API or the Swift API are created in the root

        compartment of the Oracle Cloud Infrastructure tenancy.


        You can change the default Swift/Amazon S3 compartmentId designation to a different compartmentId. All

        subsequent bucket creations will use the new default compartment, but no previously created

        buckets will be modified. A user must have OBJECTSTORAGE_NAMESPACE_UPDATE permission to make changes to the default

        compartments for Amazon S3 and Swift.

        '
      operationId: UpdateNamespaceMetadata
      parameters:
      - $ref: '#/components/parameters/NamespacePathParam'
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      responses:
        200:
          description: The updated NamespaceMetadata information.
          headers:
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NamespaceMetadata'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        404:
          $ref: '#/components/responses/NotAuthorizedOrNotFound'
        408:
          $ref: '#/components/responses/RequestTimeout'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: PUT Namespace
      tags:
      - objectStorage
      x-example: "PUT /n/<var>&lt;namespace_metadata&gt;</var> HTTP/1.1\nHost: objectstorage.us-phoenix-1.oraclecloud.com\nconnection: keep-alive\naccept-encoding: gzip, deflate\naccept: */*\nuser-agent: python-requests/2.11.0\ndate: Fri, 12 Aug 2016 22:50:18 GMT\ncontent-type: application/json\nauthorization: <var>&lt;authorization and other headers&gt;</var>\n{\n  \"defaultS3CompartmentId\": \"ocid.compartment.oc1..exampleuniquecompartmentS3ID\",\n  \"defaultSwiftCompartmentId\": \"ocid.compartment.oc1..exampleuniquecompartmentSwiftID\"\n}\n"
      x-related-resource: '#/definitions/Namespace'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateNamespaceMetadataDetails'
        description: Request object for update NamespaceMetadata.
        required: true
  /n/{namespaceName}/b/:
    get:
      description: 'Gets a list of all BucketSummary items in a compartment. A BucketSummary contains only summary fields for the bucket

        and does not contain fields like the user-defined metadata.


        ListBuckets returns a BucketSummary containing at most 1000 buckets. To paginate through more buckets, use the returned

        `opc-next-page` value with the `page` request parameter.


        To use this and other API operations, you must be authorized in an IAM policy. If you are not authorized,

        talk to an administrator. If you are an administrator who needs to write policies to give users access, see

        [Getting Started with Policies](/Content/Identity/Concepts/policygetstarted.htm).

        '
      operationId: ListBuckets
      parameters:
      - $ref: '#/components/parameters/NamespacePathParam'
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/ListBucketFieldsQueryParam'
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      responses:
        200:
          description: A page of BucketSummary objects.
          headers:
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-next-page:
              description: 'For paginating a list of buckets.

                In the GET request, set the limit to the number of buckets items that you want returned in the response.

                If the `opc-next-page` header appears in the response, then this is a partial list and there are additional

                buckets to get. Include the header''s value as the `page` parameter in the subsequent GET request to get the

                next batch of buckets. Repeat this process to retrieve the entire list of buckets.

                By default, the page limit is set to 25 buckets per page, but you can specify a value from 1 to 1000.


                For more 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, provide this request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/BucketSummary'
                type: array
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        404:
          $ref: '#/components/responses/NotAuthorizedOrNotFound'
        408:
          $ref: '#/components/responses/RequestTimeout'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: List Buckets
      tags:
      - objectStorage
      x-example: 'GET /n/<var>&lt;namespace_string&gt;</var>/b/ HTTP/1.1

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

        connection: keep-alive

        accept-encoding: gzip, deflate

        accept: */*

        user-agent: python-requests/2.11.0

        date: Fri, 20 Jan 2017 22:52:33 GMT

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

        '
      x-related-resource: '#/definitions/Bucket'
    post:
      description: 'Creates a bucket in the given namespace with a bucket name and optional user-defined metadata. Avoid entering

        confidential information in bucket names.

        '
      operationId: CreateBucket
      parameters:
      - $ref: '#/components/parameters/NamespacePathParam'
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      responses:
        200:
          description: The complete bucket representation, including fields set by the server.
          headers:
            ETag:
              description: The entity tag (ETag) for the bucket that was created.
              schema:
                type: string
            Location:
              description: The full path to the bucket that was created.
              schema:
                type: string
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bucket'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        404:
          $ref: '#/components/responses/NotAuthorizedOrNotFound'
        408:
          $ref: '#/components/responses/RequestTimeout'
        409:
          $ref: '#/components/responses/NotAuthorizedOrInternalConflict'
        411:
          $ref: '#/components/responses/ContentLengthRequired'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: Create Bucket
      tags:
      - objectStorage
      x-example: "POST /n/<var>&lt;namespace_string&gt;</var>/b/ HTTP/1.1\nHost: objectstorage.us-phoenix-1.oraclecloud.com\nconnection: keep-alive\naccept-encoding: gzip, deflate\naccept: */*\nuser-agent: python-requests/2.11.0\ndate: Fri, 12 Aug 2016 22:50:18 GMT\nx-content-sha256: GzeGbC8Ad9cEhdcnD2wjPiUej5TIHHw2I+uj4w7Jot4=\nContent-Length: 148\ncontent-type: application/json\nauthorization: <var>&lt;authorization and other headers&gt;</var>\n{\n  \"compartmentId\": \"ocid.compartment.oc1..exampleuniquecompartmentID\",\n  \"namespace\": \"ansh8lvru1zp\",\n  \"objectEventsEnabled\": true,\n  \"name\": \"my-test-1\",\n  \"freeformTags\": {\"Department\": \"Finance\"},\n  \"definedTags\":\n  {\n    \"MyTags\":\n    {\n      \"CostCenter\": \"42\",\n      \"Project\": \"Stealth\",\n      \"CreatedBy\": \"BillSmith\",\n      \"CreatedDate\": \"9/21/2017T14:00\"\n    },\n    \"Audit\":\n    {\n      \"DataSensitivity\": \"PII\",\n      \"CageSecurity\": \"High\",\n      \"Simplicity\": \"complex\"\n    }\n  }\n}\n"
      x-related-resource: '#/definitions/Bucket'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBucketDetails'
        description: Request object for creating a bucket.
        required: true
  /n/{namespaceName}/b/{bucketName}/:
    delete:
      description: 'Deletes a bucket if the bucket is already empty. If the bucket is not empty, use

        [DeleteObject](#/en/objectstorage/20160918/Object/DeleteObject) first. In addition,

        you cannot delete a bucket that has a multipart upload in progress or a pre-authenticated

        request associated with that bucket.

        '
      operationId: DeleteBucket
      parameters:
      - $ref: '#/components/parameters/NamespacePathParam'
      - $ref: '#/components/parameters/BucketPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      responses:
        204:
          description: The response body is always empty.
          headers:
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        404:
          $ref: '#/components/responses/NotAuthorizedOrNotFound'
        408:
          $ref: '#/components/responses/RequestTimeout'
        409:
          $ref: '#/components/responses/NotAuthorizedOrInternalConflict'
        412:
          $ref: '#/components/responses/PreconditionFailed'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: DELETE Bucket
      tags:
      - objectStorage
      x-example: 'DELETE /n/<var>&lt;namespace_string&gt;</var>/b/<var>&lt;bucket_name&gt;</var> HTTP/1.1

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

        connection: keep-alive

        accept-encoding: gzip, deflate

        accept: */*

        user-agent: python-requests/2.11.0

        date: Fri, 12 Aug 2016 23:04:28 GMT

        content-length: 0

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

        '
      x-related-resource: '#/definitions/Bucket'
    get:
      description: 'Gets the current representation of the given bucket in the given Object Storage namespace.

        '
      operationId: GetBucket
      parameters:
      - $ref: '#/components/parameters/NamespacePathParam'
      - $ref: '#/components/parameters/BucketPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/IfNoneMatchHeaderExceptStar'
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      - $ref: '#/components/parameters/GetBucketFieldsQueryParam'
      responses:
        200:
          description: A bucket representation for the requested bucket.
          headers:
            ETag:
              description: The current entity tag (ETag) for the bucket.
              schema:
                type: string
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bucket'
        304:
          description: Not Modified
          headers:
            ETag:
              description: The current entity tag (ETag) for the bucket.
              schema:
                type: string
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        404:
          $ref: '#/components/responses/NotAuthorizedOrNotFound'
        408:
          $ref: '#/components/responses/RequestTimeout'
        412:
          $ref: '#/components/responses/PreconditionFailed'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: GET Bucket
      tags:
      - objectStorage
      x-example: 'GET /n/<var>&lt;namespace_string&gt;</var>/b/<var>&lt;bucket_name&gt;</var> HTTP/1.1

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

        connection: keep-alive

        accept-encoding: gzip, deflate

        accept: */*

        user-agent: python-requests/2.11.0

        date: Fri, 12 Aug 2016 22:52:33 GMT

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

        '
      x-related-resource: '#/definitions/Bucket'
    head:
      description: 'Efficiently checks to see if a bucket exists and gets the current entity tag (ETag) for the bucket.

        '
      operationId: HeadBucket
      parameters:
      - $ref: '#/components/parameters/NamespacePathParam'
      - $ref: '#/components/parameters/BucketPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/IfNoneMatchHeaderExceptStar'
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      responses:
        200:
          description: The bucket exists.
          headers:
            ETag:
              description: The current entity tag (ETag) for the bucket.
              schema:
                type: string
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

                '
              schema:
                type: string
        304:
          description: Not Modified
          headers:
            ETag:
              description: The current entity tag (ETag) for the bucket.
              schema:
                type: string
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        404:
          $ref: '#/components/responses/NotAuthorizedOrNotFound'
        408:
          $ref: '#/components/responses/RequestTimeout'
        412:
          $ref: '#/components/responses/PreconditionFailed'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: HEAD Bucket
      tags:
      - objectStorage
      x-example: 'HEAD /n/<var>&lt;namespace_string&gt;</var>/b/<var>&lt;bucket_name&gt;</var> HTTP/1.1

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

        connection: keep-alive

        accept-encoding: gzip, deflate

        accept: */*

        user-agent: python-requests/2.11.0

        date: Fri, 12 Aug 2016 22:52:33 GMT

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

        '
      x-related-resource: '#/definitions/Bucket'
    post:
      description: 'Performs a partial or full update of a bucket''s user-defined metadata.


        Use UpdateBucket to move a bucket from one compartment to another within the same tenancy. Supply the compartmentID

        of the compartment that you want to move the bucket to. For more information about moving resources between compartments,

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

        '
      operationId: UpdateBucket
      parameters:
      - $ref: '#/components/parameters/NamespacePathParam'
      - $ref: '#/components/parameters/BucketPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      responses:
        200:
          description: The full representation of the bucket, including fields set by the server.
          headers:
            ETag:
              description: The entity tag (ETag) for the updated bucket.
              schema:
                type: string
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bucket'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        404:
          $ref: '#/components/responses/NotAuthorizedOrNotFound'
        408:
          $ref: '#/components/responses/RequestTimeout'
        409:
          $ref: '#/components/responses/NotAuthorizedOrInternalConflict'
        412:
          $ref: '#/components/responses/PreconditionFailed'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: POST Bucket
      tags:
      - objectStorage
      x-example: "POST /n/<var>&lt;namespace_string&gt;</var>/b/<var>&lt;bucket_name&gt;</var> HTTP/1.1\nHost: objectstorage.us-phoenix-1.oraclecloud.com\nconnection: keep-alive\naccept-encoding: gzip, deflate\naccept: */*\nuser-agent: python-requests/2.10.0\ndate: Tue, 23 Aug 2016 21:01:55 GMT\nx-content-sha256: XK0yY+agfR3IHWjFyQlO5LCU8IysvgpDdDGSRrb/xzA=\nContent-Length: 80\ncontent-type: application/json\nauthorization: <var>&lt;authorization and other headers&gt;</var>\n{\n  \"namespace\": \"ansh8lvru1zp\",\n  \"name\": \"MyBucket\",\n  \"metadata\":\n    {\n      \"foo\": \"bar\"\n    },\n  \"objectEventsEnabled\": true,  \n  \"freeformTags\": {\"Department\": \"Finance\"},\n  \"definedTags\":\n  {\n    \"MyTags\":\n    {\n      \"CostCenter\": \"42\",\n       \"Project\": \"Stealth\",\n      \"CreatedBy\": \"BillSmith\",\n      \"CreatedDate\": \"9/21/2017T14:00\"\n    },\n    \"Audit\":\n    {\n      \"DataSensitivity\": \"PII\",\n      \"CageSecurity\": \"High\",\n      \"Simplicity\": \"complex\"\n    }\n  }\n}\n"
      x-related-resource: '#/definitions/Bucket'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateBucketDetails'
        description: Request object for updating a bucket.
        required: true
  /n/{namespaceName}/b/{bucketName}/actions/batchDeleteObjects:
    post:
      description: Deletes a batch of objects.
      operationId: BatchDeleteObjects
      parameters:
      - $ref: '#/components/parameters/NamespacePathParam'
      - $ref: '#/components/parameters/BucketPathParam'
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      responses:
        200:
          description: Always returns this status code if the request was processed after validation, authentication and authorization.
          headers:
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchDeleteObjectsResult'
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        403:
          $ref: '#/components/responses/Forbidden'
        404:
          $ref: '#/components/responses/NotAuthorizedOrNotFound'
        408:
          $ref: '#/components/responses/RequestTimeout'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: Deletes a batch of objects.
      tags:
      - objectStorage
      x-example: "POST /n/example_namespace/b/example_bucket/actions/deleteObjects\nHost: objectstorage.us-phoenix-1.oraclecloud.com\nUser-Agent: curl/7.43.0\nAccept: */*\nContent-Type: application/json\nContent-Length: 139\nDate: Fri, 31 Oct 2025 11:50:24 GMT\nAuthorization: <var>&lt;authorization_string&gt;</var>\n{\n  \"objects\": [\n    {\n      \"objectName\": \"object1\",\n      \"ifMatch\": \"etag1\"\n    },\n    {\n      \"objectName\": \"object2\",\n      \"ifMatch\": \"etag1\"\n    },\n    {\n      \"objectName\": \"object3\",\n    }\n  ],\n  \"isSkipDeletedResult\": false\n}\n"
      x-related-resource: '#/definitions/Object'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchDeleteObjectsDetails'
        description: Details about batch of objects to be deleted.
        required: true
  /n/{namespaceName}/b/{bucketName}/actions/copyObject:
    post:
      description: 'Creates a request to copy an object within a region or to another region.


        See [Object Names](/Content/Object/Tasks/managingobjects.htm#namerequirements)

        for object naming requirements.

        '
      operationId: CopyObject
      parameters:
      - $ref: '#/components/parameters/NamespacePathParam'
      - $ref: '#/components/parameters/BucketPathParam'
      - $ref: '#/components/parameters/ClientRequestIdHeader'
      - $ref: '#/components/parameters/OptionalSSECustomerAlgorithmHeader'
      - $ref: '#/components/parameters/OptionalSSECustomerKeyHeader'
      - $ref: '#/components/parameters/OptionalSSECustomerKeySHA256Header'
      - $ref: '#/components/parameters/OptionalSrcSSECustomerAlgorithmHeader'
      - $ref: '#/components/parameters/OptionalSrcSSECustomerKeyHeader'
      - $ref: '#/components/parameters/OptionalSrcSSECustomerKeySHA256Header'
      - $ref: '#/components/parameters/OptionalSSEKMSKeyIdHeader'
      responses:
        202:
          description: The request has been accepted for processing, but the processing has not completed.
          headers:
            opc-client-request-id:
              description: Echoes back the value passed in the opc-client-request-id header, for use by clients when debugging.
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

                request, provide this request ID.

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

                particular request, provide this request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/BadRequest'
        401:
          $ref: '#/components/responses/NotAuthenticated'
        404:
          $ref: '#/components/responses/NotAuthorizedOrNotFound'
        408:
          $ref: '#/components/responses/RequestTimeout'
        429:
          $ref: '#/components/responses/TooManyRequests'
        500:
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/Error'
      summary: Creates a copy 

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