Upload File - Cancel

Service:

Azure AI Services

Version d'API:

2024-10-21

Annule le chargement et entraîne la suppression asynchrone de toutes les parties chargées. Aucune partie ne peut être ajoutée après l’annulation d’un chargement.

POST {endpoint}/openai/uploads/{upload-id}/cancel?api-version=2024-10-21

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string (url)	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://aoairesource.openai.azure.com. Remplacez « aoairesource » par le nom de votre compte Azure OpenAI).
upload-id	path	True	string	Identificateur du chargement.
api-version	query	True	string	Version de l’API demandée.

En-tête de la demande

Nom	Obligatoire	Type	Description
api-key	True	string	Fournissez votre clé de compte Azure OpenAI Cognitive Services ici.

Réponses

Nom	Type	Description
200 OK	UploadResource	Succès
Other Status Codes	ErrorResponse	Une erreur s’est produite.

Sécurité

api-key

Fournissez votre clé de compte Azure OpenAI Cognitive Services ici.

Type: apiKey
Dans: header

Exemples

Cancel a large file upload operation.

Exemple de requête

HTTP

POST https://aoairesource.openai.azure.com/openai/uploads/fine-tune-72a2792ef7d24ba7b82c7fe4a37e379f/cancel?api-version=2024-10-21

Exemple de réponse

Code d’état:

200

{
  "bytes": 2097152,
  "filename": "training_data_v21.jsonl",
  "purpose": "fine-tune",
  "status": "cancelled",
  "expires_at": 1646133327,
  "file": {
    "status": "processed",
    "bytes": 140,
    "purpose": "fine-tune",
    "filename": "puppy.jsonl",
    "id": "file-181a1cbdcdcf4677ada87f63a0928099",
    "created_at": 1646126127,
    "object": "file"
  },
  "id": "fine-tune-72a2792ef7d24ba7b82c7fe4a37e379f",
  "created_at": 1646126127,
  "object": "upload"
}

Définitions

Nom	Description
Error	Erreur
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
File	Lime
FileState	FileState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
Purpose	But
TypeDiscriminator	TypeDiscriminator
UploadResource	UploadResource
UploadStatus	UploadStatus

Error

Objet

Erreur

Nom	Type	Description
code	ErrorCode	ErrorCode Codes d’erreur tels que définis dans les instructions REST Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Détails de l’erreur s’il est disponible.
innererror	InnerError	InnerError Erreur interne telle que définie dans les instructions REST Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string minLength: 1	Message de cette erreur.
target	string	Emplacement où l’erreur s’est produite si disponible.

ErrorCode

Énumération

ErrorCode

Valeur	Description
conflict	L’opération demandée est en conflit avec l’état de ressource actuel.
invalidPayload	Les données de requête ne sont pas valides pour cette opération.
forbidden	L’opération est interdite pour la clé utilisateur/API actuelle.
notFound	La ressource est introuvable.
unexpectedEntityState	L’opération ne peut pas être exécutée dans l’état de la ressource actuelle.
itemDoesAlreadyExist	L’élément existe déjà.
serviceUnavailable	Le service n’est actuellement pas disponible.
internalFailure	Erreur interne. Réessayez.
quotaExceeded	Quota dépassé.
jsonlValidationFailed	Échec de la validation des données jsonl.
fileImportFailed	Échec de l’importation du fichier.
tooManyRequests	Trop de demandes. Réessayez ultérieurement.
unauthorized	La clé utilisateur/API actuelle n’est pas autorisée pour l’opération.
contentFilter	La génération d’images a échoué suite à notre système de sécurité.

ErrorResponse

Objet

ErrorResponse

Nom	Type	Description
error	Error	Erreur Contenu d’erreur tel que défini dans les instructions REST Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

File

Objet

Lime

