Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

ListHosts

Lists the hosts associated with your account.

Request Syntax


{
   "MaxResults": number,
   "NextToken": "string"
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

MaxResults

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned nextToken value.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 100.

Required: No

NextToken

The token that was returned from the previous ListHosts call, which can be used to return the next set of hosts in the list.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Pattern: ^.*$

Required: No

Response Syntax


{
   "Hosts": [ 
      { 
         "HostArn": "string",
         "Name": "string",
         "ProviderEndpoint": "string",
         "ProviderType": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VpcConfiguration": { 
            "SecurityGroupIds": [ "string" ],
            "SubnetIds": [ "string" ],
            "TlsCertificate": "string",
            "VpcId": "string"
         }
      }
   ],
   "NextToken": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

Hosts

A list of hosts and the details for each host, such as status, endpoint, and provider type.

Type: Array of Host objects

NextToken

A token that can be used in the next ListHosts call. To view all items in the list, continue to call this operation with each subsequent token until no more nextToken values are returned.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1024.

Pattern: ^.*$

Errors

For information about the errors that are common to all actions, see Common Errors.