Authorization Examples

In this article

    The Swagger UI allows a user to try the following VAO REST API authorization procedures:

    Obtaining Authorization Tokens

    To obtain an access token and a refresh token:

    1. On the Veeam Availability Orchestrator REST API v4 page, expand the Token resource and click POST /token.
    2. From the grant_type drop-down list, select password (default).
    3. In the username and password fields, specify the credentials of an account with the VAO Administrator or Plan Author privileges. The user name must be specified in the DOMAIN\USERNAME format.
    4. Click Try it out.

    Getting Authorization Token

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

    Getting Authorization Token — Server Response

    1. Save the refresh token locally for further use.

     

    Creating Clients

    To create a client account:

    1. On the Veeam Availability Orchestrator REST API v4 page, expand the Clients resource and click POST /api/v4/Clients.
    2. Click Try it out.

    Getting Child Client

    Wait for the response from the server. A successfully completed operation returns the 200 response code. In the response body, VAO returns a client ID and client secret.

    1. Save the child client ID and client secret locally for further use.

     

    Obtaining Authorization Tokens Under Client Account

    To obtain an access token and a refresh token using client credentials:

    1. On the Veeam Availability Orchestrator REST API v4 page, expand the Token resource and click POST /token.
    2. From the grant_type drop-down list, select client_credentials.
    3. In the client_id and client_secret fields, specify credentials of a client account.
    4. Click Try it out.

    Getting Tokens for Child Client

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

    1. Save the refresh token locally for further use.

     

    Using Refresh Token

    To obtain a new pair of tokens using a refresh token:

    1. On the Veeam Availability Orchestrator REST API v4 page, expand the Token resource and click POST /token.
    2. From the grant_type drop-down list, select refresh_token.
    3. In the refresh_token field, insert the refresh token saved locally.
    4. Click Try it out.

    Using Refresh Token

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

    Getting List of Clients

    To get all client IDs related to a user account:

    1. On the Veeam Availability Orchestrator REST API v4 page, expand the Clients resource and click GET /api/v4/Clients.
    2. Click Try it out.

    Getting Client IDs

    Wait for the response from the server. A successfully completed operation returns the 200 response code and a list of client IDs in the response body.

     

    Deleting Clients

    To delete a client account:

    1. On the Veeam Availability Orchestrator REST API v4 page, expand the Clients resource and click DELETE /api/v4/Clients.
    2. In the clientId field, insert the ID of the client that you want to delete.
    3. Click Try it out.

    Deleting Client

    Wait for the response from the server. A successfully completed operation returns the 204 response code.

     

    Logging Out

    To logg out from the VAO REST API:

    1. On the Veeam Availability Orchestrator REST API v4 page, expand the Token resource and click DELETE /api/token.
    1. Click Try it out.

    Logging Out

    Wait for the response from the server. A successfully completed operation returns the 204 response code.

    Related Topics

    Authorization and Security