Documentação do Oracle Cloud Infrastructure

API de arquivos contêiner

Você ou os agentes podem usar a API Contêineres para fazer upload, persistir e recuperar arquivos em um ambiente de contêiner seguro e em sandbox.

Esse sistema de arquivos localizado mantém conjuntos de dados e saídas geradas (como gráficos ou logs) disponíveis em várias etapas de uma tarefa, permitindo fluxos de trabalho de vários estágios contínuos e troca de dados programáticos sem passar manualmente o conteúdo entre as etapas.

Observação

A API OCI Container Files usa o mesmo formato que a API OpenAI Container Files com o ponto final compatível com o OCI OpenAI. Para obter detalhes de sintaxe e solicitação, consulte a documentação da API OpenAI Container Files.

Ponto Final de API Suportado

URL Base Caminho do Ponto Final Autenticação
https://inference.generativeai.${region}.oci.oraclecloud.com/openai/v1 /containers/{id}/files Chave de API ou sessão do IAM

Substitua ${region} por uma região suportada, como us-chicago-1.

Embora o formato de solicitação seja compatível com OpenAI, a autenticação usa credenciais da OCI, as solicitações são roteadas por meio de pontos finais de inferência da OCI Generative AI e os recursos e a execução permanecem na OCI.

Dica

Para saber as etapas a serem executadas antes de usar essa API, consulte o QuickStart.

Autenticação

Você pode acessar os pontos finais compatíveis com o OCI OpenAI de duas maneiras:

Use chaves de API para teste e desenvolvimento antecipado. Usar autenticação baseada em IAM para cargas de trabalho de produção e ambientes gerenciados pela OCI.

Criando um Arquivo Contêiner

POST /containers/{container_id}/files

Referência

Criar arquivo contêiner

Exemplo:

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

Listando Arquivos Contêineres

GET /containers/{container_id}/files

Referência

Listar arquivos de contêiner

Exemplo:

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

Recuperando informações do arquivo de contêiner

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

Referência

Recuperar arquivo de contêiner

Exemplo:

# 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)

Excluindo um Arquivo Contêiner

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

Referência

Excluir arquivo contêiner

Exemplo:

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