Share via

Datasets - Delete

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

Unregister a dataset.

Status codes returned:

  • 204: Operation completed successfully.
  • 400: The request was malformed.
  • 404: A dataset with the specified name was not found.
  • 412: An If-Match header was provided, but the given ETag did not match the current ETag value.
DELETE /datasets/{name}?api-version=2023-04-01-preview

URI Parameters

Name In Required Type Description
name
 path True

string

The name of the dataset to unregister.

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

string

Requested API version.

Request Header

Name Required Type Description
If-Match

string

Optional ETag for the dataset to unregister.
If an ETag is provided, then the dataset will be unregistered only if its current ETag value matches the given ETag. If the ETag values don't match, then the unregister operation will fail with status code 412 (Precondition Failed). This indicates that the dataset has been updated since the last time information for the dataset was obtained.
If an ETag is not provided or its value is '*', then the dataset will always be unregistered regardless of the current ETag value.

Responses

Name Type Description
204 No Content

No Content
Other Status Codes

ErrorResponse

Error

Headers

x-ms-error-code: string

Examples

Datasets_Unregister

Sample request

DELETE /datasets/my_dataset_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.