Remove Repository

You can remove a repository with the specified ID from the Veeam Backup for Microsoft Azure configuration database.

Request

To remove an  repository, send the HTTP DELETE request to the /repositories/{repositoryId} endpoint. {repositoryId} is a system ID assigned to the repository in the Veeam Backup for Microsoft Azure REST API.

HTTP Request

DELETE https://<hostname>/api/v2/repositories/{repositoryId}

Request Headers

The request contains the following headers.

Header

Required

Value

Description

Authorization

Required

Bearer <Access-Token>

Authenticates a client who sends the request to the server. Must contain the access token for the current logon session in the Bearer <Access-Token> format.

Response

The server returns the following response to the client.

Response Codes

A successfully completed operation returns a response code 200 (OK).

Response Headers

The response to this request contains the following headers. The response may also include additional standard HTTP headers.

Header

Value

Description

Content-length

integer

Identifies the length of the response body message, in bytes.

Content-type

  • application/json
  • application/problem+json

Identifies the media type of the response body message.

Response Body

In the response body, Veeam Backup for Microsoft Azure returns a 200 response code and a link to the /operations/{operationId} endpoint that contains the result of the operation.

Remove RepositoryExample

The following request removes a repository from <%PRODUCT% database.

Request:

DELETE https://51.11.247.127/api/v2/repositoreis/1

 

Response:

200

 

Response Body:

{

 "id": "0d7da8af-c559-4b75-b129-7d84938adeb4",

 "type": "RepositoryDeletion",

 "status": "Pending",

 "usn": 0,

 "repositoryJobInfo": {

   "repositoryId": "1",

   "repositoryName": "Repository hot",

   "repositoryRemoved": false

 },

 "_links": {

   "self": {

     "href": "https://51.11.247.127/api/v2/jobSessions/0d7da8af-c559-4b75-b129-7d84938adeb4"

   },

   "log": {

     "href": "https://51.11.247.127/api/v2/jobSessions/0d7da8af-c559-4b75-b129-7d84938adeb4/log"

   }

 },

 "_embeddedResources": {}

}

I want to report a typo

There is a misspelling right here:

 

I want to let the Veeam Documentation Team know about that.