Oracle Cloud Infrastructure · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Oracle Cloud Object Storage Objects API

5 actions 5 updates phrasing extends openapi/oracle-cloud-objects-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Oracle Cloud Infrastructure's API. It is a proposal applied on top of the contract, not a document Oracle Cloud Infrastructure publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info

$.paths['/n/{namespaceName}/b/{bucketName}/o'].get

$.paths['/n/{namespaceName}/b/{bucketName}/o/{objectName}'].get

$.paths['/n/{namespaceName}/b/{bucketName}/o/{objectName}'].put

$.paths['/n/{namespaceName}/b/{bucketName}/o/{objectName}'].delete

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Oracle Cloud Object Storage Objects API
  version: 1.0.0
extends: openapi/oracle-cloud-objects-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/n/{namespaceName}/b/{bucketName}/o'].get
  update:
    x-apievangelist-phrasing:
      intent: List objects in a storage bucket
      effect: read
      questions:
      - What files are stored in my Object Storage bucket?
      - Can I list only the objects whose names start with a given prefix?
      - Is there a way to browse a bucket like folders using a delimiter?
      instructions:
      - text: List the objects in bucket {bucketName} in namespace {namespaceName}.
        slots:
          bucketName: path.bucketName
          namespaceName: path.namespaceName
      - text: List objects starting with {prefix} in bucket {bucketName}, namespace {namespaceName}.
        slots:
          prefix: query.prefix
          bucketName: path.bucketName
          namespaceName: path.namespaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/n/{namespaceName}/b/{bucketName}/o/{objectName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download an object from a bucket
      effect: read
      questions:
      - How do I download a file from an Object Storage bucket?
      - Can I fetch both an object's contents and its metadata in one call?
      instructions:
      - text: Download object {objectName} from bucket {bucketName} in namespace {namespaceName}.
        slots:
          objectName: path.objectName
          bucketName: path.bucketName
          namespaceName: path.namespaceName
      - text: Get the contents of {objectName} in {bucketName} ({namespaceName}).
        slots:
          objectName: path.objectName
          bucketName: path.bucketName
          namespaceName: path.namespaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/n/{namespaceName}/b/{bucketName}/o/{objectName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload or overwrite an object in a bucket
      effect: write
      questions:
      - How do I upload a file to an Object Storage bucket?
      - What happens if I upload an object with a name that already exists?
      instructions:
      - text: Upload {objectName} to bucket {bucketName} in namespace {namespaceName}.
        slots:
          objectName: path.objectName
          bucketName: path.bucketName
          namespaceName: path.namespaceName
      - text: Overwrite {objectName} in {bucketName} ({namespaceName}) with content of type {Content-Type}.
        slots:
          objectName: path.objectName
          bucketName: path.bucketName
          namespaceName: path.namespaceName
          Content-Type: header.Content-Type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/n/{namespaceName}/b/{bucketName}/o/{objectName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an object from a bucket
      effect: destructive
      questions:
      - How do I delete a file from an Object Storage bucket?
      - Can I remove a single object by name?
      instructions:
      - text: Delete object {objectName} from bucket {bucketName} in namespace {namespaceName}.
        slots:
          objectName: path.objectName
          bucketName: path.bucketName
          namespaceName: path.namespaceName
      - text: Remove {objectName} from {bucketName} ({namespaceName}).
        slots:
          objectName: path.objectName
          bucketName: path.bucketName
          namespaceName: path.namespaceName
      method: generated
      generated: '2026-09-26'