Files - Delete File

Dienst:

AI Foundry

API-Version:

v1

Löschen Einer zuvor hochgeladenen Datei.

DELETE {endpoint}/files/{fileId}?api-version=v1

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string (uri)	Projektendpunkt in Form von: https://.services.ai.azure.com/api/projects/
fileId	path	True	string	Die ID der zu löschenden Datei.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	FileDeletionStatus	Status des Löschvorgangs.
Other Status Codes	AgentV1Error	Unerwartete Fehlerantwort.

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

Name	Beschreibung
https://ai.azure.com/.default

Beispiele

Files_DeleteFile_MaximumSet

Files_DeleteFile_MinimumSet

Files_DeleteFile_MaximumSet

Beispielanforderung

HTTP

DELETE {endpoint}/files/tyaedopyezvvftrscawrfl?api-version=v1

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "xpadlhlkrkdclxvs",
  "deleted": true,
  "object": "file"
}

Files_DeleteFile_MinimumSet

Beispielanforderung

HTTP

DELETE {endpoint}/files/tvdttofovjkpnxbxprgwdvoqdldz?api-version=v1

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "xpadlhlkrkdclxvs",
  "deleted": true,
  "object": "file"
}

Definitionen

Name	Beschreibung
AgentErrorDetail	Beschreibt die Fehlerinformationen, die von der Agenten-API zurückgegeben werden.
AgentV1Error	Fehlernutzlast, die von der Agenten-API zurückgegeben wird.
FileDeletionStatus	Eine Statusantwort eines Dateilöschvorgangs.

AgentErrorDetail

Objekt

Beschreibt die Fehlerinformationen, die von der Agenten-API zurückgegeben werden.

Name	Typ	Beschreibung
code	string	Maschinenlesbarer Fehlercode.
message	string	Für Menschen lesbare Beschreibung des Fehlers.
param	string	Name des Parameters, der den Fehler verursacht hat, falls zutreffend.
type	string	Kennung des Fehlertyps (z. B. invalid_request_error).

AgentV1Error

Objekt

Fehlernutzlast, die von der Agenten-API zurückgegeben wird.

Name	Typ	Beschreibung
error	AgentErrorDetail	Stellt den Fehler dar.

FileDeletionStatus

Objekt

Eine Statusantwort eines Dateilöschvorgangs.

Name	Typ	Beschreibung
deleted	boolean	Ein Wert, der angibt, ob das Löschen erfolgreich war.
id	string	Die ID der zum Löschen angegebenen Ressource.
object	enum: file	Der Objekttyp, der immer "Datei" ist.