Compute.Hosts.List (Compute Engine API alpha-rev20260410-2.0.0)

java.lang.Object
- java.util.AbstractMap<String,Object>
- - com.google.api.client.util.GenericData
  - - com.google.api.client.googleapis.services.AbstractGoogleClientRequest<T>
    - - com.google.api.client.googleapis.services.json.AbstractGoogleJsonClientRequest<T>
      - com.google.api.services.compute.ComputeRequest<HostsListResponse>
        
        com.google.api.services.compute.Compute.Hosts.List

All Implemented Interfaces:

Cloneable, Map<String,Object>

Enclosing class:

Compute.Hosts
```
public class Compute.Hosts.List
extends ComputeRequest<HostsListResponse>
```

Nested Class Summary
- Nested classes/interfaces inherited from class com.google.api.client.util.GenericData
  com.google.api.client.util.GenericData.Flags
- Nested classes/interfaces inherited from class java.util.AbstractMap
  AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>
- Nested classes/interfaces inherited from interface java.util.Map
  Map.Entry<K,V>

Field Summary
- Fields inherited from class com.google.api.client.googleapis.services.AbstractGoogleClientRequest
  API_VERSION_HEADER, USER_AGENT_SUFFIX

Constructor Summary

Constructors
Modifier Constructor and Description

protected List(String project, String zone, String association)
Retrieves a list of hosts.

