Scans - Delete

Service:

Purview

API Version:

2023-09-01

Deletes the scan associated with the data source.

DELETE {endpoint}/scan/datasources/{dataSourceName}/scans/{scanName}?api-version=2023-09-01

URI Parameters

Name	In	Required	Type	Description
dataSourceName	path	True	string	The dataSource name. Regex pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$
endpoint	path	True	string url	The scanning endpoint of your purview account. Example: https://{accountName}.purview.azure.com.
scanName	path	True	string	The scan name. Regex pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$
api-version	query	True	string	The api version to use.

Responses

Name	Type	Description
204 No Content		Success.
Other Status Codes	ErrorResponseModel	An error response received from the Scanning Service. Headers x-ms-error-code: string

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

Scans_Delete

Sample Request

HTTP

DELETE {endpoint}/scan/datasources/myDataSource/scans/myScanName?api-version=2023-09-01

Sample Response

Status code:

204

x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea888

Definitions

Name	Description
ErrorModel	The error model.
ErrorResponseModel	The error response model.

ErrorModel

The error model.

Name	Type	Description
code	string	A unique error code that identifies the specific error.
details	ErrorModel[]	An array of nested ErrorModel objects that provides additional error details.
message	string	A human-readable error message that provides more details about the error.
target	string	The specific component that the error is associated with.

ErrorResponseModel

The error response model.

Name	Type	Description
error	ErrorModel	The error model.