First Login
After you install Veeam Backup for AWS, to start working with the Veeam Backup for AWS REST API or Web UI, you must perform the following operations:
- Assure the first login.
- Read and accept the license agreement.
- Validate the ID of the EC2 instance.
- Create the Default Admin.
To assure that you log in to Veeam Backup for AWS for the first time, send the HTTP GET request to the /api/v1/users/isFirstLogin endpoint. In the x-api-version header, specify the current revision of the Veeam Backup for AWS REST API.
Request: GET https://135.169.170.192:11005/api/v1/users/isFirstLogin
Request Header: x-api-version:1.1-rev0 |
A successfully completed operation returns the 200 response code. In the response body, Veeam Backup for AWS returns the true value of the isFirstLogin property.
Response: 200 Response Body: { "isFirstLogin": true } |
Read and Accept License Agreement
To continue the first login operation, you must read and accept the license agreement for Veeam and 3rd party components that Veeam incorporates.
- To read the agreement and get the checksum parameter required for accepting the license agreement, send the HTTP GET request to the /api/v1/licenseAgreement endpoint. In the x-api-version header, specify the current revision of the Veeam Backup for AWS REST API.
Request: GET https://135.169.170.192:11005/api/v1/licenseAgreement
Request Header: x-api-version:1.1-rev0 |
A successfully completed operation returns the 200 response code. In the response body, Veeam Backup for AWS returns the license agreement types, content and the checksum parameter for each type of the agreement. The checksum parameters must be saved locally.
Response: 200 Response Body: { "items": [ { "type": "Eula", "checksum": "748686f9020de2d8b4252e70abbf76cc45a62e3c0c2d0e66d5925e6ca070342a", "content": "" }, { "type": "ThirdPartyAgreement", "checksum": "c8a3f7dec39466a6de1299c4b57b4f4695d66da26ff4b13be7ab05227cf66388", "content": "" } ] } |
- To accept the license agreement, send the HTTP POST request to the /api/v1/licenseAgreement/accept endpoint. The cheksum parameters must be sent as part of the URL. Use the question mark (?) to separate the parameters from the endpoint.
In the x-api-version header, specify the current revision of the Veeam Backup for AWS REST API.
Request: POST https://135.169.170.192:11005/api/v1/licenseAgreement/accept?eulaChecksum=748686f9020de2d8b4252e70abbf76cc45a62e3c0c2d0e66d5925e6ca070342a&thirdPartyLicenseAgreementChecksum=c8a3f7dec39466a6de1299c4b57b4f4695d66da26ff4b13be7ab05227cf66388"
Request Header: x-api-version:1.1-rev0 |
A successfully completed operation returns the 204 response code.
Response: 204 |
Tip |
You can check whether the license agreement is accepted and download the agreement to your device. For more information on how to do this, see the License Agreement section in the Veeam Backup for AWS REST API Reference. |
To validate the ID of the EC2 instance where Veeam Backup for AWS is installed, send the HTTP POST request to the /api/v1/users/checkInstanceId endpoint. In the x-api-version header, specify the current revision of the Veeam Backup for AWS REST API.
The request body must contain the ID of the EC2 instance where Veeam Backup for AWS is installed.
Request: POST https://135.169.170.192:11005/api/v1/users/checkInstanceId
Request Header: x-api-version:1.1-rev0
Request Body: { "instanceId": "i-813g91u0b0c019356" } |
A successfully completed operation returns the 200 response code. In the response body, Veeam Backup for AWS returns the true value of the isValid property.
Response: 200 Response Body: { "isValid": true } |
To create the Default Administrator whose credentials you will use for the first login to Veeam Backup for AWS, send the HTTP POST request to the /api/v1/users/createdefaultuser endpoint. In the x-api-version header, specify the current revision of the Veeam Backup for AWS REST API.
In the request body specify the ID of the EC2 instance where Veeam Backup for AWS is installed, and provide a name, description and password for the Default Administrator you want to create.
Request: POST https://135.169.170.192:11005/api/v1/users/createdefaultuser
Request Header: x-api-version:1.1-rev0
Request Body: { "instance": { "instanceId": "i-813g91u0b0c019356" }, "userSpec": { "name": "administrator", "description": "The Default Administrator user.", "password": "Password1" } } |
A successfully completed operation returns the 200 response code. In the response body, Veeam Backup for AWS returns the name and description specified for the Default Administrator. MFA is disabled by default.
Response: 201 Response Body: { "name": "administrator", "description": "The Default Administrator user.", "mfaEnabled": false, "isDefault": true } |
Note |
For increased security, it is recommended to enable multi-factor authentication for the Default Administrator after your first login to Veeam Backup for AWS. To learn how to enable MFA, see Multi-Factor Authentication or the Veeam Backup for AWS User Guide, section Configuring Multi-Factor Authentication. |