Constructors
Modifier	Constructor and Description
`protected`	`List(String project, String zone, String association)` Retrieves a list of hosts.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`com.google.api.client.http.HttpRequest`	`buildHttpRequestUsingHead()`
`com.google.api.client.http.HttpResponse`	`executeUsingHead()`
`String`	`getAssociation()` The parent resource association for the Host.
`String`	`getFilter()` A filter expression that filters resources listed in the response.
`Long`	`getMaxResults()` The maximum number of results per page that should be returned.
`String`	`getOrderBy()` Sorts list results by a certain order.
`String`	`getPageToken()` Specifies a page token to use.
`String`	`getProject()` The project ID for this request.
`Boolean`	`getReturnPartialSuccess()` Opt-in for partial success behavior which provides partial results in case of failure.
`String`	`getZone()` The name of the zone for this request, formatted as RFC1035.
`Compute.Hosts.List`	`set(String parameterName, Object value)`
`Compute.Hosts.List`	`set$Xgafv(String $Xgafv)` V1 error format.
`Compute.Hosts.List`	`setAccessToken(String accessToken)` OAuth access token.
`Compute.Hosts.List`	`setAlt(String alt)` Data format for response.
`Compute.Hosts.List`	`setAssociation(String association)` The parent resource association for the Host.
`Compute.Hosts.List`	`setCallback(String callback)` JSONP
`Compute.Hosts.List`	`setFields(String fields)` Selector specifying which fields to include in a partial response.
`Compute.Hosts.List`	`setFilter(String filter)` A filter expression that filters resources listed in the response.
`Compute.Hosts.List`	`setKey(String key)` API key.
`Compute.Hosts.List`	`setMaxResults(Long maxResults)` The maximum number of results per page that should be returned.
`Compute.Hosts.List`	`setOauthToken(String oauthToken)` OAuth 2.0 token for the current user.
`Compute.Hosts.List`	`setOrderBy(String orderBy)` Sorts list results by a certain order.
`Compute.Hosts.List`	`setPageToken(String pageToken)` Specifies a page token to use.
`Compute.Hosts.List`	`setPrettyPrint(Boolean prettyPrint)` Returns response with indentations and line breaks.
`Compute.Hosts.List`	`setProject(String project)` The project ID for this request.
`Compute.Hosts.List`	`setQuotaUser(String quotaUser)` Available to use for quota purposes for server-side applications.
`Compute.Hosts.List`	`setReturnPartialSuccess(Boolean returnPartialSuccess)` Opt-in for partial success behavior which provides partial results in case of failure.
`Compute.Hosts.List`	`setUploadProtocol(String uploadProtocol)` Upload protocol for media (e.g.
`Compute.Hosts.List`	`setUploadType(String uploadType)` Legacy upload protocol for media (e.g.
`Compute.Hosts.List`	`setUserIp(String userIp)` Legacy name for parameter that has been superseded by `quotaUser`.
`Compute.Hosts.List`	`setZone(String zone)` The name of the zone for this request, formatted as RFC1035.

Methods inherited from class com.google.api.services.compute.ComputeRequest
get$Xgafv, getAbstractGoogleClient, getAccessToken, getAlt, getCallback, getFields, getKey, getOauthToken, getPrettyPrint, getQuotaUser, getUploadProtocol, getUploadType, getUserIp, setDisableGZipContent, setRequestHeaders

Methods inherited from class com.google.api.client.googleapis.services.json.AbstractGoogleJsonClientRequest
getJsonContent, newExceptionOnError, queue

Methods inherited from class com.google.api.client.googleapis.services.AbstractGoogleClientRequest
buildHttpRequest, buildHttpRequestUrl, checkRequiredParameter, execute, executeAndDownloadTo, executeAsInputStream, executeMedia, executeMediaAndDownloadTo, executeMediaAsInputStream, executeUnparsed, getDisableGZipContent, getHttpContent, getLastResponseHeaders, getLastStatusCode, getLastStatusMessage, getMediaHttpDownloader, getMediaHttpUploader, getRequestHeaders, getRequestMethod, getResponseClass, getReturnRawInputSteam, getUriTemplate, initializeMediaDownload, initializeMediaUpload, queue, setReturnRawInputStream

Methods inherited from class com.google.api.client.util.GenericData
clone, entrySet, equals, get, getClassInfo, getUnknownKeys, hashCode, put, putAll, remove, setUnknownKeys, toString

Methods inherited from class java.util.AbstractMap
clear, containsKey, containsValue, isEmpty, keySet, size, values

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- Constructor Detail
  - List
```
protected List(String project,
               String zone,
               String association)
```
    Retrieves a list of hosts. Create a request for the method "hosts.list". This request holds the parameters needed by the the compute server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    Compute.initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest) must be called to initialize this instance immediately after invoking the constructor.
    
    Parameters:
    
    project - The project ID for this request.
    
    zone - The name of the zone for this request, formatted as RFC1035.
    
    association - The parent resource association for the Host. This field specifies the hierarchical context (e.g., reservation, block, sub-block) when accessing the host. For example, reservations/reservation_name, reservations/reservation_name/reservationBlocks/reservation_block_name or reservations/res ervation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_su b_block_name.
    
    Since:
    
    1.13
- Method Detail
  - executeUsingHead
```
public com.google.api.client.http.HttpResponse executeUsingHead()
                                                         throws IOException
```
    Overrides:
    
    executeUsingHead in class com.google.api.client.googleapis.services.AbstractGoogleClientRequest<HostsListResponse>
    
    Throws:
    
    IOException
  - buildHttpRequestUsingHead
```
public com.google.api.client.http.HttpRequest buildHttpRequestUsingHead()
                                                                 throws IOException
```
    Overrides:
    
    buildHttpRequestUsingHead in class com.google.api.client.googleapis.services.AbstractGoogleClientRequest<HostsListResponse>
    
    Throws:
    
    IOException
  - set$Xgafv
```
public Compute.Hosts.List set$Xgafv(String $Xgafv)
```
    Description copied from class: ComputeRequest
    
    V1 error format.
    
    Overrides:
    
    set$Xgafv in class ComputeRequest<HostsListResponse>
  - setAccessToken
```
public Compute.Hosts.List setAccessToken(String accessToken)
```
    Description copied from class: ComputeRequest
    
    OAuth access token.
    
    Overrides:
    
    setAccessToken in class ComputeRequest<HostsListResponse>
  - setAlt
```
public Compute.Hosts.List setAlt(String alt)
```
    Description copied from class: ComputeRequest
    
    Data format for response.
    
    Overrides:
    
    setAlt in class ComputeRequest<HostsListResponse>
  - setCallback
```
public Compute.Hosts.List setCallback(String callback)
```
    Description copied from class: ComputeRequest
    
    JSONP
    
    Overrides:
    
    setCallback in class ComputeRequest<HostsListResponse>
  - setFields
```
public Compute.Hosts.List setFields(String fields)
```
    Description copied from class: ComputeRequest
    
    Selector specifying which fields to include in a partial response.
    
    Overrides:
    
    setFields in class ComputeRequest<HostsListResponse>
  - setKey
```
public Compute.Hosts.List setKey(String key)
```
    Description copied from class: ComputeRequest
    
    API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    
    Overrides:
    
    setKey in class ComputeRequest<HostsListResponse>
  - setOauthToken
```
public Compute.Hosts.List setOauthToken(String oauthToken)
```
    Description copied from class: ComputeRequest
    
    OAuth 2.0 token for the current user.
    
    Overrides:
    
    setOauthToken in class ComputeRequest<HostsListResponse>
  - setPrettyPrint
```
public Compute.Hosts.List setPrettyPrint(Boolean prettyPrint)
```
    Description copied from class: ComputeRequest
    
    Returns response with indentations and line breaks.
    
    Overrides:
    
    setPrettyPrint in class ComputeRequest<HostsListResponse>
  - setQuotaUser
```
public Compute.Hosts.List setQuotaUser(String quotaUser)
```
    Description copied from class: ComputeRequest
    
    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
    
    Overrides:
    
    setQuotaUser in class ComputeRequest<HostsListResponse>
  - setUploadType
```
public Compute.Hosts.List setUploadType(String uploadType)
```
    Description copied from class: ComputeRequest
    
    Legacy upload protocol for media (e.g. "media", "multipart").
    
    Overrides:
    
    setUploadType in class ComputeRequest<HostsListResponse>
  - setUploadProtocol
```
public Compute.Hosts.List setUploadProtocol(String uploadProtocol)
```
    Description copied from class: ComputeRequest
    
    Upload protocol for media (e.g. "raw", "multipart").
    
    Overrides:
    
    setUploadProtocol in class ComputeRequest<HostsListResponse>
  - setUserIp
```
public Compute.Hosts.List setUserIp(String userIp)
```
    Description copied from class: ComputeRequest
    
    Legacy name for parameter that has been superseded by `quotaUser`.
    
    Overrides:
    
    setUserIp in class ComputeRequest<HostsListResponse>
  - getProject
```
public String getProject()
```
    The project ID for this request.
  - setProject
```
public Compute.Hosts.List setProject(String project)
```
    The project ID for this request.
  - getZone
```
public String getZone()
```
    The name of the zone for this request, formatted as RFC1035.
  - setZone
```
public Compute.Hosts.List setZone(String zone)
```
    The name of the zone for this request, formatted as RFC1035.
  - getAssociation
```
public String getAssociation()
```
    The parent resource association for the Host. This field specifies the hierarchical context (e.g., reservation, block, sub-block) when accessing the host. For example, reservations/reservation_name, reservations/reservation_name/reservationBlocks/reservation_block_name or reservations/reservation_ name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_block_name.
  - setAssociation
```
public Compute.Hosts.List setAssociation(String association)
```
    The parent resource association for the Host. This field specifies the hierarchical context (e.g., reservation, block, sub-block) when accessing the host. For example, reservations/reservation_name, reservations/reservation_name/reservationBlocks/reservation_block_name or reservations/rese rvation_name/reservationBlocks/reservation_block_name/reservationSubBlocks/reservation_sub_ block_name.
  - getFilter
```
public String getFilter()
```
    A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based onresource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using GoogleRE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.
  - setFilter
```
public Compute.Hosts.List setFilter(String filter)
```
    A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based onresource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq "double quoted literal"` `(fieldname1 eq literal) (fieldname2 ne "literal")` The literal value is interpreted as a regular expression using GoogleRE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name "instance", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.
  - getMaxResults
```
public Long getMaxResults()
```
    The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`) [default: 500] [minimum: 0]
  - setMaxResults
