Veeam Backup for Google Cloud 7
REST API Reference
Related documents

Security Certificates

The /certificates resource collection represents current TLS certificate details.

Get Current Security Certificate Data

The HTTP GET request to the /certificates endpoint retrieves current TLS certificate details.

SecurityBearer
Request
header Parameters
x-api-version
required
string
Default: 1.4-rev0

Specifies the current revision of the Veeam Backup for Google Cloud REST API.

Responses
200

OK

400

Bad Request. The request body is malformed, incomplete or otherwise invalid

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request.

500

Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.

get/api/v1/certificates
Request samples 
Response samples 
application/json
{
  • "data": [
    ]
}
Recreate Security Certificate
The HTTP POST request to the /certificates/recreate endpoint replaces the existing security certificate with a new self-signed certificate automatically generated by Veeam Backup for Google Cloud.
 
NOTE
 After you replace the existing security certificate, the Veeam Backup for Google Cloud REST API and Web UI services will be restarted automatically.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.4-rev0
Specifies the current revision of the Veeam Backup for Google Cloud REST API.


 
Request Body schema: application/json
required
Detailed information of a security certificate.


validBy
string <date-time> 
Specifies the date and time when the certificate will expire.


 
Responses 
200
OK


400
Bad Request. The request body is malformed, incomplete or otherwise invalid


401
Unauthorized. The authorization header has been expected but not found (or found but is expired).


403
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request.


500
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.


post/api/v1/certificates/recreate
Request samples 
application/json
{
  • "validBy": "2019-08-24T14:15:22Z"
}
Response samples 
application/json
{
  • "certificate": {
    },
  • "issues": [
    ]
}
Upload Own Security Certificate
The HTTP POST request to the /certificates/upload endpoint uploads a security certificate that you obtained from a Certificate Authority (CA) or generated using a 3rd party tool.
 
NOTE
 After you replace the existing security certificate, the Veeam Backup for Google Cloud REST API and Web UI services will be restarted automatically.


SecurityBearer 
Request 
header Parameters
x-api-version
required
string
 Default:  1.4-rev0
Specifies the current revision of the Veeam Backup for Google Cloud REST API.


 
Request Body schema: multipart/form-data
required
certificateFile
required
string <binary> 
Uploads the .PFX certificate file.


 
certificatePassword
string <password> 
Specifies a password for the certificate file.


 
Responses 
200
OK


400
Bad Request. The request body is malformed, incomplete or otherwise invalid


401
Unauthorized. The authorization header has been expected but not found (or found but is expired).


403
Forbidden. The user sending a request does not have adequate privileges to access one or more objects specified in the request.


500
Internal Server Error. The request has been received but could not be completed because of an internal error at the server side.


post/api/v1/certificates/upload
Request samples 
Response samples 
application/json
{
  • "certificate": {
    },
  • "issues": [
    ]
}

    
    

                                

                                    
Document updated 11/19/2025
Page content applies to build 7.0.0.47