BatchDelete
Removes an applied document understanding model from one or more libraries. Note that a model must be removed from all libraries before it can be deleted (see example).
HTTP request
POST /_api/machinelearning/publications/batchdelete HTTP/1.1
URI parameters
None
Request headers
Header | Value |
---|---|
Accept | application/json;odata=verbose |
Content-Type | application/json;odata=verbose;charset=utf-8 |
x-requestdigest | The appropriate digest for current site. |
Request body
Name | Required | Type | Description |
---|---|---|---|
Publications | yes | MachineLearningPublicationEntityData[] | The collection of MachineLearningPublicationEntityData each of which specifies the model and target document library. |
MachineLearningPublicationEntityData
Name | Required | Type | Description |
---|---|---|---|
ModelUniqueId | yes | string | The unique ID of the model file. |
TargetSiteUrl | yes | string | The full URL of the target library site. |
TargetWebServerRelativeUrl | yes | string | The server relative URL of the web for the target library. |
TargetLibraryServerRelativeUrl | yes | string | The server relative URL of the target library. |
Response
Name | Type | Description |
---|---|---|
200 OK | This is a customized API to support removing a model from multi document libraries. In the case of partial success, 200 OK could still be returned and the caller needs to inspect the response body to understand if the model has been successfully removed from a document library. |
Response Body
Name | Type | Description |
---|---|---|
TotalSuccesses | int | The total number of a model being successfully removed from a document library. |
TotalFailures | int | The total number of a model failing to be removed from a document library. |
Details | MachineLearningPublicationResult[] | The collection of MachineLearningPublicationResult each of which specifies the detailed result of removing the model from a document library. |
MachineLearningPublicationResult
Name | Type | Description |
---|---|---|
StatusCode | int | The HTTP status code. |
ErrorMessage | string | The error message which tells what's wrong when apply the model to the document library. |
Publication | MachineLearningPublicationEntityData | It specifies the model info and the target document library. |
MachineLearningPublicationEntityData
Name | Type | Description |
---|---|---|
ModelUniqueId | string | The unique ID of the model file. |
TargetSiteUrl | string | The full URL of the target library site. |
TargetWebServerRelativeUrl | string | The server relative URL of the web for the target library. |
TargetLibraryServerRelativeUrl | string | The server relative URL of the target library. |
Examples
Remove a model from the contracts document library in the repository site
In this sample, the ID of the Contoso Contract document understanding model is 7645e69d-21fb-4a24-a17a-9bdfa7cb63dc
.
Sample request
{
"publications": [
{
"ModelUniqueId": "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc",
"TargetSiteUrl": "https://constco.sharepoint-df.com/sites/docsite",
"TargetWebServerRelativeUrl": "/sites/docsite ",
"TargetLibraryServerRelativeUrl": "/sites/dcocsite/joedcos"
}
]
}
Sample response
In the response, TotalFailures and TotalSuccesses refer to the number of failures and successes of the model being removed from the specified libraries.
Status code: 200
{
"Details": [
{
"ErrorMessage": null,
"Publication": {
"ModelUniqueId": "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc",
"TargetSiteUrl": "https://contoso.sharepoint.com/sites/repository/",
"TargetWebServerRelativeUrl": "/sites/repository",
"TargetLibraryServerRelativeUrl": "/sites/repository/contracts",
"ViewOption": "NewViewAsDefault"
},
"StatusCode": 200
}
],
"TotalFailures": 0,
"TotalSuccesses": 1
}
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for