Nom	Type	Description
bytes	integer (int64)	Taille de ce fichier lorsqu’il est disponible (peut être null). Les tailles de fichier supérieures à 2^53-1 ne sont pas prises en charge pour garantir la compatibilité avec les entiers JavaScript.
created_at	integer (unixtime)	Horodatage lors de la création de ce travail ou de cet élément (dans les époques unix).
filename	string minLength: 1	Nom du fichier.
id	string	Identité de cet élément.
object	TypeDiscriminator	TypeDiscriminator Définit le type d’un objet.
purpose	Purpose	But Objectif prévu des documents chargés. Utilisez « affiner » pour affiner le réglage. Cela nous permet de valider le format du fichier chargé.
status	FileState	FileState État d’un fichier.
status_details	string	Message d’erreur avec des détails dans le cas où le traitement de ce fichier a échoué.

FileState

Énumération

FileState

Valeur	Description
uploaded	Le fichier a été chargé, mais il n’est pas encore traité. Cet état n’est pas retourné par Azure OpenAI et n’est exposé qu’à des fins de compatibilité. Il peut être classé comme un état inactif.
pending	L’opération a été créée et n’est pas mise en file d’attente pour être traitée ultérieurement. Il peut être classé comme un état inactif.
running	L’opération a commencé à être traitée. Il peut être classé comme état actif.
processed	L’opération a été traitée avec succès et est prête à être consommée. Il peut être classé comme état terminal.
error	L’opération a terminé le traitement avec un échec et ne peut pas être consommée. Il peut être classé comme état terminal.
deleting	L’entité est ni le processus à supprimer. Cet état n’est pas retourné par Azure OpenAI et n’est exposé qu’à des fins de compatibilité. Il peut être classé comme état actif.
deleted	L’entité a été supprimée, mais peut toujours être référencée par d’autres entités avant la suppression. Il peut être classé comme état terminal.

InnerError

Objet

InnerError

Nom	Type	Description
code	InnerErrorCode	InnerErrorCode Codes d’erreur internes tels que définis dans les instructions MICROSOFT REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Erreur interne telle que définie dans les instructions REST Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Énumération

InnerErrorCode

Valeur	Description
invalidPayload	Les données de requête ne sont pas valides pour cette opération.

Purpose

Énumération

But

Valeur	Description
fine-tune	Ce fichier contient des données d’apprentissage pour un travail d’optimisation.
fine-tune-results	Ce fichier contient les résultats d’un travail d’optimisation.
assistants	Ce fichier contient des données à utiliser dans les assistants.
assistants_output	Ce fichier contient les résultats d’un assistant.
batch	Ce fichier contient les données d’entrée d’un lot.
batch_output	Ce fichier contient les résultats d’un lot.

TypeDiscriminator

Énumération

TypeDiscriminator

Valeur	Description
list	Cet objet représente une liste d’autres objets.
fine_tuning.job	Cet objet représente un travail d’optimisation.
file	Cet objet représente un fichier.
fine_tuning.job.event	Cet objet représente un événement d’un travail de réglage précis.
fine_tuning.job.checkpoint	Cet objet représente un point de contrôle d’un travail de réglage précis.
model	Cet objet représente un modèle (il peut s’agir d’un modèle de base ou d’un résultat de travail affiné).
batch	Cet objet représente un lot.
upload	Cet objet représente un chargement de fichier.
upload.part	Cet objet représente une partie d’un chargement de fichier.

UploadResource

Objet

UploadResource

Nom	Type	Description
bytes	integer (int64)
created_at	integer (unixtime)	Horodatage lors de la création de ce travail ou de cet élément (dans les époques unix).
expires_at	integer (unixtime)
file	File	Lime Un fichier est un document utilisable pour l’apprentissage et la validation. Il peut également s’agir d’un document généré par le service avec des détails de résultat.
filename	string
id	string	Identité de cet élément.
object	TypeDiscriminator	TypeDiscriminator Définit le type d’un objet.
purpose	Purpose	But Objectif prévu des documents chargés. Utilisez « affiner » pour affiner le réglage. Cela nous permet de valider le format du fichier chargé.
status	UploadStatus	UploadStatus

UploadStatus

Énumération

UploadStatus

Valeur	Description
pending
expired
completed
cancelled