```
public Compute.Hosts.List setMaxResults(Long maxResults)
```
    The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
  - getOrderBy
```
public String getOrderBy()
```
    Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.
  - setOrderBy
```
public Compute.Hosts.List setOrderBy(String orderBy)
```
    Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy="creationTimestamp desc"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.
  - getPageToken
```
public String getPageToken()
```
    Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
  - setPageToken
```
public Compute.Hosts.List setPageToken(String pageToken)
```
    Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
  - getReturnPartialSuccess
```
public Boolean getReturnPartialSuccess()
```
    Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.
  - setReturnPartialSuccess
```
public Compute.Hosts.List setReturnPartialSuccess(Boolean returnPartialSuccess)
```
    Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.
  - set
```
public Compute.Hosts.List set(String parameterName,
                              Object value)
```
    Overrides:
    
    set in class ComputeRequest<HostsListResponse>

Class Compute.Hosts.List

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData

Nested classes/interfaces inherited from class java.util.AbstractMap

Nested classes/interfaces inherited from interface java.util.Map

Field Summary

Fields inherited from class com.google.api.client.googleapis.services.AbstractGoogleClientRequest

Constructor Summary

Method Summary

Methods inherited from class com.google.api.services.compute.ComputeRequest

Methods inherited from class com.google.api.client.googleapis.services.json.AbstractGoogleJsonClientRequest

Methods inherited from class com.google.api.client.googleapis.services.AbstractGoogleClientRequest

Methods inherited from class com.google.api.client.util.GenericData

Methods inherited from class java.util.AbstractMap

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Constructor Detail

List

Method Detail

executeUsingHead

buildHttpRequestUsingHead

set$Xgafv

setAccessToken

setAlt

setCallback

setFields

setKey

setOauthToken

setPrettyPrint

setQuotaUser

setUploadType

setUploadProtocol

setUserIp

getProject

setProject

getZone

setZone

getAssociation

setAssociation

getFilter

setFilter

getMaxResults

setMaxResults

getOrderBy

setOrderBy

getPageToken

setPageToken

getReturnPartialSuccess

setReturnPartialSuccess

set