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-objectstorage-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

openapi: 3.2.0
info:
  title: Oracle Object Storage API
  version: '20160918'
  license:
    name: Oracle Corporation
  x-refined-note:
  - x-evidence differs across the merged source definitions and was not carried
  - x-provenance differs across the merged source definitions and was not carried
  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://localhost:9000/
- url: https://localhost:9060/
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'
    servers:
    - url: https://localhost:9000/
  /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
    servers:
    - url: https://localhost:9000/
  /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
    servers:
    - url: https://localhost:9000/
  /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
    servers:
    - url: https://localhost:9000/
  /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
    servers:
    - url: https://localhost:9000/
  /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'


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