Authorization with Swagger UI

REST API authorization with the Swagger UI involves the following procedures:

  1. Obtain an access token and a refresh token:
  1. On the Veeam Backup for Microsoft Azure API page, expand the Login resource and click POST api/oauth2/token.
  2. In the expanded method window, click Try it out.
  3. From the grant_type drop-down list, select Password.
  4. In the Username and Password fields, specify the credentials of a user created in Veeam Backup for Microsoft Azure.
  5. Click Execute.

Requesting Authorization Tokens

Wait for the response from the server. A successfully completed operation returns the 200 response code. In the response body, Veeam Backup for Microsoft Azure returns an access token, its expiration time and a refresh token.

Note

If MFA is enabled for the user, Veeam Backup for Microsoft Azure returns an MFA token in the response body. To learn how to obtain an access token and a refresh token when MFA is enabled, see Requesting Authorization.

Recieving Authorization Tokens

  1. Save the access and refresh token locally for further use.

Tip

You can download a server response in the .json format. To do that, in the expanded method window, click Download at the lower right corner of the Response body field.

  1. Authorize your access in the Swagger UI:
  1. At the top right corner of the Veeam Backup for Microsoft Azure API page, click Authorize.

Loggin In

The Available authorizations window will open.

  1. In the Available authorizations window, insert the access token saved locally in the Value field. Use the Bearer <access_token> format.

Loggin In

  1. Click Authorize.
  1. When the access token expires, use the refresh token:
  1. On the Veeam Backup for Microsoft Azure API page, expand the Login resource and click POST api/oauth2/token.
  2. In the expanded method window, click Try it out.
  3. From the grant_type drop-down list, select Refresh_token.
  4. In the refresh_token field, insert the refresh token saved locally, and click Execute.

Requesting Authorization Tokens

Wait for the response from the server. A successfully completed operation returns the 200 response code and a new pair of tokens in the response body.

Receiving Authorization Tokens

  1. Save the access and refresh token locally for further use. To authorize your access in the Swagger UI, repeat step 2.
  1. When you finish working with the Swagger UI:
  1. At the top right corner of the Veeam Backup for Microsoft Azure API, click Authorize. The Available authorizations window will open.
  2. In the Available authorizations window, click Logout.

Logging Out