This is an archive version of the document. To get the most up-to-date information, see the current version.

Get Collection of Amazon Connections

You can get a list of all added amazon connections.

Request

To retrieve a representation of a collection of amazon connections, send the HTTP GET request to the /amazonConnections endpoint.

HTTP Request

GET https://<hostname>:<port>/api/v1/amazonConnections

Request Headers

The request contains the following headers.

Header

Required/Optional

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.

x-api-version

Required

1.0-rev0

Specifies the current revision of the Veeam Backup for AWS REST API.

Accept

Optional

  • application/json
  • application/problem+json

Specifies a media type of representation that is required in the response message. If the requested type is not supported, the server will return the response in the application/json media type.

Response

The server returns the following response to the client.

Response Code

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 AWS returns a representation of the /amazonConnections collection. The AmazonConnection schema is used for the collection representation.

Get Collection of Amazon ConnectionsExample

The following request returns a full list of added amazon connections.

Request:

GET https://135.169.170.192:11005/api/v1/amazonConnections

 

Request Header:

Authorization: Bearer <Access-Token>

x-api-version: 1.0-rev0

 

Response:

200

 

Response Body:

{

 "totalCount": 2,

 "results": [

   {

     "id": "2c7eb8fb-40e3-4495-9dc9-30f969277917",

     "_links": [

       {

         "method": "GET",

         "rel": "self",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/2c7eb8fb-40e3-4495-9dc9-30f969277917"

       },

       {

         "method": "DELETE",

         "rel": "delete",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/2c7eb8fb-40e3-4495-9dc9-30f969277917"

       },

       {

         "method": "GET",

         "rel": "CloudNetworks",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/2c7eb8fb-40e3-4495-9dc9-30f969277917/cloudNetworks"

       },

       {

         "method": "GET",

         "rel": "CloudSubNetworks",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/2c7eb8fb-40e3-4495-9dc9-30f969277917/cloudSubnetworks"

       },

       {

         "method": "GET",

         "rel": "CloudSecurityGroups",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/2c7eb8fb-40e3-4495-9dc9-30f969277917/cloudSecurityGroups"

       },

       {

         "method": "GET",

         "rel": "AvailabilityZones",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/2c7eb8fb-40e3-4495-9dc9-30f969277917/availabilityZones"

       },

       {

         "method": "GET",

         "rel": "ValidateS3Endpoint",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/2c7eb8fb-40e3-4495-9dc9-30f969277917/validateS3endpoint"

       },

       {

         "method": "GET",

         "rel": "CloudEncryptionKeys",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/2c7eb8fb-40e3-4495-9dc9-30f969277917/cloudEncryptionKeys"

       },

       {

         "method": "GET",

         "rel": "BucketFolders",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/2c7eb8fb-40e3-4495-9dc9-30f969277917/browseBucketFolders"

       }

     ]

   },

   {

     "id": "8591eeb5-b67d-4c24-be10-17c78e8304f1",

     "_links": [

       {

         "method": "GET",

         "rel": "self",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/8591eeb5-b67d-4c24-be10-17c78e8304f1"

       },

       {

         "method": "DELETE",

         "rel": "delete",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/8591eeb5-b67d-4c24-be10-17c78e8304f1"

       },

       {

         "method": "GET",

         "rel": "CloudNetworks",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/8591eeb5-b67d-4c24-be10-17c78e8304f1/cloudNetworks"

       },

       {

         "method": "GET",

         "rel": "CloudSubNetworks",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/8591eeb5-b67d-4c24-be10-17c78e8304f1/cloudSubnetworks"

       },

       {

         "method": "GET",

         "rel": "CloudSecurityGroups",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/8591eeb5-b67d-4c24-be10-17c78e8304f1/cloudSecurityGroups"

       },

       {

         "method": "GET",

         "rel": "AvailabilityZones",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/8591eeb5-b67d-4c24-be10-17c78e8304f1/availabilityZones"

       },

       {

         "method": "GET",

         "rel": "ValidateS3Endpoint",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/8591eeb5-b67d-4c24-be10-17c78e8304f1/validateS3endpoint"

       },

       {

         "method": "GET",

         "rel": "CloudEncryptionKeys",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/8591eeb5-b67d-4c24-be10-17c78e8304f1/cloudEncryptionKeys"

       },

       {

         "method": "GET",

         "rel": "BucketFolders",

         "href": "https://135.169.170.192:11005/api/v1/amazonConnections/8591eeb5-b67d-4c24-be10-17c78e8304f1/browseBucketFolders"

       }

     ]

   }

 ],

 "_links": [

   {

     "method": "POST",

     "rel": "create",

     "href": "https://135.169.170.192:11005/api/v1/amazonConnections"

   }

 ]

}