Oracle Cloud Infrastructure-Dokumentation

Containerdateien-API

Mit der Container-API können Sie Dateien in einer sicheren Sandbox-Containerumgebung hochladen, persistieren und abrufen.

Dieses lokalisierte Dateisystem hält Datasets und generierte Ausgaben (wie Diagramme oder Logs) über mehrere Schritte einer Aufgabe hinweg verfügbar und ermöglicht einen nahtlosen mehrstufigen Workflow und programmatischen Datenaustausch, ohne den Inhalt zwischen den Schritten manuell weiterzugeben.

Hinweis

Die OCI Container Files API verwendet dasselbe Format wie die OpenAI Container Files API mit dem OCI OpenAI-kompatiblen Endpunkt. Syntax- und Anforderungsdetails finden Sie in der Dokumentation zur OpenAI Container Files API.

Unterstützter API-Endpunkt

Basis-URL Endpunktpfad Authentifizierung
https://inference.generativeai.${region}.oci.oraclecloud.com/openai/v1 /containers/{id}/files API-Schlüssel oder IAM-Session

Ersetzen Sie ${region} durch eine unterstützte OCI-Region, wie us-chicago-1.

Obwohl das Anforderungsformat OpenAI-kompatibel ist, verwendet die Authentifizierung OCI-Zugangsdaten, Anforderungen werden über OCI Generative AI-Inferenzendpunkte weitergeleitet, und Ressourcen und Ausführung bleiben in OCI.

Tipp

Die Schritte, die vor der Verwendung dieser API ausgeführt werden müssen, finden Sie unter QuickStart.

Authentifizierung

Sie können auf zwei Arten auf OCI OpenAI-kompatible Endpunkte zugreifen:

Verwenden Sie API-Schlüssel für Tests und frühe Entwicklung. Verwenden Sie die IAM-basierte Authentifizierung für Produktions-Workloads und OCI-verwaltete Umgebungen.

Containerdatei erstellen

POST /containers/{container_id}/files

Referenz

Containerdatei erstellen

Beispiel:

# create container file
container_file = client.containers.files.create(
    container_id="container_id",
    file=open("data.csv", "rb"),
)
print(container_file.id)

Containerdateien auflisten

GET /containers/{container_id}/files

Referenz

Containerdateien auflisten

Beispiel:

# list container files
page = client.containers.files.list(
    container_id="container_id",
)
page = page.data[0]
print(page.id)

Informationen zu Containerdateien werden abgerufen...

GET /containers/{container_id}/files/{file_id}

Referenz

Containerdatei abrufen

Beispiel:

# retrieve container file content
content = client.containers.files.content.retrieve(
    file_id="file_id",
    container_id="container_id",
)
print(content)
data = content.read()
print(data)

Containerdatei löschen

DELETE /containers/{container_id}/files/{file_id}

Referenz

Containerdatei löschen

Beispiel:

# delete container file
client.containers.files.delete(
    file_id="file_id",
    container_id="container_id",
)