API de archivos de contenedor
Usted o los agentes pueden utilizar la API de contenedores para cargar, mantener y recuperar archivos en un entorno de contenedor protegido y en entorno de prueba.
Este sistema de archivos localizado mantiene los conjuntos de datos y las salidas generadas (como gráficos o logs) disponibles en varios pasos de una tarea, lo que permite flujos de trabajo de varias etapas sin problemas y el intercambio de datos programáticos sin transferir contenido manualmente entre pasos.
La API de archivos de contenedor de OCI utiliza el mismo formato que la API de archivos de contenedor de OpenAI con el punto final compatible con OpenAI de OCI. Para obtener información sobre la sintaxis y las solicitudes, consulte la documentación de la API de archivos de contenedor de OpenAI.
Punto final de API soportado
| URL Base | Ruta de punto final | Autenticación |
|---|---|---|
https://inference.generativeai.${region}.oci.oraclecloud.com/openai/v1 |
/containers/{id}/files |
Clave de API o sesión de IAM |
Sustituya ${region} por una región de OCI soportada como us-chicago-1.
Aunque el formato de solicitud es compatible con OpenAI, la autenticación utiliza credenciales de OCI, las solicitudes se enrutan a través de puntos finales de inferencia de OCI Generative AI y los recursos y la ejecución permanecen en OCI.
Para conocer los pasos que se deben realizar antes de utilizar esta API, consulte QuickStart.
Autenticación
Puede acceder a los puntos finales compatibles con OpenAI de OCI de dos formas:
Utilice claves de API para las pruebas y el desarrollo temprano. Utiliza la autenticación basada en IAM para cargas de trabajo de producción y entornos gestionados por OCI.
Creación de un archivo de contenedor
POST /containers/{container_id}/files
- Referencia
-
Ejemplo:
# create container file container_file = client.containers.files.create( container_id="container_id", file=open("data.csv", "rb"), ) print(container_file.id)
Listado de archivos de contenedor
GET /containers/{container_id}/files
- Referencia
-
Mostrar archivos de contenedor
Ejemplo:
# list container files page = client.containers.files.list( container_id="container_id", ) page = page.data[0] print(page.id)
Recuperando información de archivo de contenedor
GET /containers/{container_id}/files/{file_id}
- Referencia
-
Recuperar archivo de contenedor
Ejemplo:
# 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)
Supresión de un archivo de contenedor
DELETE /containers/{container_id}/files/{file_id}
- Referencia
-
Suprimir archivo de contenedor
Ejemplo:
# delete container file client.containers.files.delete( file_id="file_id", container_id="container_id", )