Share via

Models - Delete

  • Reference
Service:
Azure AI Services
API Version:
2023-04-01-preview

Delete a custom model. A model can be deleted if it is in one of the 'Succeeded', 'Failed', or 'Canceled' states. If a model is in the 'NotStarted' or 'Training' state, cancel training and wait for cancellation to finish before deleting the model.

Status codes returned:

  • 204: Operation completed successfully.
  • 400: The request was malformed.
  • 404: A model with the specified name was not found.
DELETE /models/{name}?api-version=2023-04-01-preview

URI Parameters

Name In Required Type Description
name
 path True

string

The name of the model to delete.

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version
 query True

string

Requested API version.

Responses

Name Type Description
204 No Content

No Content
Other Status Codes

ErrorResponse

Error

Headers

x-ms-error-code: string

Examples

Models_Delete

Sample request

DELETE /models/my_model_name?api-version=2023-04-01-preview

Sample response

Status code:
204

Definitions

Name Description
ErrorResponse

Response returned when an error occurs.
ErrorResponseDetails

Error info.
ErrorResponseInnerError

Detailed error.

ErrorResponse

Response returned when an error occurs.

Name Type Description
error

ErrorResponseDetails

Error info.

ErrorResponseDetails

Error info.

Name Type Description
code

string

Error code.
details

ErrorResponseDetails[]

List of detailed errors.
innererror

ErrorResponseInnerError

Detailed error.
message

string

Error message.
target

string

Target of the error.

ErrorResponseInnerError

Detailed error.

Name Type Description
code

string

Error code.
innererror

ErrorResponseInnerError

Detailed error.
message

string

Error message.