import "google.golang.org/api/compute/v1"
Package compute provides access to the Compute Engine API.
See https://developers.google.com/compute/docs/reference/latest/
Usage example:
import "google.golang.org/api/compute/v1" ... computeService, err := compute.New(oauthHttpClient)
const (
// View and manage your data across Google Cloud Platform services
CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"
// View and manage your Google Compute Engine resources
ComputeScope = "https://www.googleapis.com/auth/compute"
// View your Google Compute Engine resources
ComputeReadonlyScope = "https://www.googleapis.com/auth/compute.readonly"
// Manage your data and permissions in Google Cloud Storage
DevstorageFullControlScope = "https://www.googleapis.com/auth/devstorage.full_control"
// View your data in Google Cloud Storage
DevstorageReadOnlyScope = "https://www.googleapis.com/auth/devstorage.read_only"
// Manage your data in Google Cloud Storage
DevstorageReadWriteScope = "https://www.googleapis.com/auth/devstorage.read_write"
)OAuth2 scopes used by this API.
type AcceleratorConfig struct {
// AcceleratorCount: The number of the guest accelerator cards exposed
// to this instance.
AcceleratorCount int64 `json:"acceleratorCount,omitempty"`
// AcceleratorType: Full or partial URL of the accelerator type resource
// to expose to this instance.
AcceleratorType string `json:"acceleratorType,omitempty"`
// ForceSendFields is a list of field names (e.g. "AcceleratorCount") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AcceleratorCount") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}AcceleratorConfig: A specification of the type and number of accelerator cards attached to the instance.
func (s *AcceleratorConfig) MarshalJSON() ([]byte, error)
type AcceleratorType struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Deprecated: [Output Only] The deprecation status associated with this
// accelerator type.
Deprecated *DeprecationStatus `json:"deprecated,omitempty"`
// Description: [Output Only] An optional textual description of the
// resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] The type of the resource. Always
// compute#acceleratorType for accelerator types.
Kind string `json:"kind,omitempty"`
// MaximumCardsPerInstance: [Output Only] Maximum accelerator cards
// allowed per instance.
MaximumCardsPerInstance int64 `json:"maximumCardsPerInstance,omitempty"`
// Name: [Output Only] Name of the resource.
Name string `json:"name,omitempty"`
// SelfLink: [Output Only] Server-defined fully-qualified URL for this
// resource.
SelfLink string `json:"selfLink,omitempty"`
// Zone: [Output Only] The name of the zone where the accelerator type
// resides, such as us-central1-a.
Zone string `json:"zone,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}AcceleratorType: An Accelerator Type resource. (== resource_for beta.acceleratorTypes ==) (== resource_for v1.acceleratorTypes ==)
func (s *AcceleratorType) MarshalJSON() ([]byte, error)
type AcceleratorTypeAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of AcceleratorTypesScopedList resources.
Items map[string]AcceleratorTypesScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#acceleratorTypeAggregatedList for aggregated lists of
// accelerator types.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *AcceleratorTypeAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AcceleratorTypeAggregatedList) MarshalJSON() ([]byte, error)
type AcceleratorTypeAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*AcceleratorTypeAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AcceleratorTypeAggregatedListWarning: [Output Only] Informational warning message.
func (s *AcceleratorTypeAggregatedListWarning) MarshalJSON() ([]byte, error)
type AcceleratorTypeAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AcceleratorTypeAggregatedListWarningData) MarshalJSON() ([]byte, error)
type AcceleratorTypeList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of AcceleratorType resources.
Items []*AcceleratorType `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#acceleratorTypeList for lists of accelerator types.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *AcceleratorTypeListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AcceleratorTypeList: Contains a list of accelerator types.
func (s *AcceleratorTypeList) MarshalJSON() ([]byte, error)
type AcceleratorTypeListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*AcceleratorTypeListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AcceleratorTypeListWarning: [Output Only] Informational warning message.
func (s *AcceleratorTypeListWarning) MarshalJSON() ([]byte, error)
type AcceleratorTypeListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AcceleratorTypeListWarningData) MarshalJSON() ([]byte, error)
type AcceleratorTypesAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *AcceleratorTypesAggregatedListCall) Context(ctx context.Context) *AcceleratorTypesAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AcceleratorTypesAggregatedListCall) Do(opts ...googleapi.CallOption) (*AcceleratorTypeAggregatedList, error)
Do executes the "compute.acceleratorTypes.aggregatedList" call. Exactly one of *AcceleratorTypeAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *AcceleratorTypeAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AcceleratorTypesAggregatedListCall) Fields(s ...googleapi.Field) *AcceleratorTypesAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AcceleratorTypesAggregatedListCall) Filter(filter string) *AcceleratorTypesAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *AcceleratorTypesAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AcceleratorTypesAggregatedListCall) IfNoneMatch(entityTag string) *AcceleratorTypesAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *AcceleratorTypesAggregatedListCall) MaxResults(maxResults int64) *AcceleratorTypesAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *AcceleratorTypesAggregatedListCall) OrderBy(orderBy string) *AcceleratorTypesAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *AcceleratorTypesAggregatedListCall) PageToken(pageToken string) *AcceleratorTypesAggregatedListCall
PageToken sets the optional parameter "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.
func (c *AcceleratorTypesAggregatedListCall) Pages(ctx context.Context, f func(*AcceleratorTypeAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type AcceleratorTypesGetCall struct {
// contains filtered or unexported fields
}func (c *AcceleratorTypesGetCall) Context(ctx context.Context) *AcceleratorTypesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AcceleratorTypesGetCall) Do(opts ...googleapi.CallOption) (*AcceleratorType, error)
Do executes the "compute.acceleratorTypes.get" call. Exactly one of *AcceleratorType or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *AcceleratorType.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AcceleratorTypesGetCall) Fields(s ...googleapi.Field) *AcceleratorTypesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AcceleratorTypesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AcceleratorTypesGetCall) IfNoneMatch(entityTag string) *AcceleratorTypesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type AcceleratorTypesListCall struct {
// contains filtered or unexported fields
}func (c *AcceleratorTypesListCall) Context(ctx context.Context) *AcceleratorTypesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AcceleratorTypesListCall) Do(opts ...googleapi.CallOption) (*AcceleratorTypeList, error)
Do executes the "compute.acceleratorTypes.list" call. Exactly one of *AcceleratorTypeList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *AcceleratorTypeList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AcceleratorTypesListCall) Fields(s ...googleapi.Field) *AcceleratorTypesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AcceleratorTypesListCall) Filter(filter string) *AcceleratorTypesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *AcceleratorTypesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AcceleratorTypesListCall) IfNoneMatch(entityTag string) *AcceleratorTypesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *AcceleratorTypesListCall) MaxResults(maxResults int64) *AcceleratorTypesListCall
MaxResults sets the optional parameter "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)
func (c *AcceleratorTypesListCall) OrderBy(orderBy string) *AcceleratorTypesListCall
OrderBy sets the optional parameter "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.
func (c *AcceleratorTypesListCall) PageToken(pageToken string) *AcceleratorTypesListCall
PageToken sets the optional parameter "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.
func (c *AcceleratorTypesListCall) Pages(ctx context.Context, f func(*AcceleratorTypeList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type AcceleratorTypesScopedList struct {
// AcceleratorTypes: [Output Only] List of accelerator types contained
// in this scope.
AcceleratorTypes []*AcceleratorType `json:"acceleratorTypes,omitempty"`
// Warning: [Output Only] An informational warning that appears when the
// accelerator types list is empty.
Warning *AcceleratorTypesScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "AcceleratorTypes") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AcceleratorTypes") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *AcceleratorTypesScopedList) MarshalJSON() ([]byte, error)
type AcceleratorTypesScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*AcceleratorTypesScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AcceleratorTypesScopedListWarning: [Output Only] An informational warning that appears when the accelerator types list is empty.
func (s *AcceleratorTypesScopedListWarning) MarshalJSON() ([]byte, error)
type AcceleratorTypesScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AcceleratorTypesScopedListWarningData) MarshalJSON() ([]byte, error)
type AcceleratorTypesService struct {
// contains filtered or unexported fields
}func NewAcceleratorTypesService(s *Service) *AcceleratorTypesService
func (r *AcceleratorTypesService) AggregatedList(project string) *AcceleratorTypesAggregatedListCall
AggregatedList: Retrieves an aggregated list of accelerator types.
func (r *AcceleratorTypesService) Get(project string, zone string, acceleratorType string) *AcceleratorTypesGetCall
Get: Returns the specified accelerator type. Get a list of available accelerator types by making a list() request.
func (r *AcceleratorTypesService) List(project string, zone string) *AcceleratorTypesListCall
List: Retrieves a list of accelerator types available to the specified project.
type AccessConfig struct {
// Kind: [Output Only] Type of the resource. Always compute#accessConfig
// for access configs.
Kind string `json:"kind,omitempty"`
// Name: The name of this access configuration. The default and
// recommended name is External NAT but you can use any arbitrary string
// you would like. For example, My external IP or Network Access.
Name string `json:"name,omitempty"`
// NatIP: An external IP address associated with this instance. Specify
// an unused static external IP address available to the project or
// leave this field undefined to use an IP from a shared ephemeral IP
// address pool. If you specify a static external IP address, it must
// live in the same region as the zone of the instance.
NatIP string `json:"natIP,omitempty"`
// Type: The type of configuration. The default and only option is
// ONE_TO_ONE_NAT.
//
// Possible values:
// "ONE_TO_ONE_NAT" (default)
Type string `json:"type,omitempty"`
// ForceSendFields is a list of field names (e.g. "Kind") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Kind") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AccessConfig: An access configuration attached to an instance's network interface. Only one access config per instance is supported.
func (s *AccessConfig) MarshalJSON() ([]byte, error)
type Address struct {
// Address: The static IP address represented by this resource.
Address string `json:"address,omitempty"`
// AddressType: The type of address to reserve, either INTERNAL or
// EXTERNAL. If unspecified, defaults to EXTERNAL.
//
// Possible values:
// "EXTERNAL"
// "INTERNAL"
// "UNSPECIFIED_TYPE"
AddressType string `json:"addressType,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// IpVersion: The IP Version that will be used by this address. Valid
// options are IPV4 or IPV6. This can only be specified for a global
// address.
//
// Possible values:
// "IPV4"
// "IPV6"
// "UNSPECIFIED_VERSION"
IpVersion string `json:"ipVersion,omitempty"`
// Kind: [Output Only] Type of the resource. Always compute#address for
// addresses.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Region: [Output Only] URL of the region where the regional address
// resides. This field is not applicable to global addresses.
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Status: [Output Only] The status of the address, which can be one of
// RESERVING, RESERVED, or IN_USE. An address that is RESERVING is
// currently in the process of being reserved. A RESERVED address is
// currently reserved and available to use. An IN_USE address is
// currently being used by another resource and is not available.
//
// Possible values:
// "IN_USE"
// "RESERVED"
Status string `json:"status,omitempty"`
// Subnetwork: The URL of the subnetwork in which to reserve the
// address. If an IP address is specified, it must be within the
// subnetwork's IP range. This field can only be used with INTERNAL type
// with GCE_ENDPOINT/DNS_RESOLVER purposes.
Subnetwork string `json:"subnetwork,omitempty"`
// Users: [Output Only] The URLs of the resources that are using this
// address.
Users []string `json:"users,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Address") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Address") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}Address: A reserved address resource. (== resource_for beta.addresses ==) (== resource_for v1.addresses ==) (== resource_for beta.globalAddresses ==) (== resource_for v1.globalAddresses ==)
type AddressAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of AddressesScopedList resources.
Items map[string]AddressesScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#addressAggregatedList for aggregated lists of addresses.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *AddressAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AddressAggregatedList) MarshalJSON() ([]byte, error)
type AddressAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*AddressAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AddressAggregatedListWarning: [Output Only] Informational warning message.
func (s *AddressAggregatedListWarning) MarshalJSON() ([]byte, error)
type AddressAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AddressAggregatedListWarningData) MarshalJSON() ([]byte, error)
type AddressList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Address resources.
Items []*Address `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#addressList for
// lists of addresses.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *AddressListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AddressList: Contains a list of addresses.
func (s *AddressList) MarshalJSON() ([]byte, error)
type AddressListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*AddressListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AddressListWarning: [Output Only] Informational warning message.
func (s *AddressListWarning) MarshalJSON() ([]byte, error)
type AddressListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AddressListWarningData) MarshalJSON() ([]byte, error)
type AddressesAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *AddressesAggregatedListCall) Context(ctx context.Context) *AddressesAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AddressesAggregatedListCall) Do(opts ...googleapi.CallOption) (*AddressAggregatedList, error)
Do executes the "compute.addresses.aggregatedList" call. Exactly one of *AddressAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *AddressAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AddressesAggregatedListCall) Fields(s ...googleapi.Field) *AddressesAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AddressesAggregatedListCall) Filter(filter string) *AddressesAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *AddressesAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AddressesAggregatedListCall) IfNoneMatch(entityTag string) *AddressesAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *AddressesAggregatedListCall) MaxResults(maxResults int64) *AddressesAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *AddressesAggregatedListCall) OrderBy(orderBy string) *AddressesAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *AddressesAggregatedListCall) PageToken(pageToken string) *AddressesAggregatedListCall
PageToken sets the optional parameter "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.
func (c *AddressesAggregatedListCall) Pages(ctx context.Context, f func(*AddressAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type AddressesDeleteCall struct {
// contains filtered or unexported fields
}func (c *AddressesDeleteCall) Context(ctx context.Context) *AddressesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AddressesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.addresses.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AddressesDeleteCall) Fields(s ...googleapi.Field) *AddressesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AddressesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AddressesDeleteCall) RequestId(requestId string) *AddressesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type AddressesGetCall struct {
// contains filtered or unexported fields
}func (c *AddressesGetCall) Context(ctx context.Context) *AddressesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AddressesGetCall) Do(opts ...googleapi.CallOption) (*Address, error)
Do executes the "compute.addresses.get" call. Exactly one of *Address or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Address.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AddressesGetCall) Fields(s ...googleapi.Field) *AddressesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AddressesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AddressesGetCall) IfNoneMatch(entityTag string) *AddressesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type AddressesInsertCall struct {
// contains filtered or unexported fields
}func (c *AddressesInsertCall) Context(ctx context.Context) *AddressesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AddressesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.addresses.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AddressesInsertCall) Fields(s ...googleapi.Field) *AddressesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AddressesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AddressesInsertCall) RequestId(requestId string) *AddressesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type AddressesListCall struct {
// contains filtered or unexported fields
}func (c *AddressesListCall) Context(ctx context.Context) *AddressesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AddressesListCall) Do(opts ...googleapi.CallOption) (*AddressList, error)
Do executes the "compute.addresses.list" call. Exactly one of *AddressList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *AddressList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AddressesListCall) Fields(s ...googleapi.Field) *AddressesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AddressesListCall) Filter(filter string) *AddressesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *AddressesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AddressesListCall) IfNoneMatch(entityTag string) *AddressesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *AddressesListCall) MaxResults(maxResults int64) *AddressesListCall
MaxResults sets the optional parameter "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)
func (c *AddressesListCall) OrderBy(orderBy string) *AddressesListCall
OrderBy sets the optional parameter "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.
func (c *AddressesListCall) PageToken(pageToken string) *AddressesListCall
PageToken sets the optional parameter "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.
func (c *AddressesListCall) Pages(ctx context.Context, f func(*AddressList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type AddressesScopedList struct {
// Addresses: [Output Only] List of addresses contained in this scope.
Addresses []*Address `json:"addresses,omitempty"`
// Warning: [Output Only] Informational warning which replaces the list
// of addresses when the list is empty.
Warning *AddressesScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "Addresses") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Addresses") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AddressesScopedList) MarshalJSON() ([]byte, error)
type AddressesScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*AddressesScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AddressesScopedListWarning: [Output Only] Informational warning which replaces the list of addresses when the list is empty.
func (s *AddressesScopedListWarning) MarshalJSON() ([]byte, error)
type AddressesScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AddressesScopedListWarningData) MarshalJSON() ([]byte, error)
type AddressesService struct {
// contains filtered or unexported fields
}func NewAddressesService(s *Service) *AddressesService
func (r *AddressesService) AggregatedList(project string) *AddressesAggregatedListCall
AggregatedList: Retrieves an aggregated list of addresses. For details, see https://cloud.google.com/compute/docs/reference/latest/addresses/aggregatedList
func (r *AddressesService) Delete(project string, region string, address string) *AddressesDeleteCall
Delete: Deletes the specified address resource. For details, see https://cloud.google.com/compute/docs/reference/latest/addresses/delete
func (r *AddressesService) Get(project string, region string, address string) *AddressesGetCall
Get: Returns the specified address resource. For details, see https://cloud.google.com/compute/docs/reference/latest/addresses/get
func (r *AddressesService) Insert(project string, region string, address *Address) *AddressesInsertCall
Insert: Creates an address resource in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/addresses/insert
func (r *AddressesService) List(project string, region string) *AddressesListCall
List: Retrieves a list of addresses contained within the specified region. For details, see https://cloud.google.com/compute/docs/reference/latest/addresses/list
type AliasIpRange struct {
// IpCidrRange: The IP CIDR range represented by this alias IP range.
// This IP CIDR range must belong to the specified subnetwork and cannot
// contain IP addresses reserved by system or used by other network
// interfaces. This range may be a single IP address (e.g. 10.2.3.4), a
// netmask (e.g. /24) or a CIDR format string (e.g. 10.1.2.0/24).
IpCidrRange string `json:"ipCidrRange,omitempty"`
// SubnetworkRangeName: Optional subnetwork secondary range name
// specifying the secondary range from which to allocate the IP CIDR
// range for this alias IP range. If left unspecified, the primary range
// of the subnetwork will be used.
SubnetworkRangeName string `json:"subnetworkRangeName,omitempty"`
// ForceSendFields is a list of field names (e.g. "IpCidrRange") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "IpCidrRange") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AliasIpRange: An alias IP range attached to an instance's network interface.
func (s *AliasIpRange) MarshalJSON() ([]byte, error)
type AttachedDisk struct {
// AutoDelete: Specifies whether the disk will be auto-deleted when the
// instance is deleted (but not when the disk is detached from the
// instance).
AutoDelete bool `json:"autoDelete,omitempty"`
// Boot: Indicates that this is a boot disk. The virtual machine will
// use the first partition of the disk for its root filesystem.
Boot bool `json:"boot,omitempty"`
// DeviceName: Specifies a unique device name of your choice that is
// reflected into the /dev/disk/by-id/google-* tree of a Linux operating
// system running within the instance. This name can be used to
// reference the device for mounting, resizing, and so on, from within
// the instance.
//
// If not specified, the server chooses a default device name to apply
// to this disk, in the form persistent-disks-x, where x is a number
// assigned by Google Compute Engine. This field is only applicable for
// persistent disks.
DeviceName string `json:"deviceName,omitempty"`
// DiskEncryptionKey: Encrypts or decrypts a disk using a
// customer-supplied encryption key.
//
// If you are creating a new disk, this field encrypts the new disk
// using an encryption key that you provide. If you are attaching an
// existing disk that is already encrypted, this field decrypts the disk
// using the customer-supplied encryption key.
//
// If you encrypt a disk using a customer-supplied key, you must provide
// the same key again when you attempt to use this resource at a later
// time. For example, you must provide the key when you create a
// snapshot or an image from the disk or when you attach the disk to a
// virtual machine instance.
//
// If you do not provide an encryption key, then the disk will be
// encrypted using an automatically generated key and you do not need to
// provide a key to use the disk later.
//
// Instance templates do not store customer-supplied encryption keys, so
// you cannot use your own keys to encrypt disks in a managed instance
// group.
DiskEncryptionKey *CustomerEncryptionKey `json:"diskEncryptionKey,omitempty"`
// Index: [Output Only] A zero-based index to this disk, where 0 is
// reserved for the boot disk. If you have many disks attached to an
// instance, each disk would have a unique index number.
Index int64 `json:"index,omitempty"`
// InitializeParams: [Input Only] Specifies the parameters for a new
// disk that will be created alongside the new instance. Use
// initialization parameters to create boot disks or local SSDs attached
// to the new instance.
//
// This property is mutually exclusive with the source property; you can
// only define one or the other, but not both.
InitializeParams *AttachedDiskInitializeParams `json:"initializeParams,omitempty"`
// Interface: Specifies the disk interface to use for attaching this
// disk, which is either SCSI or NVME. The default is SCSI. Persistent
// disks must always use SCSI and the request will fail if you attempt
// to attach a persistent disk in any other format than SCSI. Local SSDs
// can use either NVME or SCSI. For performance characteristics of SCSI
// over NVMe, see Local SSD performance.
//
// Possible values:
// "NVME"
// "SCSI"
Interface string `json:"interface,omitempty"`
// Kind: [Output Only] Type of the resource. Always compute#attachedDisk
// for attached disks.
Kind string `json:"kind,omitempty"`
// Licenses: [Output Only] Any valid publicly visible licenses.
Licenses []string `json:"licenses,omitempty"`
// Mode: The mode in which to attach this disk, either READ_WRITE or
// READ_ONLY. If not specified, the default is to attach the disk in
// READ_WRITE mode.
//
// Possible values:
// "READ_ONLY"
// "READ_WRITE"
Mode string `json:"mode,omitempty"`
// Source: Specifies a valid partial or full URL to an existing
// Persistent Disk resource. When creating a new instance, one of
// initializeParams.sourceImage or disks.source is required except for
// local SSD.
//
// If desired, you can also attach existing non-root persistent disks
// using this property. This field is only applicable for persistent
// disks.
//
// Note that for InstanceTemplate, specify the disk name, not the URL
// for the disk.
Source string `json:"source,omitempty"`
// Type: Specifies the type of the disk, either SCRATCH or PERSISTENT.
// If not specified, the default is PERSISTENT.
//
// Possible values:
// "PERSISTENT"
// "SCRATCH"
Type string `json:"type,omitempty"`
// ForceSendFields is a list of field names (e.g. "AutoDelete") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AutoDelete") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AttachedDisk: An instance-attached disk resource.
func (s *AttachedDisk) MarshalJSON() ([]byte, error)
type AttachedDiskInitializeParams struct {
// DiskName: Specifies the disk name. If not specified, the default is
// to use the name of the instance.
DiskName string `json:"diskName,omitempty"`
// DiskSizeGb: Specifies the size of the disk in base-2 GB.
DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"`
// DiskType: Specifies the disk type to use to create the instance. If
// not specified, the default is pd-standard, specified using the full
// URL. For
// example:
//
// https://www.googleapis.com/compute/v1/projects/project/zones
// /zone/diskTypes/pd-standard
//
// Other values include pd-ssd and local-ssd. If you define this field,
// you can provide either the full or partial URL. For example, the
// following are valid values:
// -
// https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType
// - projects/project/zones/zone/diskTypes/diskType
// - zones/zone/diskTypes/diskType Note that for InstanceTemplate, this
// is the name of the disk type, not URL.
DiskType string `json:"diskType,omitempty"`
// SourceImage: The source image to create this disk. When creating a
// new instance, one of initializeParams.sourceImage or disks.source is
// required except for local SSD.
//
// To create a disk with one of the public operating system images,
// specify the image by its family name. For example, specify
// family/debian-8 to use the latest Debian 8
// image:
//
// projects/debian-cloud/global/images/family/debian-8
//
// Alternatively, use a specific version of a public operating system
// image:
//
// projects/debian-cloud/global/images/debian-8-jessie-vYYYYMMDD
//
// To create a disk with a custom image that you created, specify the
// image name in the following format:
//
// global/images/my-custom-image
//
// You can also specify a custom image by its image family, which
// returns the latest version of the image in that family. Replace the
// image name with
// family/family-name:
//
// global/images/family/my-image-family
//
// If the source image is deleted later, this field will not be set.
SourceImage string `json:"sourceImage,omitempty"`
// SourceImageEncryptionKey: The customer-supplied encryption key of the
// source image. Required if the source image is protected by a
// customer-supplied encryption key.
//
// Instance templates do not store customer-supplied encryption keys, so
// you cannot create disks for instances in a managed instance group if
// the source images are encrypted with your own keys.
SourceImageEncryptionKey *CustomerEncryptionKey `json:"sourceImageEncryptionKey,omitempty"`
// ForceSendFields is a list of field names (e.g. "DiskName") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "DiskName") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AttachedDiskInitializeParams: [Input Only] Specifies the parameters for a new disk that will be created alongside the new instance. Use initialization parameters to create boot disks or local SSDs attached to the new instance.
This property is mutually exclusive with the source property; you can only define one or the other, but not both.
func (s *AttachedDiskInitializeParams) MarshalJSON() ([]byte, error)
type Autoscaler struct {
// AutoscalingPolicy: The configuration parameters for the autoscaling
// algorithm. You can define one or more of the policies for an
// autoscaler: cpuUtilization, customMetricUtilizations, and
// loadBalancingUtilization.
//
// If none of these are specified, the default will be to autoscale
// based on cpuUtilization to 0.6 or 60%.
AutoscalingPolicy *AutoscalingPolicy `json:"autoscalingPolicy,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#autoscaler
// for autoscalers.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Region: [Output Only] URL of the region where the instance group
// resides (for autoscalers living in regional scope).
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Status: [Output Only] The status of the autoscaler configuration.
//
// Possible values:
// "ACTIVE"
// "DELETING"
// "ERROR"
// "PENDING"
Status string `json:"status,omitempty"`
// StatusDetails: [Output Only] Human-readable details about the current
// state of the autoscaler. Read the documentation for Commonly returned
// status messages for examples of status messages you might encounter.
StatusDetails []*AutoscalerStatusDetails `json:"statusDetails,omitempty"`
// Target: URL of the managed instance group that this autoscaler will
// scale.
Target string `json:"target,omitempty"`
// Zone: [Output Only] URL of the zone where the instance group resides
// (for autoscalers living in zonal scope).
Zone string `json:"zone,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "AutoscalingPolicy")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AutoscalingPolicy") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Autoscaler: Represents an Autoscaler resource. Autoscalers allow you to automatically scale virtual machine instances in managed instance groups according to an autoscaling policy that you define. For more information, read Autoscaling Groups of Instances. (== resource_for beta.autoscalers ==) (== resource_for v1.autoscalers ==) (== resource_for beta.regionAutoscalers ==) (== resource_for v1.regionAutoscalers ==)
func (s *Autoscaler) MarshalJSON() ([]byte, error)
type AutoscalerAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of AutoscalersScopedList resources.
Items map[string]AutoscalersScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#autoscalerAggregatedList for aggregated lists of autoscalers.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *AutoscalerAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AutoscalerAggregatedList) MarshalJSON() ([]byte, error)
type AutoscalerAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*AutoscalerAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AutoscalerAggregatedListWarning: [Output Only] Informational warning message.
func (s *AutoscalerAggregatedListWarning) MarshalJSON() ([]byte, error)
type AutoscalerAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AutoscalerAggregatedListWarningData) MarshalJSON() ([]byte, error)
type AutoscalerList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Autoscaler resources.
Items []*Autoscaler `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#autoscalerList
// for lists of autoscalers.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *AutoscalerListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AutoscalerList: Contains a list of Autoscaler resources.
func (s *AutoscalerList) MarshalJSON() ([]byte, error)
type AutoscalerListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*AutoscalerListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AutoscalerListWarning: [Output Only] Informational warning message.
func (s *AutoscalerListWarning) MarshalJSON() ([]byte, error)
type AutoscalerListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AutoscalerListWarningData) MarshalJSON() ([]byte, error)
type AutoscalerStatusDetails struct {
// Message: The status message.
Message string `json:"message,omitempty"`
// Type: The type of error returned.
//
// Possible values:
// "ALL_INSTANCES_UNHEALTHY"
// "BACKEND_SERVICE_DOES_NOT_EXIST"
// "CAPPED_AT_MAX_NUM_REPLICAS"
// "CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE"
// "CUSTOM_METRIC_INVALID"
// "MIN_EQUALS_MAX"
// "MISSING_CUSTOM_METRIC_DATA_POINTS"
// "MISSING_LOAD_BALANCING_DATA_POINTS"
// "MORE_THAN_ONE_BACKEND_SERVICE"
// "NOT_ENOUGH_QUOTA_AVAILABLE"
// "REGION_RESOURCE_STOCKOUT"
// "SCALING_TARGET_DOES_NOT_EXIST"
// "UNKNOWN"
// "UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION"
// "ZONE_RESOURCE_STOCKOUT"
Type string `json:"type,omitempty"`
// ForceSendFields is a list of field names (e.g. "Message") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Message") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AutoscalerStatusDetails) MarshalJSON() ([]byte, error)
type AutoscalersAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *AutoscalersAggregatedListCall) Context(ctx context.Context) *AutoscalersAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AutoscalersAggregatedListCall) Do(opts ...googleapi.CallOption) (*AutoscalerAggregatedList, error)
Do executes the "compute.autoscalers.aggregatedList" call. Exactly one of *AutoscalerAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *AutoscalerAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AutoscalersAggregatedListCall) Fields(s ...googleapi.Field) *AutoscalersAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AutoscalersAggregatedListCall) Filter(filter string) *AutoscalersAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *AutoscalersAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AutoscalersAggregatedListCall) IfNoneMatch(entityTag string) *AutoscalersAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *AutoscalersAggregatedListCall) MaxResults(maxResults int64) *AutoscalersAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *AutoscalersAggregatedListCall) OrderBy(orderBy string) *AutoscalersAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *AutoscalersAggregatedListCall) PageToken(pageToken string) *AutoscalersAggregatedListCall
PageToken sets the optional parameter "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.
func (c *AutoscalersAggregatedListCall) Pages(ctx context.Context, f func(*AutoscalerAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type AutoscalersDeleteCall struct {
// contains filtered or unexported fields
}func (c *AutoscalersDeleteCall) Context(ctx context.Context) *AutoscalersDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AutoscalersDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.autoscalers.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AutoscalersDeleteCall) Fields(s ...googleapi.Field) *AutoscalersDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AutoscalersDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AutoscalersDeleteCall) RequestId(requestId string) *AutoscalersDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type AutoscalersGetCall struct {
// contains filtered or unexported fields
}func (c *AutoscalersGetCall) Context(ctx context.Context) *AutoscalersGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AutoscalersGetCall) Do(opts ...googleapi.CallOption) (*Autoscaler, error)
Do executes the "compute.autoscalers.get" call. Exactly one of *Autoscaler or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Autoscaler.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AutoscalersGetCall) Fields(s ...googleapi.Field) *AutoscalersGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AutoscalersGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AutoscalersGetCall) IfNoneMatch(entityTag string) *AutoscalersGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type AutoscalersInsertCall struct {
// contains filtered or unexported fields
}func (c *AutoscalersInsertCall) Context(ctx context.Context) *AutoscalersInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AutoscalersInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.autoscalers.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AutoscalersInsertCall) Fields(s ...googleapi.Field) *AutoscalersInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AutoscalersInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AutoscalersInsertCall) RequestId(requestId string) *AutoscalersInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type AutoscalersListCall struct {
// contains filtered or unexported fields
}func (c *AutoscalersListCall) Context(ctx context.Context) *AutoscalersListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AutoscalersListCall) Do(opts ...googleapi.CallOption) (*AutoscalerList, error)
Do executes the "compute.autoscalers.list" call. Exactly one of *AutoscalerList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *AutoscalerList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AutoscalersListCall) Fields(s ...googleapi.Field) *AutoscalersListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AutoscalersListCall) Filter(filter string) *AutoscalersListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *AutoscalersListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AutoscalersListCall) IfNoneMatch(entityTag string) *AutoscalersListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *AutoscalersListCall) MaxResults(maxResults int64) *AutoscalersListCall
MaxResults sets the optional parameter "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)
func (c *AutoscalersListCall) OrderBy(orderBy string) *AutoscalersListCall
OrderBy sets the optional parameter "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.
func (c *AutoscalersListCall) PageToken(pageToken string) *AutoscalersListCall
PageToken sets the optional parameter "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.
func (c *AutoscalersListCall) Pages(ctx context.Context, f func(*AutoscalerList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type AutoscalersPatchCall struct {
// contains filtered or unexported fields
}func (c *AutoscalersPatchCall) Autoscaler(autoscaler string) *AutoscalersPatchCall
Autoscaler sets the optional parameter "autoscaler": Name of the autoscaler to patch.
func (c *AutoscalersPatchCall) Context(ctx context.Context) *AutoscalersPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AutoscalersPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.autoscalers.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AutoscalersPatchCall) Fields(s ...googleapi.Field) *AutoscalersPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AutoscalersPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AutoscalersPatchCall) RequestId(requestId string) *AutoscalersPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type AutoscalersScopedList struct {
// Autoscalers: [Output Only] List of autoscalers contained in this
// scope.
Autoscalers []*Autoscaler `json:"autoscalers,omitempty"`
// Warning: [Output Only] Informational warning which replaces the list
// of autoscalers when the list is empty.
Warning *AutoscalersScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "Autoscalers") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Autoscalers") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AutoscalersScopedList) MarshalJSON() ([]byte, error)
type AutoscalersScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*AutoscalersScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AutoscalersScopedListWarning: [Output Only] Informational warning which replaces the list of autoscalers when the list is empty.
func (s *AutoscalersScopedListWarning) MarshalJSON() ([]byte, error)
type AutoscalersScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *AutoscalersScopedListWarningData) MarshalJSON() ([]byte, error)
type AutoscalersService struct {
// contains filtered or unexported fields
}func NewAutoscalersService(s *Service) *AutoscalersService
func (r *AutoscalersService) AggregatedList(project string) *AutoscalersAggregatedListCall
AggregatedList: Retrieves an aggregated list of autoscalers.
func (r *AutoscalersService) Delete(project string, zone string, autoscaler string) *AutoscalersDeleteCall
Delete: Deletes the specified autoscaler.
func (r *AutoscalersService) Get(project string, zone string, autoscaler string) *AutoscalersGetCall
Get: Returns the specified autoscaler resource. Get a list of available autoscalers by making a list() request.
func (r *AutoscalersService) Insert(project string, zone string, autoscaler *Autoscaler) *AutoscalersInsertCall
Insert: Creates an autoscaler in the specified project using the data included in the request.
func (r *AutoscalersService) List(project string, zone string) *AutoscalersListCall
List: Retrieves a list of autoscalers contained within the specified zone.
func (r *AutoscalersService) Patch(project string, zone string, autoscaler *Autoscaler) *AutoscalersPatchCall
Patch: Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
func (r *AutoscalersService) Update(project string, zone string, autoscaler *Autoscaler) *AutoscalersUpdateCall
Update: Updates an autoscaler in the specified project using the data included in the request.
type AutoscalersUpdateCall struct {
// contains filtered or unexported fields
}func (c *AutoscalersUpdateCall) Autoscaler(autoscaler string) *AutoscalersUpdateCall
Autoscaler sets the optional parameter "autoscaler": Name of the autoscaler to update.
func (c *AutoscalersUpdateCall) Context(ctx context.Context) *AutoscalersUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *AutoscalersUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.autoscalers.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *AutoscalersUpdateCall) Fields(s ...googleapi.Field) *AutoscalersUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *AutoscalersUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *AutoscalersUpdateCall) RequestId(requestId string) *AutoscalersUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type AutoscalingPolicy struct {
// CoolDownPeriodSec: The number of seconds that the autoscaler should
// wait before it starts collecting information from a new instance.
// This prevents the autoscaler from collecting information when the
// instance is initializing, during which the collected usage would not
// be reliable. The default time autoscaler waits is 60
// seconds.
//
// Virtual machine initialization times might vary because of numerous
// factors. We recommend that you test how long an instance may take to
// initialize. To do this, create an instance and time the startup
// process.
CoolDownPeriodSec int64 `json:"coolDownPeriodSec,omitempty"`
// CpuUtilization: Defines the CPU utilization policy that allows the
// autoscaler to scale based on the average CPU utilization of a managed
// instance group.
CpuUtilization *AutoscalingPolicyCpuUtilization `json:"cpuUtilization,omitempty"`
// CustomMetricUtilizations: Configuration parameters of autoscaling
// based on a custom metric.
CustomMetricUtilizations []*AutoscalingPolicyCustomMetricUtilization `json:"customMetricUtilizations,omitempty"`
// LoadBalancingUtilization: Configuration parameters of autoscaling
// based on load balancer.
LoadBalancingUtilization *AutoscalingPolicyLoadBalancingUtilization `json:"loadBalancingUtilization,omitempty"`
// MaxNumReplicas: The maximum number of instances that the autoscaler
// can scale up to. This is required when creating or updating an
// autoscaler. The maximum number of replicas should not be lower than
// minimal number of replicas.
MaxNumReplicas int64 `json:"maxNumReplicas,omitempty"`
// MinNumReplicas: The minimum number of replicas that the autoscaler
// can scale down to. This cannot be less than 0. If not provided,
// autoscaler will choose a default value depending on maximum number of
// instances allowed.
MinNumReplicas int64 `json:"minNumReplicas,omitempty"`
// ForceSendFields is a list of field names (e.g. "CoolDownPeriodSec")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CoolDownPeriodSec") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}AutoscalingPolicy: Cloud Autoscaler policy.
func (s *AutoscalingPolicy) MarshalJSON() ([]byte, error)
type AutoscalingPolicyCpuUtilization struct {
// UtilizationTarget: The target CPU utilization that the autoscaler
// should maintain. Must be a float value in the range (0, 1]. If not
// specified, the default is 0.6.
//
// If the CPU level is below the target utilization, the autoscaler
// scales down the number of instances until it reaches the minimum
// number of instances you specified or until the average CPU of your
// instances reaches the target utilization.
//
// If the average CPU is above the target utilization, the autoscaler
// scales up until it reaches the maximum number of instances you
// specified or until the average utilization reaches the target
// utilization.
UtilizationTarget float64 `json:"utilizationTarget,omitempty"`
// ForceSendFields is a list of field names (e.g. "UtilizationTarget")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "UtilizationTarget") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}AutoscalingPolicyCpuUtilization: CPU utilization policy.
func (s *AutoscalingPolicyCpuUtilization) MarshalJSON() ([]byte, error)
func (s *AutoscalingPolicyCpuUtilization) UnmarshalJSON(data []byte) error
type AutoscalingPolicyCustomMetricUtilization struct {
// Metric: The identifier (type) of the Stackdriver Monitoring metric.
// The metric cannot have negative values.
//
// The metric must have a value type of INT64 or DOUBLE.
Metric string `json:"metric,omitempty"`
// UtilizationTarget: The target value of the metric that autoscaler
// should maintain. This must be a positive value. A utilization metric
// scales number of virtual machines handling requests to increase or
// decrease proportionally to the metric.
//
// For example, a good metric to use as a utilization_target is
// compute.googleapis.com/instance/network/received_bytes_count. The
// autoscaler will work to keep this value constant for each of the
// instances.
UtilizationTarget float64 `json:"utilizationTarget,omitempty"`
// UtilizationTargetType: Defines how target utilization value is
// expressed for a Stackdriver Monitoring metric. Either GAUGE,
// DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default
// is GAUGE.
//
// Possible values:
// "DELTA_PER_MINUTE"
// "DELTA_PER_SECOND"
// "GAUGE"
UtilizationTargetType string `json:"utilizationTargetType,omitempty"`
// ForceSendFields is a list of field names (e.g. "Metric") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Metric") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}AutoscalingPolicyCustomMetricUtilization: Custom utilization metric policy.
func (s *AutoscalingPolicyCustomMetricUtilization) MarshalJSON() ([]byte, error)
func (s *AutoscalingPolicyCustomMetricUtilization) UnmarshalJSON(data []byte) error
type AutoscalingPolicyLoadBalancingUtilization struct {
// UtilizationTarget: Fraction of backend capacity utilization (set in
// HTTP(s) load balancing configuration) that autoscaler should
// maintain. Must be a positive float value. If not defined, the default
// is 0.8.
UtilizationTarget float64 `json:"utilizationTarget,omitempty"`
// ForceSendFields is a list of field names (e.g. "UtilizationTarget")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "UtilizationTarget") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}AutoscalingPolicyLoadBalancingUtilization: Configuration parameters of autoscaling based on load balancing.
func (s *AutoscalingPolicyLoadBalancingUtilization) MarshalJSON() ([]byte, error)
func (s *AutoscalingPolicyLoadBalancingUtilization) UnmarshalJSON(data []byte) error
type Backend struct {
// BalancingMode: Specifies the balancing mode for this backend. For
// global HTTP(S) or TCP/SSL load balancing, the default is UTILIZATION.
// Valid values are UTILIZATION, RATE (for HTTP(S)) and CONNECTION (for
// TCP/SSL).
//
// For Internal Load Balancing, the default and only supported mode is
// CONNECTION.
//
// Possible values:
// "CONNECTION"
// "RATE"
// "UTILIZATION"
BalancingMode string `json:"balancingMode,omitempty"`
// CapacityScaler: A multiplier applied to the group's maximum servicing
// capacity (based on UTILIZATION, RATE or CONNECTION). Default value is
// 1, which means the group will serve up to 100% of its configured
// capacity (depending on balancingMode). A setting of 0 means the group
// is completely drained, offering 0% of its available Capacity. Valid
// range is [0.0,1.0].
//
// This cannot be used for internal load balancing.
CapacityScaler float64 `json:"capacityScaler,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Group: The fully-qualified URL of a Instance Group resource. This
// instance group defines the list of instances that serve traffic.
// Member virtual machine instances from each instance group must live
// in the same zone as the instance group itself. No two backends in a
// backend service are allowed to use same Instance Group
// resource.
//
// Note that you must specify an Instance Group resource using the
// fully-qualified URL, rather than a partial URL.
//
// When the BackendService has load balancing scheme INTERNAL, the
// instance group must be within the same region as the BackendService.
Group string `json:"group,omitempty"`
// MaxConnections: The max number of simultaneous connections for the
// group. Can be used with either CONNECTION or UTILIZATION balancing
// modes. For CONNECTION mode, either maxConnections or
// maxConnectionsPerInstance must be set.
//
// This cannot be used for internal load balancing.
MaxConnections int64 `json:"maxConnections,omitempty"`
// MaxConnectionsPerInstance: The max number of simultaneous connections
// that a single backend instance can handle. This is used to calculate
// the capacity of the group. Can be used in either CONNECTION or
// UTILIZATION balancing modes. For CONNECTION mode, either
// maxConnections or maxConnectionsPerInstance must be set.
//
// This cannot be used for internal load balancing.
MaxConnectionsPerInstance int64 `json:"maxConnectionsPerInstance,omitempty"`
// MaxRate: The max requests per second (RPS) of the group. Can be used
// with either RATE or UTILIZATION balancing modes, but required if RATE
// mode. For RATE mode, either maxRate or maxRatePerInstance must be
// set.
//
// This cannot be used for internal load balancing.
MaxRate int64 `json:"maxRate,omitempty"`
// MaxRatePerInstance: The max requests per second (RPS) that a single
// backend instance can handle. This is used to calculate the capacity
// of the group. Can be used in either balancing mode. For RATE mode,
// either maxRate or maxRatePerInstance must be set.
//
// This cannot be used for internal load balancing.
MaxRatePerInstance float64 `json:"maxRatePerInstance,omitempty"`
// MaxUtilization: Used when balancingMode is UTILIZATION. This ratio
// defines the CPU utilization target for the group. The default is 0.8.
// Valid range is [0.0, 1.0].
//
// This cannot be used for internal load balancing.
MaxUtilization float64 `json:"maxUtilization,omitempty"`
// ForceSendFields is a list of field names (e.g. "BalancingMode") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "BalancingMode") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}Backend: Message containing information of one individual backend.
type BackendBucket struct {
// BucketName: Cloud Storage bucket name.
BucketName string `json:"bucketName,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional textual description of the resource;
// provided by the client when the resource is created.
Description string `json:"description,omitempty"`
// EnableCdn: If true, enable Cloud CDN for this BackendBucket.
EnableCdn bool `json:"enableCdn,omitempty"`
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id uint64 `json:"id,omitempty,string"`
// Kind: Type of the resource.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "BucketName") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "BucketName") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}BackendBucket: A BackendBucket resource. This resource defines a Cloud Storage bucket.
func (s *BackendBucket) MarshalJSON() ([]byte, error)
type BackendBucketList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of BackendBucket resources.
Items []*BackendBucket `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *BackendBucketListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}BackendBucketList: Contains a list of BackendBucket resources.
func (s *BackendBucketList) MarshalJSON() ([]byte, error)
type BackendBucketListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*BackendBucketListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}BackendBucketListWarning: [Output Only] Informational warning message.
func (s *BackendBucketListWarning) MarshalJSON() ([]byte, error)
type BackendBucketListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *BackendBucketListWarningData) MarshalJSON() ([]byte, error)
type BackendBucketsDeleteCall struct {
// contains filtered or unexported fields
}func (c *BackendBucketsDeleteCall) Context(ctx context.Context) *BackendBucketsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendBucketsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.backendBuckets.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendBucketsDeleteCall) Fields(s ...googleapi.Field) *BackendBucketsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendBucketsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendBucketsDeleteCall) RequestId(requestId string) *BackendBucketsDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type BackendBucketsGetCall struct {
// contains filtered or unexported fields
}func (c *BackendBucketsGetCall) Context(ctx context.Context) *BackendBucketsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendBucketsGetCall) Do(opts ...googleapi.CallOption) (*BackendBucket, error)
Do executes the "compute.backendBuckets.get" call. Exactly one of *BackendBucket or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BackendBucket.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendBucketsGetCall) Fields(s ...googleapi.Field) *BackendBucketsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendBucketsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendBucketsGetCall) IfNoneMatch(entityTag string) *BackendBucketsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type BackendBucketsInsertCall struct {
// contains filtered or unexported fields
}func (c *BackendBucketsInsertCall) Context(ctx context.Context) *BackendBucketsInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendBucketsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.backendBuckets.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendBucketsInsertCall) Fields(s ...googleapi.Field) *BackendBucketsInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendBucketsInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendBucketsInsertCall) RequestId(requestId string) *BackendBucketsInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type BackendBucketsListCall struct {
// contains filtered or unexported fields
}func (c *BackendBucketsListCall) Context(ctx context.Context) *BackendBucketsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendBucketsListCall) Do(opts ...googleapi.CallOption) (*BackendBucketList, error)
Do executes the "compute.backendBuckets.list" call. Exactly one of *BackendBucketList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BackendBucketList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendBucketsListCall) Fields(s ...googleapi.Field) *BackendBucketsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendBucketsListCall) Filter(filter string) *BackendBucketsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *BackendBucketsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendBucketsListCall) IfNoneMatch(entityTag string) *BackendBucketsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *BackendBucketsListCall) MaxResults(maxResults int64) *BackendBucketsListCall
MaxResults sets the optional parameter "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)
func (c *BackendBucketsListCall) OrderBy(orderBy string) *BackendBucketsListCall
OrderBy sets the optional parameter "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.
func (c *BackendBucketsListCall) PageToken(pageToken string) *BackendBucketsListCall
PageToken sets the optional parameter "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.
func (c *BackendBucketsListCall) Pages(ctx context.Context, f func(*BackendBucketList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type BackendBucketsPatchCall struct {
// contains filtered or unexported fields
}func (c *BackendBucketsPatchCall) Context(ctx context.Context) *BackendBucketsPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendBucketsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.backendBuckets.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendBucketsPatchCall) Fields(s ...googleapi.Field) *BackendBucketsPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendBucketsPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendBucketsPatchCall) RequestId(requestId string) *BackendBucketsPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type BackendBucketsService struct {
// contains filtered or unexported fields
}func NewBackendBucketsService(s *Service) *BackendBucketsService
func (r *BackendBucketsService) Delete(project string, backendBucket string) *BackendBucketsDeleteCall
Delete: Deletes the specified BackendBucket resource.
func (r *BackendBucketsService) Get(project string, backendBucket string) *BackendBucketsGetCall
Get: Returns the specified BackendBucket resource. Get a list of available backend buckets by making a list() request.
func (r *BackendBucketsService) Insert(project string, backendbucket *BackendBucket) *BackendBucketsInsertCall
Insert: Creates a BackendBucket resource in the specified project using the data included in the request.
func (r *BackendBucketsService) List(project string) *BackendBucketsListCall
List: Retrieves the list of BackendBucket resources available to the specified project.
func (r *BackendBucketsService) Patch(project string, backendBucket string, backendbucket *BackendBucket) *BackendBucketsPatchCall
Patch: Updates the specified BackendBucket resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
func (r *BackendBucketsService) Update(project string, backendBucket string, backendbucket *BackendBucket) *BackendBucketsUpdateCall
Update: Updates the specified BackendBucket resource with the data included in the request.
type BackendBucketsUpdateCall struct {
// contains filtered or unexported fields
}func (c *BackendBucketsUpdateCall) Context(ctx context.Context) *BackendBucketsUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendBucketsUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.backendBuckets.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendBucketsUpdateCall) Fields(s ...googleapi.Field) *BackendBucketsUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendBucketsUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendBucketsUpdateCall) RequestId(requestId string) *BackendBucketsUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type BackendService struct {
// AffinityCookieTtlSec: Lifetime of cookies in seconds if
// session_affinity is GENERATED_COOKIE. If set to 0, the cookie is
// non-persistent and lasts only until the end of the browser session
// (or equivalent). The maximum allowed value for TTL is one day.
//
// When the load balancing scheme is INTERNAL, this field is not used.
AffinityCookieTtlSec int64 `json:"affinityCookieTtlSec,omitempty"`
// Backends: The list of backends that serve this BackendService.
Backends []*Backend `json:"backends,omitempty"`
// CdnPolicy: Cloud CDN configuration for this BackendService.
CdnPolicy *BackendServiceCdnPolicy `json:"cdnPolicy,omitempty"`
ConnectionDraining *ConnectionDraining `json:"connectionDraining,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// EnableCDN: If true, enable Cloud CDN for this BackendService.
//
// When the load balancing scheme is INTERNAL, this field is not used.
EnableCDN bool `json:"enableCDN,omitempty"`
// Fingerprint: Fingerprint of this resource. A hash of the contents
// stored in this object. This field is used in optimistic locking. This
// field will be ignored when inserting a BackendService. An up-to-date
// fingerprint must be provided in order to update the BackendService.
Fingerprint string `json:"fingerprint,omitempty"`
// HealthChecks: The list of URLs to the HttpHealthCheck or
// HttpsHealthCheck resource for health checking this BackendService.
// Currently at most one health check can be specified, and a health
// check is required for Compute Engine backend services. A health check
// must not be specified for App Engine backend and Cloud Function
// backend.
//
// For internal load balancing, a URL to a HealthCheck resource must be
// specified instead.
HealthChecks []string `json:"healthChecks,omitempty"`
Iap *BackendServiceIAP `json:"iap,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of resource. Always compute#backendService
// for backend services.
Kind string `json:"kind,omitempty"`
// LoadBalancingScheme: Indicates whether the backend service will be
// used with internal or external load balancing. A backend service
// created for one type of load balancing cannot be used with the other.
// Possible values are INTERNAL and EXTERNAL.
//
// Possible values:
// "EXTERNAL"
// "INTERNAL"
// "INVALID_LOAD_BALANCING_SCHEME"
LoadBalancingScheme string `json:"loadBalancingScheme,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Port: Deprecated in favor of portName. The TCP port to connect on the
// backend. The default value is 80.
//
// This cannot be used for internal load balancing.
Port int64 `json:"port,omitempty"`
// PortName: Name of backend port. The same name should appear in the
// instance groups referenced by this service. Required when the load
// balancing scheme is EXTERNAL.
//
// When the load balancing scheme is INTERNAL, this field is not used.
PortName string `json:"portName,omitempty"`
// Protocol: The protocol this BackendService uses to communicate with
// backends.
//
// Possible values are HTTP, HTTPS, TCP, and SSL. The default is
// HTTP.
//
// For internal load balancing, the possible values are TCP and UDP, and
// the default is TCP.
//
// Possible values:
// "HTTP"
// "HTTPS"
// "SSL"
// "TCP"
// "UDP"
Protocol string `json:"protocol,omitempty"`
// Region: [Output Only] URL of the region where the regional backend
// service resides. This field is not applicable to global backend
// services.
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// SessionAffinity: Type of session affinity to use. The default is
// NONE.
//
// When the load balancing scheme is EXTERNAL, can be NONE, CLIENT_IP,
// or GENERATED_COOKIE.
//
// When the load balancing scheme is INTERNAL, can be NONE, CLIENT_IP,
// CLIENT_IP_PROTO, or CLIENT_IP_PORT_PROTO.
//
// When the protocol is UDP, this field is not used.
//
// Possible values:
// "CLIENT_IP"
// "CLIENT_IP_PORT_PROTO"
// "CLIENT_IP_PROTO"
// "GENERATED_COOKIE"
// "NONE"
SessionAffinity string `json:"sessionAffinity,omitempty"`
// TimeoutSec: How many seconds to wait for the backend before
// considering it a failed request. Default is 30 seconds.
TimeoutSec int64 `json:"timeoutSec,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g.
// "AffinityCookieTtlSec") to unconditionally include in API requests.
// By default, fields with empty values are omitted from API requests.
// However, any non-pointer, non-interface field appearing in
// ForceSendFields will be sent to the server regardless of whether the
// field is empty or not. This may be used to include empty fields in
// Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AffinityCookieTtlSec") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}BackendService: A BackendService resource. This resource defines a group of backend virtual machines and their serving capacity. (== resource_for v1.backendService ==) (== resource_for beta.backendService ==)
func (s *BackendService) MarshalJSON() ([]byte, error)
type BackendServiceAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of BackendServicesScopedList resources.
Items map[string]BackendServicesScopedList `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *BackendServiceAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}BackendServiceAggregatedList: Contains a list of BackendServicesScopedList.
func (s *BackendServiceAggregatedList) MarshalJSON() ([]byte, error)
type BackendServiceAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*BackendServiceAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}BackendServiceAggregatedListWarning: [Output Only] Informational warning message.
func (s *BackendServiceAggregatedListWarning) MarshalJSON() ([]byte, error)
type BackendServiceAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *BackendServiceAggregatedListWarningData) MarshalJSON() ([]byte, error)
type BackendServiceCdnPolicy struct {
// CacheKeyPolicy: The CacheKeyPolicy for this CdnPolicy.
CacheKeyPolicy *CacheKeyPolicy `json:"cacheKeyPolicy,omitempty"`
// ForceSendFields is a list of field names (e.g. "CacheKeyPolicy") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CacheKeyPolicy") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}BackendServiceCdnPolicy: Message containing Cloud CDN configuration for a backend service.
func (s *BackendServiceCdnPolicy) MarshalJSON() ([]byte, error)
type BackendServiceGroupHealth struct {
HealthStatus []*HealthStatus `json:"healthStatus,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#backendServiceGroupHealth for the health of backend services.
Kind string `json:"kind,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "HealthStatus") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "HealthStatus") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *BackendServiceGroupHealth) MarshalJSON() ([]byte, error)
type BackendServiceIAP struct {
Enabled bool `json:"enabled,omitempty"`
Oauth2ClientId string `json:"oauth2ClientId,omitempty"`
Oauth2ClientSecret string `json:"oauth2ClientSecret,omitempty"`
// Oauth2ClientSecretSha256: [Output Only] SHA256 hash value for the
// field oauth2_client_secret above.
Oauth2ClientSecretSha256 string `json:"oauth2ClientSecretSha256,omitempty"`
// ForceSendFields is a list of field names (e.g. "Enabled") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Enabled") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}BackendServiceIAP: Identity-Aware Proxy
func (s *BackendServiceIAP) MarshalJSON() ([]byte, error)
type BackendServiceList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of BackendService resources.
Items []*BackendService `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#backendServiceList for lists of backend services.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *BackendServiceListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}BackendServiceList: Contains a list of BackendService resources.
func (s *BackendServiceList) MarshalJSON() ([]byte, error)
type BackendServiceListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*BackendServiceListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}BackendServiceListWarning: [Output Only] Informational warning message.
func (s *BackendServiceListWarning) MarshalJSON() ([]byte, error)
type BackendServiceListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *BackendServiceListWarningData) MarshalJSON() ([]byte, error)
type BackendServicesAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *BackendServicesAggregatedListCall) Context(ctx context.Context) *BackendServicesAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendServicesAggregatedListCall) Do(opts ...googleapi.CallOption) (*BackendServiceAggregatedList, error)
Do executes the "compute.backendServices.aggregatedList" call. Exactly one of *BackendServiceAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BackendServiceAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendServicesAggregatedListCall) Fields(s ...googleapi.Field) *BackendServicesAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendServicesAggregatedListCall) Filter(filter string) *BackendServicesAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *BackendServicesAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendServicesAggregatedListCall) IfNoneMatch(entityTag string) *BackendServicesAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *BackendServicesAggregatedListCall) MaxResults(maxResults int64) *BackendServicesAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *BackendServicesAggregatedListCall) OrderBy(orderBy string) *BackendServicesAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *BackendServicesAggregatedListCall) PageToken(pageToken string) *BackendServicesAggregatedListCall
PageToken sets the optional parameter "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.
func (c *BackendServicesAggregatedListCall) Pages(ctx context.Context, f func(*BackendServiceAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type BackendServicesDeleteCall struct {
// contains filtered or unexported fields
}func (c *BackendServicesDeleteCall) Context(ctx context.Context) *BackendServicesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendServicesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.backendServices.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendServicesDeleteCall) Fields(s ...googleapi.Field) *BackendServicesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendServicesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendServicesDeleteCall) RequestId(requestId string) *BackendServicesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type BackendServicesGetCall struct {
// contains filtered or unexported fields
}func (c *BackendServicesGetCall) Context(ctx context.Context) *BackendServicesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendServicesGetCall) Do(opts ...googleapi.CallOption) (*BackendService, error)
Do executes the "compute.backendServices.get" call. Exactly one of *BackendService or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BackendService.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendServicesGetCall) Fields(s ...googleapi.Field) *BackendServicesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendServicesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendServicesGetCall) IfNoneMatch(entityTag string) *BackendServicesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type BackendServicesGetHealthCall struct {
// contains filtered or unexported fields
}func (c *BackendServicesGetHealthCall) Context(ctx context.Context) *BackendServicesGetHealthCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendServicesGetHealthCall) Do(opts ...googleapi.CallOption) (*BackendServiceGroupHealth, error)
Do executes the "compute.backendServices.getHealth" call. Exactly one of *BackendServiceGroupHealth or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BackendServiceGroupHealth.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendServicesGetHealthCall) Fields(s ...googleapi.Field) *BackendServicesGetHealthCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendServicesGetHealthCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type BackendServicesInsertCall struct {
// contains filtered or unexported fields
}func (c *BackendServicesInsertCall) Context(ctx context.Context) *BackendServicesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendServicesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.backendServices.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendServicesInsertCall) Fields(s ...googleapi.Field) *BackendServicesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendServicesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendServicesInsertCall) RequestId(requestId string) *BackendServicesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type BackendServicesListCall struct {
// contains filtered or unexported fields
}func (c *BackendServicesListCall) Context(ctx context.Context) *BackendServicesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendServicesListCall) Do(opts ...googleapi.CallOption) (*BackendServiceList, error)
Do executes the "compute.backendServices.list" call. Exactly one of *BackendServiceList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BackendServiceList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendServicesListCall) Fields(s ...googleapi.Field) *BackendServicesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendServicesListCall) Filter(filter string) *BackendServicesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *BackendServicesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendServicesListCall) IfNoneMatch(entityTag string) *BackendServicesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *BackendServicesListCall) MaxResults(maxResults int64) *BackendServicesListCall
MaxResults sets the optional parameter "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)
func (c *BackendServicesListCall) OrderBy(orderBy string) *BackendServicesListCall
OrderBy sets the optional parameter "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.
func (c *BackendServicesListCall) PageToken(pageToken string) *BackendServicesListCall
PageToken sets the optional parameter "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.
func (c *BackendServicesListCall) Pages(ctx context.Context, f func(*BackendServiceList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type BackendServicesPatchCall struct {
// contains filtered or unexported fields
}func (c *BackendServicesPatchCall) Context(ctx context.Context) *BackendServicesPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendServicesPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.backendServices.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendServicesPatchCall) Fields(s ...googleapi.Field) *BackendServicesPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendServicesPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendServicesPatchCall) RequestId(requestId string) *BackendServicesPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type BackendServicesScopedList struct {
// BackendServices: List of BackendServices contained in this scope.
BackendServices []*BackendService `json:"backendServices,omitempty"`
// Warning: Informational warning which replaces the list of backend
// services when the list is empty.
Warning *BackendServicesScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "BackendServices") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "BackendServices") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *BackendServicesScopedList) MarshalJSON() ([]byte, error)
type BackendServicesScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*BackendServicesScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}BackendServicesScopedListWarning: Informational warning which replaces the list of backend services when the list is empty.
func (s *BackendServicesScopedListWarning) MarshalJSON() ([]byte, error)
type BackendServicesScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *BackendServicesScopedListWarningData) MarshalJSON() ([]byte, error)
type BackendServicesService struct {
// contains filtered or unexported fields
}func NewBackendServicesService(s *Service) *BackendServicesService
func (r *BackendServicesService) AggregatedList(project string) *BackendServicesAggregatedListCall
AggregatedList: Retrieves the list of all BackendService resources, regional and global, available to the specified project.
func (r *BackendServicesService) Delete(project string, backendService string) *BackendServicesDeleteCall
Delete: Deletes the specified BackendService resource. For details, see https://cloud.google.com/compute/docs/reference/latest/backendServices/delete
func (r *BackendServicesService) Get(project string, backendService string) *BackendServicesGetCall
Get: Returns the specified BackendService resource. Get a list of available backend services by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/backendServices/get
func (r *BackendServicesService) GetHealth(project string, backendService string, resourcegroupreference *ResourceGroupReference) *BackendServicesGetHealthCall
GetHealth: Gets the most recent health check results for this BackendService. For details, see https://cloud.google.com/compute/docs/reference/latest/backendServices/getHealth
func (r *BackendServicesService) Insert(project string, backendservice *BackendService) *BackendServicesInsertCall
Insert: Creates a BackendService resource in the specified project using the data included in the request. There are several restrictions and guidelines to keep in mind when creating a backend service. Read Restrictions and Guidelines for more information. For details, see https://cloud.google.com/compute/docs/reference/latest/backendServices/insert
func (r *BackendServicesService) List(project string) *BackendServicesListCall
List: Retrieves the list of BackendService resources available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/backendServices/list
func (r *BackendServicesService) Patch(project string, backendService string, backendservice *BackendService) *BackendServicesPatchCall
Patch: Patches the specified BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read Restrictions and Guidelines for more information. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. For details, see https://cloud.google.com/compute/docs/reference/latest/backendServices/patch
func (r *BackendServicesService) Update(project string, backendService string, backendservice *BackendService) *BackendServicesUpdateCall
Update: Updates the specified BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read Restrictions and Guidelines for more information. For details, see https://cloud.google.com/compute/docs/reference/latest/backendServices/update
type BackendServicesUpdateCall struct {
// contains filtered or unexported fields
}func (c *BackendServicesUpdateCall) Context(ctx context.Context) *BackendServicesUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *BackendServicesUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.backendServices.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *BackendServicesUpdateCall) Fields(s ...googleapi.Field) *BackendServicesUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *BackendServicesUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *BackendServicesUpdateCall) RequestId(requestId string) *BackendServicesUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type CacheInvalidationRule struct {
// Host: If set, this invalidation rule will only apply to requests with
// a Host header matching host.
Host string `json:"host,omitempty"`
Path string `json:"path,omitempty"`
// ForceSendFields is a list of field names (e.g. "Host") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Host") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *CacheInvalidationRule) MarshalJSON() ([]byte, error)
type CacheKeyPolicy struct {
// IncludeHost: If true, requests to different hosts will be cached
// separately.
IncludeHost bool `json:"includeHost,omitempty"`
// IncludeProtocol: If true, http and https requests will be cached
// separately.
IncludeProtocol bool `json:"includeProtocol,omitempty"`
// IncludeQueryString: If true, include query string parameters in the
// cache key according to query_string_whitelist and
// query_string_blacklist. If neither is set, the entire query string
// will be included. If false, the query string will be excluded from
// the cache key entirely.
IncludeQueryString bool `json:"includeQueryString,omitempty"`
// QueryStringBlacklist: Names of query string parameters to exclude in
// cache keys. All other parameters will be included. Either specify
// query_string_whitelist or query_string_blacklist, not both. '&' and
// '=' will be percent encoded and not treated as delimiters.
QueryStringBlacklist []string `json:"queryStringBlacklist,omitempty"`
// QueryStringWhitelist: Names of query string parameters to include in
// cache keys. All other parameters will be excluded. Either specify
// query_string_whitelist or query_string_blacklist, not both. '&' and
// '=' will be percent encoded and not treated as delimiters.
QueryStringWhitelist []string `json:"queryStringWhitelist,omitempty"`
// ForceSendFields is a list of field names (e.g. "IncludeHost") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "IncludeHost") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}CacheKeyPolicy: Message containing what to include in the cache key for a request for Cloud CDN.
func (s *CacheKeyPolicy) MarshalJSON() ([]byte, error)
type Commitment struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// EndTimestamp: [Output Only] Commitment end time in RFC3339 text
// format.
EndTimestamp string `json:"endTimestamp,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#commitment
// for commitments.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Plan: The plan for this commitment, which determines duration and
// discount rate. The currently supported plans are TWELVE_MONTH (1
// year), and THIRTY_SIX_MONTH (3 years).
//
// Possible values:
// "INVALID"
// "THIRTY_SIX_MONTH"
// "TWELVE_MONTH"
Plan string `json:"plan,omitempty"`
// Region: [Output Only] URL of the region where this commitment may be
// used.
Region string `json:"region,omitempty"`
// Resources: List of commitment amounts for particular resources. Note
// that VCPU and MEMORY resource commitments must occur together.
Resources []*ResourceCommitment `json:"resources,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// StartTimestamp: [Output Only] Commitment start time in RFC3339 text
// format.
StartTimestamp string `json:"startTimestamp,omitempty"`
// Status: [Output Only] Status of the commitment with regards to
// eventual expiration (each commitment has an end date defined). One of
// the following values: NOT_YET_ACTIVE, ACTIVE, EXPIRED.
//
// Possible values:
// "ACTIVE"
// "CREATING"
// "EXPIRED"
// "NOT_YET_ACTIVE"
Status string `json:"status,omitempty"`
// StatusMessage: [Output Only] An optional, human-readable explanation
// of the status.
StatusMessage string `json:"statusMessage,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Commitment: Represents a Commitment resource. Creating a Commitment resource means that you are purchasing a committed use contract with an explicit start and end time. You can create commitments based on vCPUs and memory usage and receive discounted rates. For full details, read Signing Up for Committed Use Discounts.
Committed use discounts are subject to Google Cloud Platform's Service Specific Terms. By purchasing a committed use discount, you agree to these terms. Committed use discounts will not renew, so you must purchase a new commitment to continue receiving discounts. (== resource_for beta.commitments ==) (== resource_for v1.commitments ==)
func (s *Commitment) MarshalJSON() ([]byte, error)
type CommitmentAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of CommitmentsScopedList resources.
Items map[string]CommitmentsScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#commitmentAggregatedList for aggregated lists of commitments.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *CommitmentAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *CommitmentAggregatedList) MarshalJSON() ([]byte, error)
type CommitmentAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*CommitmentAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}CommitmentAggregatedListWarning: [Output Only] Informational warning message.
func (s *CommitmentAggregatedListWarning) MarshalJSON() ([]byte, error)
type CommitmentAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *CommitmentAggregatedListWarningData) MarshalJSON() ([]byte, error)
type CommitmentList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Commitment resources.
Items []*Commitment `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#commitmentList
// for lists of commitments.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *CommitmentListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}CommitmentList: Contains a list of Commitment resources.
func (s *CommitmentList) MarshalJSON() ([]byte, error)
type CommitmentListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*CommitmentListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}CommitmentListWarning: [Output Only] Informational warning message.
func (s *CommitmentListWarning) MarshalJSON() ([]byte, error)
type CommitmentListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *CommitmentListWarningData) MarshalJSON() ([]byte, error)
type CommitmentsScopedList struct {
// Commitments: [Output Only] List of commitments contained in this
// scope.
Commitments []*Commitment `json:"commitments,omitempty"`
// Warning: [Output Only] Informational warning which replaces the list
// of commitments when the list is empty.
Warning *CommitmentsScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "Commitments") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Commitments") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *CommitmentsScopedList) MarshalJSON() ([]byte, error)
type CommitmentsScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*CommitmentsScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}CommitmentsScopedListWarning: [Output Only] Informational warning which replaces the list of commitments when the list is empty.
func (s *CommitmentsScopedListWarning) MarshalJSON() ([]byte, error)
type CommitmentsScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *CommitmentsScopedListWarningData) MarshalJSON() ([]byte, error)
type ConnectionDraining struct {
// DrainingTimeoutSec: Time for which instance will be drained (not
// accept new connections, but still work to finish started).
DrainingTimeoutSec int64 `json:"drainingTimeoutSec,omitempty"`
// ForceSendFields is a list of field names (e.g. "DrainingTimeoutSec")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "DrainingTimeoutSec") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}ConnectionDraining: Message containing connection draining configuration.
func (s *ConnectionDraining) MarshalJSON() ([]byte, error)
type CustomerEncryptionKey struct {
// RawKey: Specifies a 256-bit customer-supplied encryption key, encoded
// in RFC 4648 base64 to either encrypt or decrypt this resource.
RawKey string `json:"rawKey,omitempty"`
// Sha256: [Output only] The RFC 4648 base64 encoded SHA-256 hash of the
// customer-supplied encryption key that protects this resource.
Sha256 string `json:"sha256,omitempty"`
// ForceSendFields is a list of field names (e.g. "RawKey") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "RawKey") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}CustomerEncryptionKey: Represents a customer-supplied encryption key
func (s *CustomerEncryptionKey) MarshalJSON() ([]byte, error)
type CustomerEncryptionKeyProtectedDisk struct {
// DiskEncryptionKey: Decrypts data associated with the disk with a
// customer-supplied encryption key.
DiskEncryptionKey *CustomerEncryptionKey `json:"diskEncryptionKey,omitempty"`
// Source: Specifies a valid partial or full URL to an existing
// Persistent Disk resource. This field is only applicable for
// persistent disks.
Source string `json:"source,omitempty"`
// ForceSendFields is a list of field names (e.g. "DiskEncryptionKey")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "DiskEncryptionKey") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *CustomerEncryptionKeyProtectedDisk) MarshalJSON() ([]byte, error)
type DeprecationStatus struct {
// Deleted: An optional RFC3339 timestamp on or after which the state of
// this resource is intended to change to DELETED. This is only
// informational and the status will not change unless the client
// explicitly changes it.
Deleted string `json:"deleted,omitempty"`
// Deprecated: An optional RFC3339 timestamp on or after which the state
// of this resource is intended to change to DEPRECATED. This is only
// informational and the status will not change unless the client
// explicitly changes it.
Deprecated string `json:"deprecated,omitempty"`
// Obsolete: An optional RFC3339 timestamp on or after which the state
// of this resource is intended to change to OBSOLETE. This is only
// informational and the status will not change unless the client
// explicitly changes it.
Obsolete string `json:"obsolete,omitempty"`
// Replacement: The URL of the suggested replacement for a deprecated
// resource. The suggested replacement resource must be the same kind of
// resource as the deprecated resource.
Replacement string `json:"replacement,omitempty"`
// State: The deprecation state of this resource. This can be
// DEPRECATED, OBSOLETE, or DELETED. Operations which create a new
// resource using a DEPRECATED resource will return successfully, but
// with a warning indicating the deprecated resource and recommending
// its replacement. Operations which use OBSOLETE or DELETED resources
// will be rejected and result in an error.
//
// Possible values:
// "DELETED"
// "DEPRECATED"
// "OBSOLETE"
State string `json:"state,omitempty"`
// ForceSendFields is a list of field names (e.g. "Deleted") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Deleted") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}DeprecationStatus: Deprecation status for a public resource.
func (s *DeprecationStatus) MarshalJSON() ([]byte, error)
type Disk struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// DiskEncryptionKey: Encrypts the disk using a customer-supplied
// encryption key.
//
// After you encrypt a disk with a customer-supplied key, you must
// provide the same key if you use the disk later (e.g. to create a disk
// snapshot or an image, or to attach the disk to a virtual
// machine).
//
// Customer-supplied encryption keys do not protect access to metadata
// of the disk.
//
// If you do not provide an encryption key when creating the disk, then
// the disk will be encrypted using an automatically generated key and
// you do not need to provide a key to use the disk later.
DiskEncryptionKey *CustomerEncryptionKey `json:"diskEncryptionKey,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#disk for
// disks.
Kind string `json:"kind,omitempty"`
// LabelFingerprint: A fingerprint for the labels being applied to this
// disk, which is essentially a hash of the labels set used for
// optimistic locking. The fingerprint is initially generated by Compute
// Engine and changes after every request to modify or update labels.
// You must always provide an up-to-date fingerprint hash in order to
// update or change labels.
//
// To see the latest fingerprint, make a get() request to retrieve a
// disk.
LabelFingerprint string `json:"labelFingerprint,omitempty"`
// Labels: Labels to apply to this disk. These can be later modified by
// the setLabels method.
Labels map[string]string `json:"labels,omitempty"`
// LastAttachTimestamp: [Output Only] Last attach timestamp in RFC3339
// text format.
LastAttachTimestamp string `json:"lastAttachTimestamp,omitempty"`
// LastDetachTimestamp: [Output Only] Last detach timestamp in RFC3339
// text format.
LastDetachTimestamp string `json:"lastDetachTimestamp,omitempty"`
// Licenses: Any applicable publicly visible licenses.
Licenses []string `json:"licenses,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Options: Internal use only.
Options string `json:"options,omitempty"`
// SelfLink: [Output Only] Server-defined fully-qualified URL for this
// resource.
SelfLink string `json:"selfLink,omitempty"`
// SizeGb: Size of the persistent disk, specified in GB. You can specify
// this field when creating a persistent disk using the sourceImage or
// sourceSnapshot parameter, or specify it alone to create an empty
// persistent disk.
//
// If you specify this field along with sourceImage or sourceSnapshot,
// the value of sizeGb must not be less than the size of the sourceImage
// or the size of the snapshot. Acceptable values are 1 to 65536,
// inclusive.
SizeGb int64 `json:"sizeGb,omitempty,string"`
// SourceImage: The source image used to create this disk. If the source
// image is deleted, this field will not be set.
//
// To create a disk with one of the public operating system images,
// specify the image by its family name. For example, specify
// family/debian-8 to use the latest Debian 8
// image:
//
// projects/debian-cloud/global/images/family/debian-8
//
// Alternatively, use a specific version of a public operating system
// image:
//
// projects/debian-cloud/global/images/debian-8-jessie-vYYYYMMDD
//
// To create a disk with a custom image that you created, specify the
// image name in the following format:
//
// global/images/my-custom-image
//
// You can also specify a custom image by its image family, which
// returns the latest version of the image in that family. Replace the
// image name with
// family/family-name:
//
// global/images/family/my-image-family
SourceImage string `json:"sourceImage,omitempty"`
// SourceImageEncryptionKey: The customer-supplied encryption key of the
// source image. Required if the source image is protected by a
// customer-supplied encryption key.
SourceImageEncryptionKey *CustomerEncryptionKey `json:"sourceImageEncryptionKey,omitempty"`
// SourceImageId: [Output Only] The ID value of the image used to create
// this disk. This value identifies the exact image that was used to
// create this persistent disk. For example, if you created the
// persistent disk from an image that was later deleted and recreated
// under the same name, the source image ID would identify the exact
// version of the image that was used.
SourceImageId string `json:"sourceImageId,omitempty"`
// SourceSnapshot: The source snapshot used to create this disk. You can
// provide this as a partial or full URL to the resource. For example,
// the following are valid values:
// -
// https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
// - projects/project/global/snapshots/snapshot
// - global/snapshots/snapshot
SourceSnapshot string `json:"sourceSnapshot,omitempty"`
// SourceSnapshotEncryptionKey: The customer-supplied encryption key of
// the source snapshot. Required if the source snapshot is protected by
// a customer-supplied encryption key.
SourceSnapshotEncryptionKey *CustomerEncryptionKey `json:"sourceSnapshotEncryptionKey,omitempty"`
// SourceSnapshotId: [Output Only] The unique ID of the snapshot used to
// create this disk. This value identifies the exact snapshot that was
// used to create this persistent disk. For example, if you created the
// persistent disk from a snapshot that was later deleted and recreated
// under the same name, the source snapshot ID would identify the exact
// version of the snapshot that was used.
SourceSnapshotId string `json:"sourceSnapshotId,omitempty"`
// Status: [Output Only] The status of disk creation.
//
// Possible values:
// "CREATING"
// "FAILED"
// "READY"
// "RESTORING"
Status string `json:"status,omitempty"`
// Type: URL of the disk type resource describing which disk type to use
// to create the disk. Provide this when creating the disk.
Type string `json:"type,omitempty"`
// Users: [Output Only] Links to the users of the disk (attached
// instances) in form: project/zones/zone/instances/instance
Users []string `json:"users,omitempty"`
// Zone: [Output Only] URL of the zone where the disk resides.
Zone string `json:"zone,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Disk: A Disk resource. (== resource_for beta.disks ==) (== resource_for v1.disks ==)
type DiskAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of DisksScopedList resources.
Items map[string]DisksScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#diskAggregatedList for aggregated lists of persistent disks.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *DiskAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DiskAggregatedList) MarshalJSON() ([]byte, error)
type DiskAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*DiskAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}DiskAggregatedListWarning: [Output Only] Informational warning message.
func (s *DiskAggregatedListWarning) MarshalJSON() ([]byte, error)
type DiskAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DiskAggregatedListWarningData) MarshalJSON() ([]byte, error)
type DiskList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Disk resources.
Items []*Disk `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#diskList for
// lists of disks.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *DiskListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}DiskList: A list of Disk resources.
type DiskListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*DiskListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}DiskListWarning: [Output Only] Informational warning message.
func (s *DiskListWarning) MarshalJSON() ([]byte, error)
type DiskListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DiskListWarningData) MarshalJSON() ([]byte, error)
type DiskMoveRequest struct {
// DestinationZone: The URL of the destination zone to move the disk.
// This can be a full or partial URL. For example, the following are all
// valid URLs to a zone:
// - https://www.googleapis.com/compute/v1/projects/project/zones/zone
//
// - projects/project/zones/zone
// - zones/zone
DestinationZone string `json:"destinationZone,omitempty"`
// TargetDisk: The URL of the target disk to move. This can be a full or
// partial URL. For example, the following are all valid URLs to a disk:
//
// -
// https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
// - projects/project/zones/zone/disks/disk
// - zones/zone/disks/disk
TargetDisk string `json:"targetDisk,omitempty"`
// ForceSendFields is a list of field names (e.g. "DestinationZone") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "DestinationZone") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *DiskMoveRequest) MarshalJSON() ([]byte, error)
type DiskType struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// DefaultDiskSizeGb: [Output Only] Server-defined default disk size in
// GB.
DefaultDiskSizeGb int64 `json:"defaultDiskSizeGb,omitempty,string"`
// Deprecated: [Output Only] The deprecation status associated with this
// disk type.
Deprecated *DeprecationStatus `json:"deprecated,omitempty"`
// Description: [Output Only] An optional description of this resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#diskType for
// disk types.
Kind string `json:"kind,omitempty"`
// Name: [Output Only] Name of the resource.
Name string `json:"name,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// ValidDiskSize: [Output Only] An optional textual description of the
// valid disk size, such as "10GB-10TB".
ValidDiskSize string `json:"validDiskSize,omitempty"`
// Zone: [Output Only] URL of the zone where the disk type resides.
Zone string `json:"zone,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}DiskType: A DiskType resource. (== resource_for beta.diskTypes ==) (== resource_for v1.diskTypes ==)
type DiskTypeAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of DiskTypesScopedList resources.
Items map[string]DiskTypesScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#diskTypeAggregatedList.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *DiskTypeAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DiskTypeAggregatedList) MarshalJSON() ([]byte, error)
type DiskTypeAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*DiskTypeAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}DiskTypeAggregatedListWarning: [Output Only] Informational warning message.
func (s *DiskTypeAggregatedListWarning) MarshalJSON() ([]byte, error)
type DiskTypeAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DiskTypeAggregatedListWarningData) MarshalJSON() ([]byte, error)
type DiskTypeList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of DiskType resources.
Items []*DiskType `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#diskTypeList for
// disk types.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *DiskTypeListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}DiskTypeList: Contains a list of disk types.
func (s *DiskTypeList) MarshalJSON() ([]byte, error)
type DiskTypeListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*DiskTypeListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}DiskTypeListWarning: [Output Only] Informational warning message.
func (s *DiskTypeListWarning) MarshalJSON() ([]byte, error)
type DiskTypeListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DiskTypeListWarningData) MarshalJSON() ([]byte, error)
type DiskTypesAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *DiskTypesAggregatedListCall) Context(ctx context.Context) *DiskTypesAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DiskTypesAggregatedListCall) Do(opts ...googleapi.CallOption) (*DiskTypeAggregatedList, error)
Do executes the "compute.diskTypes.aggregatedList" call. Exactly one of *DiskTypeAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *DiskTypeAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DiskTypesAggregatedListCall) Fields(s ...googleapi.Field) *DiskTypesAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DiskTypesAggregatedListCall) Filter(filter string) *DiskTypesAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *DiskTypesAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DiskTypesAggregatedListCall) IfNoneMatch(entityTag string) *DiskTypesAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *DiskTypesAggregatedListCall) MaxResults(maxResults int64) *DiskTypesAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *DiskTypesAggregatedListCall) OrderBy(orderBy string) *DiskTypesAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *DiskTypesAggregatedListCall) PageToken(pageToken string) *DiskTypesAggregatedListCall
PageToken sets the optional parameter "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.
func (c *DiskTypesAggregatedListCall) Pages(ctx context.Context, f func(*DiskTypeAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type DiskTypesGetCall struct {
// contains filtered or unexported fields
}func (c *DiskTypesGetCall) Context(ctx context.Context) *DiskTypesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DiskTypesGetCall) Do(opts ...googleapi.CallOption) (*DiskType, error)
Do executes the "compute.diskTypes.get" call. Exactly one of *DiskType or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *DiskType.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DiskTypesGetCall) Fields(s ...googleapi.Field) *DiskTypesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DiskTypesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DiskTypesGetCall) IfNoneMatch(entityTag string) *DiskTypesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type DiskTypesListCall struct {
// contains filtered or unexported fields
}func (c *DiskTypesListCall) Context(ctx context.Context) *DiskTypesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DiskTypesListCall) Do(opts ...googleapi.CallOption) (*DiskTypeList, error)
Do executes the "compute.diskTypes.list" call. Exactly one of *DiskTypeList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *DiskTypeList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DiskTypesListCall) Fields(s ...googleapi.Field) *DiskTypesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DiskTypesListCall) Filter(filter string) *DiskTypesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *DiskTypesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DiskTypesListCall) IfNoneMatch(entityTag string) *DiskTypesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *DiskTypesListCall) MaxResults(maxResults int64) *DiskTypesListCall
MaxResults sets the optional parameter "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)
func (c *DiskTypesListCall) OrderBy(orderBy string) *DiskTypesListCall
OrderBy sets the optional parameter "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.
func (c *DiskTypesListCall) PageToken(pageToken string) *DiskTypesListCall
PageToken sets the optional parameter "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.
func (c *DiskTypesListCall) Pages(ctx context.Context, f func(*DiskTypeList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type DiskTypesScopedList struct {
// DiskTypes: [Output Only] List of disk types contained in this scope.
DiskTypes []*DiskType `json:"diskTypes,omitempty"`
// Warning: [Output Only] Informational warning which replaces the list
// of disk types when the list is empty.
Warning *DiskTypesScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "DiskTypes") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "DiskTypes") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DiskTypesScopedList) MarshalJSON() ([]byte, error)
type DiskTypesScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*DiskTypesScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}DiskTypesScopedListWarning: [Output Only] Informational warning which replaces the list of disk types when the list is empty.
func (s *DiskTypesScopedListWarning) MarshalJSON() ([]byte, error)
type DiskTypesScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DiskTypesScopedListWarningData) MarshalJSON() ([]byte, error)
type DiskTypesService struct {
// contains filtered or unexported fields
}func NewDiskTypesService(s *Service) *DiskTypesService
func (r *DiskTypesService) AggregatedList(project string) *DiskTypesAggregatedListCall
AggregatedList: Retrieves an aggregated list of disk types. For details, see https://cloud.google.com/compute/docs/reference/latest/diskTypes/aggregatedList
func (r *DiskTypesService) Get(project string, zone string, diskType string) *DiskTypesGetCall
Get: Returns the specified disk type. Get a list of available disk types by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/diskTypes/get
func (r *DiskTypesService) List(project string, zone string) *DiskTypesListCall
List: Retrieves a list of disk types available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/diskTypes/list
type DisksAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *DisksAggregatedListCall) Context(ctx context.Context) *DisksAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DisksAggregatedListCall) Do(opts ...googleapi.CallOption) (*DiskAggregatedList, error)
Do executes the "compute.disks.aggregatedList" call. Exactly one of *DiskAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *DiskAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DisksAggregatedListCall) Fields(s ...googleapi.Field) *DisksAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DisksAggregatedListCall) Filter(filter string) *DisksAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *DisksAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DisksAggregatedListCall) IfNoneMatch(entityTag string) *DisksAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *DisksAggregatedListCall) MaxResults(maxResults int64) *DisksAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *DisksAggregatedListCall) OrderBy(orderBy string) *DisksAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *DisksAggregatedListCall) PageToken(pageToken string) *DisksAggregatedListCall
PageToken sets the optional parameter "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.
func (c *DisksAggregatedListCall) Pages(ctx context.Context, f func(*DiskAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type DisksCreateSnapshotCall struct {
// contains filtered or unexported fields
}func (c *DisksCreateSnapshotCall) Context(ctx context.Context) *DisksCreateSnapshotCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DisksCreateSnapshotCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.disks.createSnapshot" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DisksCreateSnapshotCall) Fields(s ...googleapi.Field) *DisksCreateSnapshotCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DisksCreateSnapshotCall) GuestFlush(guestFlush bool) *DisksCreateSnapshotCall
GuestFlush sets the optional parameter "guestFlush":
func (c *DisksCreateSnapshotCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DisksCreateSnapshotCall) RequestId(requestId string) *DisksCreateSnapshotCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type DisksDeleteCall struct {
// contains filtered or unexported fields
}func (c *DisksDeleteCall) Context(ctx context.Context) *DisksDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DisksDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.disks.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DisksDeleteCall) Fields(s ...googleapi.Field) *DisksDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DisksDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DisksDeleteCall) RequestId(requestId string) *DisksDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type DisksGetCall struct {
// contains filtered or unexported fields
}func (c *DisksGetCall) Context(ctx context.Context) *DisksGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DisksGetCall) Do(opts ...googleapi.CallOption) (*Disk, error)
Do executes the "compute.disks.get" call. Exactly one of *Disk or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Disk.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DisksGetCall) Fields(s ...googleapi.Field) *DisksGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DisksGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DisksGetCall) IfNoneMatch(entityTag string) *DisksGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type DisksInsertCall struct {
// contains filtered or unexported fields
}func (c *DisksInsertCall) Context(ctx context.Context) *DisksInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DisksInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.disks.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DisksInsertCall) Fields(s ...googleapi.Field) *DisksInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DisksInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DisksInsertCall) RequestId(requestId string) *DisksInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
func (c *DisksInsertCall) SourceImage(sourceImage string) *DisksInsertCall
SourceImage sets the optional parameter "sourceImage": Source image to restore onto a disk.
type DisksListCall struct {
// contains filtered or unexported fields
}func (c *DisksListCall) Context(ctx context.Context) *DisksListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DisksListCall) Do(opts ...googleapi.CallOption) (*DiskList, error)
Do executes the "compute.disks.list" call. Exactly one of *DiskList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *DiskList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DisksListCall) Fields(s ...googleapi.Field) *DisksListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DisksListCall) Filter(filter string) *DisksListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *DisksListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DisksListCall) IfNoneMatch(entityTag string) *DisksListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *DisksListCall) MaxResults(maxResults int64) *DisksListCall
MaxResults sets the optional parameter "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)
func (c *DisksListCall) OrderBy(orderBy string) *DisksListCall
OrderBy sets the optional parameter "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.
func (c *DisksListCall) PageToken(pageToken string) *DisksListCall
PageToken sets the optional parameter "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.
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type DisksResizeCall struct {
// contains filtered or unexported fields
}func (c *DisksResizeCall) Context(ctx context.Context) *DisksResizeCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DisksResizeCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.disks.resize" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DisksResizeCall) Fields(s ...googleapi.Field) *DisksResizeCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DisksResizeCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DisksResizeCall) RequestId(requestId string) *DisksResizeCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type DisksResizeRequest struct {
// SizeGb: The new size of the persistent disk, which is specified in
// GB.
SizeGb int64 `json:"sizeGb,omitempty,string"`
// ForceSendFields is a list of field names (e.g. "SizeGb") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "SizeGb") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DisksResizeRequest) MarshalJSON() ([]byte, error)
type DisksScopedList struct {
// Disks: [Output Only] List of disks contained in this scope.
Disks []*Disk `json:"disks,omitempty"`
// Warning: [Output Only] Informational warning which replaces the list
// of disks when the list is empty.
Warning *DisksScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "Disks") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Disks") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DisksScopedList) MarshalJSON() ([]byte, error)
type DisksScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*DisksScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}DisksScopedListWarning: [Output Only] Informational warning which replaces the list of disks when the list is empty.
func (s *DisksScopedListWarning) MarshalJSON() ([]byte, error)
type DisksScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *DisksScopedListWarningData) MarshalJSON() ([]byte, error)
type DisksService struct {
// contains filtered or unexported fields
}func NewDisksService(s *Service) *DisksService
func (r *DisksService) AggregatedList(project string) *DisksAggregatedListCall
AggregatedList: Retrieves an aggregated list of persistent disks. For details, see https://cloud.google.com/compute/docs/reference/latest/disks/aggregatedList
func (r *DisksService) CreateSnapshot(project string, zone string, disk string, snapshot *Snapshot) *DisksCreateSnapshotCall
CreateSnapshot: Creates a snapshot of a specified persistent disk. For details, see https://cloud.google.com/compute/docs/reference/latest/disks/createSnapshot
func (r *DisksService) Delete(project string, zone string, disk string) *DisksDeleteCall
Delete: Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots. For details, see https://cloud.google.com/compute/docs/reference/latest/disks/delete
func (r *DisksService) Get(project string, zone string, disk string) *DisksGetCall
Get: Returns a specified persistent disk. Get a list of available persistent disks by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/disks/get
func (r *DisksService) Insert(project string, zone string, disk *Disk) *DisksInsertCall
Insert: Creates a persistent disk in the specified project using the data in the request. You can create a disk with a sourceImage, a sourceSnapshot, or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property. For details, see https://cloud.google.com/compute/docs/reference/latest/disks/insert
func (r *DisksService) List(project string, zone string) *DisksListCall
List: Retrieves a list of persistent disks contained within the specified zone. For details, see https://cloud.google.com/compute/docs/reference/latest/disks/list
func (r *DisksService) Resize(project string, zone string, disk string, disksresizerequest *DisksResizeRequest) *DisksResizeCall
Resize: Resizes the specified persistent disk. You can only increase the size of the disk.
func (r *DisksService) SetLabels(project string, zone string, resource string, zonesetlabelsrequest *ZoneSetLabelsRequest) *DisksSetLabelsCall
SetLabels: Sets the labels on a disk. To learn more about labels, read the Labeling Resources documentation.
type DisksSetLabelsCall struct {
// contains filtered or unexported fields
}func (c *DisksSetLabelsCall) Context(ctx context.Context) *DisksSetLabelsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *DisksSetLabelsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.disks.setLabels" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *DisksSetLabelsCall) Fields(s ...googleapi.Field) *DisksSetLabelsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *DisksSetLabelsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *DisksSetLabelsCall) RequestId(requestId string) *DisksSetLabelsCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type Firewall struct {
// Allowed: The list of ALLOW rules specified by this firewall. Each
// rule specifies a protocol and port-range tuple that describes a
// permitted connection.
Allowed []*FirewallAllowed `json:"allowed,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Denied: The list of DENY rules specified by this firewall. Each rule
// specifies a protocol and port-range tuple that describes a permitted
// connection.
Denied []*FirewallDenied `json:"denied,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// DestinationRanges: If destination ranges are specified, the firewall
// will apply only to traffic that has destination IP address in these
// ranges. These ranges must be expressed in CIDR format. Only IPv4 is
// supported.
DestinationRanges []string `json:"destinationRanges,omitempty"`
// Direction: Direction of traffic to which this firewall applies;
// default is INGRESS. Note: For INGRESS traffic, it is NOT supported to
// specify destinationRanges; For EGRESS traffic, it is NOT supported to
// specify sourceRanges OR sourceTags.
//
// Possible values:
// "EGRESS"
// "INGRESS"
Direction string `json:"direction,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#firewall for
// firewall rules.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource; provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Network: URL of the network resource for this firewall rule. If not
// specified when creating a firewall rule, the default network is
// used:
// global/networks/default
// If you choose to specify this property, you can specify the network
// as a full or partial URL. For example, the following are all valid
// URLs:
// -
// https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network
// - projects/myproject/global/networks/my-network
// - global/networks/default
Network string `json:"network,omitempty"`
// Priority: Priority for this rule. This is an integer between 0 and
// 65535, both inclusive. When not specified, the value assumed is 1000.
// Relative priorities determine precedence of conflicting rules. Lower
// value of priority implies higher precedence (eg, a rule with priority
// 0 has higher precedence than a rule with priority 1). DENY rules take
// precedence over ALLOW rules having equal priority.
Priority int64 `json:"priority,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// SourceRanges: If source ranges are specified, the firewall will apply
// only to traffic that has source IP address in these ranges. These
// ranges must be expressed in CIDR format. One or both of sourceRanges
// and sourceTags may be set. If both properties are set, the firewall
// will apply to traffic that has source IP address within sourceRanges
// OR the source IP that belongs to a tag listed in the sourceTags
// property. The connection does not need to match both properties for
// the firewall to apply. Only IPv4 is supported.
SourceRanges []string `json:"sourceRanges,omitempty"`
// SourceServiceAccounts: If source service accounts are specified, the
// firewall will apply only to traffic originating from an instance with
// a service account in this list. Source service accounts cannot be
// used to control traffic to an instance's external IP address because
// service accounts are associated with an instance, not an IP address.
// sourceRanges can be set at the same time as sourceServiceAccounts. If
// both are set, the firewall will apply to traffic that has source IP
// address within sourceRanges OR the source IP belongs to an instance
// with service account listed in sourceServiceAccount. The connection
// does not need to match both properties for the firewall to apply.
// sourceServiceAccounts cannot be used at the same time as sourceTags
// or targetTags.
SourceServiceAccounts []string `json:"sourceServiceAccounts,omitempty"`
// SourceTags: If source tags are specified, the firewall rule applies
// only to traffic with source IPs that match the primary network
// interfaces of VM instances that have the tag and are in the same VPC
// network. Source tags cannot be used to control traffic to an
// instance's external IP address, it only applies to traffic between
// instances in the same virtual network. Because tags are associated
// with instances, not IP addresses. One or both of sourceRanges and
// sourceTags may be set. If both properties are set, the firewall will
// apply to traffic that has source IP address within sourceRanges OR
// the source IP that belongs to a tag listed in the sourceTags
// property. The connection does not need to match both properties for
// the firewall to apply.
SourceTags []string `json:"sourceTags,omitempty"`
// TargetServiceAccounts: A list of service accounts indicating sets of
// instances located in the network that may make network connections as
// specified in allowed[]. targetServiceAccounts cannot be used at the
// same time as targetTags or sourceTags. If neither
// targetServiceAccounts nor targetTags are specified, the firewall rule
// applies to all instances on the specified network.
TargetServiceAccounts []string `json:"targetServiceAccounts,omitempty"`
// TargetTags: A list of tags that controls which instances the firewall
// rule applies to. If targetTags are specified, then the firewall rule
// applies only to instances in the VPC network that have one of those
// tags. If no targetTags are specified, the firewall rule applies to
// all instances on the specified network.
TargetTags []string `json:"targetTags,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Allowed") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Allowed") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}Firewall: Represents a Firewall resource.
type FirewallAllowed struct {
// IPProtocol: The IP protocol to which this rule applies. The protocol
// type is required when creating a firewall rule. This value can either
// be one of the following well known protocol strings (tcp, udp, icmp,
// esp, ah, ipip, sctp), or the IP protocol number.
IPProtocol string `json:"IPProtocol,omitempty"`
// Ports: An optional list of ports to which this rule applies. This
// field is only applicable for UDP or TCP protocol. Each entry must be
// either an integer or a range. If not specified, this rule applies to
// connections through any port.
//
// Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
Ports []string `json:"ports,omitempty"`
// ForceSendFields is a list of field names (e.g. "IPProtocol") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "IPProtocol") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *FirewallAllowed) MarshalJSON() ([]byte, error)
type FirewallDenied struct {
// IPProtocol: The IP protocol to which this rule applies. The protocol
// type is required when creating a firewall rule. This value can either
// be one of the following well known protocol strings (tcp, udp, icmp,
// esp, ah, ipip, sctp), or the IP protocol number.
IPProtocol string `json:"IPProtocol,omitempty"`
// Ports: An optional list of ports to which this rule applies. This
// field is only applicable for UDP or TCP protocol. Each entry must be
// either an integer or a range. If not specified, this rule applies to
// connections through any port.
//
// Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
Ports []string `json:"ports,omitempty"`
// ForceSendFields is a list of field names (e.g. "IPProtocol") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "IPProtocol") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *FirewallDenied) MarshalJSON() ([]byte, error)
type FirewallList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Firewall resources.
Items []*Firewall `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#firewallList for
// lists of firewalls.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *FirewallListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}FirewallList: Contains a list of firewalls.
func (s *FirewallList) MarshalJSON() ([]byte, error)
type FirewallListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*FirewallListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}FirewallListWarning: [Output Only] Informational warning message.
func (s *FirewallListWarning) MarshalJSON() ([]byte, error)
type FirewallListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *FirewallListWarningData) MarshalJSON() ([]byte, error)
type FirewallsDeleteCall struct {
// contains filtered or unexported fields
}func (c *FirewallsDeleteCall) Context(ctx context.Context) *FirewallsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *FirewallsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.firewalls.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *FirewallsDeleteCall) Fields(s ...googleapi.Field) *FirewallsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *FirewallsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *FirewallsDeleteCall) RequestId(requestId string) *FirewallsDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type FirewallsGetCall struct {
// contains filtered or unexported fields
}func (c *FirewallsGetCall) Context(ctx context.Context) *FirewallsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *FirewallsGetCall) Do(opts ...googleapi.CallOption) (*Firewall, error)
Do executes the "compute.firewalls.get" call. Exactly one of *Firewall or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Firewall.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *FirewallsGetCall) Fields(s ...googleapi.Field) *FirewallsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *FirewallsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *FirewallsGetCall) IfNoneMatch(entityTag string) *FirewallsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type FirewallsInsertCall struct {
// contains filtered or unexported fields
}func (c *FirewallsInsertCall) Context(ctx context.Context) *FirewallsInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *FirewallsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.firewalls.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *FirewallsInsertCall) Fields(s ...googleapi.Field) *FirewallsInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *FirewallsInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *FirewallsInsertCall) RequestId(requestId string) *FirewallsInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type FirewallsListCall struct {
// contains filtered or unexported fields
}func (c *FirewallsListCall) Context(ctx context.Context) *FirewallsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *FirewallsListCall) Do(opts ...googleapi.CallOption) (*FirewallList, error)
Do executes the "compute.firewalls.list" call. Exactly one of *FirewallList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *FirewallList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *FirewallsListCall) Fields(s ...googleapi.Field) *FirewallsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *FirewallsListCall) Filter(filter string) *FirewallsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *FirewallsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *FirewallsListCall) IfNoneMatch(entityTag string) *FirewallsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *FirewallsListCall) MaxResults(maxResults int64) *FirewallsListCall
MaxResults sets the optional parameter "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)
func (c *FirewallsListCall) OrderBy(orderBy string) *FirewallsListCall
OrderBy sets the optional parameter "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.
func (c *FirewallsListCall) PageToken(pageToken string) *FirewallsListCall
PageToken sets the optional parameter "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.
func (c *FirewallsListCall) Pages(ctx context.Context, f func(*FirewallList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type FirewallsPatchCall struct {
// contains filtered or unexported fields
}func (c *FirewallsPatchCall) Context(ctx context.Context) *FirewallsPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *FirewallsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.firewalls.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *FirewallsPatchCall) Fields(s ...googleapi.Field) *FirewallsPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *FirewallsPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *FirewallsPatchCall) RequestId(requestId string) *FirewallsPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type FirewallsService struct {
// contains filtered or unexported fields
}func NewFirewallsService(s *Service) *FirewallsService
func (r *FirewallsService) Delete(project string, firewall string) *FirewallsDeleteCall
Delete: Deletes the specified firewall. For details, see https://cloud.google.com/compute/docs/reference/latest/firewalls/delete
func (r *FirewallsService) Get(project string, firewall string) *FirewallsGetCall
Get: Returns the specified firewall. For details, see https://cloud.google.com/compute/docs/reference/latest/firewalls/get
func (r *FirewallsService) Insert(project string, firewall *Firewall) *FirewallsInsertCall
Insert: Creates a firewall rule in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/firewalls/insert
func (r *FirewallsService) List(project string) *FirewallsListCall
List: Retrieves the list of firewall rules available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/firewalls/list
func (r *FirewallsService) Patch(project string, firewall string, firewall2 *Firewall) *FirewallsPatchCall
Patch: Updates the specified firewall rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. For details, see https://cloud.google.com/compute/docs/reference/latest/firewalls/patch
func (r *FirewallsService) Update(project string, firewall string, firewall2 *Firewall) *FirewallsUpdateCall
Update: Updates the specified firewall rule with the data included in the request. Using PUT method, can only update following fields of firewall rule: allowed, description, sourceRanges, sourceTags, targetTags. For details, see https://cloud.google.com/compute/docs/reference/latest/firewalls/update
type FirewallsUpdateCall struct {
// contains filtered or unexported fields
}func (c *FirewallsUpdateCall) Context(ctx context.Context) *FirewallsUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *FirewallsUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.firewalls.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *FirewallsUpdateCall) Fields(s ...googleapi.Field) *FirewallsUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *FirewallsUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *FirewallsUpdateCall) RequestId(requestId string) *FirewallsUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ForwardingRule struct {
// IPAddress: The IP address that this forwarding rule is serving on
// behalf of.
//
// Addresses are restricted based on the forwarding rule's load
// balancing scheme (EXTERNAL or INTERNAL) and scope (global or
// regional).
//
// When the load balancing scheme is EXTERNAL, for global forwarding
// rules, the address must be a global IP, and for regional forwarding
// rules, the address must live in the same region as the forwarding
// rule. If this field is empty, an ephemeral IPv4 address from the same
// scope (global or regional) will be assigned. A regional forwarding
// rule supports IPv4 only. A global forwarding rule supports either
// IPv4 or IPv6.
//
// When the load balancing scheme is INTERNAL, this can only be an RFC
// 1918 IP address belonging to the network/subnet configured for the
// forwarding rule. By default, if this field is empty, an ephemeral
// internal IP address will be automatically allocated from the IP range
// of the subnet or network configured for this forwarding rule.
//
// An address can be specified either by a literal IP address or a URL
// reference to an existing Address resource. The following examples are
// all valid:
// - 100.1.2.3
// -
// https://www.googleapis.com/compute/v1/projects/project/regions/region/addresses/address
// - projects/project/regions/region/addresses/address
// - regions/region/addresses/address
// - global/addresses/address
// - address
IPAddress string `json:"IPAddress,omitempty"`
// IPProtocol: The IP protocol to which this rule applies. Valid options
// are TCP, UDP, ESP, AH, SCTP or ICMP.
//
// When the load balancing scheme is INTERNAL, only TCP and UDP are
// valid.
//
// Possible values:
// "AH"
// "ESP"
// "ICMP"
// "SCTP"
// "TCP"
// "UDP"
IPProtocol string `json:"IPProtocol,omitempty"`
// BackendService: This field is not used for external load
// balancing.
//
// For internal load balancing, this field identifies the BackendService
// resource to receive the matched traffic.
BackendService string `json:"backendService,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// IpVersion: The IP Version that will be used by this forwarding rule.
// Valid options are IPV4 or IPV6. This can only be specified for a
// global forwarding rule.
//
// Possible values:
// "IPV4"
// "IPV6"
// "UNSPECIFIED_VERSION"
IpVersion string `json:"ipVersion,omitempty"`
// Kind: [Output Only] Type of the resource. Always
// compute#forwardingRule for Forwarding Rule resources.
Kind string `json:"kind,omitempty"`
// LoadBalancingScheme: This signifies what the ForwardingRule will be
// used for and can only take the following values: INTERNAL, EXTERNAL
// The value of INTERNAL means that this will be used for Internal
// Network Load Balancing (TCP, UDP). The value of EXTERNAL means that
// this will be used for External Load Balancing (HTTP(S) LB, External
// TCP/UDP LB, SSL Proxy)
//
// Possible values:
// "EXTERNAL"
// "INTERNAL"
// "INVALID"
LoadBalancingScheme string `json:"loadBalancingScheme,omitempty"`
// Name: Name of the resource; provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Network: This field is not used for external load balancing.
//
// For internal load balancing, this field identifies the network that
// the load balanced IP should belong to for this Forwarding Rule. If
// this field is not specified, the default network will be used.
Network string `json:"network,omitempty"`
// PortRange: This field is used along with the target field for
// TargetHttpProxy, TargetHttpsProxy, TargetSslProxy, TargetTcpProxy,
// TargetVpnGateway, TargetPool, TargetInstance.
//
// Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets
// addressed to ports in the specified range will be forwarded to
// target. Forwarding rules with the same [IPAddress, IPProtocol] pair
// must have disjoint port ranges.
//
// Some types of forwarding target have constraints on the acceptable
// ports:
// - TargetHttpProxy: 80, 8080
// - TargetHttpsProxy: 443
// - TargetTcpProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993,
// 995, 1883, 5222
// - TargetSslProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993,
// 995, 1883, 5222
// - TargetVpnGateway: 500, 4500
// -
PortRange string `json:"portRange,omitempty"`
// Ports: This field is used along with the backend_service field for
// internal load balancing.
//
// When the load balancing scheme is INTERNAL, a single port or a comma
// separated list of ports can be configured. Only packets addressed to
// these ports will be forwarded to the backends configured with this
// forwarding rule.
//
// You may specify a maximum of up to 5 ports.
Ports []string `json:"ports,omitempty"`
// Region: [Output Only] URL of the region where the regional forwarding
// rule resides. This field is not applicable to global forwarding
// rules.
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Subnetwork: This field is not used for external load balancing.
//
// For internal load balancing, this field identifies the subnetwork
// that the load balanced IP should belong to for this Forwarding
// Rule.
//
// If the network specified is in auto subnet mode, this field is
// optional. However, if the network is in custom subnet mode, a
// subnetwork must be specified.
Subnetwork string `json:"subnetwork,omitempty"`
// Target: The URL of the target resource to receive the matched
// traffic. For regional forwarding rules, this target must live in the
// same region as the forwarding rule. For global forwarding rules, this
// target must be a global load balancing resource. The forwarded
// traffic must be of a type appropriate to the target object.
//
// This field is not used for internal load balancing.
Target string `json:"target,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "IPAddress") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "IPAddress") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ForwardingRule: A ForwardingRule resource. A ForwardingRule resource specifies which pool of target virtual machines to forward a packet to if it matches the given [IPAddress, IPProtocol, ports] tuple. (== resource_for beta.forwardingRules ==) (== resource_for v1.forwardingRules ==) (== resource_for beta.globalForwardingRules ==) (== resource_for v1.globalForwardingRules ==) (== resource_for beta.regionForwardingRules ==) (== resource_for v1.regionForwardingRules ==)
func (s *ForwardingRule) MarshalJSON() ([]byte, error)
type ForwardingRuleAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of ForwardingRulesScopedList resources.
Items map[string]ForwardingRulesScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#forwardingRuleAggregatedList for lists of forwarding rules.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *ForwardingRuleAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ForwardingRuleAggregatedList) MarshalJSON() ([]byte, error)
type ForwardingRuleAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*ForwardingRuleAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ForwardingRuleAggregatedListWarning: [Output Only] Informational warning message.
func (s *ForwardingRuleAggregatedListWarning) MarshalJSON() ([]byte, error)
type ForwardingRuleAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ForwardingRuleAggregatedListWarningData) MarshalJSON() ([]byte, error)
type ForwardingRuleList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of ForwardingRule resources.
Items []*ForwardingRule `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *ForwardingRuleListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ForwardingRuleList: Contains a list of ForwardingRule resources.
func (s *ForwardingRuleList) MarshalJSON() ([]byte, error)
type ForwardingRuleListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*ForwardingRuleListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ForwardingRuleListWarning: [Output Only] Informational warning message.
func (s *ForwardingRuleListWarning) MarshalJSON() ([]byte, error)
type ForwardingRuleListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ForwardingRuleListWarningData) MarshalJSON() ([]byte, error)
type ForwardingRulesAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *ForwardingRulesAggregatedListCall) Context(ctx context.Context) *ForwardingRulesAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ForwardingRulesAggregatedListCall) Do(opts ...googleapi.CallOption) (*ForwardingRuleAggregatedList, error)
Do executes the "compute.forwardingRules.aggregatedList" call. Exactly one of *ForwardingRuleAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ForwardingRuleAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ForwardingRulesAggregatedListCall) Fields(s ...googleapi.Field) *ForwardingRulesAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ForwardingRulesAggregatedListCall) Filter(filter string) *ForwardingRulesAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *ForwardingRulesAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ForwardingRulesAggregatedListCall) IfNoneMatch(entityTag string) *ForwardingRulesAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *ForwardingRulesAggregatedListCall) MaxResults(maxResults int64) *ForwardingRulesAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *ForwardingRulesAggregatedListCall) OrderBy(orderBy string) *ForwardingRulesAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *ForwardingRulesAggregatedListCall) PageToken(pageToken string) *ForwardingRulesAggregatedListCall
PageToken sets the optional parameter "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.
func (c *ForwardingRulesAggregatedListCall) Pages(ctx context.Context, f func(*ForwardingRuleAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type ForwardingRulesDeleteCall struct {
// contains filtered or unexported fields
}func (c *ForwardingRulesDeleteCall) Context(ctx context.Context) *ForwardingRulesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ForwardingRulesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.forwardingRules.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ForwardingRulesDeleteCall) Fields(s ...googleapi.Field) *ForwardingRulesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ForwardingRulesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ForwardingRulesDeleteCall) RequestId(requestId string) *ForwardingRulesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ForwardingRulesGetCall struct {
// contains filtered or unexported fields
}func (c *ForwardingRulesGetCall) Context(ctx context.Context) *ForwardingRulesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ForwardingRulesGetCall) Do(opts ...googleapi.CallOption) (*ForwardingRule, error)
Do executes the "compute.forwardingRules.get" call. Exactly one of *ForwardingRule or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ForwardingRule.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ForwardingRulesGetCall) Fields(s ...googleapi.Field) *ForwardingRulesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ForwardingRulesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ForwardingRulesGetCall) IfNoneMatch(entityTag string) *ForwardingRulesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type ForwardingRulesInsertCall struct {
// contains filtered or unexported fields
}func (c *ForwardingRulesInsertCall) Context(ctx context.Context) *ForwardingRulesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ForwardingRulesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.forwardingRules.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ForwardingRulesInsertCall) Fields(s ...googleapi.Field) *ForwardingRulesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ForwardingRulesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ForwardingRulesInsertCall) RequestId(requestId string) *ForwardingRulesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ForwardingRulesListCall struct {
// contains filtered or unexported fields
}func (c *ForwardingRulesListCall) Context(ctx context.Context) *ForwardingRulesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ForwardingRulesListCall) Do(opts ...googleapi.CallOption) (*ForwardingRuleList, error)
Do executes the "compute.forwardingRules.list" call. Exactly one of *ForwardingRuleList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ForwardingRuleList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ForwardingRulesListCall) Fields(s ...googleapi.Field) *ForwardingRulesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ForwardingRulesListCall) Filter(filter string) *ForwardingRulesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *ForwardingRulesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ForwardingRulesListCall) IfNoneMatch(entityTag string) *ForwardingRulesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *ForwardingRulesListCall) MaxResults(maxResults int64) *ForwardingRulesListCall
MaxResults sets the optional parameter "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)
func (c *ForwardingRulesListCall) OrderBy(orderBy string) *ForwardingRulesListCall
OrderBy sets the optional parameter "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.
func (c *ForwardingRulesListCall) PageToken(pageToken string) *ForwardingRulesListCall
PageToken sets the optional parameter "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.
func (c *ForwardingRulesListCall) Pages(ctx context.Context, f func(*ForwardingRuleList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type ForwardingRulesScopedList struct {
// ForwardingRules: List of forwarding rules contained in this scope.
ForwardingRules []*ForwardingRule `json:"forwardingRules,omitempty"`
// Warning: Informational warning which replaces the list of forwarding
// rules when the list is empty.
Warning *ForwardingRulesScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "ForwardingRules") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ForwardingRules") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *ForwardingRulesScopedList) MarshalJSON() ([]byte, error)
type ForwardingRulesScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*ForwardingRulesScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ForwardingRulesScopedListWarning: Informational warning which replaces the list of forwarding rules when the list is empty.
func (s *ForwardingRulesScopedListWarning) MarshalJSON() ([]byte, error)
type ForwardingRulesScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ForwardingRulesScopedListWarningData) MarshalJSON() ([]byte, error)
type ForwardingRulesService struct {
// contains filtered or unexported fields
}func NewForwardingRulesService(s *Service) *ForwardingRulesService
func (r *ForwardingRulesService) AggregatedList(project string) *ForwardingRulesAggregatedListCall
AggregatedList: Retrieves an aggregated list of forwarding rules. For details, see https://cloud.google.com/compute/docs/reference/latest/forwardingRules/aggregatedList
func (r *ForwardingRulesService) Delete(project string, region string, forwardingRule string) *ForwardingRulesDeleteCall
Delete: Deletes the specified ForwardingRule resource. For details, see https://cloud.google.com/compute/docs/reference/latest/forwardingRules/delete
func (r *ForwardingRulesService) Get(project string, region string, forwardingRule string) *ForwardingRulesGetCall
Get: Returns the specified ForwardingRule resource. For details, see https://cloud.google.com/compute/docs/reference/latest/forwardingRules/get
func (r *ForwardingRulesService) Insert(project string, region string, forwardingrule *ForwardingRule) *ForwardingRulesInsertCall
Insert: Creates a ForwardingRule resource in the specified project and region using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/forwardingRules/insert
func (r *ForwardingRulesService) List(project string, region string) *ForwardingRulesListCall
List: Retrieves a list of ForwardingRule resources available to the specified project and region. For details, see https://cloud.google.com/compute/docs/reference/latest/forwardingRules/list
func (r *ForwardingRulesService) SetTarget(project string, region string, forwardingRule string, targetreference *TargetReference) *ForwardingRulesSetTargetCall
SetTarget: Changes target URL for forwarding rule. The new target should be of the same type as the old target. For details, see https://cloud.google.com/compute/docs/reference/latest/forwardingRules/setTarget
type ForwardingRulesSetTargetCall struct {
// contains filtered or unexported fields
}func (c *ForwardingRulesSetTargetCall) Context(ctx context.Context) *ForwardingRulesSetTargetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ForwardingRulesSetTargetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.forwardingRules.setTarget" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ForwardingRulesSetTargetCall) Fields(s ...googleapi.Field) *ForwardingRulesSetTargetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ForwardingRulesSetTargetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ForwardingRulesSetTargetCall) RequestId(requestId string) *ForwardingRulesSetTargetCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type GlobalAddressesDeleteCall struct {
// contains filtered or unexported fields
}func (c *GlobalAddressesDeleteCall) Context(ctx context.Context) *GlobalAddressesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalAddressesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.globalAddresses.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalAddressesDeleteCall) Fields(s ...googleapi.Field) *GlobalAddressesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalAddressesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalAddressesDeleteCall) RequestId(requestId string) *GlobalAddressesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type GlobalAddressesGetCall struct {
// contains filtered or unexported fields
}func (c *GlobalAddressesGetCall) Context(ctx context.Context) *GlobalAddressesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalAddressesGetCall) Do(opts ...googleapi.CallOption) (*Address, error)
Do executes the "compute.globalAddresses.get" call. Exactly one of *Address or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Address.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalAddressesGetCall) Fields(s ...googleapi.Field) *GlobalAddressesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalAddressesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalAddressesGetCall) IfNoneMatch(entityTag string) *GlobalAddressesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type GlobalAddressesInsertCall struct {
// contains filtered or unexported fields
}func (c *GlobalAddressesInsertCall) Context(ctx context.Context) *GlobalAddressesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalAddressesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.globalAddresses.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalAddressesInsertCall) Fields(s ...googleapi.Field) *GlobalAddressesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalAddressesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalAddressesInsertCall) RequestId(requestId string) *GlobalAddressesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type GlobalAddressesListCall struct {
// contains filtered or unexported fields
}func (c *GlobalAddressesListCall) Context(ctx context.Context) *GlobalAddressesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalAddressesListCall) Do(opts ...googleapi.CallOption) (*AddressList, error)
Do executes the "compute.globalAddresses.list" call. Exactly one of *AddressList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *AddressList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalAddressesListCall) Fields(s ...googleapi.Field) *GlobalAddressesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalAddressesListCall) Filter(filter string) *GlobalAddressesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *GlobalAddressesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalAddressesListCall) IfNoneMatch(entityTag string) *GlobalAddressesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *GlobalAddressesListCall) MaxResults(maxResults int64) *GlobalAddressesListCall
MaxResults sets the optional parameter "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)
func (c *GlobalAddressesListCall) OrderBy(orderBy string) *GlobalAddressesListCall
OrderBy sets the optional parameter "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.
func (c *GlobalAddressesListCall) PageToken(pageToken string) *GlobalAddressesListCall
PageToken sets the optional parameter "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.
func (c *GlobalAddressesListCall) Pages(ctx context.Context, f func(*AddressList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type GlobalAddressesService struct {
// contains filtered or unexported fields
}func NewGlobalAddressesService(s *Service) *GlobalAddressesService
func (r *GlobalAddressesService) Delete(project string, address string) *GlobalAddressesDeleteCall
Delete: Deletes the specified address resource. For details, see https://cloud.google.com/compute/docs/reference/latest/globalAddresses/delete
func (r *GlobalAddressesService) Get(project string, address string) *GlobalAddressesGetCall
Get: Returns the specified address resource. Get a list of available addresses by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/globalAddresses/get
func (r *GlobalAddressesService) Insert(project string, address *Address) *GlobalAddressesInsertCall
Insert: Creates an address resource in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/globalAddresses/insert
func (r *GlobalAddressesService) List(project string) *GlobalAddressesListCall
List: Retrieves a list of global addresses. For details, see https://cloud.google.com/compute/docs/reference/latest/globalAddresses/list
type GlobalForwardingRulesDeleteCall struct {
// contains filtered or unexported fields
}func (c *GlobalForwardingRulesDeleteCall) Context(ctx context.Context) *GlobalForwardingRulesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalForwardingRulesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.globalForwardingRules.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalForwardingRulesDeleteCall) Fields(s ...googleapi.Field) *GlobalForwardingRulesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalForwardingRulesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalForwardingRulesDeleteCall) RequestId(requestId string) *GlobalForwardingRulesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type GlobalForwardingRulesGetCall struct {
// contains filtered or unexported fields
}func (c *GlobalForwardingRulesGetCall) Context(ctx context.Context) *GlobalForwardingRulesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalForwardingRulesGetCall) Do(opts ...googleapi.CallOption) (*ForwardingRule, error)
Do executes the "compute.globalForwardingRules.get" call. Exactly one of *ForwardingRule or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ForwardingRule.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalForwardingRulesGetCall) Fields(s ...googleapi.Field) *GlobalForwardingRulesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalForwardingRulesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalForwardingRulesGetCall) IfNoneMatch(entityTag string) *GlobalForwardingRulesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type GlobalForwardingRulesInsertCall struct {
// contains filtered or unexported fields
}func (c *GlobalForwardingRulesInsertCall) Context(ctx context.Context) *GlobalForwardingRulesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalForwardingRulesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.globalForwardingRules.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalForwardingRulesInsertCall) Fields(s ...googleapi.Field) *GlobalForwardingRulesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalForwardingRulesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalForwardingRulesInsertCall) RequestId(requestId string) *GlobalForwardingRulesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type GlobalForwardingRulesListCall struct {
// contains filtered or unexported fields
}func (c *GlobalForwardingRulesListCall) Context(ctx context.Context) *GlobalForwardingRulesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalForwardingRulesListCall) Do(opts ...googleapi.CallOption) (*ForwardingRuleList, error)
Do executes the "compute.globalForwardingRules.list" call. Exactly one of *ForwardingRuleList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ForwardingRuleList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalForwardingRulesListCall) Fields(s ...googleapi.Field) *GlobalForwardingRulesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalForwardingRulesListCall) Filter(filter string) *GlobalForwardingRulesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *GlobalForwardingRulesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalForwardingRulesListCall) IfNoneMatch(entityTag string) *GlobalForwardingRulesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *GlobalForwardingRulesListCall) MaxResults(maxResults int64) *GlobalForwardingRulesListCall
MaxResults sets the optional parameter "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)
func (c *GlobalForwardingRulesListCall) OrderBy(orderBy string) *GlobalForwardingRulesListCall
OrderBy sets the optional parameter "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.
func (c *GlobalForwardingRulesListCall) PageToken(pageToken string) *GlobalForwardingRulesListCall
PageToken sets the optional parameter "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.
func (c *GlobalForwardingRulesListCall) Pages(ctx context.Context, f func(*ForwardingRuleList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type GlobalForwardingRulesService struct {
// contains filtered or unexported fields
}func NewGlobalForwardingRulesService(s *Service) *GlobalForwardingRulesService
func (r *GlobalForwardingRulesService) Delete(project string, forwardingRule string) *GlobalForwardingRulesDeleteCall
Delete: Deletes the specified GlobalForwardingRule resource. For details, see https://cloud.google.com/compute/docs/reference/latest/globalForwardingRules/delete
func (r *GlobalForwardingRulesService) Get(project string, forwardingRule string) *GlobalForwardingRulesGetCall
Get: Returns the specified GlobalForwardingRule resource. Get a list of available forwarding rules by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/globalForwardingRules/get
func (r *GlobalForwardingRulesService) Insert(project string, forwardingrule *ForwardingRule) *GlobalForwardingRulesInsertCall
Insert: Creates a GlobalForwardingRule resource in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/globalForwardingRules/insert
func (r *GlobalForwardingRulesService) List(project string) *GlobalForwardingRulesListCall
List: Retrieves a list of GlobalForwardingRule resources available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/globalForwardingRules/list
func (r *GlobalForwardingRulesService) SetTarget(project string, forwardingRule string, targetreference *TargetReference) *GlobalForwardingRulesSetTargetCall
SetTarget: Changes target URL for the GlobalForwardingRule resource. The new target should be of the same type as the old target. For details, see https://cloud.google.com/compute/docs/reference/latest/globalForwardingRules/setTarget
type GlobalForwardingRulesSetTargetCall struct {
// contains filtered or unexported fields
}func (c *GlobalForwardingRulesSetTargetCall) Context(ctx context.Context) *GlobalForwardingRulesSetTargetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalForwardingRulesSetTargetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.globalForwardingRules.setTarget" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalForwardingRulesSetTargetCall) Fields(s ...googleapi.Field) *GlobalForwardingRulesSetTargetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalForwardingRulesSetTargetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalForwardingRulesSetTargetCall) RequestId(requestId string) *GlobalForwardingRulesSetTargetCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type GlobalOperationsAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *GlobalOperationsAggregatedListCall) Context(ctx context.Context) *GlobalOperationsAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalOperationsAggregatedListCall) Do(opts ...googleapi.CallOption) (*OperationAggregatedList, error)
Do executes the "compute.globalOperations.aggregatedList" call. Exactly one of *OperationAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *OperationAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalOperationsAggregatedListCall) Fields(s ...googleapi.Field) *GlobalOperationsAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalOperationsAggregatedListCall) Filter(filter string) *GlobalOperationsAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *GlobalOperationsAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalOperationsAggregatedListCall) IfNoneMatch(entityTag string) *GlobalOperationsAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *GlobalOperationsAggregatedListCall) MaxResults(maxResults int64) *GlobalOperationsAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *GlobalOperationsAggregatedListCall) OrderBy(orderBy string) *GlobalOperationsAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *GlobalOperationsAggregatedListCall) PageToken(pageToken string) *GlobalOperationsAggregatedListCall
PageToken sets the optional parameter "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.
func (c *GlobalOperationsAggregatedListCall) Pages(ctx context.Context, f func(*OperationAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type GlobalOperationsDeleteCall struct {
// contains filtered or unexported fields
}func (c *GlobalOperationsDeleteCall) Context(ctx context.Context) *GlobalOperationsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalOperationsDeleteCall) Do(opts ...googleapi.CallOption) error
Do executes the "compute.globalOperations.delete" call.
func (c *GlobalOperationsDeleteCall) Fields(s ...googleapi.Field) *GlobalOperationsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalOperationsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type GlobalOperationsGetCall struct {
// contains filtered or unexported fields
}func (c *GlobalOperationsGetCall) Context(ctx context.Context) *GlobalOperationsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.globalOperations.get" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalOperationsGetCall) Fields(s ...googleapi.Field) *GlobalOperationsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalOperationsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalOperationsGetCall) IfNoneMatch(entityTag string) *GlobalOperationsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type GlobalOperationsListCall struct {
// contains filtered or unexported fields
}func (c *GlobalOperationsListCall) Context(ctx context.Context) *GlobalOperationsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *GlobalOperationsListCall) Do(opts ...googleapi.CallOption) (*OperationList, error)
Do executes the "compute.globalOperations.list" call. Exactly one of *OperationList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *OperationList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *GlobalOperationsListCall) Fields(s ...googleapi.Field) *GlobalOperationsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *GlobalOperationsListCall) Filter(filter string) *GlobalOperationsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *GlobalOperationsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *GlobalOperationsListCall) IfNoneMatch(entityTag string) *GlobalOperationsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *GlobalOperationsListCall) MaxResults(maxResults int64) *GlobalOperationsListCall
MaxResults sets the optional parameter "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)
func (c *GlobalOperationsListCall) OrderBy(orderBy string) *GlobalOperationsListCall
OrderBy sets the optional parameter "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.
func (c *GlobalOperationsListCall) PageToken(pageToken string) *GlobalOperationsListCall
PageToken sets the optional parameter "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.
func (c *GlobalOperationsListCall) Pages(ctx context.Context, f func(*OperationList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type GlobalOperationsService struct {
// contains filtered or unexported fields
}func NewGlobalOperationsService(s *Service) *GlobalOperationsService
func (r *GlobalOperationsService) AggregatedList(project string) *GlobalOperationsAggregatedListCall
AggregatedList: Retrieves an aggregated list of all operations. For details, see https://cloud.google.com/compute/docs/reference/latest/globalOperations/aggregatedList
func (r *GlobalOperationsService) Delete(project string, operation string) *GlobalOperationsDeleteCall
Delete: Deletes the specified Operations resource. For details, see https://cloud.google.com/compute/docs/reference/latest/globalOperations/delete
func (r *GlobalOperationsService) Get(project string, operation string) *GlobalOperationsGetCall
Get: Retrieves the specified Operations resource. Get a list of operations by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/globalOperations/get
func (r *GlobalOperationsService) List(project string) *GlobalOperationsListCall
List: Retrieves a list of Operation resources contained within the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/globalOperations/list
type GlobalSetLabelsRequest struct {
// LabelFingerprint: The fingerprint of the previous set of labels for
// this resource, used to detect conflicts. The fingerprint is initially
// generated by Compute Engine and changes after every request to modify
// or update labels. You must always provide an up-to-date fingerprint
// hash when updating or changing labels. Make a get() request to the
// resource to get the latest fingerprint.
LabelFingerprint string `json:"labelFingerprint,omitempty"`
// Labels: A list of labels to apply for this resource. Each label key &
// value must comply with RFC1035. Specifically, the name must be 1-63
// characters long and match the regular expression
// [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a
// lowercase letter, and all following characters must be a dash,
// lowercase letter, or digit, except the last character, which cannot
// be a dash. For example, "webserver-frontend": "images". A label value
// can also be empty (e.g. "my-label": "").
Labels map[string]string `json:"labels,omitempty"`
// ForceSendFields is a list of field names (e.g. "LabelFingerprint") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "LabelFingerprint") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *GlobalSetLabelsRequest) MarshalJSON() ([]byte, error)
type GuestOsFeature struct {
// Type: The ID of a supported feature. Read Enabling guest operating
// system features to see a list of available options.
//
// Possible values:
// "FEATURE_TYPE_UNSPECIFIED"
// "VIRTIO_SCSI_MULTIQUEUE"
// "WINDOWS"
Type string `json:"type,omitempty"`
// ForceSendFields is a list of field names (e.g. "Type") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Type") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}GuestOsFeature: Guest OS features.
func (s *GuestOsFeature) MarshalJSON() ([]byte, error)
type HTTPHealthCheck struct {
// Host: The value of the host header in the HTTP health check request.
// If left empty (default value), the IP on behalf of which this health
// check is performed will be used.
Host string `json:"host,omitempty"`
// Port: The TCP port number for the health check request. The default
// value is 80. Valid values are 1 through 65535.
Port int64 `json:"port,omitempty"`
// PortName: Port name as defined in InstanceGroup#NamedPort#name. If
// both port and port_name are defined, port takes precedence.
PortName string `json:"portName,omitempty"`
// ProxyHeader: Specifies the type of proxy header to append before
// sending data to the backend, either NONE or PROXY_V1. The default is
// NONE.
//
// Possible values:
// "NONE"
// "PROXY_V1"
ProxyHeader string `json:"proxyHeader,omitempty"`
// RequestPath: The request path of the HTTP health check request. The
// default value is /.
RequestPath string `json:"requestPath,omitempty"`
// ForceSendFields is a list of field names (e.g. "Host") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Host") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *HTTPHealthCheck) MarshalJSON() ([]byte, error)
type HTTPSHealthCheck struct {
// Host: The value of the host header in the HTTPS health check request.
// If left empty (default value), the IP on behalf of which this health
// check is performed will be used.
Host string `json:"host,omitempty"`
// Port: The TCP port number for the health check request. The default
// value is 443. Valid values are 1 through 65535.
Port int64 `json:"port,omitempty"`
// PortName: Port name as defined in InstanceGroup#NamedPort#name. If
// both port and port_name are defined, port takes precedence.
PortName string `json:"portName,omitempty"`
// ProxyHeader: Specifies the type of proxy header to append before
// sending data to the backend, either NONE or PROXY_V1. The default is
// NONE.
//
// Possible values:
// "NONE"
// "PROXY_V1"
ProxyHeader string `json:"proxyHeader,omitempty"`
// RequestPath: The request path of the HTTPS health check request. The
// default value is /.
RequestPath string `json:"requestPath,omitempty"`
// ForceSendFields is a list of field names (e.g. "Host") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Host") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *HTTPSHealthCheck) MarshalJSON() ([]byte, error)
type HealthCheck struct {
// CheckIntervalSec: How often (in seconds) to send a health check. The
// default value is 5 seconds.
CheckIntervalSec int64 `json:"checkIntervalSec,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in 3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// HealthyThreshold: A so-far unhealthy instance will be marked healthy
// after this many consecutive successes. The default value is 2.
HealthyThreshold int64 `json:"healthyThreshold,omitempty"`
HttpHealthCheck *HTTPHealthCheck `json:"httpHealthCheck,omitempty"`
HttpsHealthCheck *HTTPSHealthCheck `json:"httpsHealthCheck,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: Type of the resource.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
SslHealthCheck *SSLHealthCheck `json:"sslHealthCheck,omitempty"`
TcpHealthCheck *TCPHealthCheck `json:"tcpHealthCheck,omitempty"`
// TimeoutSec: How long (in seconds) to wait before claiming failure.
// The default value is 5 seconds. It is invalid for timeoutSec to have
// greater value than checkIntervalSec.
TimeoutSec int64 `json:"timeoutSec,omitempty"`
// Type: Specifies the type of the healthCheck, either TCP, SSL, HTTP or
// HTTPS. If not specified, the default is TCP. Exactly one of the
// protocol-specific health check field must be specified, which must
// match type field.
//
// Possible values:
// "HTTP"
// "HTTPS"
// "INVALID"
// "SSL"
// "TCP"
Type string `json:"type,omitempty"`
// UnhealthyThreshold: A so-far healthy instance will be marked
// unhealthy after this many consecutive failures. The default value is
// 2.
UnhealthyThreshold int64 `json:"unhealthyThreshold,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CheckIntervalSec") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CheckIntervalSec") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}HealthCheck: An HealthCheck resource. This resource defines a template for how individual virtual machines should be checked for health, via one of the supported protocols.
func (s *HealthCheck) MarshalJSON() ([]byte, error)
type HealthCheckList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of HealthCheck resources.
Items []*HealthCheck `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *HealthCheckListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}HealthCheckList: Contains a list of HealthCheck resources.
func (s *HealthCheckList) MarshalJSON() ([]byte, error)
type HealthCheckListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*HealthCheckListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}HealthCheckListWarning: [Output Only] Informational warning message.
func (s *HealthCheckListWarning) MarshalJSON() ([]byte, error)
type HealthCheckListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *HealthCheckListWarningData) MarshalJSON() ([]byte, error)
type HealthCheckReference struct {
HealthCheck string `json:"healthCheck,omitempty"`
// ForceSendFields is a list of field names (e.g. "HealthCheck") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "HealthCheck") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}HealthCheckReference: A full or valid partial URL to a health check. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check - projects/project-id/global/httpHealthChecks/health-check - global/httpHealthChecks/health-check
func (s *HealthCheckReference) MarshalJSON() ([]byte, error)
type HealthChecksDeleteCall struct {
// contains filtered or unexported fields
}func (c *HealthChecksDeleteCall) Context(ctx context.Context) *HealthChecksDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HealthChecksDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.healthChecks.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HealthChecksDeleteCall) Fields(s ...googleapi.Field) *HealthChecksDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HealthChecksDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HealthChecksDeleteCall) RequestId(requestId string) *HealthChecksDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HealthChecksGetCall struct {
// contains filtered or unexported fields
}func (c *HealthChecksGetCall) Context(ctx context.Context) *HealthChecksGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HealthChecksGetCall) Do(opts ...googleapi.CallOption) (*HealthCheck, error)
Do executes the "compute.healthChecks.get" call. Exactly one of *HealthCheck or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *HealthCheck.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HealthChecksGetCall) Fields(s ...googleapi.Field) *HealthChecksGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HealthChecksGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HealthChecksGetCall) IfNoneMatch(entityTag string) *HealthChecksGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type HealthChecksInsertCall struct {
// contains filtered or unexported fields
}func (c *HealthChecksInsertCall) Context(ctx context.Context) *HealthChecksInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HealthChecksInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.healthChecks.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HealthChecksInsertCall) Fields(s ...googleapi.Field) *HealthChecksInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HealthChecksInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HealthChecksInsertCall) RequestId(requestId string) *HealthChecksInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HealthChecksListCall struct {
// contains filtered or unexported fields
}func (c *HealthChecksListCall) Context(ctx context.Context) *HealthChecksListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HealthChecksListCall) Do(opts ...googleapi.CallOption) (*HealthCheckList, error)
Do executes the "compute.healthChecks.list" call. Exactly one of *HealthCheckList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *HealthCheckList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HealthChecksListCall) Fields(s ...googleapi.Field) *HealthChecksListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HealthChecksListCall) Filter(filter string) *HealthChecksListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *HealthChecksListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HealthChecksListCall) IfNoneMatch(entityTag string) *HealthChecksListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *HealthChecksListCall) MaxResults(maxResults int64) *HealthChecksListCall
MaxResults sets the optional parameter "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)
func (c *HealthChecksListCall) OrderBy(orderBy string) *HealthChecksListCall
OrderBy sets the optional parameter "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.
func (c *HealthChecksListCall) PageToken(pageToken string) *HealthChecksListCall
PageToken sets the optional parameter "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.
func (c *HealthChecksListCall) Pages(ctx context.Context, f func(*HealthCheckList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type HealthChecksPatchCall struct {
// contains filtered or unexported fields
}func (c *HealthChecksPatchCall) Context(ctx context.Context) *HealthChecksPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HealthChecksPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.healthChecks.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HealthChecksPatchCall) Fields(s ...googleapi.Field) *HealthChecksPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HealthChecksPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HealthChecksPatchCall) RequestId(requestId string) *HealthChecksPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HealthChecksService struct {
// contains filtered or unexported fields
}func NewHealthChecksService(s *Service) *HealthChecksService
func (r *HealthChecksService) Delete(project string, healthCheck string) *HealthChecksDeleteCall
Delete: Deletes the specified HealthCheck resource.
func (r *HealthChecksService) Get(project string, healthCheck string) *HealthChecksGetCall
Get: Returns the specified HealthCheck resource. Get a list of available health checks by making a list() request.
func (r *HealthChecksService) Insert(project string, healthcheck *HealthCheck) *HealthChecksInsertCall
Insert: Creates a HealthCheck resource in the specified project using the data included in the request.
func (r *HealthChecksService) List(project string) *HealthChecksListCall
List: Retrieves the list of HealthCheck resources available to the specified project.
func (r *HealthChecksService) Patch(project string, healthCheck string, healthcheck *HealthCheck) *HealthChecksPatchCall
Patch: Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
func (r *HealthChecksService) Update(project string, healthCheck string, healthcheck *HealthCheck) *HealthChecksUpdateCall
Update: Updates a HealthCheck resource in the specified project using the data included in the request.
type HealthChecksUpdateCall struct {
// contains filtered or unexported fields
}func (c *HealthChecksUpdateCall) Context(ctx context.Context) *HealthChecksUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HealthChecksUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.healthChecks.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HealthChecksUpdateCall) Fields(s ...googleapi.Field) *HealthChecksUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HealthChecksUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HealthChecksUpdateCall) RequestId(requestId string) *HealthChecksUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HealthStatus struct {
// HealthState: Health state of the instance.
//
// Possible values:
// "HEALTHY"
// "UNHEALTHY"
HealthState string `json:"healthState,omitempty"`
// Instance: URL of the instance resource.
Instance string `json:"instance,omitempty"`
// IpAddress: The IP address represented by this resource.
IpAddress string `json:"ipAddress,omitempty"`
// Port: The port on the instance.
Port int64 `json:"port,omitempty"`
// ForceSendFields is a list of field names (e.g. "HealthState") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "HealthState") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *HealthStatus) MarshalJSON() ([]byte, error)
type HostRule struct {
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Hosts: The list of host patterns to match. They must be valid
// hostnames, except * will match any string of ([a-z0-9-.]*). In that
// case, * must be the first character and must be followed in the
// pattern by either - or ..
Hosts []string `json:"hosts,omitempty"`
// PathMatcher: The name of the PathMatcher to use to match the path
// portion of the URL if the hostRule matches the URL's host portion.
PathMatcher string `json:"pathMatcher,omitempty"`
// ForceSendFields is a list of field names (e.g. "Description") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Description") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}HostRule: UrlMaps A host-matching rule for a URL. If matched, will use the named PathMatcher to select the BackendService.
type HttpHealthCheck struct {
// CheckIntervalSec: How often (in seconds) to send a health check. The
// default value is 5 seconds.
CheckIntervalSec int64 `json:"checkIntervalSec,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// HealthyThreshold: A so-far unhealthy instance will be marked healthy
// after this many consecutive successes. The default value is 2.
HealthyThreshold int64 `json:"healthyThreshold,omitempty"`
// Host: The value of the host header in the HTTP health check request.
// If left empty (default value), the public IP on behalf of which this
// health check is performed will be used.
Host string `json:"host,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always
// compute#httpHealthCheck for HTTP health checks.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Port: The TCP port number for the HTTP health check request. The
// default value is 80.
Port int64 `json:"port,omitempty"`
// RequestPath: The request path of the HTTP health check request. The
// default value is /.
RequestPath string `json:"requestPath,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// TimeoutSec: How long (in seconds) to wait before claiming failure.
// The default value is 5 seconds. It is invalid for timeoutSec to have
// greater value than checkIntervalSec.
TimeoutSec int64 `json:"timeoutSec,omitempty"`
// UnhealthyThreshold: A so-far healthy instance will be marked
// unhealthy after this many consecutive failures. The default value is
// 2.
UnhealthyThreshold int64 `json:"unhealthyThreshold,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CheckIntervalSec") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CheckIntervalSec") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}HttpHealthCheck: An HttpHealthCheck resource. This resource defines a template for how individual instances should be checked for health, via HTTP.
func (s *HttpHealthCheck) MarshalJSON() ([]byte, error)
type HttpHealthCheckList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of HttpHealthCheck resources.
Items []*HttpHealthCheck `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *HttpHealthCheckListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}HttpHealthCheckList: Contains a list of HttpHealthCheck resources.
func (s *HttpHealthCheckList) MarshalJSON() ([]byte, error)
type HttpHealthCheckListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*HttpHealthCheckListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}HttpHealthCheckListWarning: [Output Only] Informational warning message.
func (s *HttpHealthCheckListWarning) MarshalJSON() ([]byte, error)
type HttpHealthCheckListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *HttpHealthCheckListWarningData) MarshalJSON() ([]byte, error)
type HttpHealthChecksDeleteCall struct {
// contains filtered or unexported fields
}func (c *HttpHealthChecksDeleteCall) Context(ctx context.Context) *HttpHealthChecksDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpHealthChecksDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.httpHealthChecks.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpHealthChecksDeleteCall) Fields(s ...googleapi.Field) *HttpHealthChecksDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpHealthChecksDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpHealthChecksDeleteCall) RequestId(requestId string) *HttpHealthChecksDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HttpHealthChecksGetCall struct {
// contains filtered or unexported fields
}func (c *HttpHealthChecksGetCall) Context(ctx context.Context) *HttpHealthChecksGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpHealthChecksGetCall) Do(opts ...googleapi.CallOption) (*HttpHealthCheck, error)
Do executes the "compute.httpHealthChecks.get" call. Exactly one of *HttpHealthCheck or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *HttpHealthCheck.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpHealthChecksGetCall) Fields(s ...googleapi.Field) *HttpHealthChecksGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpHealthChecksGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpHealthChecksGetCall) IfNoneMatch(entityTag string) *HttpHealthChecksGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type HttpHealthChecksInsertCall struct {
// contains filtered or unexported fields
}func (c *HttpHealthChecksInsertCall) Context(ctx context.Context) *HttpHealthChecksInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpHealthChecksInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.httpHealthChecks.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpHealthChecksInsertCall) Fields(s ...googleapi.Field) *HttpHealthChecksInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpHealthChecksInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpHealthChecksInsertCall) RequestId(requestId string) *HttpHealthChecksInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HttpHealthChecksListCall struct {
// contains filtered or unexported fields
}func (c *HttpHealthChecksListCall) Context(ctx context.Context) *HttpHealthChecksListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpHealthChecksListCall) Do(opts ...googleapi.CallOption) (*HttpHealthCheckList, error)
Do executes the "compute.httpHealthChecks.list" call. Exactly one of *HttpHealthCheckList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *HttpHealthCheckList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpHealthChecksListCall) Fields(s ...googleapi.Field) *HttpHealthChecksListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpHealthChecksListCall) Filter(filter string) *HttpHealthChecksListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *HttpHealthChecksListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpHealthChecksListCall) IfNoneMatch(entityTag string) *HttpHealthChecksListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *HttpHealthChecksListCall) MaxResults(maxResults int64) *HttpHealthChecksListCall
MaxResults sets the optional parameter "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)
func (c *HttpHealthChecksListCall) OrderBy(orderBy string) *HttpHealthChecksListCall
OrderBy sets the optional parameter "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.
func (c *HttpHealthChecksListCall) PageToken(pageToken string) *HttpHealthChecksListCall
PageToken sets the optional parameter "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.
func (c *HttpHealthChecksListCall) Pages(ctx context.Context, f func(*HttpHealthCheckList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type HttpHealthChecksPatchCall struct {
// contains filtered or unexported fields
}func (c *HttpHealthChecksPatchCall) Context(ctx context.Context) *HttpHealthChecksPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpHealthChecksPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.httpHealthChecks.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpHealthChecksPatchCall) Fields(s ...googleapi.Field) *HttpHealthChecksPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpHealthChecksPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpHealthChecksPatchCall) RequestId(requestId string) *HttpHealthChecksPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HttpHealthChecksService struct {
// contains filtered or unexported fields
}func NewHttpHealthChecksService(s *Service) *HttpHealthChecksService
func (r *HttpHealthChecksService) Delete(project string, httpHealthCheck string) *HttpHealthChecksDeleteCall
Delete: Deletes the specified HttpHealthCheck resource. For details, see https://cloud.google.com/compute/docs/reference/latest/httpHealthChecks/delete
func (r *HttpHealthChecksService) Get(project string, httpHealthCheck string) *HttpHealthChecksGetCall
Get: Returns the specified HttpHealthCheck resource. Get a list of available HTTP health checks by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/httpHealthChecks/get
func (r *HttpHealthChecksService) Insert(project string, httphealthcheck *HttpHealthCheck) *HttpHealthChecksInsertCall
Insert: Creates a HttpHealthCheck resource in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/httpHealthChecks/insert
func (r *HttpHealthChecksService) List(project string) *HttpHealthChecksListCall
List: Retrieves the list of HttpHealthCheck resources available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/httpHealthChecks/list
func (r *HttpHealthChecksService) Patch(project string, httpHealthCheck string, httphealthcheck *HttpHealthCheck) *HttpHealthChecksPatchCall
Patch: Updates a HttpHealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. For details, see https://cloud.google.com/compute/docs/reference/latest/httpHealthChecks/patch
func (r *HttpHealthChecksService) Update(project string, httpHealthCheck string, httphealthcheck *HttpHealthCheck) *HttpHealthChecksUpdateCall
Update: Updates a HttpHealthCheck resource in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/httpHealthChecks/update
type HttpHealthChecksUpdateCall struct {
// contains filtered or unexported fields
}func (c *HttpHealthChecksUpdateCall) Context(ctx context.Context) *HttpHealthChecksUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpHealthChecksUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.httpHealthChecks.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpHealthChecksUpdateCall) Fields(s ...googleapi.Field) *HttpHealthChecksUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpHealthChecksUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpHealthChecksUpdateCall) RequestId(requestId string) *HttpHealthChecksUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HttpsHealthCheck struct {
// CheckIntervalSec: How often (in seconds) to send a health check. The
// default value is 5 seconds.
CheckIntervalSec int64 `json:"checkIntervalSec,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// HealthyThreshold: A so-far unhealthy instance will be marked healthy
// after this many consecutive successes. The default value is 2.
HealthyThreshold int64 `json:"healthyThreshold,omitempty"`
// Host: The value of the host header in the HTTPS health check request.
// If left empty (default value), the public IP on behalf of which this
// health check is performed will be used.
Host string `json:"host,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: Type of the resource.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Port: The TCP port number for the HTTPS health check request. The
// default value is 443.
Port int64 `json:"port,omitempty"`
// RequestPath: The request path of the HTTPS health check request. The
// default value is "/".
RequestPath string `json:"requestPath,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// TimeoutSec: How long (in seconds) to wait before claiming failure.
// The default value is 5 seconds. It is invalid for timeoutSec to have
// a greater value than checkIntervalSec.
TimeoutSec int64 `json:"timeoutSec,omitempty"`
// UnhealthyThreshold: A so-far healthy instance will be marked
// unhealthy after this many consecutive failures. The default value is
// 2.
UnhealthyThreshold int64 `json:"unhealthyThreshold,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CheckIntervalSec") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CheckIntervalSec") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}HttpsHealthCheck: An HttpsHealthCheck resource. This resource defines a template for how individual instances should be checked for health, via HTTPS.
func (s *HttpsHealthCheck) MarshalJSON() ([]byte, error)
type HttpsHealthCheckList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of HttpsHealthCheck resources.
Items []*HttpsHealthCheck `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *HttpsHealthCheckListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}HttpsHealthCheckList: Contains a list of HttpsHealthCheck resources.
func (s *HttpsHealthCheckList) MarshalJSON() ([]byte, error)
type HttpsHealthCheckListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*HttpsHealthCheckListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}HttpsHealthCheckListWarning: [Output Only] Informational warning message.
func (s *HttpsHealthCheckListWarning) MarshalJSON() ([]byte, error)
type HttpsHealthCheckListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *HttpsHealthCheckListWarningData) MarshalJSON() ([]byte, error)
type HttpsHealthChecksDeleteCall struct {
// contains filtered or unexported fields
}func (c *HttpsHealthChecksDeleteCall) Context(ctx context.Context) *HttpsHealthChecksDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpsHealthChecksDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.httpsHealthChecks.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpsHealthChecksDeleteCall) Fields(s ...googleapi.Field) *HttpsHealthChecksDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpsHealthChecksDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpsHealthChecksDeleteCall) RequestId(requestId string) *HttpsHealthChecksDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HttpsHealthChecksGetCall struct {
// contains filtered or unexported fields
}func (c *HttpsHealthChecksGetCall) Context(ctx context.Context) *HttpsHealthChecksGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpsHealthChecksGetCall) Do(opts ...googleapi.CallOption) (*HttpsHealthCheck, error)
Do executes the "compute.httpsHealthChecks.get" call. Exactly one of *HttpsHealthCheck or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *HttpsHealthCheck.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpsHealthChecksGetCall) Fields(s ...googleapi.Field) *HttpsHealthChecksGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpsHealthChecksGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpsHealthChecksGetCall) IfNoneMatch(entityTag string) *HttpsHealthChecksGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type HttpsHealthChecksInsertCall struct {
// contains filtered or unexported fields
}func (c *HttpsHealthChecksInsertCall) Context(ctx context.Context) *HttpsHealthChecksInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpsHealthChecksInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.httpsHealthChecks.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpsHealthChecksInsertCall) Fields(s ...googleapi.Field) *HttpsHealthChecksInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpsHealthChecksInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpsHealthChecksInsertCall) RequestId(requestId string) *HttpsHealthChecksInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HttpsHealthChecksListCall struct {
// contains filtered or unexported fields
}func (c *HttpsHealthChecksListCall) Context(ctx context.Context) *HttpsHealthChecksListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpsHealthChecksListCall) Do(opts ...googleapi.CallOption) (*HttpsHealthCheckList, error)
Do executes the "compute.httpsHealthChecks.list" call. Exactly one of *HttpsHealthCheckList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *HttpsHealthCheckList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpsHealthChecksListCall) Fields(s ...googleapi.Field) *HttpsHealthChecksListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpsHealthChecksListCall) Filter(filter string) *HttpsHealthChecksListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *HttpsHealthChecksListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpsHealthChecksListCall) IfNoneMatch(entityTag string) *HttpsHealthChecksListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *HttpsHealthChecksListCall) MaxResults(maxResults int64) *HttpsHealthChecksListCall
MaxResults sets the optional parameter "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)
func (c *HttpsHealthChecksListCall) OrderBy(orderBy string) *HttpsHealthChecksListCall
OrderBy sets the optional parameter "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.
func (c *HttpsHealthChecksListCall) PageToken(pageToken string) *HttpsHealthChecksListCall
PageToken sets the optional parameter "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.
func (c *HttpsHealthChecksListCall) Pages(ctx context.Context, f func(*HttpsHealthCheckList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type HttpsHealthChecksPatchCall struct {
// contains filtered or unexported fields
}func (c *HttpsHealthChecksPatchCall) Context(ctx context.Context) *HttpsHealthChecksPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpsHealthChecksPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.httpsHealthChecks.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpsHealthChecksPatchCall) Fields(s ...googleapi.Field) *HttpsHealthChecksPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpsHealthChecksPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpsHealthChecksPatchCall) RequestId(requestId string) *HttpsHealthChecksPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type HttpsHealthChecksService struct {
// contains filtered or unexported fields
}func NewHttpsHealthChecksService(s *Service) *HttpsHealthChecksService
func (r *HttpsHealthChecksService) Delete(project string, httpsHealthCheck string) *HttpsHealthChecksDeleteCall
Delete: Deletes the specified HttpsHealthCheck resource.
func (r *HttpsHealthChecksService) Get(project string, httpsHealthCheck string) *HttpsHealthChecksGetCall
Get: Returns the specified HttpsHealthCheck resource. Get a list of available HTTPS health checks by making a list() request.
func (r *HttpsHealthChecksService) Insert(project string, httpshealthcheck *HttpsHealthCheck) *HttpsHealthChecksInsertCall
Insert: Creates a HttpsHealthCheck resource in the specified project using the data included in the request.
func (r *HttpsHealthChecksService) List(project string) *HttpsHealthChecksListCall
List: Retrieves the list of HttpsHealthCheck resources available to the specified project.
func (r *HttpsHealthChecksService) Patch(project string, httpsHealthCheck string, httpshealthcheck *HttpsHealthCheck) *HttpsHealthChecksPatchCall
Patch: Updates a HttpsHealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
func (r *HttpsHealthChecksService) Update(project string, httpsHealthCheck string, httpshealthcheck *HttpsHealthCheck) *HttpsHealthChecksUpdateCall
Update: Updates a HttpsHealthCheck resource in the specified project using the data included in the request.
type HttpsHealthChecksUpdateCall struct {
// contains filtered or unexported fields
}func (c *HttpsHealthChecksUpdateCall) Context(ctx context.Context) *HttpsHealthChecksUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *HttpsHealthChecksUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.httpsHealthChecks.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *HttpsHealthChecksUpdateCall) Fields(s ...googleapi.Field) *HttpsHealthChecksUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *HttpsHealthChecksUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *HttpsHealthChecksUpdateCall) RequestId(requestId string) *HttpsHealthChecksUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type Image struct {
// ArchiveSizeBytes: Size of the image tar.gz archive stored in Google
// Cloud Storage (in bytes).
ArchiveSizeBytes int64 `json:"archiveSizeBytes,omitempty,string"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Deprecated: The deprecation status associated with this image.
Deprecated *DeprecationStatus `json:"deprecated,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// DiskSizeGb: Size of the image when restored onto a persistent disk
// (in GB).
DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"`
// Family: The name of the image family to which this image belongs. You
// can create disks by specifying an image family instead of a specific
// image name. The image family always returns its latest image that is
// not deprecated. The name of the image family must comply with
// RFC1035.
Family string `json:"family,omitempty"`
// GuestOsFeatures: A list of features to enable on the guest operating
// system. Applicable only for bootable images. Read Enabling guest
// operating system features to see a list of available options.
GuestOsFeatures []*GuestOsFeature `json:"guestOsFeatures,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// ImageEncryptionKey: Encrypts the image using a customer-supplied
// encryption key.
//
// After you encrypt an image with a customer-supplied key, you must
// provide the same key if you use the image later (e.g. to create a
// disk from the image).
//
// Customer-supplied encryption keys do not protect access to metadata
// of the disk.
//
// If you do not provide an encryption key when creating the image, then
// the disk will be encrypted using an automatically generated key and
// you do not need to provide a key to use the image later.
ImageEncryptionKey *CustomerEncryptionKey `json:"imageEncryptionKey,omitempty"`
// Kind: [Output Only] Type of the resource. Always compute#image for
// images.
Kind string `json:"kind,omitempty"`
// LabelFingerprint: A fingerprint for the labels being applied to this
// image, which is essentially a hash of the labels used for optimistic
// locking. The fingerprint is initially generated by Compute Engine and
// changes after every request to modify or update labels. You must
// always provide an up-to-date fingerprint hash in order to update or
// change labels.
//
// To see the latest fingerprint, make a get() request to retrieve an
// image.
LabelFingerprint string `json:"labelFingerprint,omitempty"`
// Labels: Labels to apply to this image. These can be later modified by
// the setLabels method.
Labels map[string]string `json:"labels,omitempty"`
// Licenses: Any applicable license URI.
Licenses []string `json:"licenses,omitempty"`
// Name: Name of the resource; provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// RawDisk: The parameters of the raw disk image.
RawDisk *ImageRawDisk `json:"rawDisk,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// SourceDisk: URL of the source disk used to create this image. This
// can be a full or valid partial URL. You must provide either this
// property or the rawDisk.source property but not both to create an
// image. For example, the following are valid values:
// -
// https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
// - projects/project/zones/zone/disks/disk
// - zones/zone/disks/disk
SourceDisk string `json:"sourceDisk,omitempty"`
// SourceDiskEncryptionKey: The customer-supplied encryption key of the
// source disk. Required if the source disk is protected by a
// customer-supplied encryption key.
SourceDiskEncryptionKey *CustomerEncryptionKey `json:"sourceDiskEncryptionKey,omitempty"`
// SourceDiskId: The ID value of the disk used to create this image.
// This value may be used to determine whether the image was taken from
// the current or a previous instance of a given disk name.
SourceDiskId string `json:"sourceDiskId,omitempty"`
// SourceImage: URL of the source image used to create this image. This
// can be a full or valid partial URL. You must provide exactly one of:
//
// - this property, or
// - the rawDisk.source property, or
// - the sourceDisk property in order to create an image.
SourceImage string `json:"sourceImage,omitempty"`
// SourceImageEncryptionKey: The customer-supplied encryption key of the
// source image. Required if the source image is protected by a
// customer-supplied encryption key.
SourceImageEncryptionKey *CustomerEncryptionKey `json:"sourceImageEncryptionKey,omitempty"`
// SourceImageId: [Output Only] The ID value of the image used to create
// this image. This value may be used to determine whether the image was
// taken from the current or a previous instance of a given image name.
SourceImageId string `json:"sourceImageId,omitempty"`
// SourceType: The type of the image used to create this disk. The
// default and only value is RAW
//
// Possible values:
// "RAW" (default)
SourceType string `json:"sourceType,omitempty"`
// Status: [Output Only] The status of the image. An image can be used
// to create other resources, such as instances, only after the image
// has been successfully created and the status is set to READY.
// Possible values are FAILED, PENDING, or READY.
//
// Possible values:
// "FAILED"
// "PENDING"
// "READY"
Status string `json:"status,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "ArchiveSizeBytes") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ArchiveSizeBytes") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Image: An Image resource. (== resource_for beta.images ==) (== resource_for v1.images ==)
type ImageList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Image resources.
Items []*Image `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *ImageListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ImageList: Contains a list of images.
type ImageListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*ImageListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ImageListWarning: [Output Only] Informational warning message.
func (s *ImageListWarning) MarshalJSON() ([]byte, error)
type ImageListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ImageListWarningData) MarshalJSON() ([]byte, error)
type ImageRawDisk struct {
// ContainerType: The format used to encode and transmit the block
// device, which should be TAR. This is just a container and
// transmission format and not a runtime format. Provided by the client
// when the disk image is created.
//
// Possible values:
// "TAR"
ContainerType string `json:"containerType,omitempty"`
// Sha1Checksum: An optional SHA1 checksum of the disk image before
// unpackaging; provided by the client when the disk image is created.
Sha1Checksum string `json:"sha1Checksum,omitempty"`
// Source: The full Google Cloud Storage URL where the disk image is
// stored. You must provide either this property or the sourceDisk
// property but not both.
Source string `json:"source,omitempty"`
// ForceSendFields is a list of field names (e.g. "ContainerType") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ContainerType") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ImageRawDisk: The parameters of the raw disk image.
func (s *ImageRawDisk) MarshalJSON() ([]byte, error)
type ImagesDeleteCall struct {
// contains filtered or unexported fields
}func (c *ImagesDeleteCall) Context(ctx context.Context) *ImagesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ImagesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.images.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ImagesDeleteCall) Fields(s ...googleapi.Field) *ImagesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ImagesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ImagesDeleteCall) RequestId(requestId string) *ImagesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ImagesDeprecateCall struct {
// contains filtered or unexported fields
}func (c *ImagesDeprecateCall) Context(ctx context.Context) *ImagesDeprecateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ImagesDeprecateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.images.deprecate" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ImagesDeprecateCall) Fields(s ...googleapi.Field) *ImagesDeprecateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ImagesDeprecateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ImagesDeprecateCall) RequestId(requestId string) *ImagesDeprecateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ImagesGetCall struct {
// contains filtered or unexported fields
}func (c *ImagesGetCall) Context(ctx context.Context) *ImagesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ImagesGetCall) Do(opts ...googleapi.CallOption) (*Image, error)
Do executes the "compute.images.get" call. Exactly one of *Image or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Image.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ImagesGetCall) Fields(s ...googleapi.Field) *ImagesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ImagesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ImagesGetCall) IfNoneMatch(entityTag string) *ImagesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type ImagesGetFromFamilyCall struct {
// contains filtered or unexported fields
}func (c *ImagesGetFromFamilyCall) Context(ctx context.Context) *ImagesGetFromFamilyCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ImagesGetFromFamilyCall) Do(opts ...googleapi.CallOption) (*Image, error)
Do executes the "compute.images.getFromFamily" call. Exactly one of *Image or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Image.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ImagesGetFromFamilyCall) Fields(s ...googleapi.Field) *ImagesGetFromFamilyCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ImagesGetFromFamilyCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ImagesGetFromFamilyCall) IfNoneMatch(entityTag string) *ImagesGetFromFamilyCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type ImagesInsertCall struct {
// contains filtered or unexported fields
}func (c *ImagesInsertCall) Context(ctx context.Context) *ImagesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ImagesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.images.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ImagesInsertCall) Fields(s ...googleapi.Field) *ImagesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ImagesInsertCall) ForceCreate(forceCreate bool) *ImagesInsertCall
ForceCreate sets the optional parameter "forceCreate": Force image creation if true.
func (c *ImagesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ImagesInsertCall) RequestId(requestId string) *ImagesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ImagesListCall struct {
// contains filtered or unexported fields
}func (c *ImagesListCall) Context(ctx context.Context) *ImagesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ImagesListCall) Do(opts ...googleapi.CallOption) (*ImageList, error)
Do executes the "compute.images.list" call. Exactly one of *ImageList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ImageList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ImagesListCall) Fields(s ...googleapi.Field) *ImagesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ImagesListCall) Filter(filter string) *ImagesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *ImagesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ImagesListCall) IfNoneMatch(entityTag string) *ImagesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *ImagesListCall) MaxResults(maxResults int64) *ImagesListCall
MaxResults sets the optional parameter "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)
func (c *ImagesListCall) OrderBy(orderBy string) *ImagesListCall
OrderBy sets the optional parameter "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.
func (c *ImagesListCall) PageToken(pageToken string) *ImagesListCall
PageToken sets the optional parameter "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.
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type ImagesService struct {
// contains filtered or unexported fields
}func NewImagesService(s *Service) *ImagesService
func (r *ImagesService) Delete(project string, image string) *ImagesDeleteCall
Delete: Deletes the specified image. For details, see https://cloud.google.com/compute/docs/reference/latest/images/delete
func (r *ImagesService) Deprecate(project string, image string, deprecationstatus *DeprecationStatus) *ImagesDeprecateCall
Deprecate: Sets the deprecation status of an image.
If an empty request body is given, clears the deprecation status instead. For details, see https://cloud.google.com/compute/docs/reference/latest/images/deprecate
func (r *ImagesService) Get(project string, image string) *ImagesGetCall
Get: Returns the specified image. Get a list of available images by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/images/get
func (r *ImagesService) GetFromFamily(project string, family string) *ImagesGetFromFamilyCall
GetFromFamily: Returns the latest image that is part of an image family and is not deprecated.
func (r *ImagesService) Insert(project string, image *Image) *ImagesInsertCall
Insert: Creates an image in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/images/insert
func (r *ImagesService) List(project string) *ImagesListCall
List: Retrieves the list of custom images available to the specified project. Custom images are images you create that belong to your project. This method does not get any images that belong to other projects, including publicly-available images, like Debian 8. If you want to get a list of publicly-available images, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud. For details, see https://cloud.google.com/compute/docs/reference/latest/images/list
func (r *ImagesService) SetLabels(project string, resource string, globalsetlabelsrequest *GlobalSetLabelsRequest) *ImagesSetLabelsCall
SetLabels: Sets the labels on an image. To learn more about labels, read the Labeling Resources documentation.
type ImagesSetLabelsCall struct {
// contains filtered or unexported fields
}func (c *ImagesSetLabelsCall) Context(ctx context.Context) *ImagesSetLabelsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ImagesSetLabelsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.images.setLabels" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ImagesSetLabelsCall) Fields(s ...googleapi.Field) *ImagesSetLabelsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ImagesSetLabelsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type Instance struct {
// CanIpForward: Allows this instance to send and receive packets with
// non-matching destination or source IPs. This is required if you plan
// to use this instance to forward routes. For more information, see
// Enabling IP Forwarding.
CanIpForward bool `json:"canIpForward,omitempty"`
// CpuPlatform: [Output Only] The CPU platform used by this instance.
CpuPlatform string `json:"cpuPlatform,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// DeletionProtection: Whether the resource should be protected against
// deletion.
DeletionProtection bool `json:"deletionProtection,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Disks: Array of disks associated with this instance. Persistent disks
// must be created before you can assign them.
Disks []*AttachedDisk `json:"disks,omitempty"`
// GuestAccelerators: List of the type and count of accelerator cards
// attached to the instance.
GuestAccelerators []*AcceleratorConfig `json:"guestAccelerators,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#instance for
// instances.
Kind string `json:"kind,omitempty"`
// LabelFingerprint: A fingerprint for this request, which is
// essentially a hash of the metadata's contents and used for optimistic
// locking. The fingerprint is initially generated by Compute Engine and
// changes after every request to modify or update metadata. You must
// always provide an up-to-date fingerprint hash in order to update or
// change metadata.
//
// To see the latest fingerprint, make get() request to the instance.
LabelFingerprint string `json:"labelFingerprint,omitempty"`
// Labels: Labels to apply to this instance. These can be later modified
// by the setLabels method.
Labels map[string]string `json:"labels,omitempty"`
// MachineType: Full or partial URL of the machine type resource to use
// for this instance, in the format:
// zones/zone/machineTypes/machine-type. This is provided by the client
// when the instance is created. For example, the following is a valid
// partial url to a predefined machine
// type:
//
// zones/us-central1-f/machineTypes/n1-standard-1
//
// To create a custom machine type, provide a URL to a machine type in
// the following format, where CPUS is 1 or an even number up to 32 (2,
// 4, 6, ... 24, etc), and MEMORY is the total memory for this instance.
// Memory must be a multiple of 256 MB and must be supplied in MB (e.g.
// 5 GB of memory is 5120
// MB):
//
// zones/zone/machineTypes/custom-CPUS-MEMORY
//
// For example: zones/us-central1-f/machineTypes/custom-4-5120
//
// For a full list of restrictions, read the Specifications for custom
// machine types.
MachineType string `json:"machineType,omitempty"`
// Metadata: The metadata key/value pairs assigned to this instance.
// This includes custom metadata and predefined keys.
Metadata *Metadata `json:"metadata,omitempty"`
// MinCpuPlatform: Specifies a minimum CPU platform for the VM instance.
// Applicable values are the friendly names of CPU platforms, such as
// minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy
// Bridge".
MinCpuPlatform string `json:"minCpuPlatform,omitempty"`
// Name: The name of the resource, provided by the client when initially
// creating the resource. The resource name must be 1-63 characters
// long, and comply with RFC1035. Specifically, the name must be 1-63
// characters long and match the regular expression
// [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a
// lowercase letter, and all following characters must be a dash,
// lowercase letter, or digit, except the last character, which cannot
// be a dash.
Name string `json:"name,omitempty"`
// NetworkInterfaces: An array of network configurations for this
// instance. These specify how interfaces are configured to interact
// with other network services, such as connecting to the internet.
// Multiple interfaces are supported per instance.
NetworkInterfaces []*NetworkInterface `json:"networkInterfaces,omitempty"`
// Scheduling: Sets the scheduling options for this instance.
Scheduling *Scheduling `json:"scheduling,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// ServiceAccounts: A list of service accounts, with their specified
// scopes, authorized for this instance. Only one service account per VM
// instance is supported.
//
// Service accounts generate access tokens that can be accessed through
// the metadata server and used to authenticate applications on the
// instance. See Service Accounts for more information.
ServiceAccounts []*ServiceAccount `json:"serviceAccounts,omitempty"`
// StartRestricted: [Output Only] Whether a VM has been restricted for
// start because Compute Engine has detected suspicious activity.
StartRestricted bool `json:"startRestricted,omitempty"`
// Status: [Output Only] The status of the instance. One of the
// following values: PROVISIONING, STAGING, RUNNING, STOPPING, STOPPED,
// SUSPENDING, SUSPENDED, and TERMINATED.
//
// Possible values:
// "PROVISIONING"
// "RUNNING"
// "STAGING"
// "STOPPED"
// "STOPPING"
// "SUSPENDED"
// "SUSPENDING"
// "TERMINATED"
Status string `json:"status,omitempty"`
// StatusMessage: [Output Only] An optional, human-readable explanation
// of the status.
StatusMessage string `json:"statusMessage,omitempty"`
// Tags: A list of tags to apply to this instance. Tags are used to
// identify valid sources or targets for network firewalls and are
// specified by the client during instance creation. The tags can be
// later modified by the setTags method. Each tag within the list must
// comply with RFC1035.
Tags *Tags `json:"tags,omitempty"`
// Zone: [Output Only] URL of the zone where the instance resides.
Zone string `json:"zone,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CanIpForward") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CanIpForward") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}Instance: An Instance resource. (== resource_for beta.instances ==) (== resource_for v1.instances ==)
type InstanceAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InstancesScopedList resources.
Items map[string]InstancesScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#instanceAggregatedList for aggregated lists of Instance
// resources.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InstanceAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceAggregatedList) MarshalJSON() ([]byte, error)
type InstanceAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstanceAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceAggregatedListWarning: [Output Only] Informational warning message.
func (s *InstanceAggregatedListWarning) MarshalJSON() ([]byte, error)
type InstanceAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceAggregatedListWarningData) MarshalJSON() ([]byte, error)
type InstanceGroup struct {
// CreationTimestamp: [Output Only] The creation timestamp for this
// instance group in RFC3339 text format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Fingerprint: [Output Only] The fingerprint of the named ports. The
// system uses this fingerprint to detect conflicts when multiple users
// change the named ports concurrently.
Fingerprint string `json:"fingerprint,omitempty"`
// Id: [Output Only] A unique identifier for this instance group,
// generated by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] The resource type, which is always
// compute#instanceGroup for instance groups.
Kind string `json:"kind,omitempty"`
// Name: The name of the instance group. The name must be 1-63
// characters long, and comply with RFC1035.
Name string `json:"name,omitempty"`
// NamedPorts: Assigns a name to a port number. For example: {name:
// "http", port: 80}
//
// This allows the system to reference ports by the assigned name
// instead of a port number. Named ports can also contain multiple
// ports. For example: [{name: "http", port: 80},{name: "http", port:
// 8080}]
//
// Named ports apply to all instances in this instance group.
NamedPorts []*NamedPort `json:"namedPorts,omitempty"`
// Network: The URL of the network to which all instances in the
// instance group belong.
Network string `json:"network,omitempty"`
// Region: The URL of the region where the instance group is located
// (for regional resources).
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] The URL for this instance group. The server
// generates this URL.
SelfLink string `json:"selfLink,omitempty"`
// Size: [Output Only] The total number of instances in the instance
// group.
Size int64 `json:"size,omitempty"`
// Subnetwork: The URL of the subnetwork to which all instances in the
// instance group belong.
Subnetwork string `json:"subnetwork,omitempty"`
// Zone: [Output Only] The URL of the zone where the instance group is
// located (for zonal resources).
Zone string `json:"zone,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}InstanceGroup: InstanceGroups (== resource_for beta.instanceGroups ==) (== resource_for v1.instanceGroups ==) (== resource_for beta.regionInstanceGroups ==) (== resource_for v1.regionInstanceGroups ==)
func (s *InstanceGroup) MarshalJSON() ([]byte, error)
type InstanceGroupAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InstanceGroupsScopedList resources.
Items map[string]InstanceGroupsScopedList `json:"items,omitempty"`
// Kind: [Output Only] The resource type, which is always
// compute#instanceGroupAggregatedList for aggregated lists of instance
// groups.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InstanceGroupAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupAggregatedList) MarshalJSON() ([]byte, error)
type InstanceGroupAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstanceGroupAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceGroupAggregatedListWarning: [Output Only] Informational warning message.
func (s *InstanceGroupAggregatedListWarning) MarshalJSON() ([]byte, error)
type InstanceGroupAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupAggregatedListWarningData) MarshalJSON() ([]byte, error)
type InstanceGroupList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InstanceGroup resources.
Items []*InstanceGroup `json:"items,omitempty"`
// Kind: [Output Only] The resource type, which is always
// compute#instanceGroupList for instance group lists.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InstanceGroupListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceGroupList: A list of InstanceGroup resources.
func (s *InstanceGroupList) MarshalJSON() ([]byte, error)
type InstanceGroupListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstanceGroupListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceGroupListWarning: [Output Only] Informational warning message.
func (s *InstanceGroupListWarning) MarshalJSON() ([]byte, error)
type InstanceGroupListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupListWarningData) MarshalJSON() ([]byte, error)
type InstanceGroupManager struct {
// BaseInstanceName: The base instance name to use for instances in this
// group. The value must be 1-58 characters long. Instances are named by
// appending a hyphen and a random four-character string to the base
// instance name. The base instance name must comply with RFC1035.
BaseInstanceName string `json:"baseInstanceName,omitempty"`
// CreationTimestamp: [Output Only] The creation timestamp for this
// managed instance group in RFC3339 text format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// CurrentActions: [Output Only] The list of instance actions and the
// number of instances in this managed instance group that are scheduled
// for each of those actions.
CurrentActions *InstanceGroupManagerActionsSummary `json:"currentActions,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Fingerprint: [Output Only] The fingerprint of the resource data. You
// can use this optional field for optimistic locking when you update
// the resource.
Fingerprint string `json:"fingerprint,omitempty"`
// Id: [Output Only] A unique identifier for this resource type. The
// server generates this identifier.
Id uint64 `json:"id,omitempty,string"`
// InstanceGroup: [Output Only] The URL of the Instance Group resource.
InstanceGroup string `json:"instanceGroup,omitempty"`
// InstanceTemplate: The URL of the instance template that is specified
// for this managed instance group. The group uses this template to
// create all new instances in the managed instance group.
InstanceTemplate string `json:"instanceTemplate,omitempty"`
// Kind: [Output Only] The resource type, which is always
// compute#instanceGroupManager for managed instance groups.
Kind string `json:"kind,omitempty"`
// Name: The name of the managed instance group. The name must be 1-63
// characters long, and comply with RFC1035.
Name string `json:"name,omitempty"`
// NamedPorts: Named ports configured for the Instance Groups
// complementary to this Instance Group Manager.
NamedPorts []*NamedPort `json:"namedPorts,omitempty"`
// Region: [Output Only] The URL of the region where the managed
// instance group resides (for regional resources).
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] The URL for this managed instance group. The
// server defines this URL.
SelfLink string `json:"selfLink,omitempty"`
// TargetPools: The URLs for all TargetPool resources to which instances
// in the instanceGroup field are added. The target pools automatically
// apply to all of the instances in the managed instance group.
TargetPools []string `json:"targetPools,omitempty"`
// TargetSize: The target number of running instances for this managed
// instance group. Deleting or abandoning instances reduces this number.
// Resizing the group changes this number.
TargetSize int64 `json:"targetSize,omitempty"`
// Zone: [Output Only] The URL of the zone where the managed instance
// group is located (for zonal resources).
Zone string `json:"zone,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "BaseInstanceName") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "BaseInstanceName") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}InstanceGroupManager: An Instance Group Manager resource. (== resource_for beta.instanceGroupManagers ==) (== resource_for v1.instanceGroupManagers ==) (== resource_for beta.regionInstanceGroupManagers ==) (== resource_for v1.regionInstanceGroupManagers ==)
func (s *InstanceGroupManager) MarshalJSON() ([]byte, error)
type InstanceGroupManagerActionsSummary struct {
// Abandoning: [Output Only] The total number of instances in the
// managed instance group that are scheduled to be abandoned. Abandoning
// an instance removes it from the managed instance group without
// deleting it.
Abandoning int64 `json:"abandoning,omitempty"`
// Creating: [Output Only] The number of instances in the managed
// instance group that are scheduled to be created or are currently
// being created. If the group fails to create any of these instances,
// it tries again until it creates the instance successfully.
//
// If you have disabled creation retries, this field will not be
// populated; instead, the creatingWithoutRetries field will be
// populated.
Creating int64 `json:"creating,omitempty"`
// CreatingWithoutRetries: [Output Only] The number of instances that
// the managed instance group will attempt to create. The group attempts
// to create each instance only once. If the group fails to create any
// of these instances, it decreases the group's targetSize value
// accordingly.
CreatingWithoutRetries int64 `json:"creatingWithoutRetries,omitempty"`
// Deleting: [Output Only] The number of instances in the managed
// instance group that are scheduled to be deleted or are currently
// being deleted.
Deleting int64 `json:"deleting,omitempty"`
// None: [Output Only] The number of instances in the managed instance
// group that are running and have no scheduled actions.
None int64 `json:"none,omitempty"`
// Recreating: [Output Only] The number of instances in the managed
// instance group that are scheduled to be recreated or are currently
// being being recreated. Recreating an instance deletes the existing
// root persistent disk and creates a new disk from the image that is
// defined in the instance template.
Recreating int64 `json:"recreating,omitempty"`
// Refreshing: [Output Only] The number of instances in the managed
// instance group that are being reconfigured with properties that do
// not require a restart or a recreate action. For example, setting or
// removing target pools for the instance.
Refreshing int64 `json:"refreshing,omitempty"`
// Restarting: [Output Only] The number of instances in the managed
// instance group that are scheduled to be restarted or are currently
// being restarted.
Restarting int64 `json:"restarting,omitempty"`
// ForceSendFields is a list of field names (e.g. "Abandoning") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Abandoning") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagerActionsSummary) MarshalJSON() ([]byte, error)
type InstanceGroupManagerAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InstanceGroupManagersScopedList resources.
Items map[string]InstanceGroupManagersScopedList `json:"items,omitempty"`
// Kind: [Output Only] The resource type, which is always
// compute#instanceGroupManagerAggregatedList for an aggregated list of
// managed instance groups.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InstanceGroupManagerAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagerAggregatedList) MarshalJSON() ([]byte, error)
type InstanceGroupManagerAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstanceGroupManagerAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceGroupManagerAggregatedListWarning: [Output Only] Informational warning message.
func (s *InstanceGroupManagerAggregatedListWarning) MarshalJSON() ([]byte, error)
type InstanceGroupManagerAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagerAggregatedListWarningData) MarshalJSON() ([]byte, error)
type InstanceGroupManagerList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InstanceGroupManager resources.
Items []*InstanceGroupManager `json:"items,omitempty"`
// Kind: [Output Only] The resource type, which is always
// compute#instanceGroupManagerList for a list of managed instance
// groups.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InstanceGroupManagerListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceGroupManagerList: [Output Only] A list of managed instance groups.
func (s *InstanceGroupManagerList) MarshalJSON() ([]byte, error)
type InstanceGroupManagerListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstanceGroupManagerListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceGroupManagerListWarning: [Output Only] Informational warning message.
func (s *InstanceGroupManagerListWarning) MarshalJSON() ([]byte, error)
type InstanceGroupManagerListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagerListWarningData) MarshalJSON() ([]byte, error)
type InstanceGroupManagersAbandonInstancesCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersAbandonInstancesCall) Context(ctx context.Context) *InstanceGroupManagersAbandonInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersAbandonInstancesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroupManagers.abandonInstances" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersAbandonInstancesCall) Fields(s ...googleapi.Field) *InstanceGroupManagersAbandonInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersAbandonInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersAbandonInstancesCall) RequestId(requestId string) *InstanceGroupManagersAbandonInstancesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupManagersAbandonInstancesRequest struct {
// Instances: The URLs of one or more instances to abandon. This can be
// a full URL or a partial URL, such as
// zones/[ZONE]/instances/[INSTANCE_NAME].
Instances []string `json:"instances,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagersAbandonInstancesRequest) MarshalJSON() ([]byte, error)
type InstanceGroupManagersAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersAggregatedListCall) Context(ctx context.Context) *InstanceGroupManagersAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersAggregatedListCall) Do(opts ...googleapi.CallOption) (*InstanceGroupManagerAggregatedList, error)
Do executes the "compute.instanceGroupManagers.aggregatedList" call. Exactly one of *InstanceGroupManagerAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceGroupManagerAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersAggregatedListCall) Fields(s ...googleapi.Field) *InstanceGroupManagersAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersAggregatedListCall) Filter(filter string) *InstanceGroupManagersAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InstanceGroupManagersAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersAggregatedListCall) IfNoneMatch(entityTag string) *InstanceGroupManagersAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InstanceGroupManagersAggregatedListCall) MaxResults(maxResults int64) *InstanceGroupManagersAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *InstanceGroupManagersAggregatedListCall) OrderBy(orderBy string) *InstanceGroupManagersAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *InstanceGroupManagersAggregatedListCall) PageToken(pageToken string) *InstanceGroupManagersAggregatedListCall
PageToken sets the optional parameter "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.
func (c *InstanceGroupManagersAggregatedListCall) Pages(ctx context.Context, f func(*InstanceGroupManagerAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InstanceGroupManagersDeleteCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersDeleteCall) Context(ctx context.Context) *InstanceGroupManagersDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroupManagers.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersDeleteCall) Fields(s ...googleapi.Field) *InstanceGroupManagersDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersDeleteCall) RequestId(requestId string) *InstanceGroupManagersDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupManagersDeleteInstancesCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersDeleteInstancesCall) Context(ctx context.Context) *InstanceGroupManagersDeleteInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersDeleteInstancesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroupManagers.deleteInstances" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersDeleteInstancesCall) Fields(s ...googleapi.Field) *InstanceGroupManagersDeleteInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersDeleteInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersDeleteInstancesCall) RequestId(requestId string) *InstanceGroupManagersDeleteInstancesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupManagersDeleteInstancesRequest struct {
// Instances: The URLs of one or more instances to delete. This can be a
// full URL or a partial URL, such as
// zones/[ZONE]/instances/[INSTANCE_NAME].
Instances []string `json:"instances,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagersDeleteInstancesRequest) MarshalJSON() ([]byte, error)
type InstanceGroupManagersGetCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersGetCall) Context(ctx context.Context) *InstanceGroupManagersGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersGetCall) Do(opts ...googleapi.CallOption) (*InstanceGroupManager, error)
Do executes the "compute.instanceGroupManagers.get" call. Exactly one of *InstanceGroupManager or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceGroupManager.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersGetCall) Fields(s ...googleapi.Field) *InstanceGroupManagersGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersGetCall) IfNoneMatch(entityTag string) *InstanceGroupManagersGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type InstanceGroupManagersInsertCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersInsertCall) Context(ctx context.Context) *InstanceGroupManagersInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroupManagers.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersInsertCall) Fields(s ...googleapi.Field) *InstanceGroupManagersInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersInsertCall) RequestId(requestId string) *InstanceGroupManagersInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupManagersListCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersListCall) Context(ctx context.Context) *InstanceGroupManagersListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersListCall) Do(opts ...googleapi.CallOption) (*InstanceGroupManagerList, error)
Do executes the "compute.instanceGroupManagers.list" call. Exactly one of *InstanceGroupManagerList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceGroupManagerList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersListCall) Fields(s ...googleapi.Field) *InstanceGroupManagersListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersListCall) Filter(filter string) *InstanceGroupManagersListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InstanceGroupManagersListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersListCall) IfNoneMatch(entityTag string) *InstanceGroupManagersListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InstanceGroupManagersListCall) MaxResults(maxResults int64) *InstanceGroupManagersListCall
MaxResults sets the optional parameter "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)
func (c *InstanceGroupManagersListCall) OrderBy(orderBy string) *InstanceGroupManagersListCall
OrderBy sets the optional parameter "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.
func (c *InstanceGroupManagersListCall) PageToken(pageToken string) *InstanceGroupManagersListCall
PageToken sets the optional parameter "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.
func (c *InstanceGroupManagersListCall) Pages(ctx context.Context, f func(*InstanceGroupManagerList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InstanceGroupManagersListManagedInstancesCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersListManagedInstancesCall) Context(ctx context.Context) *InstanceGroupManagersListManagedInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersListManagedInstancesCall) Do(opts ...googleapi.CallOption) (*InstanceGroupManagersListManagedInstancesResponse, error)
Do executes the "compute.instanceGroupManagers.listManagedInstances" call. Exactly one of *InstanceGroupManagersListManagedInstancesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceGroupManagersListManagedInstancesResponse.ServerResponse.Head er or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersListManagedInstancesCall) Fields(s ...googleapi.Field) *InstanceGroupManagersListManagedInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersListManagedInstancesCall) Filter(filter string) *InstanceGroupManagersListManagedInstancesCall
Filter sets the optional parameter "filter":
func (c *InstanceGroupManagersListManagedInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersListManagedInstancesCall) MaxResults(maxResults int64) *InstanceGroupManagersListManagedInstancesCall
MaxResults sets the optional parameter "maxResults":
func (c *InstanceGroupManagersListManagedInstancesCall) OrderBy(orderBy string) *InstanceGroupManagersListManagedInstancesCall
OrderBy sets the optional parameter "order_by":
func (c *InstanceGroupManagersListManagedInstancesCall) PageToken(pageToken string) *InstanceGroupManagersListManagedInstancesCall
PageToken sets the optional parameter "pageToken":
type InstanceGroupManagersListManagedInstancesResponse struct {
// ManagedInstances: [Output Only] The list of instances in the managed
// instance group.
ManagedInstances []*ManagedInstance `json:"managedInstances,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "ManagedInstances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ManagedInstances") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagersListManagedInstancesResponse) MarshalJSON() ([]byte, error)
type InstanceGroupManagersRecreateInstancesCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersRecreateInstancesCall) Context(ctx context.Context) *InstanceGroupManagersRecreateInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersRecreateInstancesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroupManagers.recreateInstances" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersRecreateInstancesCall) Fields(s ...googleapi.Field) *InstanceGroupManagersRecreateInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersRecreateInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersRecreateInstancesCall) RequestId(requestId string) *InstanceGroupManagersRecreateInstancesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupManagersRecreateInstancesRequest struct {
// Instances: The URLs of one or more instances to recreate. This can be
// a full URL or a partial URL, such as
// zones/[ZONE]/instances/[INSTANCE_NAME].
Instances []string `json:"instances,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagersRecreateInstancesRequest) MarshalJSON() ([]byte, error)
type InstanceGroupManagersResizeCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersResizeCall) Context(ctx context.Context) *InstanceGroupManagersResizeCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersResizeCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroupManagers.resize" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersResizeCall) Fields(s ...googleapi.Field) *InstanceGroupManagersResizeCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersResizeCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersResizeCall) RequestId(requestId string) *InstanceGroupManagersResizeCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupManagersScopedList struct {
// InstanceGroupManagers: [Output Only] The list of managed instance
// groups that are contained in the specified project and zone.
InstanceGroupManagers []*InstanceGroupManager `json:"instanceGroupManagers,omitempty"`
// Warning: [Output Only] The warning that replaces the list of managed
// instance groups when the list is empty.
Warning *InstanceGroupManagersScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g.
// "InstanceGroupManagers") to unconditionally include in API requests.
// By default, fields with empty values are omitted from API requests.
// However, any non-pointer, non-interface field appearing in
// ForceSendFields will be sent to the server regardless of whether the
// field is empty or not. This may be used to include empty fields in
// Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "InstanceGroupManagers") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagersScopedList) MarshalJSON() ([]byte, error)
type InstanceGroupManagersScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstanceGroupManagersScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceGroupManagersScopedListWarning: [Output Only] The warning that replaces the list of managed instance groups when the list is empty.
func (s *InstanceGroupManagersScopedListWarning) MarshalJSON() ([]byte, error)
type InstanceGroupManagersScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagersScopedListWarningData) MarshalJSON() ([]byte, error)
type InstanceGroupManagersService struct {
// contains filtered or unexported fields
}func NewInstanceGroupManagersService(s *Service) *InstanceGroupManagersService
func (r *InstanceGroupManagersService) AbandonInstances(project string, zone string, instanceGroupManager string, instancegroupmanagersabandoninstancesrequest *InstanceGroupManagersAbandonInstancesRequest) *InstanceGroupManagersAbandonInstancesCall
AbandonInstances: Schedules a group action to remove the specified instances from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
func (r *InstanceGroupManagersService) AggregatedList(project string) *InstanceGroupManagersAggregatedListCall
AggregatedList: Retrieves the list of managed instance groups and groups them by zone.
func (r *InstanceGroupManagersService) Delete(project string, zone string, instanceGroupManager string) *InstanceGroupManagersDeleteCall
Delete: Deletes the specified managed instance group and all of the instances in that group. Note that the instance group must not belong to a backend service. Read Deleting an instance group for more information.
func (r *InstanceGroupManagersService) DeleteInstances(project string, zone string, instanceGroupManager string, instancegroupmanagersdeleteinstancesrequest *InstanceGroupManagersDeleteInstancesRequest) *InstanceGroupManagersDeleteInstancesCall
DeleteInstances: Schedules a group action to delete the specified instances in the managed instance group. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
func (r *InstanceGroupManagersService) Get(project string, zone string, instanceGroupManager string) *InstanceGroupManagersGetCall
Get: Returns all of the details about the specified managed instance group. Get a list of available managed instance groups by making a list() request.
func (r *InstanceGroupManagersService) Insert(project string, zone string, instancegroupmanager *InstanceGroupManager) *InstanceGroupManagersInsertCall
Insert: Creates a managed instance group using the information that you specify in the request. After the group is created, it schedules an action to create instances in the group using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.
A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit.
func (r *InstanceGroupManagersService) List(project string, zone string) *InstanceGroupManagersListCall
List: Retrieves a list of managed instance groups that are contained within the specified project and zone.
func (r *InstanceGroupManagersService) ListManagedInstances(project string, zone string, instanceGroupManager string) *InstanceGroupManagersListManagedInstancesCall
ListManagedInstances: Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action.
func (r *InstanceGroupManagersService) RecreateInstances(project string, zone string, instanceGroupManager string, instancegroupmanagersrecreateinstancesrequest *InstanceGroupManagersRecreateInstancesRequest) *InstanceGroupManagersRecreateInstancesCall
RecreateInstances: Schedules a group action to recreate the specified instances in the managed instance group. The instances are deleted and recreated using the current instance template for the managed instance group. This operation is marked as DONE when the action is scheduled even if the instances have not yet been recreated. You must separately verify the status of the recreating action with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
func (r *InstanceGroupManagersService) Resize(project string, zone string, instanceGroupManager string, size int64) *InstanceGroupManagersResizeCall
Resize: Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
func (r *InstanceGroupManagersService) SetInstanceTemplate(project string, zone string, instanceGroupManager string, instancegroupmanagerssetinstancetemplaterequest *InstanceGroupManagersSetInstanceTemplateRequest) *InstanceGroupManagersSetInstanceTemplateCall
SetInstanceTemplate: Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you recreate them.
func (r *InstanceGroupManagersService) SetTargetPools(project string, zone string, instanceGroupManager string, instancegroupmanagerssettargetpoolsrequest *InstanceGroupManagersSetTargetPoolsRequest) *InstanceGroupManagersSetTargetPoolsCall
SetTargetPools: Modifies the target pools to which all instances in this managed instance group are assigned. The target pools automatically apply to all of the instances in the managed instance group. This operation is marked DONE when you make the request even if the instances have not yet been added to their target pools. The change might take some time to apply to all of the instances in the group depending on the size of the group.
type InstanceGroupManagersSetInstanceTemplateCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersSetInstanceTemplateCall) Context(ctx context.Context) *InstanceGroupManagersSetInstanceTemplateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersSetInstanceTemplateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroupManagers.setInstanceTemplate" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersSetInstanceTemplateCall) Fields(s ...googleapi.Field) *InstanceGroupManagersSetInstanceTemplateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersSetInstanceTemplateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersSetInstanceTemplateCall) RequestId(requestId string) *InstanceGroupManagersSetInstanceTemplateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupManagersSetInstanceTemplateRequest struct {
// InstanceTemplate: The URL of the instance template that is specified
// for this managed instance group. The group uses this template to
// create all new instances in the managed instance group.
InstanceTemplate string `json:"instanceTemplate,omitempty"`
// ForceSendFields is a list of field names (e.g. "InstanceTemplate") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "InstanceTemplate") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagersSetInstanceTemplateRequest) MarshalJSON() ([]byte, error)
type InstanceGroupManagersSetTargetPoolsCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupManagersSetTargetPoolsCall) Context(ctx context.Context) *InstanceGroupManagersSetTargetPoolsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupManagersSetTargetPoolsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroupManagers.setTargetPools" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupManagersSetTargetPoolsCall) Fields(s ...googleapi.Field) *InstanceGroupManagersSetTargetPoolsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupManagersSetTargetPoolsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupManagersSetTargetPoolsCall) RequestId(requestId string) *InstanceGroupManagersSetTargetPoolsCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupManagersSetTargetPoolsRequest struct {
// Fingerprint: The fingerprint of the target pools information. Use
// this optional property to prevent conflicts when multiple users
// change the target pools settings concurrently. Obtain the fingerprint
// with the instanceGroupManagers.get method. Then, include the
// fingerprint in your request to ensure that you do not overwrite
// changes that were applied from another concurrent request.
Fingerprint string `json:"fingerprint,omitempty"`
// TargetPools: The list of target pool URLs that instances in this
// managed instance group belong to. The managed instance group applies
// these target pools to all of the instances in the group. Existing
// instances and new instances in the group all receive these target
// pool settings.
TargetPools []string `json:"targetPools,omitempty"`
// ForceSendFields is a list of field names (e.g. "Fingerprint") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Fingerprint") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupManagersSetTargetPoolsRequest) MarshalJSON() ([]byte, error)
type InstanceGroupsAddInstancesCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupsAddInstancesCall) Context(ctx context.Context) *InstanceGroupsAddInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupsAddInstancesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroups.addInstances" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupsAddInstancesCall) Fields(s ...googleapi.Field) *InstanceGroupsAddInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupsAddInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupsAddInstancesCall) RequestId(requestId string) *InstanceGroupsAddInstancesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupsAddInstancesRequest struct {
// Instances: The list of instances to add to the instance group.
Instances []*InstanceReference `json:"instances,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupsAddInstancesRequest) MarshalJSON() ([]byte, error)
type InstanceGroupsAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupsAggregatedListCall) Context(ctx context.Context) *InstanceGroupsAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupsAggregatedListCall) Do(opts ...googleapi.CallOption) (*InstanceGroupAggregatedList, error)
Do executes the "compute.instanceGroups.aggregatedList" call. Exactly one of *InstanceGroupAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceGroupAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupsAggregatedListCall) Fields(s ...googleapi.Field) *InstanceGroupsAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupsAggregatedListCall) Filter(filter string) *InstanceGroupsAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InstanceGroupsAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupsAggregatedListCall) IfNoneMatch(entityTag string) *InstanceGroupsAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InstanceGroupsAggregatedListCall) MaxResults(maxResults int64) *InstanceGroupsAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *InstanceGroupsAggregatedListCall) OrderBy(orderBy string) *InstanceGroupsAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *InstanceGroupsAggregatedListCall) PageToken(pageToken string) *InstanceGroupsAggregatedListCall
PageToken sets the optional parameter "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.
func (c *InstanceGroupsAggregatedListCall) Pages(ctx context.Context, f func(*InstanceGroupAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InstanceGroupsDeleteCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupsDeleteCall) Context(ctx context.Context) *InstanceGroupsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroups.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupsDeleteCall) Fields(s ...googleapi.Field) *InstanceGroupsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupsDeleteCall) RequestId(requestId string) *InstanceGroupsDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupsGetCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupsGetCall) Context(ctx context.Context) *InstanceGroupsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupsGetCall) Do(opts ...googleapi.CallOption) (*InstanceGroup, error)
Do executes the "compute.instanceGroups.get" call. Exactly one of *InstanceGroup or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceGroup.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupsGetCall) Fields(s ...googleapi.Field) *InstanceGroupsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupsGetCall) IfNoneMatch(entityTag string) *InstanceGroupsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type InstanceGroupsInsertCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupsInsertCall) Context(ctx context.Context) *InstanceGroupsInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroups.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupsInsertCall) Fields(s ...googleapi.Field) *InstanceGroupsInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupsInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupsInsertCall) RequestId(requestId string) *InstanceGroupsInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupsListCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupsListCall) Context(ctx context.Context) *InstanceGroupsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupsListCall) Do(opts ...googleapi.CallOption) (*InstanceGroupList, error)
Do executes the "compute.instanceGroups.list" call. Exactly one of *InstanceGroupList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceGroupList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupsListCall) Fields(s ...googleapi.Field) *InstanceGroupsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupsListCall) Filter(filter string) *InstanceGroupsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InstanceGroupsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupsListCall) IfNoneMatch(entityTag string) *InstanceGroupsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InstanceGroupsListCall) MaxResults(maxResults int64) *InstanceGroupsListCall
MaxResults sets the optional parameter "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)
func (c *InstanceGroupsListCall) OrderBy(orderBy string) *InstanceGroupsListCall
OrderBy sets the optional parameter "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.
func (c *InstanceGroupsListCall) PageToken(pageToken string) *InstanceGroupsListCall
PageToken sets the optional parameter "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.
func (c *InstanceGroupsListCall) Pages(ctx context.Context, f func(*InstanceGroupList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InstanceGroupsListInstances struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InstanceWithNamedPorts resources.
Items []*InstanceWithNamedPorts `json:"items,omitempty"`
// Kind: [Output Only] The resource type, which is always
// compute#instanceGroupsListInstances for the list of instances in the
// specified instance group.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InstanceGroupsListInstancesWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupsListInstances) MarshalJSON() ([]byte, error)
type InstanceGroupsListInstancesCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupsListInstancesCall) Context(ctx context.Context) *InstanceGroupsListInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupsListInstancesCall) Do(opts ...googleapi.CallOption) (*InstanceGroupsListInstances, error)
Do executes the "compute.instanceGroups.listInstances" call. Exactly one of *InstanceGroupsListInstances or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceGroupsListInstances.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupsListInstancesCall) Fields(s ...googleapi.Field) *InstanceGroupsListInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupsListInstancesCall) Filter(filter string) *InstanceGroupsListInstancesCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InstanceGroupsListInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupsListInstancesCall) MaxResults(maxResults int64) *InstanceGroupsListInstancesCall
MaxResults sets the optional parameter "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)
func (c *InstanceGroupsListInstancesCall) OrderBy(orderBy string) *InstanceGroupsListInstancesCall
OrderBy sets the optional parameter "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.
func (c *InstanceGroupsListInstancesCall) PageToken(pageToken string) *InstanceGroupsListInstancesCall
PageToken sets the optional parameter "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.
func (c *InstanceGroupsListInstancesCall) Pages(ctx context.Context, f func(*InstanceGroupsListInstances) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InstanceGroupsListInstancesRequest struct {
// InstanceState: A filter for the state of the instances in the
// instance group. Valid options are ALL or RUNNING. If you do not
// specify this parameter the list includes all instances regardless of
// their state.
//
// Possible values:
// "ALL"
// "RUNNING"
InstanceState string `json:"instanceState,omitempty"`
// ForceSendFields is a list of field names (e.g. "InstanceState") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "InstanceState") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupsListInstancesRequest) MarshalJSON() ([]byte, error)
type InstanceGroupsListInstancesWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstanceGroupsListInstancesWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceGroupsListInstancesWarning: [Output Only] Informational warning message.
func (s *InstanceGroupsListInstancesWarning) MarshalJSON() ([]byte, error)
type InstanceGroupsListInstancesWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupsListInstancesWarningData) MarshalJSON() ([]byte, error)
type InstanceGroupsRemoveInstancesCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupsRemoveInstancesCall) Context(ctx context.Context) *InstanceGroupsRemoveInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupsRemoveInstancesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroups.removeInstances" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupsRemoveInstancesCall) Fields(s ...googleapi.Field) *InstanceGroupsRemoveInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupsRemoveInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupsRemoveInstancesCall) RequestId(requestId string) *InstanceGroupsRemoveInstancesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupsRemoveInstancesRequest struct {
// Instances: The list of instances to remove from the instance group.
Instances []*InstanceReference `json:"instances,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupsRemoveInstancesRequest) MarshalJSON() ([]byte, error)
type InstanceGroupsScopedList struct {
// InstanceGroups: [Output Only] The list of instance groups that are
// contained in this scope.
InstanceGroups []*InstanceGroup `json:"instanceGroups,omitempty"`
// Warning: [Output Only] An informational warning that replaces the
// list of instance groups when the list is empty.
Warning *InstanceGroupsScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "InstanceGroups") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "InstanceGroups") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupsScopedList) MarshalJSON() ([]byte, error)
type InstanceGroupsScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstanceGroupsScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceGroupsScopedListWarning: [Output Only] An informational warning that replaces the list of instance groups when the list is empty.
func (s *InstanceGroupsScopedListWarning) MarshalJSON() ([]byte, error)
type InstanceGroupsScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupsScopedListWarningData) MarshalJSON() ([]byte, error)
type InstanceGroupsService struct {
// contains filtered or unexported fields
}func NewInstanceGroupsService(s *Service) *InstanceGroupsService
func (r *InstanceGroupsService) AddInstances(project string, zone string, instanceGroup string, instancegroupsaddinstancesrequest *InstanceGroupsAddInstancesRequest) *InstanceGroupsAddInstancesCall
AddInstances: Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information.
func (r *InstanceGroupsService) AggregatedList(project string) *InstanceGroupsAggregatedListCall
AggregatedList: Retrieves the list of instance groups and sorts them by zone.
func (r *InstanceGroupsService) Delete(project string, zone string, instanceGroup string) *InstanceGroupsDeleteCall
Delete: Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information.
func (r *InstanceGroupsService) Get(project string, zone string, instanceGroup string) *InstanceGroupsGetCall
Get: Returns the specified instance group. Get a list of available instance groups by making a list() request.
func (r *InstanceGroupsService) Insert(project string, zone string, instancegroup *InstanceGroup) *InstanceGroupsInsertCall
Insert: Creates an instance group in the specified project using the parameters that are included in the request.
func (r *InstanceGroupsService) List(project string, zone string) *InstanceGroupsListCall
List: Retrieves the list of instance groups that are located in the specified project and zone.
func (r *InstanceGroupsService) ListInstances(project string, zone string, instanceGroup string, instancegroupslistinstancesrequest *InstanceGroupsListInstancesRequest) *InstanceGroupsListInstancesCall
ListInstances: Lists the instances in the specified instance group.
func (r *InstanceGroupsService) RemoveInstances(project string, zone string, instanceGroup string, instancegroupsremoveinstancesrequest *InstanceGroupsRemoveInstancesRequest) *InstanceGroupsRemoveInstancesCall
RemoveInstances: Removes one or more instances from the specified instance group, but does not delete those instances.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration before the VM instance is removed or deleted.
func (r *InstanceGroupsService) SetNamedPorts(project string, zone string, instanceGroup string, instancegroupssetnamedportsrequest *InstanceGroupsSetNamedPortsRequest) *InstanceGroupsSetNamedPortsCall
SetNamedPorts: Sets the named ports for the specified instance group.
type InstanceGroupsSetNamedPortsCall struct {
// contains filtered or unexported fields
}func (c *InstanceGroupsSetNamedPortsCall) Context(ctx context.Context) *InstanceGroupsSetNamedPortsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceGroupsSetNamedPortsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceGroups.setNamedPorts" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceGroupsSetNamedPortsCall) Fields(s ...googleapi.Field) *InstanceGroupsSetNamedPortsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceGroupsSetNamedPortsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceGroupsSetNamedPortsCall) RequestId(requestId string) *InstanceGroupsSetNamedPortsCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceGroupsSetNamedPortsRequest struct {
// Fingerprint: The fingerprint of the named ports information for this
// instance group. Use this optional property to prevent conflicts when
// multiple users change the named ports settings concurrently. Obtain
// the fingerprint with the instanceGroups.get method. Then, include the
// fingerprint in your request to ensure that you do not overwrite
// changes that were applied from another concurrent request.
Fingerprint string `json:"fingerprint,omitempty"`
// NamedPorts: The list of named ports to set for this instance group.
NamedPorts []*NamedPort `json:"namedPorts,omitempty"`
// ForceSendFields is a list of field names (e.g. "Fingerprint") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Fingerprint") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceGroupsSetNamedPortsRequest) MarshalJSON() ([]byte, error)
type InstanceList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Instance resources.
Items []*Instance `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#instanceList for
// lists of Instance resources.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InstanceListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceList: Contains a list of instances.
func (s *InstanceList) MarshalJSON() ([]byte, error)
type InstanceListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstanceListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceListWarning: [Output Only] Informational warning message.
func (s *InstanceListWarning) MarshalJSON() ([]byte, error)
type InstanceListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceListWarningData) MarshalJSON() ([]byte, error)
type InstanceMoveRequest struct {
// DestinationZone: The URL of the destination zone to move the
// instance. This can be a full or partial URL. For example, the
// following are all valid URLs to a zone:
// - https://www.googleapis.com/compute/v1/projects/project/zones/zone
//
// - projects/project/zones/zone
// - zones/zone
DestinationZone string `json:"destinationZone,omitempty"`
// TargetInstance: The URL of the target instance to move. This can be a
// full or partial URL. For example, the following are all valid URLs to
// an instance:
// -
// https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
// - projects/project/zones/zone/instances/instance
// - zones/zone/instances/instance
TargetInstance string `json:"targetInstance,omitempty"`
// ForceSendFields is a list of field names (e.g. "DestinationZone") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "DestinationZone") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *InstanceMoveRequest) MarshalJSON() ([]byte, error)
type InstanceProperties struct {
// CanIpForward: Enables instances created based on this template to
// send packets with source IP addresses other than their own and
// receive packets with destination IP addresses other than their own.
// If these instances will be used as an IP gateway or it will be set as
// the next-hop in a Route resource, specify true. If unsure, leave this
// set to false. See the Enable IP forwarding documentation for more
// information.
CanIpForward bool `json:"canIpForward,omitempty"`
// Description: An optional text description for the instances that are
// created from this instance template.
Description string `json:"description,omitempty"`
// Disks: An array of disks that are associated with the instances that
// are created from this template.
Disks []*AttachedDisk `json:"disks,omitempty"`
// GuestAccelerators: A list of guest accelerator cards' type and count
// to use for instances created from the instance template.
GuestAccelerators []*AcceleratorConfig `json:"guestAccelerators,omitempty"`
// Labels: Labels to apply to instances that are created from this
// template.
Labels map[string]string `json:"labels,omitempty"`
// MachineType: The machine type to use for instances that are created
// from this template.
MachineType string `json:"machineType,omitempty"`
// Metadata: The metadata key/value pairs to assign to instances that
// are created from this template. These pairs can consist of custom
// metadata or predefined keys. See Project and instance metadata for
// more information.
Metadata *Metadata `json:"metadata,omitempty"`
// MinCpuPlatform: Minimum cpu/platform to be used by this instance. The
// instance may be scheduled on the specified or newer cpu/platform.
// Applicable values are the friendly names of CPU platforms, such as
// minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy
// Bridge". For more information, read Specifying a Minimum CPU
// Platform.
MinCpuPlatform string `json:"minCpuPlatform,omitempty"`
// NetworkInterfaces: An array of network access configurations for this
// interface.
NetworkInterfaces []*NetworkInterface `json:"networkInterfaces,omitempty"`
// Scheduling: Specifies the scheduling options for the instances that
// are created from this template.
Scheduling *Scheduling `json:"scheduling,omitempty"`
// ServiceAccounts: A list of service accounts with specified scopes.
// Access tokens for these service accounts are available to the
// instances that are created from this template. Use metadata queries
// to obtain the access tokens for these instances.
ServiceAccounts []*ServiceAccount `json:"serviceAccounts,omitempty"`
// Tags: A list of tags to apply to the instances that are created from
// this template. The tags identify valid sources or targets for network
// firewalls. The setTags method can modify this list of tags. Each tag
// within the list must comply with RFC1035.
Tags *Tags `json:"tags,omitempty"`
// ForceSendFields is a list of field names (e.g. "CanIpForward") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CanIpForward") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceProperties) MarshalJSON() ([]byte, error)
type InstanceReference struct {
// Instance: The URL for a specific instance.
Instance string `json:"instance,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instance") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instance") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceReference) MarshalJSON() ([]byte, error)
type InstanceTemplate struct {
// CreationTimestamp: [Output Only] The creation timestamp for this
// instance template in RFC3339 text format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] A unique identifier for this instance template. The
// server defines this identifier.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] The resource type, which is always
// compute#instanceTemplate for instance templates.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource; provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Properties: The instance properties for this instance template.
Properties *InstanceProperties `json:"properties,omitempty"`
// SelfLink: [Output Only] The URL for this instance template. The
// server defines this URL.
SelfLink string `json:"selfLink,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}InstanceTemplate: An Instance Template resource. (== resource_for beta.instanceTemplates ==) (== resource_for v1.instanceTemplates ==)
func (s *InstanceTemplate) MarshalJSON() ([]byte, error)
type InstanceTemplateList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InstanceTemplate resources.
Items []*InstanceTemplate `json:"items,omitempty"`
// Kind: [Output Only] The resource type, which is always
// compute#instanceTemplatesListResponse for instance template lists.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InstanceTemplateListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceTemplateList: A list of instance templates.
func (s *InstanceTemplateList) MarshalJSON() ([]byte, error)
type InstanceTemplateListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstanceTemplateListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstanceTemplateListWarning: [Output Only] Informational warning message.
func (s *InstanceTemplateListWarning) MarshalJSON() ([]byte, error)
type InstanceTemplateListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceTemplateListWarningData) MarshalJSON() ([]byte, error)
type InstanceTemplatesDeleteCall struct {
// contains filtered or unexported fields
}func (c *InstanceTemplatesDeleteCall) Context(ctx context.Context) *InstanceTemplatesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceTemplatesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceTemplates.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceTemplatesDeleteCall) Fields(s ...googleapi.Field) *InstanceTemplatesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceTemplatesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceTemplatesDeleteCall) RequestId(requestId string) *InstanceTemplatesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceTemplatesGetCall struct {
// contains filtered or unexported fields
}func (c *InstanceTemplatesGetCall) Context(ctx context.Context) *InstanceTemplatesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceTemplatesGetCall) Do(opts ...googleapi.CallOption) (*InstanceTemplate, error)
Do executes the "compute.instanceTemplates.get" call. Exactly one of *InstanceTemplate or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceTemplate.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceTemplatesGetCall) Fields(s ...googleapi.Field) *InstanceTemplatesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceTemplatesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceTemplatesGetCall) IfNoneMatch(entityTag string) *InstanceTemplatesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type InstanceTemplatesInsertCall struct {
// contains filtered or unexported fields
}func (c *InstanceTemplatesInsertCall) Context(ctx context.Context) *InstanceTemplatesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceTemplatesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instanceTemplates.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceTemplatesInsertCall) Fields(s ...googleapi.Field) *InstanceTemplatesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceTemplatesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceTemplatesInsertCall) RequestId(requestId string) *InstanceTemplatesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstanceTemplatesListCall struct {
// contains filtered or unexported fields
}func (c *InstanceTemplatesListCall) Context(ctx context.Context) *InstanceTemplatesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstanceTemplatesListCall) Do(opts ...googleapi.CallOption) (*InstanceTemplateList, error)
Do executes the "compute.instanceTemplates.list" call. Exactly one of *InstanceTemplateList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceTemplateList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstanceTemplatesListCall) Fields(s ...googleapi.Field) *InstanceTemplatesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstanceTemplatesListCall) Filter(filter string) *InstanceTemplatesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InstanceTemplatesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstanceTemplatesListCall) IfNoneMatch(entityTag string) *InstanceTemplatesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InstanceTemplatesListCall) MaxResults(maxResults int64) *InstanceTemplatesListCall
MaxResults sets the optional parameter "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)
func (c *InstanceTemplatesListCall) OrderBy(orderBy string) *InstanceTemplatesListCall
OrderBy sets the optional parameter "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.
func (c *InstanceTemplatesListCall) PageToken(pageToken string) *InstanceTemplatesListCall
PageToken sets the optional parameter "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.
func (c *InstanceTemplatesListCall) Pages(ctx context.Context, f func(*InstanceTemplateList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InstanceTemplatesService struct {
// contains filtered or unexported fields
}func NewInstanceTemplatesService(s *Service) *InstanceTemplatesService
func (r *InstanceTemplatesService) Delete(project string, instanceTemplate string) *InstanceTemplatesDeleteCall
Delete: Deletes the specified instance template. If you delete an instance template that is being referenced from another instance group, the instance group will not be able to create or recreate virtual machine instances. Deleting an instance template is permanent and cannot be undone. For details, see https://cloud.google.com/compute/docs/reference/latest/instanceTemplates/delete
func (r *InstanceTemplatesService) Get(project string, instanceTemplate string) *InstanceTemplatesGetCall
Get: Returns the specified instance template. Get a list of available instance templates by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/instanceTemplates/get
func (r *InstanceTemplatesService) Insert(project string, instancetemplate *InstanceTemplate) *InstanceTemplatesInsertCall
Insert: Creates an instance template in the specified project using the data that is included in the request. If you are creating a new template to update an existing instance group, your new instance template must use the same network or, if applicable, the same subnetwork as the original template. For details, see https://cloud.google.com/compute/docs/reference/latest/instanceTemplates/insert
func (r *InstanceTemplatesService) List(project string) *InstanceTemplatesListCall
List: Retrieves a list of instance templates that are contained within the specified project and zone. For details, see https://cloud.google.com/compute/docs/reference/latest/instanceTemplates/list
type InstanceWithNamedPorts struct {
// Instance: [Output Only] The URL of the instance.
Instance string `json:"instance,omitempty"`
// NamedPorts: [Output Only] The named ports that belong to this
// instance group.
NamedPorts []*NamedPort `json:"namedPorts,omitempty"`
// Status: [Output Only] The status of the instance.
//
// Possible values:
// "PROVISIONING"
// "RUNNING"
// "STAGING"
// "STOPPED"
// "STOPPING"
// "SUSPENDED"
// "SUSPENDING"
// "TERMINATED"
Status string `json:"status,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instance") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instance") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstanceWithNamedPorts) MarshalJSON() ([]byte, error)
type InstancesAddAccessConfigCall struct {
// contains filtered or unexported fields
}func (c *InstancesAddAccessConfigCall) Context(ctx context.Context) *InstancesAddAccessConfigCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesAddAccessConfigCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.addAccessConfig" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesAddAccessConfigCall) Fields(s ...googleapi.Field) *InstancesAddAccessConfigCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesAddAccessConfigCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesAddAccessConfigCall) RequestId(requestId string) *InstancesAddAccessConfigCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *InstancesAggregatedListCall) Context(ctx context.Context) *InstancesAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesAggregatedListCall) Do(opts ...googleapi.CallOption) (*InstanceAggregatedList, error)
Do executes the "compute.instances.aggregatedList" call. Exactly one of *InstanceAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesAggregatedListCall) Fields(s ...googleapi.Field) *InstancesAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesAggregatedListCall) Filter(filter string) *InstancesAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InstancesAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesAggregatedListCall) IfNoneMatch(entityTag string) *InstancesAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InstancesAggregatedListCall) MaxResults(maxResults int64) *InstancesAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *InstancesAggregatedListCall) OrderBy(orderBy string) *InstancesAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *InstancesAggregatedListCall) PageToken(pageToken string) *InstancesAggregatedListCall
PageToken sets the optional parameter "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.
func (c *InstancesAggregatedListCall) Pages(ctx context.Context, f func(*InstanceAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InstancesAttachDiskCall struct {
// contains filtered or unexported fields
}func (c *InstancesAttachDiskCall) Context(ctx context.Context) *InstancesAttachDiskCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesAttachDiskCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.attachDisk" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesAttachDiskCall) Fields(s ...googleapi.Field) *InstancesAttachDiskCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesAttachDiskCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesAttachDiskCall) RequestId(requestId string) *InstancesAttachDiskCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesDeleteAccessConfigCall struct {
// contains filtered or unexported fields
}func (c *InstancesDeleteAccessConfigCall) Context(ctx context.Context) *InstancesDeleteAccessConfigCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesDeleteAccessConfigCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.deleteAccessConfig" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesDeleteAccessConfigCall) Fields(s ...googleapi.Field) *InstancesDeleteAccessConfigCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesDeleteAccessConfigCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesDeleteAccessConfigCall) RequestId(requestId string) *InstancesDeleteAccessConfigCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesDeleteCall struct {
// contains filtered or unexported fields
}func (c *InstancesDeleteCall) Context(ctx context.Context) *InstancesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesDeleteCall) Fields(s ...googleapi.Field) *InstancesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesDeleteCall) RequestId(requestId string) *InstancesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesDetachDiskCall struct {
// contains filtered or unexported fields
}func (c *InstancesDetachDiskCall) Context(ctx context.Context) *InstancesDetachDiskCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesDetachDiskCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.detachDisk" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesDetachDiskCall) Fields(s ...googleapi.Field) *InstancesDetachDiskCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesDetachDiskCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesDetachDiskCall) RequestId(requestId string) *InstancesDetachDiskCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesGetCall struct {
// contains filtered or unexported fields
}func (c *InstancesGetCall) Context(ctx context.Context) *InstancesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesGetCall) Do(opts ...googleapi.CallOption) (*Instance, error)
Do executes the "compute.instances.get" call. Exactly one of *Instance or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Instance.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesGetCall) Fields(s ...googleapi.Field) *InstancesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesGetCall) IfNoneMatch(entityTag string) *InstancesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type InstancesGetSerialPortOutputCall struct {
// contains filtered or unexported fields
}func (c *InstancesGetSerialPortOutputCall) Context(ctx context.Context) *InstancesGetSerialPortOutputCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesGetSerialPortOutputCall) Do(opts ...googleapi.CallOption) (*SerialPortOutput, error)
Do executes the "compute.instances.getSerialPortOutput" call. Exactly one of *SerialPortOutput or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *SerialPortOutput.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesGetSerialPortOutputCall) Fields(s ...googleapi.Field) *InstancesGetSerialPortOutputCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesGetSerialPortOutputCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesGetSerialPortOutputCall) IfNoneMatch(entityTag string) *InstancesGetSerialPortOutputCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InstancesGetSerialPortOutputCall) Port(port int64) *InstancesGetSerialPortOutputCall
Port sets the optional parameter "port": Specifies which COM or serial port to retrieve data from.
func (c *InstancesGetSerialPortOutputCall) Start(start int64) *InstancesGetSerialPortOutputCall
Start sets the optional parameter "start": Returns output starting from a specific byte position. Use this to page through output when the output is too large to return in a single request. For the initial request, leave this field unspecified. For subsequent calls, this field should be set to the next value returned in the previous call.
type InstancesInsertCall struct {
// contains filtered or unexported fields
}func (c *InstancesInsertCall) Context(ctx context.Context) *InstancesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesInsertCall) Fields(s ...googleapi.Field) *InstancesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesInsertCall) RequestId(requestId string) *InstancesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesListCall struct {
// contains filtered or unexported fields
}func (c *InstancesListCall) Context(ctx context.Context) *InstancesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesListCall) Do(opts ...googleapi.CallOption) (*InstanceList, error)
Do executes the "compute.instances.list" call. Exactly one of *InstanceList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesListCall) Fields(s ...googleapi.Field) *InstancesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesListCall) Filter(filter string) *InstancesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InstancesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesListCall) IfNoneMatch(entityTag string) *InstancesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InstancesListCall) MaxResults(maxResults int64) *InstancesListCall
MaxResults sets the optional parameter "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)
func (c *InstancesListCall) OrderBy(orderBy string) *InstancesListCall
OrderBy sets the optional parameter "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.
func (c *InstancesListCall) PageToken(pageToken string) *InstancesListCall
PageToken sets the optional parameter "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.
func (c *InstancesListCall) Pages(ctx context.Context, f func(*InstanceList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InstancesResetCall struct {
// contains filtered or unexported fields
}func (c *InstancesResetCall) Context(ctx context.Context) *InstancesResetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesResetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.reset" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesResetCall) Fields(s ...googleapi.Field) *InstancesResetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesResetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesResetCall) RequestId(requestId string) *InstancesResetCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesScopedList struct {
// Instances: [Output Only] List of instances contained in this scope.
Instances []*Instance `json:"instances,omitempty"`
// Warning: [Output Only] Informational warning which replaces the list
// of instances when the list is empty.
Warning *InstancesScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstancesScopedList) MarshalJSON() ([]byte, error)
type InstancesScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InstancesScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InstancesScopedListWarning: [Output Only] Informational warning which replaces the list of instances when the list is empty.
func (s *InstancesScopedListWarning) MarshalJSON() ([]byte, error)
type InstancesScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstancesScopedListWarningData) MarshalJSON() ([]byte, error)
type InstancesService struct {
// contains filtered or unexported fields
}func NewInstancesService(s *Service) *InstancesService
func (r *InstancesService) AddAccessConfig(project string, zone string, instance string, networkInterface string, accessconfig *AccessConfig) *InstancesAddAccessConfigCall
AddAccessConfig: Adds an access config to an instance's network interface. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/addAccessConfig
func (r *InstancesService) AggregatedList(project string) *InstancesAggregatedListCall
AggregatedList: Retrieves aggregated list of instances. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/aggregatedList
func (r *InstancesService) AttachDisk(project string, zone string, instance string, attacheddisk *AttachedDisk) *InstancesAttachDiskCall
AttachDisk: Attaches an existing Disk resource to an instance. You must first create the disk before you can attach it. It is not possible to create and attach a disk at the same time. For more information, read Adding a persistent disk to your instance. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/attachDisk
func (r *InstancesService) Delete(project string, zone string, instance string) *InstancesDeleteCall
Delete: Deletes the specified Instance resource. For more information, see Stopping or Deleting an Instance. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/delete
func (r *InstancesService) DeleteAccessConfig(project string, zone string, instance string, accessConfig string, networkInterface string) *InstancesDeleteAccessConfigCall
DeleteAccessConfig: Deletes an access config from an instance's network interface. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/deleteAccessConfig
func (r *InstancesService) DetachDisk(project string, zone string, instance string, deviceName string) *InstancesDetachDiskCall
DetachDisk: Detaches a disk from an instance. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/detachDisk
func (r *InstancesService) Get(project string, zone string, instance string) *InstancesGetCall
Get: Returns the specified Instance resource. Get a list of available instances by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/get
func (r *InstancesService) GetSerialPortOutput(project string, zone string, instance string) *InstancesGetSerialPortOutputCall
GetSerialPortOutput: Returns the specified instance's serial port output. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/getSerialPortOutput
func (r *InstancesService) Insert(project string, zone string, instance *Instance) *InstancesInsertCall
Insert: Creates an instance resource in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/insert
func (r *InstancesService) List(project string, zone string) *InstancesListCall
List: Retrieves the list of instances contained within the specified zone. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/list
func (r *InstancesService) Reset(project string, zone string, instance string) *InstancesResetCall
Reset: Performs a reset on the instance. For more information, see Resetting an instance. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/reset
func (r *InstancesService) SetDeletionProtection(project string, zone string, resource string) *InstancesSetDeletionProtectionCall
SetDeletionProtection: Sets deletion protection on the instance.
func (r *InstancesService) SetDiskAutoDelete(project string, zone string, instance string, autoDelete bool, deviceName string) *InstancesSetDiskAutoDeleteCall
SetDiskAutoDelete: Sets the auto-delete flag for a disk attached to an instance. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/setDiskAutoDelete
func (r *InstancesService) SetLabels(project string, zone string, instance string, instancessetlabelsrequest *InstancesSetLabelsRequest) *InstancesSetLabelsCall
SetLabels: Sets labels on an instance. To learn more about labels, read the Labeling Resources documentation.
func (r *InstancesService) SetMachineResources(project string, zone string, instance string, instancessetmachineresourcesrequest *InstancesSetMachineResourcesRequest) *InstancesSetMachineResourcesCall
SetMachineResources: Changes the number and/or type of accelerator for a stopped instance to the values specified in the request.
func (r *InstancesService) SetMachineType(project string, zone string, instance string, instancessetmachinetyperequest *InstancesSetMachineTypeRequest) *InstancesSetMachineTypeCall
SetMachineType: Changes the machine type for a stopped instance to the machine type specified in the request.
func (r *InstancesService) SetMetadata(project string, zone string, instance string, metadata *Metadata) *InstancesSetMetadataCall
SetMetadata: Sets metadata for the specified instance to the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/setMetadata
func (r *InstancesService) SetMinCpuPlatform(project string, zone string, instance string, instancessetmincpuplatformrequest *InstancesSetMinCpuPlatformRequest) *InstancesSetMinCpuPlatformCall
SetMinCpuPlatform: Changes the minimum CPU platform that this instance should use. This method can only be called on a stopped instance. For more information, read Specifying a Minimum CPU Platform.
func (r *InstancesService) SetScheduling(project string, zone string, instance string, scheduling *Scheduling) *InstancesSetSchedulingCall
SetScheduling: Sets an instance's scheduling options. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/setScheduling
func (r *InstancesService) SetServiceAccount(project string, zone string, instance string, instancessetserviceaccountrequest *InstancesSetServiceAccountRequest) *InstancesSetServiceAccountCall
SetServiceAccount: Sets the service account on the instance. For more information, read Changing the service account and access scopes for an instance.
func (r *InstancesService) SetTags(project string, zone string, instance string, tags *Tags) *InstancesSetTagsCall
SetTags: Sets tags for the specified instance to the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/setTags
func (r *InstancesService) Start(project string, zone string, instance string) *InstancesStartCall
Start: Starts an instance that was stopped using the using the instances().stop method. For more information, see Restart an instance. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/start
func (r *InstancesService) StartWithEncryptionKey(project string, zone string, instance string, instancesstartwithencryptionkeyrequest *InstancesStartWithEncryptionKeyRequest) *InstancesStartWithEncryptionKeyCall
StartWithEncryptionKey: Starts an instance that was stopped using the using the instances().stop method. For more information, see Restart an instance.
func (r *InstancesService) Stop(project string, zone string, instance string) *InstancesStopCall
Stop: Stops a running instance, shutting it down cleanly, and allows you to restart the instance at a later time. Stopped instances do not incur VM usage charges while they are stopped. However, resources that the VM is using, such as persistent disks and static IP addresses, will continue to be charged until they are deleted. For more information, see Stopping an instance. For details, see https://cloud.google.com/compute/docs/reference/latest/instances/stop
type InstancesSetDeletionProtectionCall struct {
// contains filtered or unexported fields
}func (c *InstancesSetDeletionProtectionCall) Context(ctx context.Context) *InstancesSetDeletionProtectionCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesSetDeletionProtectionCall) DeletionProtection(deletionProtection bool) *InstancesSetDeletionProtectionCall
DeletionProtection sets the optional parameter "deletionProtection": Whether the resource should be protected against deletion.
func (c *InstancesSetDeletionProtectionCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.setDeletionProtection" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesSetDeletionProtectionCall) Fields(s ...googleapi.Field) *InstancesSetDeletionProtectionCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesSetDeletionProtectionCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesSetDeletionProtectionCall) RequestId(requestId string) *InstancesSetDeletionProtectionCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesSetDiskAutoDeleteCall struct {
// contains filtered or unexported fields
}func (c *InstancesSetDiskAutoDeleteCall) Context(ctx context.Context) *InstancesSetDiskAutoDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesSetDiskAutoDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.setDiskAutoDelete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesSetDiskAutoDeleteCall) Fields(s ...googleapi.Field) *InstancesSetDiskAutoDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesSetDiskAutoDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesSetDiskAutoDeleteCall) RequestId(requestId string) *InstancesSetDiskAutoDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesSetLabelsCall struct {
// contains filtered or unexported fields
}func (c *InstancesSetLabelsCall) Context(ctx context.Context) *InstancesSetLabelsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesSetLabelsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.setLabels" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesSetLabelsCall) Fields(s ...googleapi.Field) *InstancesSetLabelsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesSetLabelsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesSetLabelsCall) RequestId(requestId string) *InstancesSetLabelsCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesSetLabelsRequest struct {
// LabelFingerprint: Fingerprint of the previous set of labels for this
// resource, used to prevent conflicts. Provide the latest fingerprint
// value when making a request to add or change labels.
LabelFingerprint string `json:"labelFingerprint,omitempty"`
Labels map[string]string `json:"labels,omitempty"`
// ForceSendFields is a list of field names (e.g. "LabelFingerprint") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "LabelFingerprint") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *InstancesSetLabelsRequest) MarshalJSON() ([]byte, error)
type InstancesSetMachineResourcesCall struct {
// contains filtered or unexported fields
}func (c *InstancesSetMachineResourcesCall) Context(ctx context.Context) *InstancesSetMachineResourcesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesSetMachineResourcesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.setMachineResources" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesSetMachineResourcesCall) Fields(s ...googleapi.Field) *InstancesSetMachineResourcesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesSetMachineResourcesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesSetMachineResourcesCall) RequestId(requestId string) *InstancesSetMachineResourcesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesSetMachineResourcesRequest struct {
// GuestAccelerators: List of the type and count of accelerator cards
// attached to the instance.
GuestAccelerators []*AcceleratorConfig `json:"guestAccelerators,omitempty"`
// ForceSendFields is a list of field names (e.g. "GuestAccelerators")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "GuestAccelerators") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *InstancesSetMachineResourcesRequest) MarshalJSON() ([]byte, error)
type InstancesSetMachineTypeCall struct {
// contains filtered or unexported fields
}func (c *InstancesSetMachineTypeCall) Context(ctx context.Context) *InstancesSetMachineTypeCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesSetMachineTypeCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.setMachineType" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesSetMachineTypeCall) Fields(s ...googleapi.Field) *InstancesSetMachineTypeCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesSetMachineTypeCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesSetMachineTypeCall) RequestId(requestId string) *InstancesSetMachineTypeCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesSetMachineTypeRequest struct {
// MachineType: Full or partial URL of the machine type resource. See
// Machine Types for a full list of machine types. For example:
// zones/us-central1-f/machineTypes/n1-standard-1
MachineType string `json:"machineType,omitempty"`
// ForceSendFields is a list of field names (e.g. "MachineType") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "MachineType") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstancesSetMachineTypeRequest) MarshalJSON() ([]byte, error)
type InstancesSetMetadataCall struct {
// contains filtered or unexported fields
}func (c *InstancesSetMetadataCall) Context(ctx context.Context) *InstancesSetMetadataCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesSetMetadataCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.setMetadata" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesSetMetadataCall) Fields(s ...googleapi.Field) *InstancesSetMetadataCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesSetMetadataCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesSetMetadataCall) RequestId(requestId string) *InstancesSetMetadataCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesSetMinCpuPlatformCall struct {
// contains filtered or unexported fields
}func (c *InstancesSetMinCpuPlatformCall) Context(ctx context.Context) *InstancesSetMinCpuPlatformCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesSetMinCpuPlatformCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.setMinCpuPlatform" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesSetMinCpuPlatformCall) Fields(s ...googleapi.Field) *InstancesSetMinCpuPlatformCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesSetMinCpuPlatformCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesSetMinCpuPlatformCall) RequestId(requestId string) *InstancesSetMinCpuPlatformCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesSetMinCpuPlatformRequest struct {
// MinCpuPlatform: Minimum cpu/platform this instance should be started
// at.
MinCpuPlatform string `json:"minCpuPlatform,omitempty"`
// ForceSendFields is a list of field names (e.g. "MinCpuPlatform") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "MinCpuPlatform") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *InstancesSetMinCpuPlatformRequest) MarshalJSON() ([]byte, error)
type InstancesSetSchedulingCall struct {
// contains filtered or unexported fields
}func (c *InstancesSetSchedulingCall) Context(ctx context.Context) *InstancesSetSchedulingCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesSetSchedulingCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.setScheduling" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesSetSchedulingCall) Fields(s ...googleapi.Field) *InstancesSetSchedulingCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesSetSchedulingCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesSetSchedulingCall) RequestId(requestId string) *InstancesSetSchedulingCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesSetServiceAccountCall struct {
// contains filtered or unexported fields
}func (c *InstancesSetServiceAccountCall) Context(ctx context.Context) *InstancesSetServiceAccountCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesSetServiceAccountCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.setServiceAccount" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesSetServiceAccountCall) Fields(s ...googleapi.Field) *InstancesSetServiceAccountCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesSetServiceAccountCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesSetServiceAccountCall) RequestId(requestId string) *InstancesSetServiceAccountCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesSetServiceAccountRequest struct {
// Email: Email address of the service account.
Email string `json:"email,omitempty"`
// Scopes: The list of scopes to be made available for this service
// account.
Scopes []string `json:"scopes,omitempty"`
// ForceSendFields is a list of field names (e.g. "Email") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Email") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstancesSetServiceAccountRequest) MarshalJSON() ([]byte, error)
type InstancesSetTagsCall struct {
// contains filtered or unexported fields
}func (c *InstancesSetTagsCall) Context(ctx context.Context) *InstancesSetTagsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesSetTagsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.setTags" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesSetTagsCall) Fields(s ...googleapi.Field) *InstancesSetTagsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesSetTagsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesSetTagsCall) RequestId(requestId string) *InstancesSetTagsCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesStartCall struct {
// contains filtered or unexported fields
}func (c *InstancesStartCall) Context(ctx context.Context) *InstancesStartCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesStartCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.start" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesStartCall) Fields(s ...googleapi.Field) *InstancesStartCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesStartCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesStartCall) RequestId(requestId string) *InstancesStartCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesStartWithEncryptionKeyCall struct {
// contains filtered or unexported fields
}func (c *InstancesStartWithEncryptionKeyCall) Context(ctx context.Context) *InstancesStartWithEncryptionKeyCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesStartWithEncryptionKeyCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.startWithEncryptionKey" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesStartWithEncryptionKeyCall) Fields(s ...googleapi.Field) *InstancesStartWithEncryptionKeyCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesStartWithEncryptionKeyCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesStartWithEncryptionKeyCall) RequestId(requestId string) *InstancesStartWithEncryptionKeyCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InstancesStartWithEncryptionKeyRequest struct {
// Disks: Array of disks associated with this instance that are
// protected with a customer-supplied encryption key.
//
// In order to start the instance, the disk url and its corresponding
// key must be provided.
//
// If the disk is not protected with a customer-supplied encryption key
// it should not be specified.
Disks []*CustomerEncryptionKeyProtectedDisk `json:"disks,omitempty"`
// ForceSendFields is a list of field names (e.g. "Disks") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Disks") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InstancesStartWithEncryptionKeyRequest) MarshalJSON() ([]byte, error)
type InstancesStopCall struct {
// contains filtered or unexported fields
}func (c *InstancesStopCall) Context(ctx context.Context) *InstancesStopCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InstancesStopCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.instances.stop" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InstancesStopCall) Fields(s ...googleapi.Field) *InstancesStopCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InstancesStopCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InstancesStopCall) RequestId(requestId string) *InstancesStopCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type Interconnect struct {
// AdminEnabled: Administrative status of the interconnect. When this is
// set to true, the Interconnect is functional and can carry traffic.
// When set to false, no packets can be carried over the interconnect
// and no BGP routes are exchanged over it. By default, the status is
// set to true.
AdminEnabled bool `json:"adminEnabled,omitempty"`
// CircuitInfos: [Output Only] List of CircuitInfo objects, that
// describe the individual circuits in this LAG.
CircuitInfos []*InterconnectCircuitInfo `json:"circuitInfos,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// CustomerName: Customer name, to put in the Letter of Authorization as
// the party authorized to request a crossconnect.
CustomerName string `json:"customerName,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// ExpectedOutages: [Output Only] List of outages expected for this
// Interconnect.
ExpectedOutages []*InterconnectOutageNotification `json:"expectedOutages,omitempty"`
// GoogleIpAddress: [Output Only] IP address configured on the Google
// side of the Interconnect link. This can be used only for ping tests.
GoogleIpAddress string `json:"googleIpAddress,omitempty"`
// GoogleReferenceId: [Output Only] Google reference ID; to be used when
// raising support tickets with Google or otherwise to debug backend
// connectivity issues.
GoogleReferenceId string `json:"googleReferenceId,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// InterconnectAttachments: [Output Only] A list of the URLs of all
// InterconnectAttachments configured to use this Interconnect.
InterconnectAttachments []string `json:"interconnectAttachments,omitempty"`
// InterconnectType: Type of interconnect. Note that "IT_PRIVATE" has
// been deprecated in favor of "DEDICATED"
//
// Possible values:
// "DEDICATED"
// "IT_PRIVATE"
InterconnectType string `json:"interconnectType,omitempty"`
// Kind: [Output Only] Type of the resource. Always compute#interconnect
// for interconnects.
Kind string `json:"kind,omitempty"`
// LinkType: Type of link requested. This field indicates speed of each
// of the links in the bundle, not the entire bundle. Only 10G per link
// is allowed for a dedicated interconnect. Options: Ethernet_10G_LR
//
// Possible values:
// "LINK_TYPE_ETHERNET_10G_LR"
LinkType string `json:"linkType,omitempty"`
// Location: URL of the InterconnectLocation object that represents
// where this connection is to be provisioned.
Location string `json:"location,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// NocContactEmail: Email address to contact the customer NOC for
// operations and maintenance notifications regarding this Interconnect.
// If specified, this will be used for notifications in addition to all
// other forms described, such as Stackdriver logs alerting and Cloud
// Notifications.
NocContactEmail string `json:"nocContactEmail,omitempty"`
// OperationalStatus: [Output Only] The current status of whether or not
// this Interconnect is functional.
//
// Possible values:
// "OS_ACTIVE"
// "OS_UNPROVISIONED"
OperationalStatus string `json:"operationalStatus,omitempty"`
// PeerIpAddress: [Output Only] IP address configured on the customer
// side of the Interconnect link. The customer should configure this IP
// address during turnup when prompted by Google NOC. This can be used
// only for ping tests.
PeerIpAddress string `json:"peerIpAddress,omitempty"`
// ProvisionedLinkCount: [Output Only] Number of links actually
// provisioned in this interconnect.
ProvisionedLinkCount int64 `json:"provisionedLinkCount,omitempty"`
// RequestedLinkCount: Target number of physical links in the link
// bundle, as requested by the customer.
RequestedLinkCount int64 `json:"requestedLinkCount,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "AdminEnabled") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AdminEnabled") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}Interconnect: Represents an Interconnects resource. The Interconnects resource is a dedicated connection between Google's network and your on-premises network. For more information, see the Dedicated overview page. (== resource_for v1.interconnects ==) (== resource_for beta.interconnects ==)
func (s *Interconnect) MarshalJSON() ([]byte, error)
type InterconnectAttachment struct {
// CloudRouterIpAddress: [Output Only] IPv4 address + prefix length to
// be configured on Cloud Router Interface for this interconnect
// attachment.
CloudRouterIpAddress string `json:"cloudRouterIpAddress,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// CustomerRouterIpAddress: [Output Only] IPv4 address + prefix length
// to be configured on the customer router subinterface for this
// interconnect attachment.
CustomerRouterIpAddress string `json:"customerRouterIpAddress,omitempty"`
// Description: An optional description of this resource.
Description string `json:"description,omitempty"`
// GoogleReferenceId: [Output Only] Google reference ID, to be used when
// raising support tickets with Google or otherwise to debug backend
// connectivity issues.
GoogleReferenceId string `json:"googleReferenceId,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Interconnect: URL of the underlying Interconnect object that this
// attachment's traffic will traverse through.
Interconnect string `json:"interconnect,omitempty"`
// Kind: [Output Only] Type of the resource. Always
// compute#interconnectAttachment for interconnect attachments.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// OperationalStatus: [Output Only] The current status of whether or not
// this interconnect attachment is functional.
//
// Possible values:
// "OS_ACTIVE"
// "OS_UNPROVISIONED"
OperationalStatus string `json:"operationalStatus,omitempty"`
// PrivateInterconnectInfo: [Output Only] Information specific to an
// InterconnectAttachment. This property is populated if the
// interconnect that this is attached to is of type DEDICATED.
PrivateInterconnectInfo *InterconnectAttachmentPrivateInfo `json:"privateInterconnectInfo,omitempty"`
// Region: [Output Only] URL of the region where the regional
// interconnect attachment resides.
Region string `json:"region,omitempty"`
// Router: URL of the cloud router to be used for dynamic routing. This
// router must be in the same region as this InterconnectAttachment. The
// InterconnectAttachment will automatically connect the Interconnect to
// the network & region within which the Cloud Router is configured.
Router string `json:"router,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g.
// "CloudRouterIpAddress") to unconditionally include in API requests.
// By default, fields with empty values are omitted from API requests.
// However, any non-pointer, non-interface field appearing in
// ForceSendFields will be sent to the server regardless of whether the
// field is empty or not. This may be used to include empty fields in
// Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CloudRouterIpAddress") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}InterconnectAttachment: Represents an InterconnectAttachment (VLAN attachment) resource. For more information, see Creating VLAN Attachments. (== resource_for beta.interconnectAttachments ==) (== resource_for v1.interconnectAttachments ==)
func (s *InterconnectAttachment) MarshalJSON() ([]byte, error)
type InterconnectAttachmentAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InterconnectAttachmentsScopedList resources.
Items map[string]InterconnectAttachmentsScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#interconnectAttachmentAggregatedList for aggregated lists of
// interconnect attachments.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InterconnectAttachmentAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InterconnectAttachmentAggregatedList) MarshalJSON() ([]byte, error)
type InterconnectAttachmentAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InterconnectAttachmentAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectAttachmentAggregatedListWarning: [Output Only] Informational warning message.
func (s *InterconnectAttachmentAggregatedListWarning) MarshalJSON() ([]byte, error)
type InterconnectAttachmentAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InterconnectAttachmentAggregatedListWarningData) MarshalJSON() ([]byte, error)
type InterconnectAttachmentList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InterconnectAttachment resources.
Items []*InterconnectAttachment `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#interconnectAttachmentList for lists of interconnect
// attachments.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InterconnectAttachmentListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectAttachmentList: Response to the list request, and contains a list of interconnect attachments.
func (s *InterconnectAttachmentList) MarshalJSON() ([]byte, error)
type InterconnectAttachmentListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InterconnectAttachmentListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectAttachmentListWarning: [Output Only] Informational warning message.
func (s *InterconnectAttachmentListWarning) MarshalJSON() ([]byte, error)
type InterconnectAttachmentListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InterconnectAttachmentListWarningData) MarshalJSON() ([]byte, error)
type InterconnectAttachmentPrivateInfo struct {
// Tag8021q: [Output Only] 802.1q encapsulation tag to be used for
// traffic between Google and the customer, going to and from this
// network and region.
Tag8021q int64 `json:"tag8021q,omitempty"`
// ForceSendFields is a list of field names (e.g. "Tag8021q") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Tag8021q") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectAttachmentPrivateInfo: Information for an interconnect attachment when this belongs to an interconnect of type DEDICATED.
func (s *InterconnectAttachmentPrivateInfo) MarshalJSON() ([]byte, error)
type InterconnectAttachmentsAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *InterconnectAttachmentsAggregatedListCall) Context(ctx context.Context) *InterconnectAttachmentsAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectAttachmentsAggregatedListCall) Do(opts ...googleapi.CallOption) (*InterconnectAttachmentAggregatedList, error)
Do executes the "compute.interconnectAttachments.aggregatedList" call. Exactly one of *InterconnectAttachmentAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InterconnectAttachmentAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectAttachmentsAggregatedListCall) Fields(s ...googleapi.Field) *InterconnectAttachmentsAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectAttachmentsAggregatedListCall) Filter(filter string) *InterconnectAttachmentsAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InterconnectAttachmentsAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectAttachmentsAggregatedListCall) IfNoneMatch(entityTag string) *InterconnectAttachmentsAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InterconnectAttachmentsAggregatedListCall) MaxResults(maxResults int64) *InterconnectAttachmentsAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *InterconnectAttachmentsAggregatedListCall) OrderBy(orderBy string) *InterconnectAttachmentsAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *InterconnectAttachmentsAggregatedListCall) PageToken(pageToken string) *InterconnectAttachmentsAggregatedListCall
PageToken sets the optional parameter "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.
func (c *InterconnectAttachmentsAggregatedListCall) Pages(ctx context.Context, f func(*InterconnectAttachmentAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InterconnectAttachmentsDeleteCall struct {
// contains filtered or unexported fields
}func (c *InterconnectAttachmentsDeleteCall) Context(ctx context.Context) *InterconnectAttachmentsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectAttachmentsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.interconnectAttachments.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectAttachmentsDeleteCall) Fields(s ...googleapi.Field) *InterconnectAttachmentsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectAttachmentsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectAttachmentsDeleteCall) RequestId(requestId string) *InterconnectAttachmentsDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InterconnectAttachmentsGetCall struct {
// contains filtered or unexported fields
}func (c *InterconnectAttachmentsGetCall) Context(ctx context.Context) *InterconnectAttachmentsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectAttachmentsGetCall) Do(opts ...googleapi.CallOption) (*InterconnectAttachment, error)
Do executes the "compute.interconnectAttachments.get" call. Exactly one of *InterconnectAttachment or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InterconnectAttachment.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectAttachmentsGetCall) Fields(s ...googleapi.Field) *InterconnectAttachmentsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectAttachmentsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectAttachmentsGetCall) IfNoneMatch(entityTag string) *InterconnectAttachmentsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type InterconnectAttachmentsInsertCall struct {
// contains filtered or unexported fields
}func (c *InterconnectAttachmentsInsertCall) Context(ctx context.Context) *InterconnectAttachmentsInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectAttachmentsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.interconnectAttachments.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectAttachmentsInsertCall) Fields(s ...googleapi.Field) *InterconnectAttachmentsInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectAttachmentsInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectAttachmentsInsertCall) RequestId(requestId string) *InterconnectAttachmentsInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InterconnectAttachmentsListCall struct {
// contains filtered or unexported fields
}func (c *InterconnectAttachmentsListCall) Context(ctx context.Context) *InterconnectAttachmentsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectAttachmentsListCall) Do(opts ...googleapi.CallOption) (*InterconnectAttachmentList, error)
Do executes the "compute.interconnectAttachments.list" call. Exactly one of *InterconnectAttachmentList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InterconnectAttachmentList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectAttachmentsListCall) Fields(s ...googleapi.Field) *InterconnectAttachmentsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectAttachmentsListCall) Filter(filter string) *InterconnectAttachmentsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InterconnectAttachmentsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectAttachmentsListCall) IfNoneMatch(entityTag string) *InterconnectAttachmentsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InterconnectAttachmentsListCall) MaxResults(maxResults int64) *InterconnectAttachmentsListCall
MaxResults sets the optional parameter "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)
func (c *InterconnectAttachmentsListCall) OrderBy(orderBy string) *InterconnectAttachmentsListCall
OrderBy sets the optional parameter "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.
func (c *InterconnectAttachmentsListCall) PageToken(pageToken string) *InterconnectAttachmentsListCall
PageToken sets the optional parameter "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.
func (c *InterconnectAttachmentsListCall) Pages(ctx context.Context, f func(*InterconnectAttachmentList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InterconnectAttachmentsScopedList struct {
// InterconnectAttachments: List of interconnect attachments contained
// in this scope.
InterconnectAttachments []*InterconnectAttachment `json:"interconnectAttachments,omitempty"`
// Warning: Informational warning which replaces the list of addresses
// when the list is empty.
Warning *InterconnectAttachmentsScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g.
// "InterconnectAttachments") to unconditionally include in API
// requests. By default, fields with empty values are omitted from API
// requests. However, any non-pointer, non-interface field appearing in
// ForceSendFields will be sent to the server regardless of whether the
// field is empty or not. This may be used to include empty fields in
// Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "InterconnectAttachments")
// to include in API requests with the JSON null value. By default,
// fields with empty values are omitted from API requests. However, any
// field with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *InterconnectAttachmentsScopedList) MarshalJSON() ([]byte, error)
type InterconnectAttachmentsScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InterconnectAttachmentsScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectAttachmentsScopedListWarning: Informational warning which replaces the list of addresses when the list is empty.
func (s *InterconnectAttachmentsScopedListWarning) MarshalJSON() ([]byte, error)
type InterconnectAttachmentsScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InterconnectAttachmentsScopedListWarningData) MarshalJSON() ([]byte, error)
type InterconnectAttachmentsService struct {
// contains filtered or unexported fields
}func NewInterconnectAttachmentsService(s *Service) *InterconnectAttachmentsService
func (r *InterconnectAttachmentsService) AggregatedList(project string) *InterconnectAttachmentsAggregatedListCall
AggregatedList: Retrieves an aggregated list of interconnect attachments.
func (r *InterconnectAttachmentsService) Delete(project string, region string, interconnectAttachment string) *InterconnectAttachmentsDeleteCall
Delete: Deletes the specified interconnect attachment.
func (r *InterconnectAttachmentsService) Get(project string, region string, interconnectAttachment string) *InterconnectAttachmentsGetCall
Get: Returns the specified interconnect attachment.
func (r *InterconnectAttachmentsService) Insert(project string, region string, interconnectattachment *InterconnectAttachment) *InterconnectAttachmentsInsertCall
Insert: Creates an InterconnectAttachment in the specified project using the data included in the request.
func (r *InterconnectAttachmentsService) List(project string, region string) *InterconnectAttachmentsListCall
List: Retrieves the list of interconnect attachments contained within the specified region.
type InterconnectCircuitInfo struct {
// CustomerDemarcId: Customer-side demarc ID for this circuit.
CustomerDemarcId string `json:"customerDemarcId,omitempty"`
// GoogleCircuitId: Google-assigned unique ID for this circuit. Assigned
// at circuit turn-up.
GoogleCircuitId string `json:"googleCircuitId,omitempty"`
// GoogleDemarcId: Google-side demarc ID for this circuit. Assigned at
// circuit turn-up and provided by Google to the customer in the LOA.
GoogleDemarcId string `json:"googleDemarcId,omitempty"`
// ForceSendFields is a list of field names (e.g. "CustomerDemarcId") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CustomerDemarcId") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}InterconnectCircuitInfo: Describes a single physical circuit between the Customer and Google. CircuitInfo objects are created by Google, so all fields are output only. Next id: 4
func (s *InterconnectCircuitInfo) MarshalJSON() ([]byte, error)
type InterconnectList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Interconnect resources.
Items []*Interconnect `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#interconnectList
// for lists of interconnects.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InterconnectListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectList: Response to the list request, and contains a list of interconnects.
func (s *InterconnectList) MarshalJSON() ([]byte, error)
type InterconnectListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InterconnectListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectListWarning: [Output Only] Informational warning message.
func (s *InterconnectListWarning) MarshalJSON() ([]byte, error)
type InterconnectListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InterconnectListWarningData) MarshalJSON() ([]byte, error)
type InterconnectLocation struct {
// Address: [Output Only] The postal address of the Point of Presence,
// each line in the address is separated by a newline character.
Address string `json:"address,omitempty"`
// AvailabilityZone: [Output Only] Availability zone for this location.
// Within a metropolitan area (metro), maintenance will not be
// simultaneously scheduled in more than one availability zone. Example:
// "zone1" or "zone2".
AvailabilityZone string `json:"availabilityZone,omitempty"`
// City: [Output Only] Metropolitan area designator that indicates which
// city an interconnect is located. For example: "Chicago, IL",
// "Amsterdam, Netherlands".
City string `json:"city,omitempty"`
// Continent: [Output Only] Continent for this location.
//
// Possible values:
// "AFRICA"
// "ASIA_PAC"
// "C_AFRICA"
// "C_ASIA_PAC"
// "C_EUROPE"
// "C_NORTH_AMERICA"
// "C_SOUTH_AMERICA"
// "EUROPE"
// "NORTH_AMERICA"
// "SOUTH_AMERICA"
Continent string `json:"continent,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: [Output Only] An optional description of the resource.
Description string `json:"description,omitempty"`
// FacilityProvider: [Output Only] The name of the provider for this
// facility (e.g., EQUINIX).
FacilityProvider string `json:"facilityProvider,omitempty"`
// FacilityProviderFacilityId: [Output Only] A provider-assigned
// Identifier for this facility (e.g., Ashburn-DC1).
FacilityProviderFacilityId string `json:"facilityProviderFacilityId,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always
// compute#interconnectLocation for interconnect locations.
Kind string `json:"kind,omitempty"`
// Name: [Output Only] Name of the resource.
Name string `json:"name,omitempty"`
// PeeringdbFacilityId: [Output Only] The peeringdb identifier for this
// facility (corresponding with a netfac type in peeringdb).
PeeringdbFacilityId string `json:"peeringdbFacilityId,omitempty"`
// RegionInfos: [Output Only] A list of InterconnectLocation.RegionInfo
// objects, that describe parameters pertaining to the relation between
// this InterconnectLocation and various Google Cloud regions.
RegionInfos []*InterconnectLocationRegionInfo `json:"regionInfos,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Address") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Address") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectLocation: Represents an InterconnectLocations resource. The InterconnectLocations resource describes the locations where you can connect to Google's networks. For more information, see Colocation Facilities.
func (s *InterconnectLocation) MarshalJSON() ([]byte, error)
type InterconnectLocationList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InterconnectLocation resources.
Items []*InterconnectLocation `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#interconnectLocationList for lists of interconnect locations.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *InterconnectLocationListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectLocationList: Response to the list request, and contains a list of interconnect locations.
func (s *InterconnectLocationList) MarshalJSON() ([]byte, error)
type InterconnectLocationListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*InterconnectLocationListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectLocationListWarning: [Output Only] Informational warning message.
func (s *InterconnectLocationListWarning) MarshalJSON() ([]byte, error)
type InterconnectLocationListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *InterconnectLocationListWarningData) MarshalJSON() ([]byte, error)
type InterconnectLocationRegionInfo struct {
// ExpectedRttMs: Expected round-trip time in milliseconds, from this
// InterconnectLocation to a VM in this region.
ExpectedRttMs int64 `json:"expectedRttMs,omitempty,string"`
// LocationPresence: Identifies the network presence of this location.
//
// Possible values:
// "GLOBAL"
// "LOCAL_REGION"
// "LP_GLOBAL"
// "LP_LOCAL_REGION"
LocationPresence string `json:"locationPresence,omitempty"`
// Region: URL for the region of this location.
Region string `json:"region,omitempty"`
// ForceSendFields is a list of field names (e.g. "ExpectedRttMs") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ExpectedRttMs") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}InterconnectLocationRegionInfo: Information about any potential InterconnectAttachments between an Interconnect at a specific InterconnectLocation, and a specific Cloud Region.
func (s *InterconnectLocationRegionInfo) MarshalJSON() ([]byte, error)
type InterconnectLocationsGetCall struct {
// contains filtered or unexported fields
}func (c *InterconnectLocationsGetCall) Context(ctx context.Context) *InterconnectLocationsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectLocationsGetCall) Do(opts ...googleapi.CallOption) (*InterconnectLocation, error)
Do executes the "compute.interconnectLocations.get" call. Exactly one of *InterconnectLocation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InterconnectLocation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectLocationsGetCall) Fields(s ...googleapi.Field) *InterconnectLocationsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectLocationsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectLocationsGetCall) IfNoneMatch(entityTag string) *InterconnectLocationsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type InterconnectLocationsListCall struct {
// contains filtered or unexported fields
}func (c *InterconnectLocationsListCall) Context(ctx context.Context) *InterconnectLocationsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectLocationsListCall) Do(opts ...googleapi.CallOption) (*InterconnectLocationList, error)
Do executes the "compute.interconnectLocations.list" call. Exactly one of *InterconnectLocationList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InterconnectLocationList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectLocationsListCall) Fields(s ...googleapi.Field) *InterconnectLocationsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectLocationsListCall) Filter(filter string) *InterconnectLocationsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InterconnectLocationsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectLocationsListCall) IfNoneMatch(entityTag string) *InterconnectLocationsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InterconnectLocationsListCall) MaxResults(maxResults int64) *InterconnectLocationsListCall
MaxResults sets the optional parameter "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)
func (c *InterconnectLocationsListCall) OrderBy(orderBy string) *InterconnectLocationsListCall
OrderBy sets the optional parameter "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.
func (c *InterconnectLocationsListCall) PageToken(pageToken string) *InterconnectLocationsListCall
PageToken sets the optional parameter "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.
func (c *InterconnectLocationsListCall) Pages(ctx context.Context, f func(*InterconnectLocationList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InterconnectLocationsService struct {
// contains filtered or unexported fields
}func NewInterconnectLocationsService(s *Service) *InterconnectLocationsService
func (r *InterconnectLocationsService) Get(project string, interconnectLocation string) *InterconnectLocationsGetCall
Get: Returns the details for the specified interconnect location. Get a list of available interconnect locations by making a list() request.
func (r *InterconnectLocationsService) List(project string) *InterconnectLocationsListCall
List: Retrieves the list of interconnect locations available to the specified project.
type InterconnectOutageNotification struct {
// AffectedCircuits: Iff issue_type is IT_PARTIAL_OUTAGE, a list of the
// Google-side circuit IDs that will be affected.
AffectedCircuits []string `json:"affectedCircuits,omitempty"`
// Description: A description about the purpose of the outage.
Description string `json:"description,omitempty"`
// EndTime: Scheduled end time for the outage (milliseconds since Unix
// epoch).
EndTime int64 `json:"endTime,omitempty,string"`
// IssueType: Form this outage is expected to take. Note that the "IT_"
// versions of this enum have been deprecated in favor of the unprefixed
// values.
//
// Possible values:
// "IT_OUTAGE"
// "IT_PARTIAL_OUTAGE"
// "OUTAGE"
// "PARTIAL_OUTAGE"
IssueType string `json:"issueType,omitempty"`
// Name: Unique identifier for this outage notification.
Name string `json:"name,omitempty"`
// Source: The party that generated this notification. Note that
// "NSRC_GOOGLE" has been deprecated in favor of "GOOGLE"
//
// Possible values:
// "GOOGLE"
// "NSRC_GOOGLE"
Source string `json:"source,omitempty"`
// StartTime: Scheduled start time for the outage (milliseconds since
// Unix epoch).
StartTime int64 `json:"startTime,omitempty,string"`
// State: State of this notification. Note that the "NS_" versions of
// this enum have been deprecated in favor of the unprefixed values.
//
// Possible values:
// "ACTIVE"
// "CANCELLED"
// "NS_ACTIVE"
// "NS_CANCELED"
State string `json:"state,omitempty"`
// ForceSendFields is a list of field names (e.g. "AffectedCircuits") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AffectedCircuits") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}InterconnectOutageNotification: Description of a planned outage on this Interconnect. Next id: 9
func (s *InterconnectOutageNotification) MarshalJSON() ([]byte, error)
type InterconnectsDeleteCall struct {
// contains filtered or unexported fields
}func (c *InterconnectsDeleteCall) Context(ctx context.Context) *InterconnectsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.interconnects.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectsDeleteCall) Fields(s ...googleapi.Field) *InterconnectsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectsDeleteCall) RequestId(requestId string) *InterconnectsDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InterconnectsGetCall struct {
// contains filtered or unexported fields
}func (c *InterconnectsGetCall) Context(ctx context.Context) *InterconnectsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectsGetCall) Do(opts ...googleapi.CallOption) (*Interconnect, error)
Do executes the "compute.interconnects.get" call. Exactly one of *Interconnect or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Interconnect.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectsGetCall) Fields(s ...googleapi.Field) *InterconnectsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectsGetCall) IfNoneMatch(entityTag string) *InterconnectsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type InterconnectsInsertCall struct {
// contains filtered or unexported fields
}func (c *InterconnectsInsertCall) Context(ctx context.Context) *InterconnectsInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.interconnects.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectsInsertCall) Fields(s ...googleapi.Field) *InterconnectsInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectsInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectsInsertCall) RequestId(requestId string) *InterconnectsInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InterconnectsListCall struct {
// contains filtered or unexported fields
}func (c *InterconnectsListCall) Context(ctx context.Context) *InterconnectsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectsListCall) Do(opts ...googleapi.CallOption) (*InterconnectList, error)
Do executes the "compute.interconnects.list" call. Exactly one of *InterconnectList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InterconnectList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectsListCall) Fields(s ...googleapi.Field) *InterconnectsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectsListCall) Filter(filter string) *InterconnectsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *InterconnectsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectsListCall) IfNoneMatch(entityTag string) *InterconnectsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *InterconnectsListCall) MaxResults(maxResults int64) *InterconnectsListCall
MaxResults sets the optional parameter "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)
func (c *InterconnectsListCall) OrderBy(orderBy string) *InterconnectsListCall
OrderBy sets the optional parameter "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.
func (c *InterconnectsListCall) PageToken(pageToken string) *InterconnectsListCall
PageToken sets the optional parameter "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.
func (c *InterconnectsListCall) Pages(ctx context.Context, f func(*InterconnectList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type InterconnectsPatchCall struct {
// contains filtered or unexported fields
}func (c *InterconnectsPatchCall) Context(ctx context.Context) *InterconnectsPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *InterconnectsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.interconnects.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *InterconnectsPatchCall) Fields(s ...googleapi.Field) *InterconnectsPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *InterconnectsPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *InterconnectsPatchCall) RequestId(requestId string) *InterconnectsPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type InterconnectsService struct {
// contains filtered or unexported fields
}func NewInterconnectsService(s *Service) *InterconnectsService
func (r *InterconnectsService) Delete(project string, interconnect string) *InterconnectsDeleteCall
Delete: Deletes the specified interconnect.
func (r *InterconnectsService) Get(project string, interconnect string) *InterconnectsGetCall
Get: Returns the specified interconnect. Get a list of available interconnects by making a list() request.
func (r *InterconnectsService) Insert(project string, interconnect *Interconnect) *InterconnectsInsertCall
Insert: Creates a Interconnect in the specified project using the data included in the request.
func (r *InterconnectsService) List(project string) *InterconnectsListCall
List: Retrieves the list of interconnect available to the specified project.
func (r *InterconnectsService) Patch(project string, interconnect string, interconnect2 *Interconnect) *InterconnectsPatchCall
Patch: Updates the specified interconnect with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
type License struct {
// ChargesUseFee: [Output Only] Deprecated. This field no longer
// reflects whether a license charges a usage fee.
ChargesUseFee bool `json:"chargesUseFee,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#license for
// licenses.
Kind string `json:"kind,omitempty"`
// Name: [Output Only] Name of the resource. The name is 1-63 characters
// long and complies with RFC1035.
Name string `json:"name,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "ChargesUseFee") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ChargesUseFee") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}License: A license resource.
type LicensesGetCall struct {
// contains filtered or unexported fields
}func (c *LicensesGetCall) Context(ctx context.Context) *LicensesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *LicensesGetCall) Do(opts ...googleapi.CallOption) (*License, error)
Do executes the "compute.licenses.get" call. Exactly one of *License or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *License.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *LicensesGetCall) Fields(s ...googleapi.Field) *LicensesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *LicensesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *LicensesGetCall) IfNoneMatch(entityTag string) *LicensesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type LicensesService struct {
// contains filtered or unexported fields
}func NewLicensesService(s *Service) *LicensesService
func (r *LicensesService) Get(project string, license string) *LicensesGetCall
Get: Returns the specified License resource. For details, see https://cloud.google.com/compute/docs/reference/latest/licenses/get
type MachineType struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Deprecated: [Output Only] The deprecation status associated with this
// machine type.
Deprecated *DeprecationStatus `json:"deprecated,omitempty"`
// Description: [Output Only] An optional textual description of the
// resource.
Description string `json:"description,omitempty"`
// GuestCpus: [Output Only] The number of virtual CPUs that are
// available to the instance.
GuestCpus int64 `json:"guestCpus,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// ImageSpaceGb: [Deprecated] This property is deprecated and will never
// be populated with any relevant values.
ImageSpaceGb int64 `json:"imageSpaceGb,omitempty"`
// IsSharedCpu: [Output Only] Whether this machine type has a shared
// CPU. See Shared-core machine types for more information.
bool `json:"isSharedCpu,omitempty"`
// Kind: [Output Only] The type of the resource. Always
// compute#machineType for machine types.
Kind string `json:"kind,omitempty"`
// MaximumPersistentDisks: [Output Only] Maximum persistent disks
// allowed.
MaximumPersistentDisks int64 `json:"maximumPersistentDisks,omitempty"`
// MaximumPersistentDisksSizeGb: [Output Only] Maximum total persistent
// disks size (GB) allowed.
MaximumPersistentDisksSizeGb int64 `json:"maximumPersistentDisksSizeGb,omitempty,string"`
// MemoryMb: [Output Only] The amount of physical memory available to
// the instance, defined in MB.
MemoryMb int64 `json:"memoryMb,omitempty"`
// Name: [Output Only] Name of the resource.
Name string `json:"name,omitempty"`
// ScratchDisks: [Output Only] List of extended scratch disks assigned
// to the instance.
ScratchDisks []*MachineTypeScratchDisks `json:"scratchDisks,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Zone: [Output Only] The name of the zone where the machine type
// resides, such as us-central1-a.
Zone string `json:"zone,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}MachineType: A Machine Type resource. (== resource_for v1.machineTypes ==) (== resource_for beta.machineTypes ==)
func (s *MachineType) MarshalJSON() ([]byte, error)
type MachineTypeAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of MachineTypesScopedList resources.
Items map[string]MachineTypesScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#machineTypeAggregatedList for aggregated lists of machine
// types.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *MachineTypeAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *MachineTypeAggregatedList) MarshalJSON() ([]byte, error)
type MachineTypeAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*MachineTypeAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}MachineTypeAggregatedListWarning: [Output Only] Informational warning message.
func (s *MachineTypeAggregatedListWarning) MarshalJSON() ([]byte, error)
type MachineTypeAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *MachineTypeAggregatedListWarningData) MarshalJSON() ([]byte, error)
type MachineTypeList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of MachineType resources.
Items []*MachineType `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#machineTypeList
// for lists of machine types.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *MachineTypeListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}MachineTypeList: Contains a list of machine types.
func (s *MachineTypeList) MarshalJSON() ([]byte, error)
type MachineTypeListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*MachineTypeListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}MachineTypeListWarning: [Output Only] Informational warning message.
func (s *MachineTypeListWarning) MarshalJSON() ([]byte, error)
type MachineTypeListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *MachineTypeListWarningData) MarshalJSON() ([]byte, error)
type MachineTypeScratchDisks struct {
// DiskGb: Size of the scratch disk, defined in GB.
DiskGb int64 `json:"diskGb,omitempty"`
// ForceSendFields is a list of field names (e.g. "DiskGb") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "DiskGb") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *MachineTypeScratchDisks) MarshalJSON() ([]byte, error)
type MachineTypesAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *MachineTypesAggregatedListCall) Context(ctx context.Context) *MachineTypesAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *MachineTypesAggregatedListCall) Do(opts ...googleapi.CallOption) (*MachineTypeAggregatedList, error)
Do executes the "compute.machineTypes.aggregatedList" call. Exactly one of *MachineTypeAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *MachineTypeAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *MachineTypesAggregatedListCall) Fields(s ...googleapi.Field) *MachineTypesAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *MachineTypesAggregatedListCall) Filter(filter string) *MachineTypesAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *MachineTypesAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *MachineTypesAggregatedListCall) IfNoneMatch(entityTag string) *MachineTypesAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *MachineTypesAggregatedListCall) MaxResults(maxResults int64) *MachineTypesAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *MachineTypesAggregatedListCall) OrderBy(orderBy string) *MachineTypesAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *MachineTypesAggregatedListCall) PageToken(pageToken string) *MachineTypesAggregatedListCall
PageToken sets the optional parameter "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.
func (c *MachineTypesAggregatedListCall) Pages(ctx context.Context, f func(*MachineTypeAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type MachineTypesGetCall struct {
// contains filtered or unexported fields
}func (c *MachineTypesGetCall) Context(ctx context.Context) *MachineTypesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *MachineTypesGetCall) Do(opts ...googleapi.CallOption) (*MachineType, error)
Do executes the "compute.machineTypes.get" call. Exactly one of *MachineType or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *MachineType.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *MachineTypesGetCall) Fields(s ...googleapi.Field) *MachineTypesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *MachineTypesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *MachineTypesGetCall) IfNoneMatch(entityTag string) *MachineTypesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type MachineTypesListCall struct {
// contains filtered or unexported fields
}func (c *MachineTypesListCall) Context(ctx context.Context) *MachineTypesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *MachineTypesListCall) Do(opts ...googleapi.CallOption) (*MachineTypeList, error)
Do executes the "compute.machineTypes.list" call. Exactly one of *MachineTypeList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *MachineTypeList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *MachineTypesListCall) Fields(s ...googleapi.Field) *MachineTypesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *MachineTypesListCall) Filter(filter string) *MachineTypesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *MachineTypesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *MachineTypesListCall) IfNoneMatch(entityTag string) *MachineTypesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *MachineTypesListCall) MaxResults(maxResults int64) *MachineTypesListCall
MaxResults sets the optional parameter "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)
func (c *MachineTypesListCall) OrderBy(orderBy string) *MachineTypesListCall
OrderBy sets the optional parameter "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.
func (c *MachineTypesListCall) PageToken(pageToken string) *MachineTypesListCall
PageToken sets the optional parameter "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.
func (c *MachineTypesListCall) Pages(ctx context.Context, f func(*MachineTypeList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type MachineTypesScopedList struct {
// MachineTypes: [Output Only] List of machine types contained in this
// scope.
MachineTypes []*MachineType `json:"machineTypes,omitempty"`
// Warning: [Output Only] An informational warning that appears when the
// machine types list is empty.
Warning *MachineTypesScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "MachineTypes") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "MachineTypes") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *MachineTypesScopedList) MarshalJSON() ([]byte, error)
type MachineTypesScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*MachineTypesScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}MachineTypesScopedListWarning: [Output Only] An informational warning that appears when the machine types list is empty.
func (s *MachineTypesScopedListWarning) MarshalJSON() ([]byte, error)
type MachineTypesScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *MachineTypesScopedListWarningData) MarshalJSON() ([]byte, error)
type MachineTypesService struct {
// contains filtered or unexported fields
}func NewMachineTypesService(s *Service) *MachineTypesService
func (r *MachineTypesService) AggregatedList(project string) *MachineTypesAggregatedListCall
AggregatedList: Retrieves an aggregated list of machine types. For details, see https://cloud.google.com/compute/docs/reference/latest/machineTypes/aggregatedList
func (r *MachineTypesService) Get(project string, zone string, machineType string) *MachineTypesGetCall
Get: Returns the specified machine type. Get a list of available machine types by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/machineTypes/get
func (r *MachineTypesService) List(project string, zone string) *MachineTypesListCall
List: Retrieves a list of machine types available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/machineTypes/list
type ManagedInstance struct {
// CurrentAction: [Output Only] The current action that the managed
// instance group has scheduled for the instance. Possible values:
// - NONE The instance is running, and the managed instance group does
// not have any scheduled actions for this instance.
// - CREATING The managed instance group is creating this instance. If
// the group fails to create this instance, it will try again until it
// is successful.
// - CREATING_WITHOUT_RETRIES The managed instance group is attempting
// to create this instance only once. If the group fails to create this
// instance, it does not try again and the group's targetSize value is
// decreased instead.
// - RECREATING The managed instance group is recreating this instance.
//
// - DELETING The managed instance group is permanently deleting this
// instance.
// - ABANDONING The managed instance group is abandoning this instance.
// The instance will be removed from the instance group and from any
// target pools that are associated with this group.
// - RESTARTING The managed instance group is restarting the instance.
//
// - REFRESHING The managed instance group is applying configuration
// changes to the instance without stopping it. For example, the group
// can update the target pool list for an instance without stopping that
// instance.
//
// Possible values:
// "ABANDONING"
// "CREATING"
// "CREATING_WITHOUT_RETRIES"
// "DELETING"
// "NONE"
// "RECREATING"
// "REFRESHING"
// "RESTARTING"
CurrentAction string `json:"currentAction,omitempty"`
// Id: [Output only] The unique identifier for this resource. This field
// is empty when instance does not exist.
Id uint64 `json:"id,omitempty,string"`
// Instance: [Output Only] The URL of the instance. The URL can exist
// even if the instance has not yet been created.
Instance string `json:"instance,omitempty"`
// InstanceStatus: [Output Only] The status of the instance. This field
// is empty when the instance does not exist.
//
// Possible values:
// "PROVISIONING"
// "RUNNING"
// "STAGING"
// "STOPPED"
// "STOPPING"
// "SUSPENDED"
// "SUSPENDING"
// "TERMINATED"
InstanceStatus string `json:"instanceStatus,omitempty"`
// LastAttempt: [Output Only] Information about the last attempt to
// create or delete the instance.
LastAttempt *ManagedInstanceLastAttempt `json:"lastAttempt,omitempty"`
// ForceSendFields is a list of field names (e.g. "CurrentAction") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CurrentAction") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ManagedInstance) MarshalJSON() ([]byte, error)
type ManagedInstanceLastAttempt struct {
// Errors: [Output Only] Encountered errors during the last attempt to
// create or delete the instance.
Errors *ManagedInstanceLastAttemptErrors `json:"errors,omitempty"`
// ForceSendFields is a list of field names (e.g. "Errors") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Errors") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ManagedInstanceLastAttempt) MarshalJSON() ([]byte, error)
type ManagedInstanceLastAttemptErrors struct {
// Errors: [Output Only] The array of errors encountered while
// processing this operation.
Errors []*ManagedInstanceLastAttemptErrorsErrors `json:"errors,omitempty"`
// ForceSendFields is a list of field names (e.g. "Errors") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Errors") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ManagedInstanceLastAttemptErrors: [Output Only] Encountered errors during the last attempt to create or delete the instance.
func (s *ManagedInstanceLastAttemptErrors) MarshalJSON() ([]byte, error)
type ManagedInstanceLastAttemptErrorsErrors struct {
// Code: [Output Only] The error type identifier for this error.
Code string `json:"code,omitempty"`
// Location: [Output Only] Indicates the field in the request that
// caused the error. This property is optional.
Location string `json:"location,omitempty"`
// Message: [Output Only] An optional, human-readable error message.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ManagedInstanceLastAttemptErrorsErrors) MarshalJSON() ([]byte, error)
type Metadata struct {
// Fingerprint: Specifies a fingerprint for this request, which is
// essentially a hash of the metadata's contents and used for optimistic
// locking. The fingerprint is initially generated by Compute Engine and
// changes after every request to modify or update metadata. You must
// always provide an up-to-date fingerprint hash in order to update or
// change metadata.
Fingerprint string `json:"fingerprint,omitempty"`
// Items: Array of key/value pairs. The total size of all keys and
// values must be less than 512 KB.
Items []*MetadataItems `json:"items,omitempty"`
// Kind: [Output Only] Type of the resource. Always compute#metadata for
// metadata.
Kind string `json:"kind,omitempty"`
// ForceSendFields is a list of field names (e.g. "Fingerprint") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Fingerprint") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}Metadata: A metadata key/value entry.
type MetadataItems struct {
// Key: Key for the metadata entry. Keys must conform to the following
// regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is
// reflected as part of a URL in the metadata server. Additionally, to
// avoid ambiguity, keys must not conflict with any other metadata keys
// for the project.
Key string `json:"key,omitempty"`
// Value: Value for the metadata entry. These are free-form strings, and
// only have meaning as interpreted by the image running in the
// instance. The only restriction placed on values is that their size
// must be less than or equal to 262144 bytes (256 KiB).
Value *string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *MetadataItems) MarshalJSON() ([]byte, error)
type NamedPort struct {
// Name: The name for this named port. The name must be 1-63 characters
// long, and comply with RFC1035.
Name string `json:"name,omitempty"`
// Port: The port number, which can be a value between 1 and 65535.
Port int64 `json:"port,omitempty"`
// ForceSendFields is a list of field names (e.g. "Name") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Name") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}NamedPort: The named port. For example: .
type Network struct {
// IPv4Range: The range of internal addresses that are legal on this
// network. This range is a CIDR specification, for example:
// 192.168.0.0/16. Provided by the client when the network is created.
IPv4Range string `json:"IPv4Range,omitempty"`
// AutoCreateSubnetworks: When set to true, the network is created in
// "auto subnet mode". When set to false, the network is in "custom
// subnet mode".
//
// In "auto subnet mode", a newly created network is assigned the
// default CIDR of 10.128.0.0/9 and it automatically creates one
// subnetwork per region.
AutoCreateSubnetworks bool `json:"autoCreateSubnetworks,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// GatewayIPv4: A gateway address for default routing to other networks.
// This value is read only and is selected by the Google Compute Engine,
// typically as the first usable address in the IPv4Range.
GatewayIPv4 string `json:"gatewayIPv4,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#network for
// networks.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Peerings: [Output Only] List of network peerings for the resource.
Peerings []*NetworkPeering `json:"peerings,omitempty"`
// RoutingConfig: The network-level routing configuration for this
// network. Used by Cloud Router to determine what type of network-wide
// routing behavior to enforce.
RoutingConfig *NetworkRoutingConfig `json:"routingConfig,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Subnetworks: [Output Only] Server-defined fully-qualified URLs for
// all subnetworks in this network.
Subnetworks []string `json:"subnetworks,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "IPv4Range") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "IPv4Range") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}Network: Represents a Network resource. Read Networks and Firewalls for more information. (== resource_for v1.networks ==) (== resource_for beta.networks ==)
type NetworkInterface struct {
// AccessConfigs: An array of configurations for this interface.
// Currently, only one access config, ONE_TO_ONE_NAT, is supported. If
// there are no accessConfigs specified, then this instance will have no
// external internet access.
AccessConfigs []*AccessConfig `json:"accessConfigs,omitempty"`
// AliasIpRanges: An array of alias IP ranges for this network
// interface. Can only be specified for network interfaces on
// subnet-mode networks.
AliasIpRanges []*AliasIpRange `json:"aliasIpRanges,omitempty"`
// Kind: [Output Only] Type of the resource. Always
// compute#networkInterface for network interfaces.
Kind string `json:"kind,omitempty"`
// Name: [Output Only] The name of the network interface, generated by
// the server. For network devices, these are eth0, eth1, etc.
Name string `json:"name,omitempty"`
// Network: URL of the network resource for this instance. When creating
// an instance, if neither the network nor the subnetwork is specified,
// the default network global/networks/default is used; if the network
// is not specified but the subnetwork is specified, the network is
// inferred.
//
// This field is optional when creating a firewall rule. If not
// specified when creating a firewall rule, the default network
// global/networks/default is used.
//
// If you specify this property, you can specify the network as a full
// or partial URL. For example, the following are all valid URLs:
// -
// https://www.googleapis.com/compute/v1/projects/project/global/networks/network
// - projects/project/global/networks/network
// - global/networks/default
Network string `json:"network,omitempty"`
// NetworkIP: An IPv4 internal network address to assign to the instance
// for this network interface. If not specified by the user, an unused
// internal IP is assigned by the system.
NetworkIP string `json:"networkIP,omitempty"`
// Subnetwork: The URL of the Subnetwork resource for this instance. If
// the network resource is in legacy mode, do not provide this property.
// If the network is in auto subnet mode, providing the subnetwork is
// optional. If the network is in custom subnet mode, then this field
// should be specified. If you specify this property, you can specify
// the subnetwork as a full or partial URL. For example, the following
// are all valid URLs:
// -
// https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
// - regions/region/subnetworks/subnetwork
Subnetwork string `json:"subnetwork,omitempty"`
// ForceSendFields is a list of field names (e.g. "AccessConfigs") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AccessConfigs") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}NetworkInterface: A network interface resource attached to an instance.
func (s *NetworkInterface) MarshalJSON() ([]byte, error)
type NetworkList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Network resources.
Items []*Network `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#networkList for
// lists of networks.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *NetworkListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}NetworkList: Contains a list of networks.
func (s *NetworkList) MarshalJSON() ([]byte, error)
type NetworkListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*NetworkListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}NetworkListWarning: [Output Only] Informational warning message.
func (s *NetworkListWarning) MarshalJSON() ([]byte, error)
type NetworkListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *NetworkListWarningData) MarshalJSON() ([]byte, error)
type NetworkPeering struct {
// AutoCreateRoutes: Whether full mesh connectivity is created and
// managed automatically. When it is set to true, Google Compute Engine
// will automatically create and manage the routes between two networks
// when the state is ACTIVE. Otherwise, user needs to create routes
// manually to route packets to peer network.
AutoCreateRoutes bool `json:"autoCreateRoutes,omitempty"`
// Name: Name of this peering. Provided by the client when the peering
// is created. The name must comply with RFC1035. Specifically, the name
// must be 1-63 characters long and match regular expression
// [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a
// lowercase letter, and all the following characters must be a dash,
// lowercase letter, or digit, except the last character, which cannot
// be a dash.
Name string `json:"name,omitempty"`
// Network: The URL of the peer network. It can be either full URL or
// partial URL. The peer network may belong to a different project. If
// the partial URL does not contain project, it is assumed that the peer
// network is in the same project as the current network.
Network string `json:"network,omitempty"`
// State: [Output Only] State for the peering.
//
// Possible values:
// "ACTIVE"
// "INACTIVE"
State string `json:"state,omitempty"`
// StateDetails: [Output Only] Details about the current state of the
// peering.
StateDetails string `json:"stateDetails,omitempty"`
// ForceSendFields is a list of field names (e.g. "AutoCreateRoutes") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AutoCreateRoutes") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}NetworkPeering: A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering.
func (s *NetworkPeering) MarshalJSON() ([]byte, error)
type NetworkRoutingConfig struct {
// RoutingMode: The network-wide routing mode to use. If set to
// REGIONAL, this network's cloud routers will only advertise routes
// with subnetworks of this network in the same region as the router. If
// set to GLOBAL, this network's cloud routers will advertise routes
// with all subnetworks of this network, across regions.
//
// Possible values:
// "GLOBAL"
// "REGIONAL"
RoutingMode string `json:"routingMode,omitempty"`
// ForceSendFields is a list of field names (e.g. "RoutingMode") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "RoutingMode") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}NetworkRoutingConfig: A routing configuration attached to a network resource. The message includes the list of routers associated with the network, and a flag indicating the type of routing behavior to enforce network-wide.
func (s *NetworkRoutingConfig) MarshalJSON() ([]byte, error)
type NetworksAddPeeringCall struct {
// contains filtered or unexported fields
}func (c *NetworksAddPeeringCall) Context(ctx context.Context) *NetworksAddPeeringCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *NetworksAddPeeringCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.networks.addPeering" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *NetworksAddPeeringCall) Fields(s ...googleapi.Field) *NetworksAddPeeringCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *NetworksAddPeeringCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *NetworksAddPeeringCall) RequestId(requestId string) *NetworksAddPeeringCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type NetworksAddPeeringRequest struct {
// AutoCreateRoutes: Whether Google Compute Engine manages the routes
// automatically.
AutoCreateRoutes bool `json:"autoCreateRoutes,omitempty"`
// Name: Name of the peering, which should conform to RFC1035.
Name string `json:"name,omitempty"`
// PeerNetwork: URL of the peer network. It can be either full URL or
// partial URL. The peer network may belong to a different project. If
// the partial URL does not contain project, it is assumed that the peer
// network is in the same project as the current network.
PeerNetwork string `json:"peerNetwork,omitempty"`
// ForceSendFields is a list of field names (e.g. "AutoCreateRoutes") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AutoCreateRoutes") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *NetworksAddPeeringRequest) MarshalJSON() ([]byte, error)
type NetworksDeleteCall struct {
// contains filtered or unexported fields
}func (c *NetworksDeleteCall) Context(ctx context.Context) *NetworksDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *NetworksDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.networks.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *NetworksDeleteCall) Fields(s ...googleapi.Field) *NetworksDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *NetworksDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *NetworksDeleteCall) RequestId(requestId string) *NetworksDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type NetworksGetCall struct {
// contains filtered or unexported fields
}func (c *NetworksGetCall) Context(ctx context.Context) *NetworksGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *NetworksGetCall) Do(opts ...googleapi.CallOption) (*Network, error)
Do executes the "compute.networks.get" call. Exactly one of *Network or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Network.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *NetworksGetCall) Fields(s ...googleapi.Field) *NetworksGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *NetworksGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *NetworksGetCall) IfNoneMatch(entityTag string) *NetworksGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type NetworksInsertCall struct {
// contains filtered or unexported fields
}func (c *NetworksInsertCall) Context(ctx context.Context) *NetworksInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *NetworksInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.networks.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *NetworksInsertCall) Fields(s ...googleapi.Field) *NetworksInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *NetworksInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *NetworksInsertCall) RequestId(requestId string) *NetworksInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type NetworksListCall struct {
// contains filtered or unexported fields
}func (c *NetworksListCall) Context(ctx context.Context) *NetworksListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *NetworksListCall) Do(opts ...googleapi.CallOption) (*NetworkList, error)
Do executes the "compute.networks.list" call. Exactly one of *NetworkList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *NetworkList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *NetworksListCall) Fields(s ...googleapi.Field) *NetworksListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *NetworksListCall) Filter(filter string) *NetworksListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *NetworksListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *NetworksListCall) IfNoneMatch(entityTag string) *NetworksListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *NetworksListCall) MaxResults(maxResults int64) *NetworksListCall
MaxResults sets the optional parameter "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)
func (c *NetworksListCall) OrderBy(orderBy string) *NetworksListCall
OrderBy sets the optional parameter "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.
func (c *NetworksListCall) PageToken(pageToken string) *NetworksListCall
PageToken sets the optional parameter "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.
func (c *NetworksListCall) Pages(ctx context.Context, f func(*NetworkList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type NetworksPatchCall struct {
// contains filtered or unexported fields
}func (c *NetworksPatchCall) Context(ctx context.Context) *NetworksPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *NetworksPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.networks.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *NetworksPatchCall) Fields(s ...googleapi.Field) *NetworksPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *NetworksPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *NetworksPatchCall) RequestId(requestId string) *NetworksPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type NetworksRemovePeeringCall struct {
// contains filtered or unexported fields
}func (c *NetworksRemovePeeringCall) Context(ctx context.Context) *NetworksRemovePeeringCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *NetworksRemovePeeringCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.networks.removePeering" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *NetworksRemovePeeringCall) Fields(s ...googleapi.Field) *NetworksRemovePeeringCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *NetworksRemovePeeringCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *NetworksRemovePeeringCall) RequestId(requestId string) *NetworksRemovePeeringCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type NetworksRemovePeeringRequest struct {
// Name: Name of the peering, which should conform to RFC1035.
Name string `json:"name,omitempty"`
// ForceSendFields is a list of field names (e.g. "Name") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Name") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *NetworksRemovePeeringRequest) MarshalJSON() ([]byte, error)
type NetworksService struct {
// contains filtered or unexported fields
}func NewNetworksService(s *Service) *NetworksService
func (r *NetworksService) AddPeering(project string, network string, networksaddpeeringrequest *NetworksAddPeeringRequest) *NetworksAddPeeringCall
AddPeering: Adds a peering to the specified network.
func (r *NetworksService) Delete(project string, network string) *NetworksDeleteCall
Delete: Deletes the specified network. For details, see https://cloud.google.com/compute/docs/reference/latest/networks/delete
func (r *NetworksService) Get(project string, network string) *NetworksGetCall
Get: Returns the specified network. Get a list of available networks by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/networks/get
func (r *NetworksService) Insert(project string, network *Network) *NetworksInsertCall
Insert: Creates a network in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/networks/insert
func (r *NetworksService) List(project string) *NetworksListCall
List: Retrieves the list of networks available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/networks/list
func (r *NetworksService) Patch(project string, network string, network2 *Network) *NetworksPatchCall
Patch: Patches the specified network with the data included in the request. Only the following fields can be modified: routingConfig.routingMode.
func (r *NetworksService) RemovePeering(project string, network string, networksremovepeeringrequest *NetworksRemovePeeringRequest) *NetworksRemovePeeringCall
RemovePeering: Removes a peering from the specified network.
func (r *NetworksService) SwitchToCustomMode(project string, network string) *NetworksSwitchToCustomModeCall
SwitchToCustomMode: Switches the network mode from auto subnet mode to custom subnet mode.
type NetworksSwitchToCustomModeCall struct {
// contains filtered or unexported fields
}func (c *NetworksSwitchToCustomModeCall) Context(ctx context.Context) *NetworksSwitchToCustomModeCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *NetworksSwitchToCustomModeCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.networks.switchToCustomMode" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *NetworksSwitchToCustomModeCall) Fields(s ...googleapi.Field) *NetworksSwitchToCustomModeCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *NetworksSwitchToCustomModeCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *NetworksSwitchToCustomModeCall) RequestId(requestId string) *NetworksSwitchToCustomModeCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type Operation struct {
// ClientOperationId: [Output Only] Reserved for future use.
ClientOperationId string `json:"clientOperationId,omitempty"`
// CreationTimestamp: [Deprecated] This field is deprecated.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: [Output Only] A textual description of the operation,
// which is set when the operation is created.
Description string `json:"description,omitempty"`
// EndTime: [Output Only] The time that this operation was completed.
// This value is in RFC3339 text format.
EndTime string `json:"endTime,omitempty"`
// Error: [Output Only] If errors are generated during processing of the
// operation, this field will be populated.
Error *OperationError `json:"error,omitempty"`
// HttpErrorMessage: [Output Only] If the operation fails, this field
// contains the HTTP error message that was returned, such as NOT FOUND.
HttpErrorMessage string `json:"httpErrorMessage,omitempty"`
// HttpErrorStatusCode: [Output Only] If the operation fails, this field
// contains the HTTP error status code that was returned. For example, a
// 404 means the resource was not found.
HttpErrorStatusCode int64 `json:"httpErrorStatusCode,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// InsertTime: [Output Only] The time that this operation was requested.
// This value is in RFC3339 text format.
InsertTime string `json:"insertTime,omitempty"`
// Kind: [Output Only] Type of the resource. Always compute#operation
// for Operation resources.
Kind string `json:"kind,omitempty"`
// Name: [Output Only] Name of the resource.
Name string `json:"name,omitempty"`
// OperationType: [Output Only] The type of operation, such as insert,
// update, or delete, and so on.
OperationType string `json:"operationType,omitempty"`
// Progress: [Output Only] An optional progress indicator that ranges
// from 0 to 100. There is no requirement that this be linear or support
// any granularity of operations. This should not be used to guess when
// the operation will be complete. This number should monotonically
// increase as the operation progresses.
Progress int64 `json:"progress,omitempty"`
// Region: [Output Only] The URL of the region where the operation
// resides. Only available when performing regional operations.
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// StartTime: [Output Only] The time that this operation was started by
// the server. This value is in RFC3339 text format.
StartTime string `json:"startTime,omitempty"`
// Status: [Output Only] The status of the operation, which can be one
// of the following: PENDING, RUNNING, or DONE.
//
// Possible values:
// "DONE"
// "PENDING"
// "RUNNING"
Status string `json:"status,omitempty"`
// StatusMessage: [Output Only] An optional textual description of the
// current status of the operation.
StatusMessage string `json:"statusMessage,omitempty"`
// TargetId: [Output Only] The unique target ID, which identifies a
// specific incarnation of the target resource.
TargetId uint64 `json:"targetId,omitempty,string"`
// TargetLink: [Output Only] The URL of the resource that the operation
// modifies. For operations related to creating a snapshot, this points
// to the persistent disk that the snapshot was created from.
TargetLink string `json:"targetLink,omitempty"`
// User: [Output Only] User who requested the operation, for example:
// user@example.com.
User string `json:"user,omitempty"`
// Warnings: [Output Only] If warning messages are generated during
// processing of the operation, this field will be populated.
Warnings []*OperationWarnings `json:"warnings,omitempty"`
// Zone: [Output Only] The URL of the zone where the operation resides.
// Only available when performing per-zone operations.
Zone string `json:"zone,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "ClientOperationId")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ClientOperationId") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Operation: An Operation resource, used to manage asynchronous API requests. (== resource_for v1.globalOperations ==) (== resource_for beta.globalOperations ==) (== resource_for v1.regionOperations ==) (== resource_for beta.regionOperations ==) (== resource_for v1.zoneOperations ==) (== resource_for beta.zoneOperations ==)
type OperationAggregatedList struct {
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id string `json:"id,omitempty"`
// Items: [Output Only] A map of scoped operation lists.
Items map[string]OperationsScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#operationAggregatedList for aggregated lists of operations.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *OperationAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *OperationAggregatedList) MarshalJSON() ([]byte, error)
type OperationAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*OperationAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}OperationAggregatedListWarning: [Output Only] Informational warning message.
func (s *OperationAggregatedListWarning) MarshalJSON() ([]byte, error)
type OperationAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *OperationAggregatedListWarningData) MarshalJSON() ([]byte, error)
type OperationError struct {
// Errors: [Output Only] The array of errors encountered while
// processing this operation.
Errors []*OperationErrorErrors `json:"errors,omitempty"`
// ForceSendFields is a list of field names (e.g. "Errors") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Errors") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}OperationError: [Output Only] If errors are generated during processing of the operation, this field will be populated.
func (s *OperationError) MarshalJSON() ([]byte, error)
type OperationErrorErrors struct {
// Code: [Output Only] The error type identifier for this error.
Code string `json:"code,omitempty"`
// Location: [Output Only] Indicates the field in the request that
// caused the error. This property is optional.
Location string `json:"location,omitempty"`
// Message: [Output Only] An optional, human-readable error message.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *OperationErrorErrors) MarshalJSON() ([]byte, error)
type OperationList struct {
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id string `json:"id,omitempty"`
// Items: [Output Only] A list of Operation resources.
Items []*Operation `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#operations for
// Operations resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *OperationListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}OperationList: Contains a list of Operation resources.
func (s *OperationList) MarshalJSON() ([]byte, error)
type OperationListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*OperationListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}OperationListWarning: [Output Only] Informational warning message.
func (s *OperationListWarning) MarshalJSON() ([]byte, error)
type OperationListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *OperationListWarningData) MarshalJSON() ([]byte, error)
type OperationWarnings struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*OperationWarningsData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *OperationWarnings) MarshalJSON() ([]byte, error)
type OperationWarningsData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *OperationWarningsData) MarshalJSON() ([]byte, error)
type OperationsScopedList struct {
// Operations: [Output Only] List of operations contained in this scope.
Operations []*Operation `json:"operations,omitempty"`
// Warning: [Output Only] Informational warning which replaces the list
// of operations when the list is empty.
Warning *OperationsScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "Operations") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Operations") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *OperationsScopedList) MarshalJSON() ([]byte, error)
type OperationsScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*OperationsScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}OperationsScopedListWarning: [Output Only] Informational warning which replaces the list of operations when the list is empty.
func (s *OperationsScopedListWarning) MarshalJSON() ([]byte, error)
type OperationsScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *OperationsScopedListWarningData) MarshalJSON() ([]byte, error)
type PathMatcher struct {
// DefaultService: The full or partial URL to the BackendService
// resource. This will be used if none of the pathRules defined by this
// PathMatcher is matched by the URL's path portion. For example, the
// following are all valid URLs to a BackendService resource:
// -
// https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
// - compute/v1/projects/project/global/backendServices/backendService
//
// - global/backendServices/backendService
DefaultService string `json:"defaultService,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Name: The name to which this PathMatcher is referred by the HostRule.
Name string `json:"name,omitempty"`
// PathRules: The list of path rules.
PathRules []*PathRule `json:"pathRules,omitempty"`
// ForceSendFields is a list of field names (e.g. "DefaultService") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "DefaultService") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}PathMatcher: A matcher for the path portion of the URL. The BackendService from the longest-matched rule will serve the URL. If no rule was matched, the default service will be used.
func (s *PathMatcher) MarshalJSON() ([]byte, error)
type PathRule struct {
// Paths: The list of path patterns to match. Each must start with / and
// the only place a * is allowed is at the end following a /. The string
// fed to the path matcher does not include any text after the first ?
// or #, and those chars are not allowed here.
Paths []string `json:"paths,omitempty"`
// Service: The URL of the BackendService resource if this rule is
// matched.
Service string `json:"service,omitempty"`
// ForceSendFields is a list of field names (e.g. "Paths") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Paths") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}PathRule: A path-matching rule for a URL. If matched, will use the specified BackendService to handle the traffic arriving at this URL.
type Project struct {
// CommonInstanceMetadata: Metadata key/value pairs available to all
// instances contained in this project. See Custom metadata for more
// information.
CommonInstanceMetadata *Metadata `json:"commonInstanceMetadata,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// DefaultServiceAccount: [Output Only] Default service account used by
// VMs running in this project.
DefaultServiceAccount string `json:"defaultServiceAccount,omitempty"`
// Description: An optional textual description of the resource.
Description string `json:"description,omitempty"`
// EnabledFeatures: Restricted features enabled for use on this project.
EnabledFeatures []string `json:"enabledFeatures,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server. This is not the project ID, and
// is just a unique ID used by Compute Engine to identify resources.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#project for
// projects.
Kind string `json:"kind,omitempty"`
// Name: The project ID. For example: my-example-project. Use the
// project ID to make requests to Compute Engine.
Name string `json:"name,omitempty"`
// Quotas: [Output Only] Quotas assigned to this project.
Quotas []*Quota `json:"quotas,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// UsageExportLocation: The naming prefix for daily usage reports and
// the Google Cloud Storage bucket where they are stored.
UsageExportLocation *UsageExportLocation `json:"usageExportLocation,omitempty"`
// XpnProjectStatus: [Output Only] The role this project has in a shared
// VPC configuration. Currently only HOST projects are differentiated.
//
// Possible values:
// "HOST"
// "UNSPECIFIED_XPN_PROJECT_STATUS"
XpnProjectStatus string `json:"xpnProjectStatus,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g.
// "CommonInstanceMetadata") to unconditionally include in API requests.
// By default, fields with empty values are omitted from API requests.
// However, any non-pointer, non-interface field appearing in
// ForceSendFields will be sent to the server regardless of whether the
// field is empty or not. This may be used to include empty fields in
// Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CommonInstanceMetadata")
// to include in API requests with the JSON null value. By default,
// fields with empty values are omitted from API requests. However, any
// field with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Project: A Project resource. Projects can only be created in the Google Cloud Platform Console. Unless marked otherwise, values can only be modified in the console. (== resource_for v1.projects ==) (== resource_for beta.projects ==)
type ProjectsDisableXpnHostCall struct {
// contains filtered or unexported fields
}func (c *ProjectsDisableXpnHostCall) Context(ctx context.Context) *ProjectsDisableXpnHostCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsDisableXpnHostCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.projects.disableXpnHost" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsDisableXpnHostCall) Fields(s ...googleapi.Field) *ProjectsDisableXpnHostCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsDisableXpnHostCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsDisableXpnHostCall) RequestId(requestId string) *ProjectsDisableXpnHostCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ProjectsDisableXpnResourceCall struct {
// contains filtered or unexported fields
}func (c *ProjectsDisableXpnResourceCall) Context(ctx context.Context) *ProjectsDisableXpnResourceCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsDisableXpnResourceCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.projects.disableXpnResource" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsDisableXpnResourceCall) Fields(s ...googleapi.Field) *ProjectsDisableXpnResourceCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsDisableXpnResourceCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsDisableXpnResourceCall) RequestId(requestId string) *ProjectsDisableXpnResourceCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ProjectsDisableXpnResourceRequest struct {
// XpnResource: Service resource (a.k.a service project) ID.
XpnResource *XpnResourceId `json:"xpnResource,omitempty"`
// ForceSendFields is a list of field names (e.g. "XpnResource") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "XpnResource") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ProjectsDisableXpnResourceRequest) MarshalJSON() ([]byte, error)
type ProjectsEnableXpnHostCall struct {
// contains filtered or unexported fields
}func (c *ProjectsEnableXpnHostCall) Context(ctx context.Context) *ProjectsEnableXpnHostCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsEnableXpnHostCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.projects.enableXpnHost" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsEnableXpnHostCall) Fields(s ...googleapi.Field) *ProjectsEnableXpnHostCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsEnableXpnHostCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsEnableXpnHostCall) RequestId(requestId string) *ProjectsEnableXpnHostCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ProjectsEnableXpnResourceCall struct {
// contains filtered or unexported fields
}func (c *ProjectsEnableXpnResourceCall) Context(ctx context.Context) *ProjectsEnableXpnResourceCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsEnableXpnResourceCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.projects.enableXpnResource" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsEnableXpnResourceCall) Fields(s ...googleapi.Field) *ProjectsEnableXpnResourceCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsEnableXpnResourceCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsEnableXpnResourceCall) RequestId(requestId string) *ProjectsEnableXpnResourceCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ProjectsEnableXpnResourceRequest struct {
// XpnResource: Service resource (a.k.a service project) ID.
XpnResource *XpnResourceId `json:"xpnResource,omitempty"`
// ForceSendFields is a list of field names (e.g. "XpnResource") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "XpnResource") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ProjectsEnableXpnResourceRequest) MarshalJSON() ([]byte, error)
type ProjectsGetCall struct {
// contains filtered or unexported fields
}func (c *ProjectsGetCall) Context(ctx context.Context) *ProjectsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsGetCall) Do(opts ...googleapi.CallOption) (*Project, error)
Do executes the "compute.projects.get" call. Exactly one of *Project or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Project.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsGetCall) Fields(s ...googleapi.Field) *ProjectsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsGetCall) IfNoneMatch(entityTag string) *ProjectsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type ProjectsGetXpnHostCall struct {
// contains filtered or unexported fields
}func (c *ProjectsGetXpnHostCall) Context(ctx context.Context) *ProjectsGetXpnHostCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsGetXpnHostCall) Do(opts ...googleapi.CallOption) (*Project, error)
Do executes the "compute.projects.getXpnHost" call. Exactly one of *Project or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Project.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsGetXpnHostCall) Fields(s ...googleapi.Field) *ProjectsGetXpnHostCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsGetXpnHostCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsGetXpnHostCall) IfNoneMatch(entityTag string) *ProjectsGetXpnHostCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type ProjectsGetXpnResources struct {
// Kind: [Output Only] Type of resource. Always
// compute#projectsGetXpnResources for lists of service resources (a.k.a
// service projects)
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// Resources: Service resources (a.k.a service projects) attached to
// this project as their shared VPC host.
Resources []*XpnResourceId `json:"resources,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Kind") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Kind") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ProjectsGetXpnResources) MarshalJSON() ([]byte, error)
type ProjectsGetXpnResourcesCall struct {
// contains filtered or unexported fields
}func (c *ProjectsGetXpnResourcesCall) Context(ctx context.Context) *ProjectsGetXpnResourcesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsGetXpnResourcesCall) Do(opts ...googleapi.CallOption) (*ProjectsGetXpnResources, error)
Do executes the "compute.projects.getXpnResources" call. Exactly one of *ProjectsGetXpnResources or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ProjectsGetXpnResources.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsGetXpnResourcesCall) Fields(s ...googleapi.Field) *ProjectsGetXpnResourcesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsGetXpnResourcesCall) Filter(filter string) *ProjectsGetXpnResourcesCall
Filter sets the optional parameter "filter":
func (c *ProjectsGetXpnResourcesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsGetXpnResourcesCall) IfNoneMatch(entityTag string) *ProjectsGetXpnResourcesCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *ProjectsGetXpnResourcesCall) MaxResults(maxResults int64) *ProjectsGetXpnResourcesCall
MaxResults sets the optional parameter "maxResults":
func (c *ProjectsGetXpnResourcesCall) OrderBy(orderBy string) *ProjectsGetXpnResourcesCall
OrderBy sets the optional parameter "order_by":
func (c *ProjectsGetXpnResourcesCall) PageToken(pageToken string) *ProjectsGetXpnResourcesCall
PageToken sets the optional parameter "pageToken":
func (c *ProjectsGetXpnResourcesCall) Pages(ctx context.Context, f func(*ProjectsGetXpnResources) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type ProjectsListXpnHostsCall struct {
// contains filtered or unexported fields
}func (c *ProjectsListXpnHostsCall) Context(ctx context.Context) *ProjectsListXpnHostsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsListXpnHostsCall) Do(opts ...googleapi.CallOption) (*XpnHostList, error)
Do executes the "compute.projects.listXpnHosts" call. Exactly one of *XpnHostList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *XpnHostList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsListXpnHostsCall) Fields(s ...googleapi.Field) *ProjectsListXpnHostsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsListXpnHostsCall) Filter(filter string) *ProjectsListXpnHostsCall
Filter sets the optional parameter "filter":
func (c *ProjectsListXpnHostsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsListXpnHostsCall) MaxResults(maxResults int64) *ProjectsListXpnHostsCall
MaxResults sets the optional parameter "maxResults":
func (c *ProjectsListXpnHostsCall) OrderBy(orderBy string) *ProjectsListXpnHostsCall
OrderBy sets the optional parameter "order_by":
func (c *ProjectsListXpnHostsCall) PageToken(pageToken string) *ProjectsListXpnHostsCall
PageToken sets the optional parameter "pageToken":
func (c *ProjectsListXpnHostsCall) Pages(ctx context.Context, f func(*XpnHostList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type ProjectsListXpnHostsRequest struct {
// Organization: Optional organization ID managed by Cloud Resource
// Manager, for which to list shared VPC host projects. If not
// specified, the organization will be inferred from the project.
Organization string `json:"organization,omitempty"`
// ForceSendFields is a list of field names (e.g. "Organization") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Organization") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ProjectsListXpnHostsRequest) MarshalJSON() ([]byte, error)
type ProjectsMoveDiskCall struct {
// contains filtered or unexported fields
}func (c *ProjectsMoveDiskCall) Context(ctx context.Context) *ProjectsMoveDiskCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsMoveDiskCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.projects.moveDisk" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsMoveDiskCall) Fields(s ...googleapi.Field) *ProjectsMoveDiskCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsMoveDiskCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsMoveDiskCall) RequestId(requestId string) *ProjectsMoveDiskCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ProjectsMoveInstanceCall struct {
// contains filtered or unexported fields
}func (c *ProjectsMoveInstanceCall) Context(ctx context.Context) *ProjectsMoveInstanceCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsMoveInstanceCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.projects.moveInstance" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsMoveInstanceCall) Fields(s ...googleapi.Field) *ProjectsMoveInstanceCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsMoveInstanceCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsMoveInstanceCall) RequestId(requestId string) *ProjectsMoveInstanceCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ProjectsService struct {
// contains filtered or unexported fields
}func NewProjectsService(s *Service) *ProjectsService
func (r *ProjectsService) DisableXpnHost(project string) *ProjectsDisableXpnHostCall
DisableXpnHost: Disable this project as a shared VPC host project.
func (r *ProjectsService) DisableXpnResource(project string, projectsdisablexpnresourcerequest *ProjectsDisableXpnResourceRequest) *ProjectsDisableXpnResourceCall
DisableXpnResource: Disable a serivce resource (a.k.a service project) associated with this host project.
func (r *ProjectsService) EnableXpnHost(project string) *ProjectsEnableXpnHostCall
EnableXpnHost: Enable this project as a shared VPC host project.
func (r *ProjectsService) EnableXpnResource(project string, projectsenablexpnresourcerequest *ProjectsEnableXpnResourceRequest) *ProjectsEnableXpnResourceCall
EnableXpnResource: Enable service resource (a.k.a service project) for a host project, so that subnets in the host project can be used by instances in the service project.
func (r *ProjectsService) Get(project string) *ProjectsGetCall
Get: Returns the specified Project resource. For details, see https://cloud.google.com/compute/docs/reference/latest/projects/get
func (r *ProjectsService) GetXpnHost(project string) *ProjectsGetXpnHostCall
GetXpnHost: Get the shared VPC host project that this project links to. May be empty if no link exists.
func (r *ProjectsService) GetXpnResources(project string) *ProjectsGetXpnResourcesCall
GetXpnResources: Get service resources (a.k.a service project) associated with this host project.
func (r *ProjectsService) ListXpnHosts(project string, projectslistxpnhostsrequest *ProjectsListXpnHostsRequest) *ProjectsListXpnHostsCall
ListXpnHosts: List all shared VPC host projects visible to the user in an organization.
func (r *ProjectsService) MoveDisk(project string, diskmoverequest *DiskMoveRequest) *ProjectsMoveDiskCall
MoveDisk: Moves a persistent disk from one zone to another.
func (r *ProjectsService) MoveInstance(project string, instancemoverequest *InstanceMoveRequest) *ProjectsMoveInstanceCall
MoveInstance: Moves an instance and its attached persistent disks from one zone to another.
func (r *ProjectsService) SetCommonInstanceMetadata(project string, metadata *Metadata) *ProjectsSetCommonInstanceMetadataCall
SetCommonInstanceMetadata: Sets metadata common to all instances within the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/projects/setCommonInstanceMetadata
func (r *ProjectsService) SetUsageExportBucket(project string, usageexportlocation *UsageExportLocation) *ProjectsSetUsageExportBucketCall
SetUsageExportBucket: Enables the usage export feature and sets the usage export bucket where reports are stored. If you provide an empty request body using this method, the usage export feature will be disabled. For details, see https://cloud.google.com/compute/docs/reference/latest/projects/setUsageExportBucket
type ProjectsSetCommonInstanceMetadataCall struct {
// contains filtered or unexported fields
}func (c *ProjectsSetCommonInstanceMetadataCall) Context(ctx context.Context) *ProjectsSetCommonInstanceMetadataCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsSetCommonInstanceMetadataCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.projects.setCommonInstanceMetadata" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsSetCommonInstanceMetadataCall) Fields(s ...googleapi.Field) *ProjectsSetCommonInstanceMetadataCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsSetCommonInstanceMetadataCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsSetCommonInstanceMetadataCall) RequestId(requestId string) *ProjectsSetCommonInstanceMetadataCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type ProjectsSetUsageExportBucketCall struct {
// contains filtered or unexported fields
}func (c *ProjectsSetUsageExportBucketCall) Context(ctx context.Context) *ProjectsSetUsageExportBucketCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ProjectsSetUsageExportBucketCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.projects.setUsageExportBucket" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ProjectsSetUsageExportBucketCall) Fields(s ...googleapi.Field) *ProjectsSetUsageExportBucketCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ProjectsSetUsageExportBucketCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ProjectsSetUsageExportBucketCall) RequestId(requestId string) *ProjectsSetUsageExportBucketCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type Quota struct {
// Limit: [Output Only] Quota limit for this metric.
Limit float64 `json:"limit,omitempty"`
// Metric: [Output Only] Name of the quota metric.
//
// Possible values:
// "AUTOSCALERS"
// "BACKEND_BUCKETS"
// "BACKEND_SERVICES"
// "COMMITMENTS"
// "CPUS"
// "CPUS_ALL_REGIONS"
// "DISKS_TOTAL_GB"
// "FIREWALLS"
// "FORWARDING_RULES"
// "HEALTH_CHECKS"
// "IMAGES"
// "INSTANCES"
// "INSTANCE_GROUPS"
// "INSTANCE_GROUP_MANAGERS"
// "INSTANCE_TEMPLATES"
// "INTERCONNECTS"
// "INTERNAL_ADDRESSES"
// "IN_USE_ADDRESSES"
// "LOCAL_SSD_TOTAL_GB"
// "NETWORKS"
// "NVIDIA_K80_GPUS"
// "NVIDIA_P100_GPUS"
// "PREEMPTIBLE_CPUS"
// "PREEMPTIBLE_LOCAL_SSD_GB"
// "PREEMPTIBLE_NVIDIA_K80_GPUS"
// "PREEMPTIBLE_NVIDIA_P100_GPUS"
// "REGIONAL_AUTOSCALERS"
// "REGIONAL_INSTANCE_GROUP_MANAGERS"
// "ROUTERS"
// "ROUTES"
// "SECURITY_POLICIES"
// "SECURITY_POLICY_RULES"
// "SNAPSHOTS"
// "SSD_TOTAL_GB"
// "SSL_CERTIFICATES"
// "STATIC_ADDRESSES"
// "SUBNETWORKS"
// "TARGET_HTTPS_PROXIES"
// "TARGET_HTTP_PROXIES"
// "TARGET_INSTANCES"
// "TARGET_POOLS"
// "TARGET_SSL_PROXIES"
// "TARGET_TCP_PROXIES"
// "TARGET_VPN_GATEWAYS"
// "URL_MAPS"
// "VPN_TUNNELS"
Metric string `json:"metric,omitempty"`
// Usage: [Output Only] Current usage of this metric.
Usage float64 `json:"usage,omitempty"`
// ForceSendFields is a list of field names (e.g. "Limit") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Limit") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}Quota: A quotas entry.
type Region struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Deprecated: [Output Only] The deprecation status associated with this
// region.
Deprecated *DeprecationStatus `json:"deprecated,omitempty"`
// Description: [Output Only] Textual description of the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#region for
// regions.
Kind string `json:"kind,omitempty"`
// Name: [Output Only] Name of the resource.
Name string `json:"name,omitempty"`
// Quotas: [Output Only] Quotas assigned to this region.
Quotas []*Quota `json:"quotas,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Status: [Output Only] Status of the region, either UP or DOWN.
//
// Possible values:
// "DOWN"
// "UP"
Status string `json:"status,omitempty"`
// Zones: [Output Only] A list of zones available in this region, in the
// form of resource URLs.
Zones []string `json:"zones,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Region: Region resource. (== resource_for beta.regions ==) (== resource_for v1.regions ==)
type RegionAutoscalerList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Autoscaler resources.
Items []*Autoscaler `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *RegionAutoscalerListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RegionAutoscalerList: Contains a list of autoscalers.
func (s *RegionAutoscalerList) MarshalJSON() ([]byte, error)
type RegionAutoscalerListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*RegionAutoscalerListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RegionAutoscalerListWarning: [Output Only] Informational warning message.
func (s *RegionAutoscalerListWarning) MarshalJSON() ([]byte, error)
type RegionAutoscalerListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionAutoscalerListWarningData) MarshalJSON() ([]byte, error)
type RegionAutoscalersDeleteCall struct {
// contains filtered or unexported fields
}func (c *RegionAutoscalersDeleteCall) Context(ctx context.Context) *RegionAutoscalersDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionAutoscalersDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionAutoscalers.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionAutoscalersDeleteCall) Fields(s ...googleapi.Field) *RegionAutoscalersDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionAutoscalersDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionAutoscalersDeleteCall) RequestId(requestId string) *RegionAutoscalersDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionAutoscalersGetCall struct {
// contains filtered or unexported fields
}func (c *RegionAutoscalersGetCall) Context(ctx context.Context) *RegionAutoscalersGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionAutoscalersGetCall) Do(opts ...googleapi.CallOption) (*Autoscaler, error)
Do executes the "compute.regionAutoscalers.get" call. Exactly one of *Autoscaler or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Autoscaler.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionAutoscalersGetCall) Fields(s ...googleapi.Field) *RegionAutoscalersGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionAutoscalersGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionAutoscalersGetCall) IfNoneMatch(entityTag string) *RegionAutoscalersGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type RegionAutoscalersInsertCall struct {
// contains filtered or unexported fields
}func (c *RegionAutoscalersInsertCall) Context(ctx context.Context) *RegionAutoscalersInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionAutoscalersInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionAutoscalers.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionAutoscalersInsertCall) Fields(s ...googleapi.Field) *RegionAutoscalersInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionAutoscalersInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionAutoscalersInsertCall) RequestId(requestId string) *RegionAutoscalersInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionAutoscalersListCall struct {
// contains filtered or unexported fields
}func (c *RegionAutoscalersListCall) Context(ctx context.Context) *RegionAutoscalersListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionAutoscalersListCall) Do(opts ...googleapi.CallOption) (*RegionAutoscalerList, error)
Do executes the "compute.regionAutoscalers.list" call. Exactly one of *RegionAutoscalerList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RegionAutoscalerList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionAutoscalersListCall) Fields(s ...googleapi.Field) *RegionAutoscalersListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionAutoscalersListCall) Filter(filter string) *RegionAutoscalersListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RegionAutoscalersListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionAutoscalersListCall) IfNoneMatch(entityTag string) *RegionAutoscalersListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RegionAutoscalersListCall) MaxResults(maxResults int64) *RegionAutoscalersListCall
MaxResults sets the optional parameter "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)
func (c *RegionAutoscalersListCall) OrderBy(orderBy string) *RegionAutoscalersListCall
OrderBy sets the optional parameter "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.
func (c *RegionAutoscalersListCall) PageToken(pageToken string) *RegionAutoscalersListCall
PageToken sets the optional parameter "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.
func (c *RegionAutoscalersListCall) Pages(ctx context.Context, f func(*RegionAutoscalerList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RegionAutoscalersPatchCall struct {
// contains filtered or unexported fields
}func (c *RegionAutoscalersPatchCall) Autoscaler(autoscaler string) *RegionAutoscalersPatchCall
Autoscaler sets the optional parameter "autoscaler": Name of the autoscaler to patch.
func (c *RegionAutoscalersPatchCall) Context(ctx context.Context) *RegionAutoscalersPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionAutoscalersPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionAutoscalers.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionAutoscalersPatchCall) Fields(s ...googleapi.Field) *RegionAutoscalersPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionAutoscalersPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionAutoscalersPatchCall) RequestId(requestId string) *RegionAutoscalersPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionAutoscalersService struct {
// contains filtered or unexported fields
}func NewRegionAutoscalersService(s *Service) *RegionAutoscalersService
func (r *RegionAutoscalersService) Delete(project string, region string, autoscaler string) *RegionAutoscalersDeleteCall
Delete: Deletes the specified autoscaler.
func (r *RegionAutoscalersService) Get(project string, region string, autoscaler string) *RegionAutoscalersGetCall
Get: Returns the specified autoscaler.
func (r *RegionAutoscalersService) Insert(project string, region string, autoscaler *Autoscaler) *RegionAutoscalersInsertCall
Insert: Creates an autoscaler in the specified project using the data included in the request.
func (r *RegionAutoscalersService) List(project string, region string) *RegionAutoscalersListCall
List: Retrieves a list of autoscalers contained within the specified region.
func (r *RegionAutoscalersService) Patch(project string, region string, autoscaler *Autoscaler) *RegionAutoscalersPatchCall
Patch: Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
func (r *RegionAutoscalersService) Update(project string, region string, autoscaler *Autoscaler) *RegionAutoscalersUpdateCall
Update: Updates an autoscaler in the specified project using the data included in the request.
type RegionAutoscalersUpdateCall struct {
// contains filtered or unexported fields
}func (c *RegionAutoscalersUpdateCall) Autoscaler(autoscaler string) *RegionAutoscalersUpdateCall
Autoscaler sets the optional parameter "autoscaler": Name of the autoscaler to update.
func (c *RegionAutoscalersUpdateCall) Context(ctx context.Context) *RegionAutoscalersUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionAutoscalersUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionAutoscalers.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionAutoscalersUpdateCall) Fields(s ...googleapi.Field) *RegionAutoscalersUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionAutoscalersUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionAutoscalersUpdateCall) RequestId(requestId string) *RegionAutoscalersUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionBackendServicesDeleteCall struct {
// contains filtered or unexported fields
}func (c *RegionBackendServicesDeleteCall) Context(ctx context.Context) *RegionBackendServicesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionBackendServicesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionBackendServices.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionBackendServicesDeleteCall) Fields(s ...googleapi.Field) *RegionBackendServicesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionBackendServicesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionBackendServicesDeleteCall) RequestId(requestId string) *RegionBackendServicesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionBackendServicesGetCall struct {
// contains filtered or unexported fields
}func (c *RegionBackendServicesGetCall) Context(ctx context.Context) *RegionBackendServicesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionBackendServicesGetCall) Do(opts ...googleapi.CallOption) (*BackendService, error)
Do executes the "compute.regionBackendServices.get" call. Exactly one of *BackendService or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BackendService.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionBackendServicesGetCall) Fields(s ...googleapi.Field) *RegionBackendServicesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionBackendServicesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionBackendServicesGetCall) IfNoneMatch(entityTag string) *RegionBackendServicesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type RegionBackendServicesGetHealthCall struct {
// contains filtered or unexported fields
}func (c *RegionBackendServicesGetHealthCall) Context(ctx context.Context) *RegionBackendServicesGetHealthCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionBackendServicesGetHealthCall) Do(opts ...googleapi.CallOption) (*BackendServiceGroupHealth, error)
Do executes the "compute.regionBackendServices.getHealth" call. Exactly one of *BackendServiceGroupHealth or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BackendServiceGroupHealth.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionBackendServicesGetHealthCall) Fields(s ...googleapi.Field) *RegionBackendServicesGetHealthCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionBackendServicesGetHealthCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type RegionBackendServicesInsertCall struct {
// contains filtered or unexported fields
}func (c *RegionBackendServicesInsertCall) Context(ctx context.Context) *RegionBackendServicesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionBackendServicesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionBackendServices.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionBackendServicesInsertCall) Fields(s ...googleapi.Field) *RegionBackendServicesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionBackendServicesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionBackendServicesInsertCall) RequestId(requestId string) *RegionBackendServicesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionBackendServicesListCall struct {
// contains filtered or unexported fields
}func (c *RegionBackendServicesListCall) Context(ctx context.Context) *RegionBackendServicesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionBackendServicesListCall) Do(opts ...googleapi.CallOption) (*BackendServiceList, error)
Do executes the "compute.regionBackendServices.list" call. Exactly one of *BackendServiceList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *BackendServiceList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionBackendServicesListCall) Fields(s ...googleapi.Field) *RegionBackendServicesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionBackendServicesListCall) Filter(filter string) *RegionBackendServicesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RegionBackendServicesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionBackendServicesListCall) IfNoneMatch(entityTag string) *RegionBackendServicesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RegionBackendServicesListCall) MaxResults(maxResults int64) *RegionBackendServicesListCall
MaxResults sets the optional parameter "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)
func (c *RegionBackendServicesListCall) OrderBy(orderBy string) *RegionBackendServicesListCall
OrderBy sets the optional parameter "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.
func (c *RegionBackendServicesListCall) PageToken(pageToken string) *RegionBackendServicesListCall
PageToken sets the optional parameter "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.
func (c *RegionBackendServicesListCall) Pages(ctx context.Context, f func(*BackendServiceList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RegionBackendServicesPatchCall struct {
// contains filtered or unexported fields
}func (c *RegionBackendServicesPatchCall) Context(ctx context.Context) *RegionBackendServicesPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionBackendServicesPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionBackendServices.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionBackendServicesPatchCall) Fields(s ...googleapi.Field) *RegionBackendServicesPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionBackendServicesPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionBackendServicesPatchCall) RequestId(requestId string) *RegionBackendServicesPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionBackendServicesService struct {
// contains filtered or unexported fields
}func NewRegionBackendServicesService(s *Service) *RegionBackendServicesService
func (r *RegionBackendServicesService) Delete(project string, region string, backendService string) *RegionBackendServicesDeleteCall
Delete: Deletes the specified regional BackendService resource.
func (r *RegionBackendServicesService) Get(project string, region string, backendService string) *RegionBackendServicesGetCall
Get: Returns the specified regional BackendService resource.
func (r *RegionBackendServicesService) GetHealth(project string, region string, backendService string, resourcegroupreference *ResourceGroupReference) *RegionBackendServicesGetHealthCall
GetHealth: Gets the most recent health check results for this regional BackendService.
func (r *RegionBackendServicesService) Insert(project string, region string, backendservice *BackendService) *RegionBackendServicesInsertCall
Insert: Creates a regional BackendService resource in the specified project using the data included in the request. There are several restrictions and guidelines to keep in mind when creating a regional backend service. Read Restrictions and Guidelines for more information.
func (r *RegionBackendServicesService) List(project string, region string) *RegionBackendServicesListCall
List: Retrieves the list of regional BackendService resources available to the specified project in the given region.
func (r *RegionBackendServicesService) Patch(project string, region string, backendService string, backendservice *BackendService) *RegionBackendServicesPatchCall
Patch: Updates the specified regional BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read Restrictions and Guidelines for more information. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.
func (r *RegionBackendServicesService) Update(project string, region string, backendService string, backendservice *BackendService) *RegionBackendServicesUpdateCall
Update: Updates the specified regional BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read Restrictions and Guidelines for more information.
type RegionBackendServicesUpdateCall struct {
// contains filtered or unexported fields
}func (c *RegionBackendServicesUpdateCall) Context(ctx context.Context) *RegionBackendServicesUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionBackendServicesUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionBackendServices.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionBackendServicesUpdateCall) Fields(s ...googleapi.Field) *RegionBackendServicesUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionBackendServicesUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionBackendServicesUpdateCall) RequestId(requestId string) *RegionBackendServicesUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionCommitmentsAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *RegionCommitmentsAggregatedListCall) Context(ctx context.Context) *RegionCommitmentsAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionCommitmentsAggregatedListCall) Do(opts ...googleapi.CallOption) (*CommitmentAggregatedList, error)
Do executes the "compute.regionCommitments.aggregatedList" call. Exactly one of *CommitmentAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *CommitmentAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionCommitmentsAggregatedListCall) Fields(s ...googleapi.Field) *RegionCommitmentsAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionCommitmentsAggregatedListCall) Filter(filter string) *RegionCommitmentsAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RegionCommitmentsAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionCommitmentsAggregatedListCall) IfNoneMatch(entityTag string) *RegionCommitmentsAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RegionCommitmentsAggregatedListCall) MaxResults(maxResults int64) *RegionCommitmentsAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *RegionCommitmentsAggregatedListCall) OrderBy(orderBy string) *RegionCommitmentsAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *RegionCommitmentsAggregatedListCall) PageToken(pageToken string) *RegionCommitmentsAggregatedListCall
PageToken sets the optional parameter "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.
func (c *RegionCommitmentsAggregatedListCall) Pages(ctx context.Context, f func(*CommitmentAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RegionCommitmentsGetCall struct {
// contains filtered or unexported fields
}func (c *RegionCommitmentsGetCall) Context(ctx context.Context) *RegionCommitmentsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionCommitmentsGetCall) Do(opts ...googleapi.CallOption) (*Commitment, error)
Do executes the "compute.regionCommitments.get" call. Exactly one of *Commitment or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Commitment.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionCommitmentsGetCall) Fields(s ...googleapi.Field) *RegionCommitmentsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionCommitmentsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionCommitmentsGetCall) IfNoneMatch(entityTag string) *RegionCommitmentsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type RegionCommitmentsInsertCall struct {
// contains filtered or unexported fields
}func (c *RegionCommitmentsInsertCall) Context(ctx context.Context) *RegionCommitmentsInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionCommitmentsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionCommitments.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionCommitmentsInsertCall) Fields(s ...googleapi.Field) *RegionCommitmentsInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionCommitmentsInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionCommitmentsInsertCall) RequestId(requestId string) *RegionCommitmentsInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionCommitmentsListCall struct {
// contains filtered or unexported fields
}func (c *RegionCommitmentsListCall) Context(ctx context.Context) *RegionCommitmentsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionCommitmentsListCall) Do(opts ...googleapi.CallOption) (*CommitmentList, error)
Do executes the "compute.regionCommitments.list" call. Exactly one of *CommitmentList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *CommitmentList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionCommitmentsListCall) Fields(s ...googleapi.Field) *RegionCommitmentsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionCommitmentsListCall) Filter(filter string) *RegionCommitmentsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RegionCommitmentsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionCommitmentsListCall) IfNoneMatch(entityTag string) *RegionCommitmentsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RegionCommitmentsListCall) MaxResults(maxResults int64) *RegionCommitmentsListCall
MaxResults sets the optional parameter "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)
func (c *RegionCommitmentsListCall) OrderBy(orderBy string) *RegionCommitmentsListCall
OrderBy sets the optional parameter "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.
func (c *RegionCommitmentsListCall) PageToken(pageToken string) *RegionCommitmentsListCall
PageToken sets the optional parameter "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.
func (c *RegionCommitmentsListCall) Pages(ctx context.Context, f func(*CommitmentList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RegionCommitmentsService struct {
// contains filtered or unexported fields
}func NewRegionCommitmentsService(s *Service) *RegionCommitmentsService
func (r *RegionCommitmentsService) AggregatedList(project string) *RegionCommitmentsAggregatedListCall
AggregatedList: Retrieves an aggregated list of commitments.
func (r *RegionCommitmentsService) Get(project string, region string, commitment string) *RegionCommitmentsGetCall
Get: Returns the specified commitment resource. Get a list of available commitments by making a list() request.
func (r *RegionCommitmentsService) Insert(project string, region string, commitment *Commitment) *RegionCommitmentsInsertCall
Insert: Creates a commitment in the specified project using the data included in the request.
func (r *RegionCommitmentsService) List(project string, region string) *RegionCommitmentsListCall
List: Retrieves a list of commitments contained within the specified region.
type RegionInstanceGroupList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InstanceGroup resources.
Items []*InstanceGroup `json:"items,omitempty"`
// Kind: The resource type.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *RegionInstanceGroupListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RegionInstanceGroupList: Contains a list of InstanceGroup resources.
func (s *RegionInstanceGroupList) MarshalJSON() ([]byte, error)
type RegionInstanceGroupListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*RegionInstanceGroupListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RegionInstanceGroupListWarning: [Output Only] Informational warning message.
func (s *RegionInstanceGroupListWarning) MarshalJSON() ([]byte, error)
type RegionInstanceGroupListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupListWarningData) MarshalJSON() ([]byte, error)
type RegionInstanceGroupManagerList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InstanceGroupManager resources.
Items []*InstanceGroupManager `json:"items,omitempty"`
// Kind: [Output Only] The resource type, which is always
// compute#instanceGroupManagerList for a list of managed instance
// groups that exist in th regional scope.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *RegionInstanceGroupManagerListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RegionInstanceGroupManagerList: Contains a list of managed instance groups.
func (s *RegionInstanceGroupManagerList) MarshalJSON() ([]byte, error)
type RegionInstanceGroupManagerListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*RegionInstanceGroupManagerListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RegionInstanceGroupManagerListWarning: [Output Only] Informational warning message.
func (s *RegionInstanceGroupManagerListWarning) MarshalJSON() ([]byte, error)
type RegionInstanceGroupManagerListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupManagerListWarningData) MarshalJSON() ([]byte, error)
type RegionInstanceGroupManagersAbandonInstancesCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersAbandonInstancesCall) Context(ctx context.Context) *RegionInstanceGroupManagersAbandonInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersAbandonInstancesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionInstanceGroupManagers.abandonInstances" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersAbandonInstancesCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersAbandonInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersAbandonInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersAbandonInstancesCall) RequestId(requestId string) *RegionInstanceGroupManagersAbandonInstancesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionInstanceGroupManagersAbandonInstancesRequest struct {
// Instances: The URLs of one or more instances to abandon. This can be
// a full URL or a partial URL, such as
// zones/[ZONE]/instances/[INSTANCE_NAME].
Instances []string `json:"instances,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupManagersAbandonInstancesRequest) MarshalJSON() ([]byte, error)
type RegionInstanceGroupManagersDeleteCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersDeleteCall) Context(ctx context.Context) *RegionInstanceGroupManagersDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionInstanceGroupManagers.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersDeleteCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersDeleteCall) RequestId(requestId string) *RegionInstanceGroupManagersDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionInstanceGroupManagersDeleteInstancesCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersDeleteInstancesCall) Context(ctx context.Context) *RegionInstanceGroupManagersDeleteInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersDeleteInstancesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionInstanceGroupManagers.deleteInstances" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersDeleteInstancesCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersDeleteInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersDeleteInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersDeleteInstancesCall) RequestId(requestId string) *RegionInstanceGroupManagersDeleteInstancesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionInstanceGroupManagersDeleteInstancesRequest struct {
// Instances: The URLs of one or more instances to delete. This can be a
// full URL or a partial URL, such as
// zones/[ZONE]/instances/[INSTANCE_NAME].
Instances []string `json:"instances,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupManagersDeleteInstancesRequest) MarshalJSON() ([]byte, error)
type RegionInstanceGroupManagersGetCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersGetCall) Context(ctx context.Context) *RegionInstanceGroupManagersGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersGetCall) Do(opts ...googleapi.CallOption) (*InstanceGroupManager, error)
Do executes the "compute.regionInstanceGroupManagers.get" call. Exactly one of *InstanceGroupManager or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceGroupManager.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersGetCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersGetCall) IfNoneMatch(entityTag string) *RegionInstanceGroupManagersGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type RegionInstanceGroupManagersInsertCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersInsertCall) Context(ctx context.Context) *RegionInstanceGroupManagersInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionInstanceGroupManagers.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersInsertCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersInsertCall) RequestId(requestId string) *RegionInstanceGroupManagersInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionInstanceGroupManagersListCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersListCall) Context(ctx context.Context) *RegionInstanceGroupManagersListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersListCall) Do(opts ...googleapi.CallOption) (*RegionInstanceGroupManagerList, error)
Do executes the "compute.regionInstanceGroupManagers.list" call. Exactly one of *RegionInstanceGroupManagerList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RegionInstanceGroupManagerList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersListCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersListCall) Filter(filter string) *RegionInstanceGroupManagersListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RegionInstanceGroupManagersListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersListCall) IfNoneMatch(entityTag string) *RegionInstanceGroupManagersListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RegionInstanceGroupManagersListCall) MaxResults(maxResults int64) *RegionInstanceGroupManagersListCall
MaxResults sets the optional parameter "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)
func (c *RegionInstanceGroupManagersListCall) OrderBy(orderBy string) *RegionInstanceGroupManagersListCall
OrderBy sets the optional parameter "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.
func (c *RegionInstanceGroupManagersListCall) PageToken(pageToken string) *RegionInstanceGroupManagersListCall
PageToken sets the optional parameter "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.
func (c *RegionInstanceGroupManagersListCall) Pages(ctx context.Context, f func(*RegionInstanceGroupManagerList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RegionInstanceGroupManagersListInstancesResponse struct {
// ManagedInstances: List of managed instances.
ManagedInstances []*ManagedInstance `json:"managedInstances,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "ManagedInstances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ManagedInstances") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupManagersListInstancesResponse) MarshalJSON() ([]byte, error)
type RegionInstanceGroupManagersListManagedInstancesCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersListManagedInstancesCall) Context(ctx context.Context) *RegionInstanceGroupManagersListManagedInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersListManagedInstancesCall) Do(opts ...googleapi.CallOption) (*RegionInstanceGroupManagersListInstancesResponse, error)
Do executes the "compute.regionInstanceGroupManagers.listManagedInstances" call. Exactly one of *RegionInstanceGroupManagersListInstancesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RegionInstanceGroupManagersListInstancesResponse.ServerResponse.Heade r or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersListManagedInstancesCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersListManagedInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersListManagedInstancesCall) Filter(filter string) *RegionInstanceGroupManagersListManagedInstancesCall
Filter sets the optional parameter "filter":
func (c *RegionInstanceGroupManagersListManagedInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersListManagedInstancesCall) MaxResults(maxResults int64) *RegionInstanceGroupManagersListManagedInstancesCall
MaxResults sets the optional parameter "maxResults":
func (c *RegionInstanceGroupManagersListManagedInstancesCall) OrderBy(orderBy string) *RegionInstanceGroupManagersListManagedInstancesCall
OrderBy sets the optional parameter "order_by":
func (c *RegionInstanceGroupManagersListManagedInstancesCall) PageToken(pageToken string) *RegionInstanceGroupManagersListManagedInstancesCall
PageToken sets the optional parameter "pageToken":
type RegionInstanceGroupManagersRecreateInstancesCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersRecreateInstancesCall) Context(ctx context.Context) *RegionInstanceGroupManagersRecreateInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersRecreateInstancesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionInstanceGroupManagers.recreateInstances" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersRecreateInstancesCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersRecreateInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersRecreateInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersRecreateInstancesCall) RequestId(requestId string) *RegionInstanceGroupManagersRecreateInstancesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionInstanceGroupManagersRecreateRequest struct {
// Instances: The URLs of one or more instances to recreate. This can be
// a full URL or a partial URL, such as
// zones/[ZONE]/instances/[INSTANCE_NAME].
Instances []string `json:"instances,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupManagersRecreateRequest) MarshalJSON() ([]byte, error)
type RegionInstanceGroupManagersResizeCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersResizeCall) Context(ctx context.Context) *RegionInstanceGroupManagersResizeCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersResizeCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionInstanceGroupManagers.resize" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersResizeCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersResizeCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersResizeCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersResizeCall) RequestId(requestId string) *RegionInstanceGroupManagersResizeCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionInstanceGroupManagersService struct {
// contains filtered or unexported fields
}func NewRegionInstanceGroupManagersService(s *Service) *RegionInstanceGroupManagersService
func (r *RegionInstanceGroupManagersService) AbandonInstances(project string, region string, instanceGroupManager string, regioninstancegroupmanagersabandoninstancesrequest *RegionInstanceGroupManagersAbandonInstancesRequest) *RegionInstanceGroupManagersAbandonInstancesCall
AbandonInstances: Schedules a group action to remove the specified instances from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
func (r *RegionInstanceGroupManagersService) Delete(project string, region string, instanceGroupManager string) *RegionInstanceGroupManagersDeleteCall
Delete: Deletes the specified managed instance group and all of the instances in that group.
func (r *RegionInstanceGroupManagersService) DeleteInstances(project string, region string, instanceGroupManager string, regioninstancegroupmanagersdeleteinstancesrequest *RegionInstanceGroupManagersDeleteInstancesRequest) *RegionInstanceGroupManagersDeleteInstancesCall
DeleteInstances: Schedules a group action to delete the specified instances in the managed instance group. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
func (r *RegionInstanceGroupManagersService) Get(project string, region string, instanceGroupManager string) *RegionInstanceGroupManagersGetCall
Get: Returns all of the details about the specified managed instance group.
func (r *RegionInstanceGroupManagersService) Insert(project string, region string, instancegroupmanager *InstanceGroupManager) *RegionInstanceGroupManagersInsertCall
Insert: Creates a managed instance group using the information that you specify in the request. After the group is created, it schedules an action to create instances in the group using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.
A regional managed instance group can contain up to 2000 instances.
func (r *RegionInstanceGroupManagersService) List(project string, region string) *RegionInstanceGroupManagersListCall
List: Retrieves the list of managed instance groups that are contained within the specified region.
func (r *RegionInstanceGroupManagersService) ListManagedInstances(project string, region string, instanceGroupManager string) *RegionInstanceGroupManagersListManagedInstancesCall
ListManagedInstances: Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances.
func (r *RegionInstanceGroupManagersService) RecreateInstances(project string, region string, instanceGroupManager string, regioninstancegroupmanagersrecreaterequest *RegionInstanceGroupManagersRecreateRequest) *RegionInstanceGroupManagersRecreateInstancesCall
RecreateInstances: Schedules a group action to recreate the specified instances in the managed instance group. The instances are deleted and recreated using the current instance template for the managed instance group. This operation is marked as DONE when the action is scheduled even if the instances have not yet been recreated. You must separately verify the status of the recreating action with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
You can specify a maximum of 1000 instances with this method per request.
func (r *RegionInstanceGroupManagersService) Resize(project string, region string, instanceGroupManager string, size int64) *RegionInstanceGroupManagersResizeCall
Resize: Changes the intended size for the managed instance group. If you increase the size, the group schedules actions to create new instances using the current instance template. If you decrease the size, the group schedules delete actions on one or more instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.
If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted.
func (r *RegionInstanceGroupManagersService) SetInstanceTemplate(project string, region string, instanceGroupManager string, regioninstancegroupmanagerssettemplaterequest *RegionInstanceGroupManagersSetTemplateRequest) *RegionInstanceGroupManagersSetInstanceTemplateCall
SetInstanceTemplate: Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected.
func (r *RegionInstanceGroupManagersService) SetTargetPools(project string, region string, instanceGroupManager string, regioninstancegroupmanagerssettargetpoolsrequest *RegionInstanceGroupManagersSetTargetPoolsRequest) *RegionInstanceGroupManagersSetTargetPoolsCall
SetTargetPools: Modifies the target pools to which all new instances in this group are assigned. Existing instances in the group are not affected.
type RegionInstanceGroupManagersSetInstanceTemplateCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersSetInstanceTemplateCall) Context(ctx context.Context) *RegionInstanceGroupManagersSetInstanceTemplateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersSetInstanceTemplateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionInstanceGroupManagers.setInstanceTemplate" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersSetInstanceTemplateCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersSetInstanceTemplateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersSetInstanceTemplateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersSetInstanceTemplateCall) RequestId(requestId string) *RegionInstanceGroupManagersSetInstanceTemplateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionInstanceGroupManagersSetTargetPoolsCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupManagersSetTargetPoolsCall) Context(ctx context.Context) *RegionInstanceGroupManagersSetTargetPoolsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupManagersSetTargetPoolsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionInstanceGroupManagers.setTargetPools" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupManagersSetTargetPoolsCall) Fields(s ...googleapi.Field) *RegionInstanceGroupManagersSetTargetPoolsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupManagersSetTargetPoolsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupManagersSetTargetPoolsCall) RequestId(requestId string) *RegionInstanceGroupManagersSetTargetPoolsCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionInstanceGroupManagersSetTargetPoolsRequest struct {
// Fingerprint: Fingerprint of the target pools information, which is a
// hash of the contents. This field is used for optimistic locking when
// you update the target pool entries. This field is optional.
Fingerprint string `json:"fingerprint,omitempty"`
// TargetPools: The URL of all TargetPool resources to which instances
// in the instanceGroup field are added. The target pools automatically
// apply to all of the instances in the managed instance group.
TargetPools []string `json:"targetPools,omitempty"`
// ForceSendFields is a list of field names (e.g. "Fingerprint") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Fingerprint") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupManagersSetTargetPoolsRequest) MarshalJSON() ([]byte, error)
type RegionInstanceGroupManagersSetTemplateRequest struct {
// InstanceTemplate: URL of the InstanceTemplate resource from which all
// new instances will be created.
InstanceTemplate string `json:"instanceTemplate,omitempty"`
// ForceSendFields is a list of field names (e.g. "InstanceTemplate") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "InstanceTemplate") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupManagersSetTemplateRequest) MarshalJSON() ([]byte, error)
type RegionInstanceGroupsGetCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupsGetCall) Context(ctx context.Context) *RegionInstanceGroupsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupsGetCall) Do(opts ...googleapi.CallOption) (*InstanceGroup, error)
Do executes the "compute.regionInstanceGroups.get" call. Exactly one of *InstanceGroup or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *InstanceGroup.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupsGetCall) Fields(s ...googleapi.Field) *RegionInstanceGroupsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupsGetCall) IfNoneMatch(entityTag string) *RegionInstanceGroupsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type RegionInstanceGroupsListCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupsListCall) Context(ctx context.Context) *RegionInstanceGroupsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupsListCall) Do(opts ...googleapi.CallOption) (*RegionInstanceGroupList, error)
Do executes the "compute.regionInstanceGroups.list" call. Exactly one of *RegionInstanceGroupList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RegionInstanceGroupList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupsListCall) Fields(s ...googleapi.Field) *RegionInstanceGroupsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupsListCall) Filter(filter string) *RegionInstanceGroupsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RegionInstanceGroupsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupsListCall) IfNoneMatch(entityTag string) *RegionInstanceGroupsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RegionInstanceGroupsListCall) MaxResults(maxResults int64) *RegionInstanceGroupsListCall
MaxResults sets the optional parameter "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)
func (c *RegionInstanceGroupsListCall) OrderBy(orderBy string) *RegionInstanceGroupsListCall
OrderBy sets the optional parameter "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.
func (c *RegionInstanceGroupsListCall) PageToken(pageToken string) *RegionInstanceGroupsListCall
PageToken sets the optional parameter "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.
func (c *RegionInstanceGroupsListCall) Pages(ctx context.Context, f func(*RegionInstanceGroupList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RegionInstanceGroupsListInstances struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of InstanceWithNamedPorts resources.
Items []*InstanceWithNamedPorts `json:"items,omitempty"`
// Kind: The resource type.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *RegionInstanceGroupsListInstancesWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupsListInstances) MarshalJSON() ([]byte, error)
type RegionInstanceGroupsListInstancesCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupsListInstancesCall) Context(ctx context.Context) *RegionInstanceGroupsListInstancesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupsListInstancesCall) Do(opts ...googleapi.CallOption) (*RegionInstanceGroupsListInstances, error)
Do executes the "compute.regionInstanceGroups.listInstances" call. Exactly one of *RegionInstanceGroupsListInstances or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RegionInstanceGroupsListInstances.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupsListInstancesCall) Fields(s ...googleapi.Field) *RegionInstanceGroupsListInstancesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupsListInstancesCall) Filter(filter string) *RegionInstanceGroupsListInstancesCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RegionInstanceGroupsListInstancesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupsListInstancesCall) MaxResults(maxResults int64) *RegionInstanceGroupsListInstancesCall
MaxResults sets the optional parameter "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)
func (c *RegionInstanceGroupsListInstancesCall) OrderBy(orderBy string) *RegionInstanceGroupsListInstancesCall
OrderBy sets the optional parameter "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.
func (c *RegionInstanceGroupsListInstancesCall) PageToken(pageToken string) *RegionInstanceGroupsListInstancesCall
PageToken sets the optional parameter "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.
func (c *RegionInstanceGroupsListInstancesCall) Pages(ctx context.Context, f func(*RegionInstanceGroupsListInstances) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RegionInstanceGroupsListInstancesRequest struct {
// InstanceState: Instances in which state should be returned. Valid
// options are: 'ALL', 'RUNNING'. By default, it lists all instances.
//
// Possible values:
// "ALL"
// "RUNNING"
InstanceState string `json:"instanceState,omitempty"`
// PortName: Name of port user is interested in. It is optional. If it
// is set, only information about this ports will be returned. If it is
// not set, all the named ports will be returned. Always lists all
// instances.
PortName string `json:"portName,omitempty"`
// ForceSendFields is a list of field names (e.g. "InstanceState") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "InstanceState") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupsListInstancesRequest) MarshalJSON() ([]byte, error)
type RegionInstanceGroupsListInstancesWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*RegionInstanceGroupsListInstancesWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RegionInstanceGroupsListInstancesWarning: [Output Only] Informational warning message.
func (s *RegionInstanceGroupsListInstancesWarning) MarshalJSON() ([]byte, error)
type RegionInstanceGroupsListInstancesWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupsListInstancesWarningData) MarshalJSON() ([]byte, error)
type RegionInstanceGroupsService struct {
// contains filtered or unexported fields
}func NewRegionInstanceGroupsService(s *Service) *RegionInstanceGroupsService
func (r *RegionInstanceGroupsService) Get(project string, region string, instanceGroup string) *RegionInstanceGroupsGetCall
Get: Returns the specified instance group resource.
func (r *RegionInstanceGroupsService) List(project string, region string) *RegionInstanceGroupsListCall
List: Retrieves the list of instance group resources contained within the specified region.
func (r *RegionInstanceGroupsService) ListInstances(project string, region string, instanceGroup string, regioninstancegroupslistinstancesrequest *RegionInstanceGroupsListInstancesRequest) *RegionInstanceGroupsListInstancesCall
ListInstances: Lists the instances in the specified instance group and displays information about the named ports. Depending on the specified options, this method can list all instances or only the instances that are running.
func (r *RegionInstanceGroupsService) SetNamedPorts(project string, region string, instanceGroup string, regioninstancegroupssetnamedportsrequest *RegionInstanceGroupsSetNamedPortsRequest) *RegionInstanceGroupsSetNamedPortsCall
SetNamedPorts: Sets the named ports for the specified regional instance group.
type RegionInstanceGroupsSetNamedPortsCall struct {
// contains filtered or unexported fields
}func (c *RegionInstanceGroupsSetNamedPortsCall) Context(ctx context.Context) *RegionInstanceGroupsSetNamedPortsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionInstanceGroupsSetNamedPortsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionInstanceGroups.setNamedPorts" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionInstanceGroupsSetNamedPortsCall) Fields(s ...googleapi.Field) *RegionInstanceGroupsSetNamedPortsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionInstanceGroupsSetNamedPortsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionInstanceGroupsSetNamedPortsCall) RequestId(requestId string) *RegionInstanceGroupsSetNamedPortsCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RegionInstanceGroupsSetNamedPortsRequest struct {
// Fingerprint: The fingerprint of the named ports information for this
// instance group. Use this optional property to prevent conflicts when
// multiple users change the named ports settings concurrently. Obtain
// the fingerprint with the instanceGroups.get method. Then, include the
// fingerprint in your request to ensure that you do not overwrite
// changes that were applied from another concurrent request.
Fingerprint string `json:"fingerprint,omitempty"`
// NamedPorts: The list of named ports to set for this instance group.
NamedPorts []*NamedPort `json:"namedPorts,omitempty"`
// ForceSendFields is a list of field names (e.g. "Fingerprint") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Fingerprint") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionInstanceGroupsSetNamedPortsRequest) MarshalJSON() ([]byte, error)
type RegionList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Region resources.
Items []*Region `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#regionList for
// lists of regions.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *RegionListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RegionList: Contains a list of region resources.
func (s *RegionList) MarshalJSON() ([]byte, error)
type RegionListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*RegionListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RegionListWarning: [Output Only] Informational warning message.
func (s *RegionListWarning) MarshalJSON() ([]byte, error)
type RegionListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RegionListWarningData) MarshalJSON() ([]byte, error)
type RegionOperationsDeleteCall struct {
// contains filtered or unexported fields
}func (c *RegionOperationsDeleteCall) Context(ctx context.Context) *RegionOperationsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionOperationsDeleteCall) Do(opts ...googleapi.CallOption) error
Do executes the "compute.regionOperations.delete" call.
func (c *RegionOperationsDeleteCall) Fields(s ...googleapi.Field) *RegionOperationsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionOperationsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type RegionOperationsGetCall struct {
// contains filtered or unexported fields
}func (c *RegionOperationsGetCall) Context(ctx context.Context) *RegionOperationsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.regionOperations.get" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionOperationsGetCall) Fields(s ...googleapi.Field) *RegionOperationsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionOperationsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionOperationsGetCall) IfNoneMatch(entityTag string) *RegionOperationsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type RegionOperationsListCall struct {
// contains filtered or unexported fields
}func (c *RegionOperationsListCall) Context(ctx context.Context) *RegionOperationsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionOperationsListCall) Do(opts ...googleapi.CallOption) (*OperationList, error)
Do executes the "compute.regionOperations.list" call. Exactly one of *OperationList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *OperationList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionOperationsListCall) Fields(s ...googleapi.Field) *RegionOperationsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionOperationsListCall) Filter(filter string) *RegionOperationsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RegionOperationsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionOperationsListCall) IfNoneMatch(entityTag string) *RegionOperationsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RegionOperationsListCall) MaxResults(maxResults int64) *RegionOperationsListCall
MaxResults sets the optional parameter "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)
func (c *RegionOperationsListCall) OrderBy(orderBy string) *RegionOperationsListCall
OrderBy sets the optional parameter "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.
func (c *RegionOperationsListCall) PageToken(pageToken string) *RegionOperationsListCall
PageToken sets the optional parameter "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.
func (c *RegionOperationsListCall) Pages(ctx context.Context, f func(*OperationList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RegionOperationsService struct {
// contains filtered or unexported fields
}func NewRegionOperationsService(s *Service) *RegionOperationsService
func (r *RegionOperationsService) Delete(project string, region string, operation string) *RegionOperationsDeleteCall
Delete: Deletes the specified region-specific Operations resource. For details, see https://cloud.google.com/compute/docs/reference/latest/regionOperations/delete
func (r *RegionOperationsService) Get(project string, region string, operation string) *RegionOperationsGetCall
Get: Retrieves the specified region-specific Operations resource. For details, see https://cloud.google.com/compute/docs/reference/latest/regionOperations/get
func (r *RegionOperationsService) List(project string, region string) *RegionOperationsListCall
List: Retrieves a list of Operation resources contained within the specified region. For details, see https://cloud.google.com/compute/docs/reference/latest/regionOperations/list
type RegionsGetCall struct {
// contains filtered or unexported fields
}func (c *RegionsGetCall) Context(ctx context.Context) *RegionsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionsGetCall) Do(opts ...googleapi.CallOption) (*Region, error)
Do executes the "compute.regions.get" call. Exactly one of *Region or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Region.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionsGetCall) Fields(s ...googleapi.Field) *RegionsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionsGetCall) IfNoneMatch(entityTag string) *RegionsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type RegionsListCall struct {
// contains filtered or unexported fields
}func (c *RegionsListCall) Context(ctx context.Context) *RegionsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RegionsListCall) Do(opts ...googleapi.CallOption) (*RegionList, error)
Do executes the "compute.regions.list" call. Exactly one of *RegionList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RegionList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RegionsListCall) Fields(s ...googleapi.Field) *RegionsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RegionsListCall) Filter(filter string) *RegionsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RegionsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RegionsListCall) IfNoneMatch(entityTag string) *RegionsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RegionsListCall) MaxResults(maxResults int64) *RegionsListCall
MaxResults sets the optional parameter "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)
func (c *RegionsListCall) OrderBy(orderBy string) *RegionsListCall
OrderBy sets the optional parameter "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.
func (c *RegionsListCall) PageToken(pageToken string) *RegionsListCall
PageToken sets the optional parameter "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.
func (c *RegionsListCall) Pages(ctx context.Context, f func(*RegionList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RegionsService struct {
// contains filtered or unexported fields
}func NewRegionsService(s *Service) *RegionsService
func (r *RegionsService) Get(project string, region string) *RegionsGetCall
Get: Returns the specified Region resource. Get a list of available regions by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/regions/get
func (r *RegionsService) List(project string) *RegionsListCall
List: Retrieves the list of region resources available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/regions/list
type ResourceCommitment struct {
// Amount: The amount of the resource purchased (in a type-dependent
// unit, such as bytes). For vCPUs, this can just be an integer. For
// memory, this must be provided in MB. Memory must be a multiple of 256
// MB, with up to 6.5GB of memory per every vCPU.
Amount int64 `json:"amount,omitempty,string"`
// Type: Type of resource for which this commitment applies. Possible
// values are VCPU and MEMORY
//
// Possible values:
// "MEMORY"
// "UNSPECIFIED"
// "VCPU"
Type string `json:"type,omitempty"`
// ForceSendFields is a list of field names (e.g. "Amount") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Amount") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ResourceCommitment: Commitment for a particular resource (a Commitment is composed of one or more of these).
func (s *ResourceCommitment) MarshalJSON() ([]byte, error)
type ResourceGroupReference struct {
// Group: A URI referencing one of the instance groups listed in the
// backend service.
Group string `json:"group,omitempty"`
// ForceSendFields is a list of field names (e.g. "Group") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Group") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ResourceGroupReference) MarshalJSON() ([]byte, error)
type Route struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// DestRange: The destination range of outgoing packets that this route
// applies to. Only IPv4 is supported.
DestRange string `json:"destRange,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of this resource. Always compute#routes for
// Route resources.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Network: Fully-qualified URL of the network that this route applies
// to.
Network string `json:"network,omitempty"`
// NextHopGateway: The URL to a gateway that should handle matching
// packets. You can only specify the internet gateway using a full or
// partial valid URL:
// projects/<project-id>/global/gateways/default-internet-gateway
NextHopGateway string `json:"nextHopGateway,omitempty"`
// NextHopInstance: The URL to an instance that should handle matching
// packets. You can specify this as a full or partial URL. For
// example:
// https://www.googleapis.com/compute/v1/projects/project/zones/
// zone/instances/
NextHopInstance string `json:"nextHopInstance,omitempty"`
// NextHopIp: The network IP address of an instance that should handle
// matching packets. Only IPv4 is supported.
NextHopIp string `json:"nextHopIp,omitempty"`
// NextHopNetwork: The URL of the local network if it should handle
// matching packets.
NextHopNetwork string `json:"nextHopNetwork,omitempty"`
// NextHopPeering: [Output Only] The network peering name that should
// handle matching packets, which should conform to RFC1035.
NextHopPeering string `json:"nextHopPeering,omitempty"`
// NextHopVpnTunnel: The URL to a VpnTunnel that should handle matching
// packets.
NextHopVpnTunnel string `json:"nextHopVpnTunnel,omitempty"`
// Priority: The priority of this route. Priority is used to break ties
// in cases where there is more than one matching route of equal prefix
// length. In the case of two routes with equal prefix length, the one
// with the lowest-numbered priority value wins. Default value is 1000.
// Valid range is 0 through 65535.
Priority int64 `json:"priority,omitempty"`
// SelfLink: [Output Only] Server-defined fully-qualified URL for this
// resource.
SelfLink string `json:"selfLink,omitempty"`
// Tags: A list of instance tags to which this route applies.
Tags []string `json:"tags,omitempty"`
// Warnings: [Output Only] If potential misconfigurations are detected
// for this route, this field will be populated with warning messages.
Warnings []*RouteWarnings `json:"warnings,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Route: Represents a Route resource. A route specifies how certain packets should be handled by the network. Routes are associated with instances by tags and the set of routes for a particular instance is called its routing table.
For each packet leaving an instance, the system searches that instance's routing table for a single best matching route. Routes match packets by destination IP address, preferring smaller or more specific ranges over larger ones. If there is a tie, the system selects the route with the smallest priority value. If there is still a tie, it uses the layer three and four packet headers to select just one of the remaining matching routes. The packet is then forwarded as specified by the nextHop field of the winning route - either to another instance destination, an instance gateway, or a Google Compute Engine-operated gateway.
Packets that do not match any route in the sending instance's routing table are dropped. (== resource_for beta.routes ==) (== resource_for v1.routes ==)
type RouteList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Route resources.
Items []*Route `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *RouteListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RouteList: Contains a list of Route resources.
type RouteListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*RouteListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RouteListWarning: [Output Only] Informational warning message.
func (s *RouteListWarning) MarshalJSON() ([]byte, error)
type RouteListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RouteListWarningData) MarshalJSON() ([]byte, error)
type RouteWarnings struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*RouteWarningsData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RouteWarnings) MarshalJSON() ([]byte, error)
type RouteWarningsData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RouteWarningsData) MarshalJSON() ([]byte, error)
type Router struct {
// Bgp: BGP information specific to this router.
Bgp *RouterBgp `json:"bgp,omitempty"`
// BgpPeers: BGP information that needs to be configured into the
// routing stack to establish the BGP peering. It must specify peer ASN
// and either interface name, IP, or peer IP. Please refer to RFC4273.
BgpPeers []*RouterBgpPeer `json:"bgpPeers,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Interfaces: Router interfaces. Each interface requires either one
// linked resource (e.g. linkedVpnTunnel), or IP address and IP address
// range (e.g. ipRange), or both.
Interfaces []*RouterInterface `json:"interfaces,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#router for
// routers.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Network: URI of the network to which this router belongs.
Network string `json:"network,omitempty"`
// Region: [Output Only] URI of the region where the router resides.
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Bgp") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Bgp") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}Router: Router resource.
type RouterAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Router resources.
Items map[string]RoutersScopedList `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *RouterAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RouterAggregatedList: Contains a list of routers.
func (s *RouterAggregatedList) MarshalJSON() ([]byte, error)
type RouterAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*RouterAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RouterAggregatedListWarning: [Output Only] Informational warning message.
func (s *RouterAggregatedListWarning) MarshalJSON() ([]byte, error)
type RouterAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RouterAggregatedListWarningData) MarshalJSON() ([]byte, error)
type RouterBgp struct {
// Asn: Local BGP Autonomous System Number (ASN). Must be an RFC6996
// private ASN, either 16-bit or 32-bit. The value will be fixed for
// this router resource. All VPN tunnels that link to this router will
// have the same local ASN.
Asn int64 `json:"asn,omitempty"`
// ForceSendFields is a list of field names (e.g. "Asn") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Asn") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}type RouterBgpPeer struct {
// AdvertisedRoutePriority: The priority of routes advertised to this
// BGP peer. In the case where there is more than one matching route of
// maximum length, the routes with lowest priority value win.
AdvertisedRoutePriority int64 `json:"advertisedRoutePriority,omitempty"`
// InterfaceName: Name of the interface the BGP peer is associated with.
InterfaceName string `json:"interfaceName,omitempty"`
// IpAddress: IP address of the interface inside Google Cloud Platform.
// Only IPv4 is supported.
IpAddress string `json:"ipAddress,omitempty"`
// Name: Name of this BGP peer. The name must be 1-63 characters long
// and comply with RFC1035.
Name string `json:"name,omitempty"`
// PeerAsn: Peer BGP Autonomous System Number (ASN). For VPN use case,
// this value can be different for every tunnel.
PeerAsn int64 `json:"peerAsn,omitempty"`
// PeerIpAddress: IP address of the BGP interface outside Google cloud.
// Only IPv4 is supported.
PeerIpAddress string `json:"peerIpAddress,omitempty"`
// ForceSendFields is a list of field names (e.g.
// "AdvertisedRoutePriority") to unconditionally include in API
// requests. By default, fields with empty values are omitted from API
// requests. However, any non-pointer, non-interface field appearing in
// ForceSendFields will be sent to the server regardless of whether the
// field is empty or not. This may be used to include empty fields in
// Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AdvertisedRoutePriority")
// to include in API requests with the JSON null value. By default,
// fields with empty values are omitted from API requests. However, any
// field with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *RouterBgpPeer) MarshalJSON() ([]byte, error)
type RouterInterface struct {
// IpRange: IP address and range of the interface. The IP range must be
// in the RFC3927 link-local IP space. The value must be a
// CIDR-formatted string, for example: 169.254.0.1/30. NOTE: Do not
// truncate the address as it represents the IP address of the
// interface.
IpRange string `json:"ipRange,omitempty"`
// LinkedInterconnectAttachment: URI of the linked interconnect
// attachment. It must be in the same region as the router. Each
// interface can have at most one linked resource and it could either be
// a VPN Tunnel or an interconnect attachment.
LinkedInterconnectAttachment string `json:"linkedInterconnectAttachment,omitempty"`
// LinkedVpnTunnel: URI of the linked VPN tunnel. It must be in the same
// region as the router. Each interface can have at most one linked
// resource and it could either be a VPN Tunnel or an interconnect
// attachment.
LinkedVpnTunnel string `json:"linkedVpnTunnel,omitempty"`
// Name: Name of this interface entry. The name must be 1-63 characters
// long and comply with RFC1035.
Name string `json:"name,omitempty"`
// ForceSendFields is a list of field names (e.g. "IpRange") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "IpRange") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RouterInterface) MarshalJSON() ([]byte, error)
type RouterList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Router resources.
Items []*Router `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#router for
// routers.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *RouterListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RouterList: Contains a list of Router resources.
func (s *RouterList) MarshalJSON() ([]byte, error)
type RouterListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*RouterListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RouterListWarning: [Output Only] Informational warning message.
func (s *RouterListWarning) MarshalJSON() ([]byte, error)
type RouterListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RouterListWarningData) MarshalJSON() ([]byte, error)
type RouterStatus struct {
// BestRoutes: Best routes for this router's network.
BestRoutes []*Route `json:"bestRoutes,omitempty"`
// BestRoutesForRouter: Best routes learned by this router.
BestRoutesForRouter []*Route `json:"bestRoutesForRouter,omitempty"`
BgpPeerStatus []*RouterStatusBgpPeerStatus `json:"bgpPeerStatus,omitempty"`
// Network: URI of the network to which this router belongs.
Network string `json:"network,omitempty"`
// ForceSendFields is a list of field names (e.g. "BestRoutes") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "BestRoutes") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RouterStatus) MarshalJSON() ([]byte, error)
type RouterStatusBgpPeerStatus struct {
// AdvertisedRoutes: Routes that were advertised to the remote BGP peer
AdvertisedRoutes []*Route `json:"advertisedRoutes,omitempty"`
// IpAddress: IP address of the local BGP interface.
IpAddress string `json:"ipAddress,omitempty"`
// LinkedVpnTunnel: URL of the VPN tunnel that this BGP peer controls.
LinkedVpnTunnel string `json:"linkedVpnTunnel,omitempty"`
// Name: Name of this BGP peer. Unique within the Routers resource.
Name string `json:"name,omitempty"`
// NumLearnedRoutes: Number of routes learned from the remote BGP Peer.
NumLearnedRoutes int64 `json:"numLearnedRoutes,omitempty"`
// PeerIpAddress: IP address of the remote BGP interface.
PeerIpAddress string `json:"peerIpAddress,omitempty"`
// State: BGP state as specified in RFC1771.
State string `json:"state,omitempty"`
// Status: Status of the BGP peer: {UP, DOWN}
//
// Possible values:
// "DOWN"
// "UNKNOWN"
// "UP"
Status string `json:"status,omitempty"`
// Uptime: Time this session has been up. Format: 14 years, 51 weeks, 6
// days, 23 hours, 59 minutes, 59 seconds
Uptime string `json:"uptime,omitempty"`
// UptimeSeconds: Time this session has been up, in seconds. Format: 145
UptimeSeconds string `json:"uptimeSeconds,omitempty"`
// ForceSendFields is a list of field names (e.g. "AdvertisedRoutes") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AdvertisedRoutes") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *RouterStatusBgpPeerStatus) MarshalJSON() ([]byte, error)
type RouterStatusResponse struct {
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
Result *RouterStatus `json:"result,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Kind") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Kind") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RouterStatusResponse) MarshalJSON() ([]byte, error)
type RoutersAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *RoutersAggregatedListCall) Context(ctx context.Context) *RoutersAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutersAggregatedListCall) Do(opts ...googleapi.CallOption) (*RouterAggregatedList, error)
Do executes the "compute.routers.aggregatedList" call. Exactly one of *RouterAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RouterAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutersAggregatedListCall) Fields(s ...googleapi.Field) *RoutersAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutersAggregatedListCall) Filter(filter string) *RoutersAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RoutersAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutersAggregatedListCall) IfNoneMatch(entityTag string) *RoutersAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RoutersAggregatedListCall) MaxResults(maxResults int64) *RoutersAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *RoutersAggregatedListCall) OrderBy(orderBy string) *RoutersAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *RoutersAggregatedListCall) PageToken(pageToken string) *RoutersAggregatedListCall
PageToken sets the optional parameter "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.
func (c *RoutersAggregatedListCall) Pages(ctx context.Context, f func(*RouterAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RoutersDeleteCall struct {
// contains filtered or unexported fields
}func (c *RoutersDeleteCall) Context(ctx context.Context) *RoutersDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutersDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.routers.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutersDeleteCall) Fields(s ...googleapi.Field) *RoutersDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutersDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutersDeleteCall) RequestId(requestId string) *RoutersDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RoutersGetCall struct {
// contains filtered or unexported fields
}func (c *RoutersGetCall) Context(ctx context.Context) *RoutersGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutersGetCall) Do(opts ...googleapi.CallOption) (*Router, error)
Do executes the "compute.routers.get" call. Exactly one of *Router or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Router.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutersGetCall) Fields(s ...googleapi.Field) *RoutersGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutersGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutersGetCall) IfNoneMatch(entityTag string) *RoutersGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type RoutersGetRouterStatusCall struct {
// contains filtered or unexported fields
}func (c *RoutersGetRouterStatusCall) Context(ctx context.Context) *RoutersGetRouterStatusCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutersGetRouterStatusCall) Do(opts ...googleapi.CallOption) (*RouterStatusResponse, error)
Do executes the "compute.routers.getRouterStatus" call. Exactly one of *RouterStatusResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RouterStatusResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutersGetRouterStatusCall) Fields(s ...googleapi.Field) *RoutersGetRouterStatusCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutersGetRouterStatusCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutersGetRouterStatusCall) IfNoneMatch(entityTag string) *RoutersGetRouterStatusCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type RoutersInsertCall struct {
// contains filtered or unexported fields
}func (c *RoutersInsertCall) Context(ctx context.Context) *RoutersInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutersInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.routers.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutersInsertCall) Fields(s ...googleapi.Field) *RoutersInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutersInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutersInsertCall) RequestId(requestId string) *RoutersInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RoutersListCall struct {
// contains filtered or unexported fields
}func (c *RoutersListCall) Context(ctx context.Context) *RoutersListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutersListCall) Do(opts ...googleapi.CallOption) (*RouterList, error)
Do executes the "compute.routers.list" call. Exactly one of *RouterList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RouterList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutersListCall) Fields(s ...googleapi.Field) *RoutersListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutersListCall) Filter(filter string) *RoutersListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RoutersListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutersListCall) IfNoneMatch(entityTag string) *RoutersListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RoutersListCall) MaxResults(maxResults int64) *RoutersListCall
MaxResults sets the optional parameter "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)
func (c *RoutersListCall) OrderBy(orderBy string) *RoutersListCall
OrderBy sets the optional parameter "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.
func (c *RoutersListCall) PageToken(pageToken string) *RoutersListCall
PageToken sets the optional parameter "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.
func (c *RoutersListCall) Pages(ctx context.Context, f func(*RouterList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RoutersPatchCall struct {
// contains filtered or unexported fields
}func (c *RoutersPatchCall) Context(ctx context.Context) *RoutersPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutersPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.routers.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutersPatchCall) Fields(s ...googleapi.Field) *RoutersPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutersPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutersPatchCall) RequestId(requestId string) *RoutersPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RoutersPreviewCall struct {
// contains filtered or unexported fields
}func (c *RoutersPreviewCall) Context(ctx context.Context) *RoutersPreviewCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutersPreviewCall) Do(opts ...googleapi.CallOption) (*RoutersPreviewResponse, error)
Do executes the "compute.routers.preview" call. Exactly one of *RoutersPreviewResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RoutersPreviewResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutersPreviewCall) Fields(s ...googleapi.Field) *RoutersPreviewCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutersPreviewCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type RoutersPreviewResponse struct {
// Resource: Preview of given router.
Resource *Router `json:"resource,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Resource") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Resource") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RoutersPreviewResponse) MarshalJSON() ([]byte, error)
type RoutersScopedList struct {
// Routers: List of routers contained in this scope.
Routers []*Router `json:"routers,omitempty"`
// Warning: Informational warning which replaces the list of routers
// when the list is empty.
Warning *RoutersScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "Routers") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Routers") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RoutersScopedList) MarshalJSON() ([]byte, error)
type RoutersScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*RoutersScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}RoutersScopedListWarning: Informational warning which replaces the list of routers when the list is empty.
func (s *RoutersScopedListWarning) MarshalJSON() ([]byte, error)
type RoutersScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *RoutersScopedListWarningData) MarshalJSON() ([]byte, error)
type RoutersService struct {
// contains filtered or unexported fields
}func NewRoutersService(s *Service) *RoutersService
func (r *RoutersService) AggregatedList(project string) *RoutersAggregatedListCall
AggregatedList: Retrieves an aggregated list of routers.
func (r *RoutersService) Delete(project string, region string, router string) *RoutersDeleteCall
Delete: Deletes the specified Router resource.
func (r *RoutersService) Get(project string, region string, router string) *RoutersGetCall
Get: Returns the specified Router resource. Get a list of available routers by making a list() request.
func (r *RoutersService) GetRouterStatus(project string, region string, router string) *RoutersGetRouterStatusCall
GetRouterStatus: Retrieves runtime information of the specified router.
func (r *RoutersService) Insert(project string, region string, router *Router) *RoutersInsertCall
Insert: Creates a Router resource in the specified project and region using the data included in the request.
func (r *RoutersService) List(project string, region string) *RoutersListCall
List: Retrieves a list of Router resources available to the specified project.
func (r *RoutersService) Patch(project string, region string, router string, router2 *Router) *RoutersPatchCall
Patch: Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules.
func (r *RoutersService) Preview(project string, region string, router string, router2 *Router) *RoutersPreviewCall
Preview: Preview fields auto-generated during router create and update operations. Calling this method does NOT create or update the router.
func (r *RoutersService) Update(project string, region string, router string, router2 *Router) *RoutersUpdateCall
Update: Updates the specified Router resource with the data included in the request.
type RoutersUpdateCall struct {
// contains filtered or unexported fields
}func (c *RoutersUpdateCall) Context(ctx context.Context) *RoutersUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutersUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.routers.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutersUpdateCall) Fields(s ...googleapi.Field) *RoutersUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutersUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutersUpdateCall) RequestId(requestId string) *RoutersUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RoutesDeleteCall struct {
// contains filtered or unexported fields
}func (c *RoutesDeleteCall) Context(ctx context.Context) *RoutesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.routes.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutesDeleteCall) Fields(s ...googleapi.Field) *RoutesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutesDeleteCall) RequestId(requestId string) *RoutesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RoutesGetCall struct {
// contains filtered or unexported fields
}func (c *RoutesGetCall) Context(ctx context.Context) *RoutesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutesGetCall) Do(opts ...googleapi.CallOption) (*Route, error)
Do executes the "compute.routes.get" call. Exactly one of *Route or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Route.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutesGetCall) Fields(s ...googleapi.Field) *RoutesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutesGetCall) IfNoneMatch(entityTag string) *RoutesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type RoutesInsertCall struct {
// contains filtered or unexported fields
}func (c *RoutesInsertCall) Context(ctx context.Context) *RoutesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.routes.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutesInsertCall) Fields(s ...googleapi.Field) *RoutesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutesInsertCall) RequestId(requestId string) *RoutesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type RoutesListCall struct {
// contains filtered or unexported fields
}func (c *RoutesListCall) Context(ctx context.Context) *RoutesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *RoutesListCall) Do(opts ...googleapi.CallOption) (*RouteList, error)
Do executes the "compute.routes.list" call. Exactly one of *RouteList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *RouteList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *RoutesListCall) Fields(s ...googleapi.Field) *RoutesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *RoutesListCall) Filter(filter string) *RoutesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *RoutesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *RoutesListCall) IfNoneMatch(entityTag string) *RoutesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *RoutesListCall) MaxResults(maxResults int64) *RoutesListCall
MaxResults sets the optional parameter "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)
func (c *RoutesListCall) OrderBy(orderBy string) *RoutesListCall
OrderBy sets the optional parameter "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.
func (c *RoutesListCall) PageToken(pageToken string) *RoutesListCall
PageToken sets the optional parameter "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.
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type RoutesService struct {
// contains filtered or unexported fields
}func NewRoutesService(s *Service) *RoutesService
func (r *RoutesService) Delete(project string, route string) *RoutesDeleteCall
Delete: Deletes the specified Route resource. For details, see https://cloud.google.com/compute/docs/reference/latest/routes/delete
func (r *RoutesService) Get(project string, route string) *RoutesGetCall
Get: Returns the specified Route resource. Get a list of available routes by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/routes/get
func (r *RoutesService) Insert(project string, route *Route) *RoutesInsertCall
Insert: Creates a Route resource in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/routes/insert
func (r *RoutesService) List(project string) *RoutesListCall
List: Retrieves the list of Route resources available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/routes/list
type SSLHealthCheck struct {
// Port: The TCP port number for the health check request. The default
// value is 443. Valid values are 1 through 65535.
Port int64 `json:"port,omitempty"`
// PortName: Port name as defined in InstanceGroup#NamedPort#name. If
// both port and port_name are defined, port takes precedence.
PortName string `json:"portName,omitempty"`
// ProxyHeader: Specifies the type of proxy header to append before
// sending data to the backend, either NONE or PROXY_V1. The default is
// NONE.
//
// Possible values:
// "NONE"
// "PROXY_V1"
ProxyHeader string `json:"proxyHeader,omitempty"`
// Request: The application data to send once the SSL connection has
// been established (default value is empty). If both request and
// response are empty, the connection establishment alone will indicate
// health. The request data can only be ASCII.
Request string `json:"request,omitempty"`
// Response: The bytes to match against the beginning of the response
// data. If left empty (the default value), any response will indicate
// health. The response data can only be ASCII.
Response string `json:"response,omitempty"`
// ForceSendFields is a list of field names (e.g. "Port") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Port") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *SSLHealthCheck) MarshalJSON() ([]byte, error)
type Scheduling struct {
// AutomaticRestart: Specifies whether the instance should be
// automatically restarted if it is terminated by Compute Engine (not
// terminated by a user). You can only set the automatic restart option
// for standard instances. Preemptible instances cannot be automatically
// restarted.
//
// By default, this is set to true so an instance is automatically
// restarted if it is terminated by Compute Engine.
AutomaticRestart *bool `json:"automaticRestart,omitempty"`
// OnHostMaintenance: Defines the maintenance behavior for this
// instance. For standard instances, the default behavior is MIGRATE.
// For preemptible instances, the default and only possible behavior is
// TERMINATE. For more information, see Setting Instance Scheduling
// Options.
//
// Possible values:
// "MIGRATE"
// "TERMINATE"
OnHostMaintenance string `json:"onHostMaintenance,omitempty"`
// Preemptible: Defines whether the instance is preemptible. This can
// only be set during instance creation, it cannot be set or changed
// after the instance has been created.
Preemptible bool `json:"preemptible,omitempty"`
// ForceSendFields is a list of field names (e.g. "AutomaticRestart") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AutomaticRestart") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Scheduling: Sets the scheduling options for an Instance.
func (s *Scheduling) MarshalJSON() ([]byte, error)
type SerialPortOutput struct {
// Contents: [Output Only] The contents of the console output.
Contents string `json:"contents,omitempty"`
// Kind: [Output Only] Type of the resource. Always
// compute#serialPortOutput for serial port output.
Kind string `json:"kind,omitempty"`
// Next: [Output Only] The position of the next byte of content from the
// serial console output. Use this value in the next request as the
// start parameter.
Next int64 `json:"next,omitempty,string"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Start: The starting byte position of the output that was returned.
// This should match the start parameter sent with the request. If the
// serial console output exceeds the size of the buffer, older output
// will be overwritten by newer content and the start values will be
// mismatched.
Start int64 `json:"start,omitempty,string"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Contents") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Contents") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SerialPortOutput: An instance's serial console output.
func (s *SerialPortOutput) MarshalJSON() ([]byte, error)
type Service struct {
BasePath string // API endpoint base URL
UserAgent string // optional additional User-Agent fragment
AcceleratorTypes *AcceleratorTypesService
Addresses *AddressesService
Autoscalers *AutoscalersService
BackendBuckets *BackendBucketsService
BackendServices *BackendServicesService
DiskTypes *DiskTypesService
Disks *DisksService
Firewalls *FirewallsService
ForwardingRules *ForwardingRulesService
GlobalAddresses *GlobalAddressesService
GlobalForwardingRules *GlobalForwardingRulesService
GlobalOperations *GlobalOperationsService
HealthChecks *HealthChecksService
HttpHealthChecks *HttpHealthChecksService
HttpsHealthChecks *HttpsHealthChecksService
Images *ImagesService
InstanceGroupManagers *InstanceGroupManagersService
InstanceGroups *InstanceGroupsService
InstanceTemplates *InstanceTemplatesService
Instances *InstancesService
InterconnectAttachments *InterconnectAttachmentsService
InterconnectLocations *InterconnectLocationsService
Interconnects *InterconnectsService
Licenses *LicensesService
MachineTypes *MachineTypesService
Networks *NetworksService
Projects *ProjectsService
RegionAutoscalers *RegionAutoscalersService
RegionBackendServices *RegionBackendServicesService
RegionCommitments *RegionCommitmentsService
RegionInstanceGroupManagers *RegionInstanceGroupManagersService
RegionInstanceGroups *RegionInstanceGroupsService
RegionOperations *RegionOperationsService
Regions *RegionsService
Routers *RoutersService
Routes *RoutesService
Snapshots *SnapshotsService
SslCertificates *SslCertificatesService
Subnetworks *SubnetworksService
TargetHttpProxies *TargetHttpProxiesService
TargetHttpsProxies *TargetHttpsProxiesService
TargetInstances *TargetInstancesService
TargetPools *TargetPoolsService
TargetSslProxies *TargetSslProxiesService
TargetTcpProxies *TargetTcpProxiesService
TargetVpnGateways *TargetVpnGatewaysService
UrlMaps *UrlMapsService
VpnTunnels *VpnTunnelsService
ZoneOperations *ZoneOperationsService
Zones *ZonesService
// contains filtered or unexported fields
}type ServiceAccount struct {
// Email: Email address of the service account.
Email string `json:"email,omitempty"`
// Scopes: The list of scopes to be made available for this service
// account.
Scopes []string `json:"scopes,omitempty"`
// ForceSendFields is a list of field names (e.g. "Email") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Email") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ServiceAccount: A service account.
func (s *ServiceAccount) MarshalJSON() ([]byte, error)
type Snapshot struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// DiskSizeGb: [Output Only] Size of the snapshot, specified in GB.
DiskSizeGb int64 `json:"diskSizeGb,omitempty,string"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#snapshot for
// Snapshot resources.
Kind string `json:"kind,omitempty"`
// LabelFingerprint: A fingerprint for the labels being applied to this
// snapshot, which is essentially a hash of the labels set used for
// optimistic locking. The fingerprint is initially generated by Compute
// Engine and changes after every request to modify or update labels.
// You must always provide an up-to-date fingerprint hash in order to
// update or change labels.
//
// To see the latest fingerprint, make a get() request to retrieve a
// snapshot.
LabelFingerprint string `json:"labelFingerprint,omitempty"`
// Labels: Labels to apply to this snapshot. These can be later modified
// by the setLabels method. Label values may be empty.
Labels map[string]string `json:"labels,omitempty"`
// Licenses: [Output Only] A list of public visible licenses that apply
// to this snapshot. This can be because the original image had licenses
// attached (such as a Windows image).
Licenses []string `json:"licenses,omitempty"`
// Name: Name of the resource; provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// SnapshotEncryptionKey: Encrypts the snapshot using a
// customer-supplied encryption key.
//
// After you encrypt a snapshot using a customer-supplied key, you must
// provide the same key if you use the image later For example, you must
// provide the encryption key when you create a disk from the encrypted
// snapshot in a future request.
//
// Customer-supplied encryption keys do not protect access to metadata
// of the disk.
//
// If you do not provide an encryption key when creating the snapshot,
// then the snapshot will be encrypted using an automatically generated
// key and you do not need to provide a key to use the snapshot later.
SnapshotEncryptionKey *CustomerEncryptionKey `json:"snapshotEncryptionKey,omitempty"`
// SourceDisk: [Output Only] The source disk used to create this
// snapshot.
SourceDisk string `json:"sourceDisk,omitempty"`
// SourceDiskEncryptionKey: The customer-supplied encryption key of the
// source disk. Required if the source disk is protected by a
// customer-supplied encryption key.
SourceDiskEncryptionKey *CustomerEncryptionKey `json:"sourceDiskEncryptionKey,omitempty"`
// SourceDiskId: [Output Only] The ID value of the disk used to create
// this snapshot. This value may be used to determine whether the
// snapshot was taken from the current or a previous instance of a given
// disk name.
SourceDiskId string `json:"sourceDiskId,omitempty"`
// Status: [Output Only] The status of the snapshot. This can be
// CREATING, DELETING, FAILED, READY, or UPLOADING.
//
// Possible values:
// "CREATING"
// "DELETING"
// "FAILED"
// "READY"
// "UPLOADING"
Status string `json:"status,omitempty"`
// StorageBytes: [Output Only] A size of the storage used by the
// snapshot. As snapshots share storage, this number is expected to
// change with snapshot creation/deletion.
StorageBytes int64 `json:"storageBytes,omitempty,string"`
// StorageBytesStatus: [Output Only] An indicator whether storageBytes
// is in a stable state or it is being adjusted as a result of shared
// storage reallocation. This status can either be UPDATING, meaning the
// size of the snapshot is being updated, or UP_TO_DATE, meaning the
// size of the snapshot is up-to-date.
//
// Possible values:
// "UPDATING"
// "UP_TO_DATE"
StorageBytesStatus string `json:"storageBytesStatus,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Snapshot: A persistent disk snapshot resource. (== resource_for beta.snapshots ==) (== resource_for v1.snapshots ==)
type SnapshotList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Snapshot resources.
Items []*Snapshot `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *SnapshotListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SnapshotList: Contains a list of Snapshot resources.
func (s *SnapshotList) MarshalJSON() ([]byte, error)
type SnapshotListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*SnapshotListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SnapshotListWarning: [Output Only] Informational warning message.
func (s *SnapshotListWarning) MarshalJSON() ([]byte, error)
type SnapshotListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *SnapshotListWarningData) MarshalJSON() ([]byte, error)
type SnapshotsDeleteCall struct {
// contains filtered or unexported fields
}func (c *SnapshotsDeleteCall) Context(ctx context.Context) *SnapshotsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SnapshotsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.snapshots.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SnapshotsDeleteCall) Fields(s ...googleapi.Field) *SnapshotsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SnapshotsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SnapshotsDeleteCall) RequestId(requestId string) *SnapshotsDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type SnapshotsGetCall struct {
// contains filtered or unexported fields
}func (c *SnapshotsGetCall) Context(ctx context.Context) *SnapshotsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SnapshotsGetCall) Do(opts ...googleapi.CallOption) (*Snapshot, error)
Do executes the "compute.snapshots.get" call. Exactly one of *Snapshot or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Snapshot.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SnapshotsGetCall) Fields(s ...googleapi.Field) *SnapshotsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SnapshotsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SnapshotsGetCall) IfNoneMatch(entityTag string) *SnapshotsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type SnapshotsListCall struct {
// contains filtered or unexported fields
}func (c *SnapshotsListCall) Context(ctx context.Context) *SnapshotsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SnapshotsListCall) Do(opts ...googleapi.CallOption) (*SnapshotList, error)
Do executes the "compute.snapshots.list" call. Exactly one of *SnapshotList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *SnapshotList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SnapshotsListCall) Fields(s ...googleapi.Field) *SnapshotsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SnapshotsListCall) Filter(filter string) *SnapshotsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *SnapshotsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SnapshotsListCall) IfNoneMatch(entityTag string) *SnapshotsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *SnapshotsListCall) MaxResults(maxResults int64) *SnapshotsListCall
MaxResults sets the optional parameter "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)
func (c *SnapshotsListCall) OrderBy(orderBy string) *SnapshotsListCall
OrderBy sets the optional parameter "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.
func (c *SnapshotsListCall) PageToken(pageToken string) *SnapshotsListCall
PageToken sets the optional parameter "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.
func (c *SnapshotsListCall) Pages(ctx context.Context, f func(*SnapshotList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type SnapshotsService struct {
// contains filtered or unexported fields
}func NewSnapshotsService(s *Service) *SnapshotsService
func (r *SnapshotsService) Delete(project string, snapshot string) *SnapshotsDeleteCall
Delete: Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot.
For more information, see Deleting snaphots. For details, see https://cloud.google.com/compute/docs/reference/latest/snapshots/delete
func (r *SnapshotsService) Get(project string, snapshot string) *SnapshotsGetCall
Get: Returns the specified Snapshot resource. Get a list of available snapshots by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/snapshots/get
func (r *SnapshotsService) List(project string) *SnapshotsListCall
List: Retrieves the list of Snapshot resources contained within the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/snapshots/list
func (r *SnapshotsService) SetLabels(project string, resource string, globalsetlabelsrequest *GlobalSetLabelsRequest) *SnapshotsSetLabelsCall
SetLabels: Sets the labels on a snapshot. To learn more about labels, read the Labeling Resources documentation.
type SnapshotsSetLabelsCall struct {
// contains filtered or unexported fields
}func (c *SnapshotsSetLabelsCall) Context(ctx context.Context) *SnapshotsSetLabelsCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SnapshotsSetLabelsCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.snapshots.setLabels" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SnapshotsSetLabelsCall) Fields(s ...googleapi.Field) *SnapshotsSetLabelsCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SnapshotsSetLabelsCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type SslCertificate struct {
// Certificate: A local certificate file. The certificate must be in PEM
// format. The certificate chain must be no greater than 5 certs long.
// The chain must include at least one intermediate cert.
Certificate string `json:"certificate,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always
// compute#sslCertificate for SSL certificates.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// PrivateKey: A write-only private key in PEM format. Only insert
// requests will include this field.
PrivateKey string `json:"privateKey,omitempty"`
// SelfLink: [Output only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Certificate") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Certificate") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SslCertificate: An SslCertificate resource. This resource provides a mechanism to upload an SSL key and certificate to the load balancer to serve secure connections from the user. (== resource_for beta.sslCertificates ==) (== resource_for v1.sslCertificates ==)
func (s *SslCertificate) MarshalJSON() ([]byte, error)
type SslCertificateList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of SslCertificate resources.
Items []*SslCertificate `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *SslCertificateListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SslCertificateList: Contains a list of SslCertificate resources.
func (s *SslCertificateList) MarshalJSON() ([]byte, error)
type SslCertificateListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*SslCertificateListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SslCertificateListWarning: [Output Only] Informational warning message.
func (s *SslCertificateListWarning) MarshalJSON() ([]byte, error)
type SslCertificateListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *SslCertificateListWarningData) MarshalJSON() ([]byte, error)
type SslCertificatesDeleteCall struct {
// contains filtered or unexported fields
}func (c *SslCertificatesDeleteCall) Context(ctx context.Context) *SslCertificatesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SslCertificatesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.sslCertificates.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SslCertificatesDeleteCall) Fields(s ...googleapi.Field) *SslCertificatesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SslCertificatesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SslCertificatesDeleteCall) RequestId(requestId string) *SslCertificatesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type SslCertificatesGetCall struct {
// contains filtered or unexported fields
}func (c *SslCertificatesGetCall) Context(ctx context.Context) *SslCertificatesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SslCertificatesGetCall) Do(opts ...googleapi.CallOption) (*SslCertificate, error)
Do executes the "compute.sslCertificates.get" call. Exactly one of *SslCertificate or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *SslCertificate.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SslCertificatesGetCall) Fields(s ...googleapi.Field) *SslCertificatesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SslCertificatesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SslCertificatesGetCall) IfNoneMatch(entityTag string) *SslCertificatesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type SslCertificatesInsertCall struct {
// contains filtered or unexported fields
}func (c *SslCertificatesInsertCall) Context(ctx context.Context) *SslCertificatesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SslCertificatesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.sslCertificates.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SslCertificatesInsertCall) Fields(s ...googleapi.Field) *SslCertificatesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SslCertificatesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SslCertificatesInsertCall) RequestId(requestId string) *SslCertificatesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type SslCertificatesListCall struct {
// contains filtered or unexported fields
}func (c *SslCertificatesListCall) Context(ctx context.Context) *SslCertificatesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SslCertificatesListCall) Do(opts ...googleapi.CallOption) (*SslCertificateList, error)
Do executes the "compute.sslCertificates.list" call. Exactly one of *SslCertificateList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *SslCertificateList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SslCertificatesListCall) Fields(s ...googleapi.Field) *SslCertificatesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SslCertificatesListCall) Filter(filter string) *SslCertificatesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *SslCertificatesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SslCertificatesListCall) IfNoneMatch(entityTag string) *SslCertificatesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *SslCertificatesListCall) MaxResults(maxResults int64) *SslCertificatesListCall
MaxResults sets the optional parameter "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)
func (c *SslCertificatesListCall) OrderBy(orderBy string) *SslCertificatesListCall
OrderBy sets the optional parameter "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.
func (c *SslCertificatesListCall) PageToken(pageToken string) *SslCertificatesListCall
PageToken sets the optional parameter "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.
func (c *SslCertificatesListCall) Pages(ctx context.Context, f func(*SslCertificateList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type SslCertificatesService struct {
// contains filtered or unexported fields
}func NewSslCertificatesService(s *Service) *SslCertificatesService
func (r *SslCertificatesService) Delete(project string, sslCertificate string) *SslCertificatesDeleteCall
Delete: Deletes the specified SslCertificate resource.
func (r *SslCertificatesService) Get(project string, sslCertificate string) *SslCertificatesGetCall
Get: Returns the specified SslCertificate resource. Get a list of available SSL certificates by making a list() request.
func (r *SslCertificatesService) Insert(project string, sslcertificate *SslCertificate) *SslCertificatesInsertCall
Insert: Creates a SslCertificate resource in the specified project using the data included in the request.
func (r *SslCertificatesService) List(project string) *SslCertificatesListCall
List: Retrieves the list of SslCertificate resources available to the specified project.
type Subnetwork struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource. This field can be set only at
// resource creation time.
Description string `json:"description,omitempty"`
// GatewayAddress: [Output Only] The gateway address for default routes
// to reach destination addresses outside this subnetwork. This field
// can be set only at resource creation time.
GatewayAddress string `json:"gatewayAddress,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// IpCidrRange: The range of internal addresses that are owned by this
// subnetwork. Provide this property when you create the subnetwork. For
// example, 10.0.0.0/8 or 192.168.0.0/16. Ranges must be unique and
// non-overlapping within a network. Only IPv4 is supported. This field
// can be set only at resource creation time.
IpCidrRange string `json:"ipCidrRange,omitempty"`
// Kind: [Output Only] Type of the resource. Always compute#subnetwork
// for Subnetwork resources.
Kind string `json:"kind,omitempty"`
// Name: The name of the resource, provided by the client when initially
// creating the resource. The name must be 1-63 characters long, and
// comply with RFC1035. Specifically, the name must be 1-63 characters
// long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?
// which means the first character must be a lowercase letter, and all
// following characters must be a dash, lowercase letter, or digit,
// except the last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Network: The URL of the network to which this subnetwork belongs,
// provided by the client when initially creating the subnetwork. Only
// networks that are in the distributed mode can have subnetworks. This
// field can be set only at resource creation time.
Network string `json:"network,omitempty"`
// PrivateIpGoogleAccess: Whether the VMs in this subnet can access
// Google services without assigned external IP addresses. This field
// can be both set at resource creation time and updated using
// setPrivateIpGoogleAccess.
PrivateIpGoogleAccess bool `json:"privateIpGoogleAccess,omitempty"`
// Region: URL of the region where the Subnetwork resides. This field
// can be set only at resource creation time.
Region string `json:"region,omitempty"`
// SecondaryIpRanges: An array of configurations for secondary IP ranges
// for VM instances contained in this subnetwork. The primary IP of such
// VM must belong to the primary ipCidrRange of the subnetwork. The
// alias IPs may belong to either primary or secondary ranges.
SecondaryIpRanges []*SubnetworkSecondaryRange `json:"secondaryIpRanges,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Subnetwork: A Subnetwork resource. (== resource_for beta.subnetworks ==) (== resource_for v1.subnetworks ==)
func (s *Subnetwork) MarshalJSON() ([]byte, error)
type SubnetworkAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of SubnetworksScopedList resources.
Items map[string]SubnetworksScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#subnetworkAggregatedList for aggregated lists of subnetworks.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *SubnetworkAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *SubnetworkAggregatedList) MarshalJSON() ([]byte, error)
type SubnetworkAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*SubnetworkAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SubnetworkAggregatedListWarning: [Output Only] Informational warning message.
func (s *SubnetworkAggregatedListWarning) MarshalJSON() ([]byte, error)
type SubnetworkAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *SubnetworkAggregatedListWarningData) MarshalJSON() ([]byte, error)
type SubnetworkList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Subnetwork resources.
Items []*Subnetwork `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#subnetworkList
// for lists of subnetworks.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *SubnetworkListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SubnetworkList: Contains a list of Subnetwork resources.
func (s *SubnetworkList) MarshalJSON() ([]byte, error)
type SubnetworkListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*SubnetworkListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SubnetworkListWarning: [Output Only] Informational warning message.
func (s *SubnetworkListWarning) MarshalJSON() ([]byte, error)
type SubnetworkListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *SubnetworkListWarningData) MarshalJSON() ([]byte, error)
type SubnetworkSecondaryRange struct {
// IpCidrRange: The range of IP addresses belonging to this subnetwork
// secondary range. Provide this property when you create the
// subnetwork. Ranges must be unique and non-overlapping with all
// primary and secondary IP ranges within a network. Only IPv4 is
// supported.
IpCidrRange string `json:"ipCidrRange,omitempty"`
// RangeName: The name associated with this subnetwork secondary range,
// used when adding an alias IP range to a VM instance. The name must be
// 1-63 characters long, and comply with RFC1035. The name must be
// unique within the subnetwork.
RangeName string `json:"rangeName,omitempty"`
// ForceSendFields is a list of field names (e.g. "IpCidrRange") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "IpCidrRange") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SubnetworkSecondaryRange: Represents a secondary IP range of a subnetwork.
func (s *SubnetworkSecondaryRange) MarshalJSON() ([]byte, error)
type SubnetworksAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *SubnetworksAggregatedListCall) Context(ctx context.Context) *SubnetworksAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SubnetworksAggregatedListCall) Do(opts ...googleapi.CallOption) (*SubnetworkAggregatedList, error)
Do executes the "compute.subnetworks.aggregatedList" call. Exactly one of *SubnetworkAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *SubnetworkAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SubnetworksAggregatedListCall) Fields(s ...googleapi.Field) *SubnetworksAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SubnetworksAggregatedListCall) Filter(filter string) *SubnetworksAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *SubnetworksAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SubnetworksAggregatedListCall) IfNoneMatch(entityTag string) *SubnetworksAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *SubnetworksAggregatedListCall) MaxResults(maxResults int64) *SubnetworksAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *SubnetworksAggregatedListCall) OrderBy(orderBy string) *SubnetworksAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *SubnetworksAggregatedListCall) PageToken(pageToken string) *SubnetworksAggregatedListCall
PageToken sets the optional parameter "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.
func (c *SubnetworksAggregatedListCall) Pages(ctx context.Context, f func(*SubnetworkAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type SubnetworksDeleteCall struct {
// contains filtered or unexported fields
}func (c *SubnetworksDeleteCall) Context(ctx context.Context) *SubnetworksDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SubnetworksDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.subnetworks.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SubnetworksDeleteCall) Fields(s ...googleapi.Field) *SubnetworksDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SubnetworksDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SubnetworksDeleteCall) RequestId(requestId string) *SubnetworksDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type SubnetworksExpandIpCidrRangeCall struct {
// contains filtered or unexported fields
}func (c *SubnetworksExpandIpCidrRangeCall) Context(ctx context.Context) *SubnetworksExpandIpCidrRangeCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SubnetworksExpandIpCidrRangeCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.subnetworks.expandIpCidrRange" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SubnetworksExpandIpCidrRangeCall) Fields(s ...googleapi.Field) *SubnetworksExpandIpCidrRangeCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SubnetworksExpandIpCidrRangeCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SubnetworksExpandIpCidrRangeCall) RequestId(requestId string) *SubnetworksExpandIpCidrRangeCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type SubnetworksExpandIpCidrRangeRequest struct {
// IpCidrRange: The IP (in CIDR format or netmask) of internal addresses
// that are legal on this Subnetwork. This range should be disjoint from
// other subnetworks within this network. This range can only be larger
// than (i.e. a superset of) the range previously defined before the
// update.
IpCidrRange string `json:"ipCidrRange,omitempty"`
// ForceSendFields is a list of field names (e.g. "IpCidrRange") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "IpCidrRange") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *SubnetworksExpandIpCidrRangeRequest) MarshalJSON() ([]byte, error)
type SubnetworksGetCall struct {
// contains filtered or unexported fields
}func (c *SubnetworksGetCall) Context(ctx context.Context) *SubnetworksGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SubnetworksGetCall) Do(opts ...googleapi.CallOption) (*Subnetwork, error)
Do executes the "compute.subnetworks.get" call. Exactly one of *Subnetwork or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Subnetwork.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SubnetworksGetCall) Fields(s ...googleapi.Field) *SubnetworksGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SubnetworksGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SubnetworksGetCall) IfNoneMatch(entityTag string) *SubnetworksGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type SubnetworksInsertCall struct {
// contains filtered or unexported fields
}func (c *SubnetworksInsertCall) Context(ctx context.Context) *SubnetworksInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SubnetworksInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.subnetworks.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SubnetworksInsertCall) Fields(s ...googleapi.Field) *SubnetworksInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SubnetworksInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SubnetworksInsertCall) RequestId(requestId string) *SubnetworksInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type SubnetworksListCall struct {
// contains filtered or unexported fields
}func (c *SubnetworksListCall) Context(ctx context.Context) *SubnetworksListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SubnetworksListCall) Do(opts ...googleapi.CallOption) (*SubnetworkList, error)
Do executes the "compute.subnetworks.list" call. Exactly one of *SubnetworkList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *SubnetworkList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SubnetworksListCall) Fields(s ...googleapi.Field) *SubnetworksListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SubnetworksListCall) Filter(filter string) *SubnetworksListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *SubnetworksListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SubnetworksListCall) IfNoneMatch(entityTag string) *SubnetworksListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *SubnetworksListCall) MaxResults(maxResults int64) *SubnetworksListCall
MaxResults sets the optional parameter "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)
func (c *SubnetworksListCall) OrderBy(orderBy string) *SubnetworksListCall
OrderBy sets the optional parameter "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.
func (c *SubnetworksListCall) PageToken(pageToken string) *SubnetworksListCall
PageToken sets the optional parameter "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.
func (c *SubnetworksListCall) Pages(ctx context.Context, f func(*SubnetworkList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type SubnetworksScopedList struct {
// Subnetworks: List of subnetworks contained in this scope.
Subnetworks []*Subnetwork `json:"subnetworks,omitempty"`
// Warning: An informational warning that appears when the list of
// addresses is empty.
Warning *SubnetworksScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "Subnetworks") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Subnetworks") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *SubnetworksScopedList) MarshalJSON() ([]byte, error)
type SubnetworksScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*SubnetworksScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}SubnetworksScopedListWarning: An informational warning that appears when the list of addresses is empty.
func (s *SubnetworksScopedListWarning) MarshalJSON() ([]byte, error)
type SubnetworksScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *SubnetworksScopedListWarningData) MarshalJSON() ([]byte, error)
type SubnetworksService struct {
// contains filtered or unexported fields
}func NewSubnetworksService(s *Service) *SubnetworksService
func (r *SubnetworksService) AggregatedList(project string) *SubnetworksAggregatedListCall
AggregatedList: Retrieves an aggregated list of subnetworks.
func (r *SubnetworksService) Delete(project string, region string, subnetwork string) *SubnetworksDeleteCall
Delete: Deletes the specified subnetwork.
func (r *SubnetworksService) ExpandIpCidrRange(project string, region string, subnetwork string, subnetworksexpandipcidrrangerequest *SubnetworksExpandIpCidrRangeRequest) *SubnetworksExpandIpCidrRangeCall
ExpandIpCidrRange: Expands the IP CIDR range of the subnetwork to a specified value.
func (r *SubnetworksService) Get(project string, region string, subnetwork string) *SubnetworksGetCall
Get: Returns the specified subnetwork. Get a list of available subnetworks list() request.
func (r *SubnetworksService) Insert(project string, region string, subnetwork *Subnetwork) *SubnetworksInsertCall
Insert: Creates a subnetwork in the specified project using the data included in the request.
func (r *SubnetworksService) List(project string, region string) *SubnetworksListCall
List: Retrieves a list of subnetworks available to the specified project.
func (r *SubnetworksService) SetPrivateIpGoogleAccess(project string, region string, subnetwork string, subnetworkssetprivateipgoogleaccessrequest *SubnetworksSetPrivateIpGoogleAccessRequest) *SubnetworksSetPrivateIpGoogleAccessCall
SetPrivateIpGoogleAccess: Set whether VMs in this subnet can access Google services without assigning external IP addresses through Private Google Access.
type SubnetworksSetPrivateIpGoogleAccessCall struct {
// contains filtered or unexported fields
}func (c *SubnetworksSetPrivateIpGoogleAccessCall) Context(ctx context.Context) *SubnetworksSetPrivateIpGoogleAccessCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *SubnetworksSetPrivateIpGoogleAccessCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.subnetworks.setPrivateIpGoogleAccess" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *SubnetworksSetPrivateIpGoogleAccessCall) Fields(s ...googleapi.Field) *SubnetworksSetPrivateIpGoogleAccessCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *SubnetworksSetPrivateIpGoogleAccessCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *SubnetworksSetPrivateIpGoogleAccessCall) RequestId(requestId string) *SubnetworksSetPrivateIpGoogleAccessCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type SubnetworksSetPrivateIpGoogleAccessRequest struct {
PrivateIpGoogleAccess bool `json:"privateIpGoogleAccess,omitempty"`
// ForceSendFields is a list of field names (e.g.
// "PrivateIpGoogleAccess") to unconditionally include in API requests.
// By default, fields with empty values are omitted from API requests.
// However, any non-pointer, non-interface field appearing in
// ForceSendFields will be sent to the server regardless of whether the
// field is empty or not. This may be used to include empty fields in
// Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "PrivateIpGoogleAccess") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *SubnetworksSetPrivateIpGoogleAccessRequest) MarshalJSON() ([]byte, error)
type TCPHealthCheck struct {
// Port: The TCP port number for the health check request. The default
// value is 80. Valid values are 1 through 65535.
Port int64 `json:"port,omitempty"`
// PortName: Port name as defined in InstanceGroup#NamedPort#name. If
// both port and port_name are defined, port takes precedence.
PortName string `json:"portName,omitempty"`
// ProxyHeader: Specifies the type of proxy header to append before
// sending data to the backend, either NONE or PROXY_V1. The default is
// NONE.
//
// Possible values:
// "NONE"
// "PROXY_V1"
ProxyHeader string `json:"proxyHeader,omitempty"`
// Request: The application data to send once the TCP connection has
// been established (default value is empty). If both request and
// response are empty, the connection establishment alone will indicate
// health. The request data can only be ASCII.
Request string `json:"request,omitempty"`
// Response: The bytes to match against the beginning of the response
// data. If left empty (the default value), any response will indicate
// health. The response data can only be ASCII.
Response string `json:"response,omitempty"`
// ForceSendFields is a list of field names (e.g. "Port") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Port") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TCPHealthCheck) MarshalJSON() ([]byte, error)
type Tags struct {
// Fingerprint: Specifies a fingerprint for this request, which is
// essentially a hash of the metadata's contents and used for optimistic
// locking. The fingerprint is initially generated by Compute Engine and
// changes after every request to modify or update metadata. You must
// always provide an up-to-date fingerprint hash in order to update or
// change metadata.
//
// To see the latest fingerprint, make get() request to the instance.
Fingerprint string `json:"fingerprint,omitempty"`
// Items: An array of tags. Each tag must be 1-63 characters long, and
// comply with RFC1035.
Items []string `json:"items,omitempty"`
// ForceSendFields is a list of field names (e.g. "Fingerprint") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Fingerprint") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}Tags: A set of instance tags.
type TargetHttpProxiesDeleteCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpProxiesDeleteCall) Context(ctx context.Context) *TargetHttpProxiesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpProxiesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetHttpProxies.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpProxiesDeleteCall) Fields(s ...googleapi.Field) *TargetHttpProxiesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpProxiesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpProxiesDeleteCall) RequestId(requestId string) *TargetHttpProxiesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetHttpProxiesGetCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpProxiesGetCall) Context(ctx context.Context) *TargetHttpProxiesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpProxiesGetCall) Do(opts ...googleapi.CallOption) (*TargetHttpProxy, error)
Do executes the "compute.targetHttpProxies.get" call. Exactly one of *TargetHttpProxy or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetHttpProxy.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpProxiesGetCall) Fields(s ...googleapi.Field) *TargetHttpProxiesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpProxiesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpProxiesGetCall) IfNoneMatch(entityTag string) *TargetHttpProxiesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type TargetHttpProxiesInsertCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpProxiesInsertCall) Context(ctx context.Context) *TargetHttpProxiesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpProxiesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetHttpProxies.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpProxiesInsertCall) Fields(s ...googleapi.Field) *TargetHttpProxiesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpProxiesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpProxiesInsertCall) RequestId(requestId string) *TargetHttpProxiesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetHttpProxiesListCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpProxiesListCall) Context(ctx context.Context) *TargetHttpProxiesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpProxiesListCall) Do(opts ...googleapi.CallOption) (*TargetHttpProxyList, error)
Do executes the "compute.targetHttpProxies.list" call. Exactly one of *TargetHttpProxyList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetHttpProxyList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpProxiesListCall) Fields(s ...googleapi.Field) *TargetHttpProxiesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpProxiesListCall) Filter(filter string) *TargetHttpProxiesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *TargetHttpProxiesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpProxiesListCall) IfNoneMatch(entityTag string) *TargetHttpProxiesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *TargetHttpProxiesListCall) MaxResults(maxResults int64) *TargetHttpProxiesListCall
MaxResults sets the optional parameter "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)
func (c *TargetHttpProxiesListCall) OrderBy(orderBy string) *TargetHttpProxiesListCall
OrderBy sets the optional parameter "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.
func (c *TargetHttpProxiesListCall) PageToken(pageToken string) *TargetHttpProxiesListCall
PageToken sets the optional parameter "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.
func (c *TargetHttpProxiesListCall) Pages(ctx context.Context, f func(*TargetHttpProxyList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type TargetHttpProxiesService struct {
// contains filtered or unexported fields
}func NewTargetHttpProxiesService(s *Service) *TargetHttpProxiesService
func (r *TargetHttpProxiesService) Delete(project string, targetHttpProxy string) *TargetHttpProxiesDeleteCall
Delete: Deletes the specified TargetHttpProxy resource. For details, see https://cloud.google.com/compute/docs/reference/latest/targetHttpProxies/delete
func (r *TargetHttpProxiesService) Get(project string, targetHttpProxy string) *TargetHttpProxiesGetCall
Get: Returns the specified TargetHttpProxy resource. Get a list of available target HTTP proxies by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/targetHttpProxies/get
func (r *TargetHttpProxiesService) Insert(project string, targethttpproxy *TargetHttpProxy) *TargetHttpProxiesInsertCall
Insert: Creates a TargetHttpProxy resource in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/targetHttpProxies/insert
func (r *TargetHttpProxiesService) List(project string) *TargetHttpProxiesListCall
List: Retrieves the list of TargetHttpProxy resources available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/targetHttpProxies/list
func (r *TargetHttpProxiesService) SetUrlMap(project string, targetHttpProxy string, urlmapreference *UrlMapReference) *TargetHttpProxiesSetUrlMapCall
SetUrlMap: Changes the URL map for TargetHttpProxy. For details, see https://cloud.google.com/compute/docs/reference/latest/targetHttpProxies/setUrlMap
type TargetHttpProxiesSetUrlMapCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpProxiesSetUrlMapCall) Context(ctx context.Context) *TargetHttpProxiesSetUrlMapCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpProxiesSetUrlMapCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetHttpProxies.setUrlMap" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpProxiesSetUrlMapCall) Fields(s ...googleapi.Field) *TargetHttpProxiesSetUrlMapCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpProxiesSetUrlMapCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpProxiesSetUrlMapCall) RequestId(requestId string) *TargetHttpProxiesSetUrlMapCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetHttpProxy struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of resource. Always compute#targetHttpProxy
// for target HTTP proxies.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// UrlMap: URL to the UrlMap resource that defines the mapping from URL
// to the BackendService.
UrlMap string `json:"urlMap,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}TargetHttpProxy: A TargetHttpProxy resource. This resource defines an HTTP proxy. (== resource_for beta.targetHttpProxies ==) (== resource_for v1.targetHttpProxies ==)
func (s *TargetHttpProxy) MarshalJSON() ([]byte, error)
type TargetHttpProxyList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of TargetHttpProxy resources.
Items []*TargetHttpProxy `json:"items,omitempty"`
// Kind: Type of resource. Always compute#targetHttpProxyList for lists
// of target HTTP proxies.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *TargetHttpProxyListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetHttpProxyList: A list of TargetHttpProxy resources.
func (s *TargetHttpProxyList) MarshalJSON() ([]byte, error)
type TargetHttpProxyListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetHttpProxyListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetHttpProxyListWarning: [Output Only] Informational warning message.
func (s *TargetHttpProxyListWarning) MarshalJSON() ([]byte, error)
type TargetHttpProxyListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetHttpProxyListWarningData) MarshalJSON() ([]byte, error)
type TargetHttpsProxiesDeleteCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpsProxiesDeleteCall) Context(ctx context.Context) *TargetHttpsProxiesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpsProxiesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetHttpsProxies.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpsProxiesDeleteCall) Fields(s ...googleapi.Field) *TargetHttpsProxiesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpsProxiesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpsProxiesDeleteCall) RequestId(requestId string) *TargetHttpsProxiesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetHttpsProxiesGetCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpsProxiesGetCall) Context(ctx context.Context) *TargetHttpsProxiesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpsProxiesGetCall) Do(opts ...googleapi.CallOption) (*TargetHttpsProxy, error)
Do executes the "compute.targetHttpsProxies.get" call. Exactly one of *TargetHttpsProxy or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetHttpsProxy.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpsProxiesGetCall) Fields(s ...googleapi.Field) *TargetHttpsProxiesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpsProxiesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpsProxiesGetCall) IfNoneMatch(entityTag string) *TargetHttpsProxiesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type TargetHttpsProxiesInsertCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpsProxiesInsertCall) Context(ctx context.Context) *TargetHttpsProxiesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpsProxiesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetHttpsProxies.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpsProxiesInsertCall) Fields(s ...googleapi.Field) *TargetHttpsProxiesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpsProxiesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpsProxiesInsertCall) RequestId(requestId string) *TargetHttpsProxiesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetHttpsProxiesListCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpsProxiesListCall) Context(ctx context.Context) *TargetHttpsProxiesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpsProxiesListCall) Do(opts ...googleapi.CallOption) (*TargetHttpsProxyList, error)
Do executes the "compute.targetHttpsProxies.list" call. Exactly one of *TargetHttpsProxyList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetHttpsProxyList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpsProxiesListCall) Fields(s ...googleapi.Field) *TargetHttpsProxiesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpsProxiesListCall) Filter(filter string) *TargetHttpsProxiesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *TargetHttpsProxiesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpsProxiesListCall) IfNoneMatch(entityTag string) *TargetHttpsProxiesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *TargetHttpsProxiesListCall) MaxResults(maxResults int64) *TargetHttpsProxiesListCall
MaxResults sets the optional parameter "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)
func (c *TargetHttpsProxiesListCall) OrderBy(orderBy string) *TargetHttpsProxiesListCall
OrderBy sets the optional parameter "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.
func (c *TargetHttpsProxiesListCall) PageToken(pageToken string) *TargetHttpsProxiesListCall
PageToken sets the optional parameter "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.
func (c *TargetHttpsProxiesListCall) Pages(ctx context.Context, f func(*TargetHttpsProxyList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type TargetHttpsProxiesService struct {
// contains filtered or unexported fields
}func NewTargetHttpsProxiesService(s *Service) *TargetHttpsProxiesService
func (r *TargetHttpsProxiesService) Delete(project string, targetHttpsProxy string) *TargetHttpsProxiesDeleteCall
Delete: Deletes the specified TargetHttpsProxy resource.
func (r *TargetHttpsProxiesService) Get(project string, targetHttpsProxy string) *TargetHttpsProxiesGetCall
Get: Returns the specified TargetHttpsProxy resource. Get a list of available target HTTPS proxies by making a list() request.
func (r *TargetHttpsProxiesService) Insert(project string, targethttpsproxy *TargetHttpsProxy) *TargetHttpsProxiesInsertCall
Insert: Creates a TargetHttpsProxy resource in the specified project using the data included in the request.
func (r *TargetHttpsProxiesService) List(project string) *TargetHttpsProxiesListCall
List: Retrieves the list of TargetHttpsProxy resources available to the specified project.
func (r *TargetHttpsProxiesService) SetSslCertificates(project string, targetHttpsProxy string, targethttpsproxiessetsslcertificatesrequest *TargetHttpsProxiesSetSslCertificatesRequest) *TargetHttpsProxiesSetSslCertificatesCall
SetSslCertificates: Replaces SslCertificates for TargetHttpsProxy.
func (r *TargetHttpsProxiesService) SetUrlMap(project string, targetHttpsProxy string, urlmapreference *UrlMapReference) *TargetHttpsProxiesSetUrlMapCall
SetUrlMap: Changes the URL map for TargetHttpsProxy.
type TargetHttpsProxiesSetSslCertificatesCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpsProxiesSetSslCertificatesCall) Context(ctx context.Context) *TargetHttpsProxiesSetSslCertificatesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpsProxiesSetSslCertificatesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetHttpsProxies.setSslCertificates" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpsProxiesSetSslCertificatesCall) Fields(s ...googleapi.Field) *TargetHttpsProxiesSetSslCertificatesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpsProxiesSetSslCertificatesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpsProxiesSetSslCertificatesCall) RequestId(requestId string) *TargetHttpsProxiesSetSslCertificatesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetHttpsProxiesSetSslCertificatesRequest struct {
// SslCertificates: New set of SslCertificate resources to associate
// with this TargetHttpsProxy resource. Currently exactly one
// SslCertificate resource must be specified.
SslCertificates []string `json:"sslCertificates,omitempty"`
// ForceSendFields is a list of field names (e.g. "SslCertificates") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "SslCertificates") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *TargetHttpsProxiesSetSslCertificatesRequest) MarshalJSON() ([]byte, error)
type TargetHttpsProxiesSetUrlMapCall struct {
// contains filtered or unexported fields
}func (c *TargetHttpsProxiesSetUrlMapCall) Context(ctx context.Context) *TargetHttpsProxiesSetUrlMapCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetHttpsProxiesSetUrlMapCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetHttpsProxies.setUrlMap" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetHttpsProxiesSetUrlMapCall) Fields(s ...googleapi.Field) *TargetHttpsProxiesSetUrlMapCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetHttpsProxiesSetUrlMapCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetHttpsProxiesSetUrlMapCall) RequestId(requestId string) *TargetHttpsProxiesSetUrlMapCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetHttpsProxy struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of resource. Always compute#targetHttpsProxy
// for target HTTPS proxies.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// SslCertificates: URLs to SslCertificate resources that are used to
// authenticate connections between users and the load balancer.
// Currently, exactly one SSL certificate must be specified.
SslCertificates []string `json:"sslCertificates,omitempty"`
// UrlMap: A fully-qualified or valid partial URL to the UrlMap resource
// that defines the mapping from URL to the BackendService. For example,
// the following are all valid URLs for specifying a URL map:
// -
// https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
// - projects/project/global/urlMaps/url-map
// - global/urlMaps/url-map
UrlMap string `json:"urlMap,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}TargetHttpsProxy: A TargetHttpsProxy resource. This resource defines an HTTPS proxy. (== resource_for beta.targetHttpsProxies ==) (== resource_for v1.targetHttpsProxies ==)
func (s *TargetHttpsProxy) MarshalJSON() ([]byte, error)
type TargetHttpsProxyList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of TargetHttpsProxy resources.
Items []*TargetHttpsProxy `json:"items,omitempty"`
// Kind: Type of resource. Always compute#targetHttpsProxyList for lists
// of target HTTPS proxies.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *TargetHttpsProxyListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetHttpsProxyList: Contains a list of TargetHttpsProxy resources.
func (s *TargetHttpsProxyList) MarshalJSON() ([]byte, error)
type TargetHttpsProxyListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetHttpsProxyListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetHttpsProxyListWarning: [Output Only] Informational warning message.
func (s *TargetHttpsProxyListWarning) MarshalJSON() ([]byte, error)
type TargetHttpsProxyListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetHttpsProxyListWarningData) MarshalJSON() ([]byte, error)
type TargetInstance struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Instance: A URL to the virtual machine instance that handles traffic
// for this target instance. When creating a target instance, you can
// provide the fully-qualified URL or a valid partial URL to the desired
// virtual machine. For example, the following are all valid URLs:
// -
// https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
// - projects/project/zones/zone/instances/instance
// - zones/zone/instances/instance
Instance string `json:"instance,omitempty"`
// Kind: [Output Only] The type of the resource. Always
// compute#targetInstance for target instances.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// NatPolicy: NAT option controlling how IPs are NAT'ed to the instance.
// Currently only NO_NAT (default value) is supported.
//
// Possible values:
// "NO_NAT"
NatPolicy string `json:"natPolicy,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Zone: [Output Only] URL of the zone where the target instance
// resides.
Zone string `json:"zone,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}TargetInstance: A TargetInstance resource. This resource defines an endpoint instance that terminates traffic of certain protocols. (== resource_for beta.targetInstances ==) (== resource_for v1.targetInstances ==)
func (s *TargetInstance) MarshalJSON() ([]byte, error)
type TargetInstanceAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of TargetInstance resources.
Items map[string]TargetInstancesScopedList `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *TargetInstanceAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetInstanceAggregatedList) MarshalJSON() ([]byte, error)
type TargetInstanceAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetInstanceAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetInstanceAggregatedListWarning: [Output Only] Informational warning message.
func (s *TargetInstanceAggregatedListWarning) MarshalJSON() ([]byte, error)
type TargetInstanceAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetInstanceAggregatedListWarningData) MarshalJSON() ([]byte, error)
type TargetInstanceList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of TargetInstance resources.
Items []*TargetInstance `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *TargetInstanceListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetInstanceList: Contains a list of TargetInstance resources.
func (s *TargetInstanceList) MarshalJSON() ([]byte, error)
type TargetInstanceListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetInstanceListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetInstanceListWarning: [Output Only] Informational warning message.
func (s *TargetInstanceListWarning) MarshalJSON() ([]byte, error)
type TargetInstanceListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetInstanceListWarningData) MarshalJSON() ([]byte, error)
type TargetInstancesAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *TargetInstancesAggregatedListCall) Context(ctx context.Context) *TargetInstancesAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetInstancesAggregatedListCall) Do(opts ...googleapi.CallOption) (*TargetInstanceAggregatedList, error)
Do executes the "compute.targetInstances.aggregatedList" call. Exactly one of *TargetInstanceAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetInstanceAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetInstancesAggregatedListCall) Fields(s ...googleapi.Field) *TargetInstancesAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetInstancesAggregatedListCall) Filter(filter string) *TargetInstancesAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *TargetInstancesAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetInstancesAggregatedListCall) IfNoneMatch(entityTag string) *TargetInstancesAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *TargetInstancesAggregatedListCall) MaxResults(maxResults int64) *TargetInstancesAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *TargetInstancesAggregatedListCall) OrderBy(orderBy string) *TargetInstancesAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *TargetInstancesAggregatedListCall) PageToken(pageToken string) *TargetInstancesAggregatedListCall
PageToken sets the optional parameter "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.
func (c *TargetInstancesAggregatedListCall) Pages(ctx context.Context, f func(*TargetInstanceAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type TargetInstancesDeleteCall struct {
// contains filtered or unexported fields
}func (c *TargetInstancesDeleteCall) Context(ctx context.Context) *TargetInstancesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetInstancesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetInstances.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetInstancesDeleteCall) Fields(s ...googleapi.Field) *TargetInstancesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetInstancesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetInstancesDeleteCall) RequestId(requestId string) *TargetInstancesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetInstancesGetCall struct {
// contains filtered or unexported fields
}func (c *TargetInstancesGetCall) Context(ctx context.Context) *TargetInstancesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetInstancesGetCall) Do(opts ...googleapi.CallOption) (*TargetInstance, error)
Do executes the "compute.targetInstances.get" call. Exactly one of *TargetInstance or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetInstance.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetInstancesGetCall) Fields(s ...googleapi.Field) *TargetInstancesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetInstancesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetInstancesGetCall) IfNoneMatch(entityTag string) *TargetInstancesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type TargetInstancesInsertCall struct {
// contains filtered or unexported fields
}func (c *TargetInstancesInsertCall) Context(ctx context.Context) *TargetInstancesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetInstancesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetInstances.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetInstancesInsertCall) Fields(s ...googleapi.Field) *TargetInstancesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetInstancesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetInstancesInsertCall) RequestId(requestId string) *TargetInstancesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetInstancesListCall struct {
// contains filtered or unexported fields
}func (c *TargetInstancesListCall) Context(ctx context.Context) *TargetInstancesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetInstancesListCall) Do(opts ...googleapi.CallOption) (*TargetInstanceList, error)
Do executes the "compute.targetInstances.list" call. Exactly one of *TargetInstanceList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetInstanceList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetInstancesListCall) Fields(s ...googleapi.Field) *TargetInstancesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetInstancesListCall) Filter(filter string) *TargetInstancesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *TargetInstancesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetInstancesListCall) IfNoneMatch(entityTag string) *TargetInstancesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *TargetInstancesListCall) MaxResults(maxResults int64) *TargetInstancesListCall
MaxResults sets the optional parameter "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)
func (c *TargetInstancesListCall) OrderBy(orderBy string) *TargetInstancesListCall
OrderBy sets the optional parameter "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.
func (c *TargetInstancesListCall) PageToken(pageToken string) *TargetInstancesListCall
PageToken sets the optional parameter "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.
func (c *TargetInstancesListCall) Pages(ctx context.Context, f func(*TargetInstanceList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type TargetInstancesScopedList struct {
// TargetInstances: List of target instances contained in this scope.
TargetInstances []*TargetInstance `json:"targetInstances,omitempty"`
// Warning: Informational warning which replaces the list of addresses
// when the list is empty.
Warning *TargetInstancesScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "TargetInstances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "TargetInstances") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *TargetInstancesScopedList) MarshalJSON() ([]byte, error)
type TargetInstancesScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetInstancesScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetInstancesScopedListWarning: Informational warning which replaces the list of addresses when the list is empty.
func (s *TargetInstancesScopedListWarning) MarshalJSON() ([]byte, error)
type TargetInstancesScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetInstancesScopedListWarningData) MarshalJSON() ([]byte, error)
type TargetInstancesService struct {
// contains filtered or unexported fields
}func NewTargetInstancesService(s *Service) *TargetInstancesService
func (r *TargetInstancesService) AggregatedList(project string) *TargetInstancesAggregatedListCall
AggregatedList: Retrieves an aggregated list of target instances. For details, see https://cloud.google.com/compute/docs/reference/latest/targetInstances/aggregatedList
func (r *TargetInstancesService) Delete(project string, zone string, targetInstance string) *TargetInstancesDeleteCall
Delete: Deletes the specified TargetInstance resource. For details, see https://cloud.google.com/compute/docs/reference/latest/targetInstances/delete
func (r *TargetInstancesService) Get(project string, zone string, targetInstance string) *TargetInstancesGetCall
Get: Returns the specified TargetInstance resource. Get a list of available target instances by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/targetInstances/get
func (r *TargetInstancesService) Insert(project string, zone string, targetinstance *TargetInstance) *TargetInstancesInsertCall
Insert: Creates a TargetInstance resource in the specified project and zone using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/targetInstances/insert
func (r *TargetInstancesService) List(project string, zone string) *TargetInstancesListCall
List: Retrieves a list of TargetInstance resources available to the specified project and zone. For details, see https://cloud.google.com/compute/docs/reference/latest/targetInstances/list
type TargetPool struct {
// BackupPool: This field is applicable only when the containing target
// pool is serving a forwarding rule as the primary pool, and its
// failoverRatio field is properly set to a value between [0,
// 1].
//
// backupPool and failoverRatio together define the fallback behavior of
// the primary target pool: if the ratio of the healthy instances in the
// primary pool is at or below failoverRatio, traffic arriving at the
// load-balanced IP will be directed to the backup pool.
//
// In case where failoverRatio and backupPool are not set, or all the
// instances in the backup pool are unhealthy, the traffic will be
// directed back to the primary pool in the "force" mode, where traffic
// will be spread to the healthy instances with the best effort, or to
// all instances when no instance is healthy.
BackupPool string `json:"backupPool,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// FailoverRatio: This field is applicable only when the containing
// target pool is serving a forwarding rule as the primary pool (i.e.,
// not as a backup pool to some other target pool). The value of the
// field must be in [0, 1].
//
// If set, backupPool must also be set. They together define the
// fallback behavior of the primary target pool: if the ratio of the
// healthy instances in the primary pool is at or below this number,
// traffic arriving at the load-balanced IP will be directed to the
// backup pool.
//
// In case where failoverRatio is not set or all the instances in the
// backup pool are unhealthy, the traffic will be directed back to the
// primary pool in the "force" mode, where traffic will be spread to the
// healthy instances with the best effort, or to all instances when no
// instance is healthy.
FailoverRatio float64 `json:"failoverRatio,omitempty"`
// HealthChecks: The URL of the HttpHealthCheck resource. A member
// instance in this pool is considered healthy if and only if the health
// checks pass. An empty list means all member instances will be
// considered healthy at all times. Only HttpHealthChecks are supported.
// Only one health check may be specified.
HealthChecks []string `json:"healthChecks,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Instances: A list of resource URLs to the virtual machine instances
// serving this pool. They must live in zones contained in the same
// region as this pool.
Instances []string `json:"instances,omitempty"`
// Kind: [Output Only] Type of the resource. Always compute#targetPool
// for target pools.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Region: [Output Only] URL of the region where the target pool
// resides.
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// SessionAffinity: Sesssion affinity option, must be one of the
// following values:
// NONE: Connections from the same client IP may go to any instance in
// the pool.
// CLIENT_IP: Connections from the same client IP will go to the same
// instance in the pool while that instance remains
// healthy.
// CLIENT_IP_PROTO: Connections from the same client IP with the same IP
// protocol will go to the same instance in the pool while that instance
// remains healthy.
//
// Possible values:
// "CLIENT_IP"
// "CLIENT_IP_PORT_PROTO"
// "CLIENT_IP_PROTO"
// "GENERATED_COOKIE"
// "NONE"
SessionAffinity string `json:"sessionAffinity,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "BackupPool") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "BackupPool") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetPool: A TargetPool resource. This resource defines a pool of instances, an associated HttpHealthCheck resource, and the fallback target pool. (== resource_for beta.targetPools ==) (== resource_for v1.targetPools ==)
func (s *TargetPool) MarshalJSON() ([]byte, error)
func (s *TargetPool) UnmarshalJSON(data []byte) error
type TargetPoolAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of TargetPool resources.
Items map[string]TargetPoolsScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#targetPoolAggregatedList for aggregated lists of target
// pools.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *TargetPoolAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetPoolAggregatedList) MarshalJSON() ([]byte, error)
type TargetPoolAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetPoolAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetPoolAggregatedListWarning: [Output Only] Informational warning message.
func (s *TargetPoolAggregatedListWarning) MarshalJSON() ([]byte, error)
type TargetPoolAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetPoolAggregatedListWarningData) MarshalJSON() ([]byte, error)
type TargetPoolInstanceHealth struct {
HealthStatus []*HealthStatus `json:"healthStatus,omitempty"`
// Kind: [Output Only] Type of resource. Always
// compute#targetPoolInstanceHealth when checking the health of an
// instance.
Kind string `json:"kind,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "HealthStatus") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "HealthStatus") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetPoolInstanceHealth) MarshalJSON() ([]byte, error)
type TargetPoolList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of TargetPool resources.
Items []*TargetPool `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#targetPoolList
// for lists of target pools.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *TargetPoolListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetPoolList: Contains a list of TargetPool resources.
func (s *TargetPoolList) MarshalJSON() ([]byte, error)
type TargetPoolListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetPoolListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetPoolListWarning: [Output Only] Informational warning message.
func (s *TargetPoolListWarning) MarshalJSON() ([]byte, error)
type TargetPoolListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetPoolListWarningData) MarshalJSON() ([]byte, error)
type TargetPoolsAddHealthCheckCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsAddHealthCheckCall) Context(ctx context.Context) *TargetPoolsAddHealthCheckCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsAddHealthCheckCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetPools.addHealthCheck" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsAddHealthCheckCall) Fields(s ...googleapi.Field) *TargetPoolsAddHealthCheckCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsAddHealthCheckCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetPoolsAddHealthCheckCall) RequestId(requestId string) *TargetPoolsAddHealthCheckCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetPoolsAddHealthCheckRequest struct {
// HealthChecks: The HttpHealthCheck to add to the target pool.
HealthChecks []*HealthCheckReference `json:"healthChecks,omitempty"`
// ForceSendFields is a list of field names (e.g. "HealthChecks") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "HealthChecks") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetPoolsAddHealthCheckRequest) MarshalJSON() ([]byte, error)
type TargetPoolsAddInstanceCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsAddInstanceCall) Context(ctx context.Context) *TargetPoolsAddInstanceCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsAddInstanceCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetPools.addInstance" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsAddInstanceCall) Fields(s ...googleapi.Field) *TargetPoolsAddInstanceCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsAddInstanceCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetPoolsAddInstanceCall) RequestId(requestId string) *TargetPoolsAddInstanceCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetPoolsAddInstanceRequest struct {
// Instances: A full or partial URL to an instance to add to this target
// pool. This can be a full or partial URL. For example, the following
// are valid URLs:
// -
// https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name
// - projects/project-id/zones/zone/instances/instance-name
// - zones/zone/instances/instance-name
Instances []*InstanceReference `json:"instances,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetPoolsAddInstanceRequest) MarshalJSON() ([]byte, error)
type TargetPoolsAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsAggregatedListCall) Context(ctx context.Context) *TargetPoolsAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsAggregatedListCall) Do(opts ...googleapi.CallOption) (*TargetPoolAggregatedList, error)
Do executes the "compute.targetPools.aggregatedList" call. Exactly one of *TargetPoolAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetPoolAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsAggregatedListCall) Fields(s ...googleapi.Field) *TargetPoolsAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsAggregatedListCall) Filter(filter string) *TargetPoolsAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *TargetPoolsAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetPoolsAggregatedListCall) IfNoneMatch(entityTag string) *TargetPoolsAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *TargetPoolsAggregatedListCall) MaxResults(maxResults int64) *TargetPoolsAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *TargetPoolsAggregatedListCall) OrderBy(orderBy string) *TargetPoolsAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *TargetPoolsAggregatedListCall) PageToken(pageToken string) *TargetPoolsAggregatedListCall
PageToken sets the optional parameter "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.
func (c *TargetPoolsAggregatedListCall) Pages(ctx context.Context, f func(*TargetPoolAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type TargetPoolsDeleteCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsDeleteCall) Context(ctx context.Context) *TargetPoolsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetPools.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsDeleteCall) Fields(s ...googleapi.Field) *TargetPoolsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetPoolsDeleteCall) RequestId(requestId string) *TargetPoolsDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetPoolsGetCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsGetCall) Context(ctx context.Context) *TargetPoolsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsGetCall) Do(opts ...googleapi.CallOption) (*TargetPool, error)
Do executes the "compute.targetPools.get" call. Exactly one of *TargetPool or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetPool.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsGetCall) Fields(s ...googleapi.Field) *TargetPoolsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetPoolsGetCall) IfNoneMatch(entityTag string) *TargetPoolsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type TargetPoolsGetHealthCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsGetHealthCall) Context(ctx context.Context) *TargetPoolsGetHealthCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsGetHealthCall) Do(opts ...googleapi.CallOption) (*TargetPoolInstanceHealth, error)
Do executes the "compute.targetPools.getHealth" call. Exactly one of *TargetPoolInstanceHealth or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetPoolInstanceHealth.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsGetHealthCall) Fields(s ...googleapi.Field) *TargetPoolsGetHealthCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsGetHealthCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type TargetPoolsInsertCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsInsertCall) Context(ctx context.Context) *TargetPoolsInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetPools.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsInsertCall) Fields(s ...googleapi.Field) *TargetPoolsInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetPoolsInsertCall) RequestId(requestId string) *TargetPoolsInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetPoolsListCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsListCall) Context(ctx context.Context) *TargetPoolsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsListCall) Do(opts ...googleapi.CallOption) (*TargetPoolList, error)
Do executes the "compute.targetPools.list" call. Exactly one of *TargetPoolList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetPoolList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsListCall) Fields(s ...googleapi.Field) *TargetPoolsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsListCall) Filter(filter string) *TargetPoolsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *TargetPoolsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetPoolsListCall) IfNoneMatch(entityTag string) *TargetPoolsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *TargetPoolsListCall) MaxResults(maxResults int64) *TargetPoolsListCall
MaxResults sets the optional parameter "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)
func (c *TargetPoolsListCall) OrderBy(orderBy string) *TargetPoolsListCall
OrderBy sets the optional parameter "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.
func (c *TargetPoolsListCall) PageToken(pageToken string) *TargetPoolsListCall
PageToken sets the optional parameter "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.
func (c *TargetPoolsListCall) Pages(ctx context.Context, f func(*TargetPoolList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type TargetPoolsRemoveHealthCheckCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsRemoveHealthCheckCall) Context(ctx context.Context) *TargetPoolsRemoveHealthCheckCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsRemoveHealthCheckCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetPools.removeHealthCheck" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsRemoveHealthCheckCall) Fields(s ...googleapi.Field) *TargetPoolsRemoveHealthCheckCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsRemoveHealthCheckCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetPoolsRemoveHealthCheckCall) RequestId(requestId string) *TargetPoolsRemoveHealthCheckCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetPoolsRemoveHealthCheckRequest struct {
// HealthChecks: Health check URL to be removed. This can be a full or
// valid partial URL. For example, the following are valid URLs:
// -
// https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check
// - projects/project/global/httpHealthChecks/health-check
// - global/httpHealthChecks/health-check
HealthChecks []*HealthCheckReference `json:"healthChecks,omitempty"`
// ForceSendFields is a list of field names (e.g. "HealthChecks") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "HealthChecks") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetPoolsRemoveHealthCheckRequest) MarshalJSON() ([]byte, error)
type TargetPoolsRemoveInstanceCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsRemoveInstanceCall) Context(ctx context.Context) *TargetPoolsRemoveInstanceCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsRemoveInstanceCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetPools.removeInstance" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsRemoveInstanceCall) Fields(s ...googleapi.Field) *TargetPoolsRemoveInstanceCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsRemoveInstanceCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetPoolsRemoveInstanceCall) RequestId(requestId string) *TargetPoolsRemoveInstanceCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetPoolsRemoveInstanceRequest struct {
// Instances: URLs of the instances to be removed from target pool.
Instances []*InstanceReference `json:"instances,omitempty"`
// ForceSendFields is a list of field names (e.g. "Instances") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Instances") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetPoolsRemoveInstanceRequest) MarshalJSON() ([]byte, error)
type TargetPoolsScopedList struct {
// TargetPools: List of target pools contained in this scope.
TargetPools []*TargetPool `json:"targetPools,omitempty"`
// Warning: Informational warning which replaces the list of addresses
// when the list is empty.
Warning *TargetPoolsScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "TargetPools") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "TargetPools") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetPoolsScopedList) MarshalJSON() ([]byte, error)
type TargetPoolsScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetPoolsScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetPoolsScopedListWarning: Informational warning which replaces the list of addresses when the list is empty.
func (s *TargetPoolsScopedListWarning) MarshalJSON() ([]byte, error)
type TargetPoolsScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetPoolsScopedListWarningData) MarshalJSON() ([]byte, error)
type TargetPoolsService struct {
// contains filtered or unexported fields
}func NewTargetPoolsService(s *Service) *TargetPoolsService
func (r *TargetPoolsService) AddHealthCheck(project string, region string, targetPool string, targetpoolsaddhealthcheckrequest *TargetPoolsAddHealthCheckRequest) *TargetPoolsAddHealthCheckCall
AddHealthCheck: Adds health check URLs to a target pool. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/addHealthCheck
func (r *TargetPoolsService) AddInstance(project string, region string, targetPool string, targetpoolsaddinstancerequest *TargetPoolsAddInstanceRequest) *TargetPoolsAddInstanceCall
AddInstance: Adds an instance to a target pool. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/addInstance
func (r *TargetPoolsService) AggregatedList(project string) *TargetPoolsAggregatedListCall
AggregatedList: Retrieves an aggregated list of target pools. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/aggregatedList
func (r *TargetPoolsService) Delete(project string, region string, targetPool string) *TargetPoolsDeleteCall
Delete: Deletes the specified target pool. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/delete
func (r *TargetPoolsService) Get(project string, region string, targetPool string) *TargetPoolsGetCall
Get: Returns the specified target pool. Get a list of available target pools by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/get
func (r *TargetPoolsService) GetHealth(project string, region string, targetPool string, instancereference *InstanceReference) *TargetPoolsGetHealthCall
GetHealth: Gets the most recent health check results for each IP for the instance that is referenced by the given target pool. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/getHealth
func (r *TargetPoolsService) Insert(project string, region string, targetpool *TargetPool) *TargetPoolsInsertCall
Insert: Creates a target pool in the specified project and region using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/insert
func (r *TargetPoolsService) List(project string, region string) *TargetPoolsListCall
List: Retrieves a list of target pools available to the specified project and region. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/list
func (r *TargetPoolsService) RemoveHealthCheck(project string, region string, targetPool string, targetpoolsremovehealthcheckrequest *TargetPoolsRemoveHealthCheckRequest) *TargetPoolsRemoveHealthCheckCall
RemoveHealthCheck: Removes health check URL from a target pool. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/removeHealthCheck
func (r *TargetPoolsService) RemoveInstance(project string, region string, targetPool string, targetpoolsremoveinstancerequest *TargetPoolsRemoveInstanceRequest) *TargetPoolsRemoveInstanceCall
RemoveInstance: Removes instance URL from a target pool. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/removeInstance
func (r *TargetPoolsService) SetBackup(project string, region string, targetPool string, targetreference *TargetReference) *TargetPoolsSetBackupCall
SetBackup: Changes a backup target pool's configurations. For details, see https://cloud.google.com/compute/docs/reference/latest/targetPools/setBackup
type TargetPoolsSetBackupCall struct {
// contains filtered or unexported fields
}func (c *TargetPoolsSetBackupCall) Context(ctx context.Context) *TargetPoolsSetBackupCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetPoolsSetBackupCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetPools.setBackup" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetPoolsSetBackupCall) FailoverRatio(failoverRatio float64) *TargetPoolsSetBackupCall
FailoverRatio sets the optional parameter "failoverRatio": New failoverRatio value for the target pool.
func (c *TargetPoolsSetBackupCall) Fields(s ...googleapi.Field) *TargetPoolsSetBackupCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetPoolsSetBackupCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetPoolsSetBackupCall) RequestId(requestId string) *TargetPoolsSetBackupCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetReference struct {
Target string `json:"target,omitempty"`
// ForceSendFields is a list of field names (e.g. "Target") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Target") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetReference) MarshalJSON() ([]byte, error)
type TargetSslProxiesDeleteCall struct {
// contains filtered or unexported fields
}func (c *TargetSslProxiesDeleteCall) Context(ctx context.Context) *TargetSslProxiesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetSslProxiesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetSslProxies.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetSslProxiesDeleteCall) Fields(s ...googleapi.Field) *TargetSslProxiesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetSslProxiesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetSslProxiesDeleteCall) RequestId(requestId string) *TargetSslProxiesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetSslProxiesGetCall struct {
// contains filtered or unexported fields
}func (c *TargetSslProxiesGetCall) Context(ctx context.Context) *TargetSslProxiesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetSslProxiesGetCall) Do(opts ...googleapi.CallOption) (*TargetSslProxy, error)
Do executes the "compute.targetSslProxies.get" call. Exactly one of *TargetSslProxy or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetSslProxy.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetSslProxiesGetCall) Fields(s ...googleapi.Field) *TargetSslProxiesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetSslProxiesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetSslProxiesGetCall) IfNoneMatch(entityTag string) *TargetSslProxiesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type TargetSslProxiesInsertCall struct {
// contains filtered or unexported fields
}func (c *TargetSslProxiesInsertCall) Context(ctx context.Context) *TargetSslProxiesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetSslProxiesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetSslProxies.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetSslProxiesInsertCall) Fields(s ...googleapi.Field) *TargetSslProxiesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetSslProxiesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetSslProxiesInsertCall) RequestId(requestId string) *TargetSslProxiesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetSslProxiesListCall struct {
// contains filtered or unexported fields
}func (c *TargetSslProxiesListCall) Context(ctx context.Context) *TargetSslProxiesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetSslProxiesListCall) Do(opts ...googleapi.CallOption) (*TargetSslProxyList, error)
Do executes the "compute.targetSslProxies.list" call. Exactly one of *TargetSslProxyList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetSslProxyList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetSslProxiesListCall) Fields(s ...googleapi.Field) *TargetSslProxiesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetSslProxiesListCall) Filter(filter string) *TargetSslProxiesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *TargetSslProxiesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetSslProxiesListCall) IfNoneMatch(entityTag string) *TargetSslProxiesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *TargetSslProxiesListCall) MaxResults(maxResults int64) *TargetSslProxiesListCall
MaxResults sets the optional parameter "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)
func (c *TargetSslProxiesListCall) OrderBy(orderBy string) *TargetSslProxiesListCall
OrderBy sets the optional parameter "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.
func (c *TargetSslProxiesListCall) PageToken(pageToken string) *TargetSslProxiesListCall
PageToken sets the optional parameter "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.
func (c *TargetSslProxiesListCall) Pages(ctx context.Context, f func(*TargetSslProxyList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type TargetSslProxiesService struct {
// contains filtered or unexported fields
}func NewTargetSslProxiesService(s *Service) *TargetSslProxiesService
func (r *TargetSslProxiesService) Delete(project string, targetSslProxy string) *TargetSslProxiesDeleteCall
Delete: Deletes the specified TargetSslProxy resource.
func (r *TargetSslProxiesService) Get(project string, targetSslProxy string) *TargetSslProxiesGetCall
Get: Returns the specified TargetSslProxy resource. Get a list of available target SSL proxies by making a list() request.
func (r *TargetSslProxiesService) Insert(project string, targetsslproxy *TargetSslProxy) *TargetSslProxiesInsertCall
Insert: Creates a TargetSslProxy resource in the specified project using the data included in the request.
func (r *TargetSslProxiesService) List(project string) *TargetSslProxiesListCall
List: Retrieves the list of TargetSslProxy resources available to the specified project.
func (r *TargetSslProxiesService) SetBackendService(project string, targetSslProxy string, targetsslproxiessetbackendservicerequest *TargetSslProxiesSetBackendServiceRequest) *TargetSslProxiesSetBackendServiceCall
SetBackendService: Changes the BackendService for TargetSslProxy.
func (r *TargetSslProxiesService) SetProxyHeader(project string, targetSslProxy string, targetsslproxiessetproxyheaderrequest *TargetSslProxiesSetProxyHeaderRequest) *TargetSslProxiesSetProxyHeaderCall
SetProxyHeader: Changes the ProxyHeaderType for TargetSslProxy.
func (r *TargetSslProxiesService) SetSslCertificates(project string, targetSslProxy string, targetsslproxiessetsslcertificatesrequest *TargetSslProxiesSetSslCertificatesRequest) *TargetSslProxiesSetSslCertificatesCall
SetSslCertificates: Changes SslCertificates for TargetSslProxy.
type TargetSslProxiesSetBackendServiceCall struct {
// contains filtered or unexported fields
}func (c *TargetSslProxiesSetBackendServiceCall) Context(ctx context.Context) *TargetSslProxiesSetBackendServiceCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetSslProxiesSetBackendServiceCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetSslProxies.setBackendService" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetSslProxiesSetBackendServiceCall) Fields(s ...googleapi.Field) *TargetSslProxiesSetBackendServiceCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetSslProxiesSetBackendServiceCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetSslProxiesSetBackendServiceCall) RequestId(requestId string) *TargetSslProxiesSetBackendServiceCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetSslProxiesSetBackendServiceRequest struct {
// Service: The URL of the new BackendService resource for the
// targetSslProxy.
Service string `json:"service,omitempty"`
// ForceSendFields is a list of field names (e.g. "Service") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Service") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetSslProxiesSetBackendServiceRequest) MarshalJSON() ([]byte, error)
type TargetSslProxiesSetProxyHeaderCall struct {
// contains filtered or unexported fields
}func (c *TargetSslProxiesSetProxyHeaderCall) Context(ctx context.Context) *TargetSslProxiesSetProxyHeaderCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetSslProxiesSetProxyHeaderCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetSslProxies.setProxyHeader" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetSslProxiesSetProxyHeaderCall) Fields(s ...googleapi.Field) *TargetSslProxiesSetProxyHeaderCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetSslProxiesSetProxyHeaderCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetSslProxiesSetProxyHeaderCall) RequestId(requestId string) *TargetSslProxiesSetProxyHeaderCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetSslProxiesSetProxyHeaderRequest struct {
// ProxyHeader: The new type of proxy header to append before sending
// data to the backend. NONE or PROXY_V1 are allowed.
//
// Possible values:
// "NONE"
// "PROXY_V1"
ProxyHeader string `json:"proxyHeader,omitempty"`
// ForceSendFields is a list of field names (e.g. "ProxyHeader") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ProxyHeader") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetSslProxiesSetProxyHeaderRequest) MarshalJSON() ([]byte, error)
type TargetSslProxiesSetSslCertificatesCall struct {
// contains filtered or unexported fields
}func (c *TargetSslProxiesSetSslCertificatesCall) Context(ctx context.Context) *TargetSslProxiesSetSslCertificatesCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetSslProxiesSetSslCertificatesCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetSslProxies.setSslCertificates" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetSslProxiesSetSslCertificatesCall) Fields(s ...googleapi.Field) *TargetSslProxiesSetSslCertificatesCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetSslProxiesSetSslCertificatesCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetSslProxiesSetSslCertificatesCall) RequestId(requestId string) *TargetSslProxiesSetSslCertificatesCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetSslProxiesSetSslCertificatesRequest struct {
// SslCertificates: New set of URLs to SslCertificate resources to
// associate with this TargetSslProxy. Currently exactly one ssl
// certificate must be specified.
SslCertificates []string `json:"sslCertificates,omitempty"`
// ForceSendFields is a list of field names (e.g. "SslCertificates") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "SslCertificates") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *TargetSslProxiesSetSslCertificatesRequest) MarshalJSON() ([]byte, error)
type TargetSslProxy struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always
// compute#targetSslProxy for target SSL proxies.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// ProxyHeader: Specifies the type of proxy header to append before
// sending data to the backend, either NONE or PROXY_V1. The default is
// NONE.
//
// Possible values:
// "NONE"
// "PROXY_V1"
ProxyHeader string `json:"proxyHeader,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Service: URL to the BackendService resource.
Service string `json:"service,omitempty"`
// SslCertificates: URLs to SslCertificate resources that are used to
// authenticate connections to Backends. Currently exactly one SSL
// certificate must be specified.
SslCertificates []string `json:"sslCertificates,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}TargetSslProxy: A TargetSslProxy resource. This resource defines an SSL proxy. (== resource_for beta.targetSslProxies ==) (== resource_for v1.targetSslProxies ==)
func (s *TargetSslProxy) MarshalJSON() ([]byte, error)
type TargetSslProxyList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of TargetSslProxy resources.
Items []*TargetSslProxy `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *TargetSslProxyListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetSslProxyList: Contains a list of TargetSslProxy resources.
func (s *TargetSslProxyList) MarshalJSON() ([]byte, error)
type TargetSslProxyListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetSslProxyListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetSslProxyListWarning: [Output Only] Informational warning message.
func (s *TargetSslProxyListWarning) MarshalJSON() ([]byte, error)
type TargetSslProxyListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetSslProxyListWarningData) MarshalJSON() ([]byte, error)
type TargetTcpProxiesDeleteCall struct {
// contains filtered or unexported fields
}func (c *TargetTcpProxiesDeleteCall) Context(ctx context.Context) *TargetTcpProxiesDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetTcpProxiesDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetTcpProxies.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetTcpProxiesDeleteCall) Fields(s ...googleapi.Field) *TargetTcpProxiesDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetTcpProxiesDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetTcpProxiesDeleteCall) RequestId(requestId string) *TargetTcpProxiesDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetTcpProxiesGetCall struct {
// contains filtered or unexported fields
}func (c *TargetTcpProxiesGetCall) Context(ctx context.Context) *TargetTcpProxiesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetTcpProxiesGetCall) Do(opts ...googleapi.CallOption) (*TargetTcpProxy, error)
Do executes the "compute.targetTcpProxies.get" call. Exactly one of *TargetTcpProxy or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetTcpProxy.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetTcpProxiesGetCall) Fields(s ...googleapi.Field) *TargetTcpProxiesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetTcpProxiesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetTcpProxiesGetCall) IfNoneMatch(entityTag string) *TargetTcpProxiesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type TargetTcpProxiesInsertCall struct {
// contains filtered or unexported fields
}func (c *TargetTcpProxiesInsertCall) Context(ctx context.Context) *TargetTcpProxiesInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetTcpProxiesInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetTcpProxies.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetTcpProxiesInsertCall) Fields(s ...googleapi.Field) *TargetTcpProxiesInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetTcpProxiesInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetTcpProxiesInsertCall) RequestId(requestId string) *TargetTcpProxiesInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetTcpProxiesListCall struct {
// contains filtered or unexported fields
}func (c *TargetTcpProxiesListCall) Context(ctx context.Context) *TargetTcpProxiesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetTcpProxiesListCall) Do(opts ...googleapi.CallOption) (*TargetTcpProxyList, error)
Do executes the "compute.targetTcpProxies.list" call. Exactly one of *TargetTcpProxyList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetTcpProxyList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetTcpProxiesListCall) Fields(s ...googleapi.Field) *TargetTcpProxiesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetTcpProxiesListCall) Filter(filter string) *TargetTcpProxiesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *TargetTcpProxiesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetTcpProxiesListCall) IfNoneMatch(entityTag string) *TargetTcpProxiesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *TargetTcpProxiesListCall) MaxResults(maxResults int64) *TargetTcpProxiesListCall
MaxResults sets the optional parameter "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)
func (c *TargetTcpProxiesListCall) OrderBy(orderBy string) *TargetTcpProxiesListCall
OrderBy sets the optional parameter "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.
func (c *TargetTcpProxiesListCall) PageToken(pageToken string) *TargetTcpProxiesListCall
PageToken sets the optional parameter "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.
func (c *TargetTcpProxiesListCall) Pages(ctx context.Context, f func(*TargetTcpProxyList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type TargetTcpProxiesService struct {
// contains filtered or unexported fields
}func NewTargetTcpProxiesService(s *Service) *TargetTcpProxiesService
func (r *TargetTcpProxiesService) Delete(project string, targetTcpProxy string) *TargetTcpProxiesDeleteCall
Delete: Deletes the specified TargetTcpProxy resource.
func (r *TargetTcpProxiesService) Get(project string, targetTcpProxy string) *TargetTcpProxiesGetCall
Get: Returns the specified TargetTcpProxy resource. Get a list of available target TCP proxies by making a list() request.
func (r *TargetTcpProxiesService) Insert(project string, targettcpproxy *TargetTcpProxy) *TargetTcpProxiesInsertCall
Insert: Creates a TargetTcpProxy resource in the specified project using the data included in the request.
func (r *TargetTcpProxiesService) List(project string) *TargetTcpProxiesListCall
List: Retrieves the list of TargetTcpProxy resources available to the specified project.
func (r *TargetTcpProxiesService) SetBackendService(project string, targetTcpProxy string, targettcpproxiessetbackendservicerequest *TargetTcpProxiesSetBackendServiceRequest) *TargetTcpProxiesSetBackendServiceCall
SetBackendService: Changes the BackendService for TargetTcpProxy.
func (r *TargetTcpProxiesService) SetProxyHeader(project string, targetTcpProxy string, targettcpproxiessetproxyheaderrequest *TargetTcpProxiesSetProxyHeaderRequest) *TargetTcpProxiesSetProxyHeaderCall
SetProxyHeader: Changes the ProxyHeaderType for TargetTcpProxy.
type TargetTcpProxiesSetBackendServiceCall struct {
// contains filtered or unexported fields
}func (c *TargetTcpProxiesSetBackendServiceCall) Context(ctx context.Context) *TargetTcpProxiesSetBackendServiceCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetTcpProxiesSetBackendServiceCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetTcpProxies.setBackendService" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetTcpProxiesSetBackendServiceCall) Fields(s ...googleapi.Field) *TargetTcpProxiesSetBackendServiceCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetTcpProxiesSetBackendServiceCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetTcpProxiesSetBackendServiceCall) RequestId(requestId string) *TargetTcpProxiesSetBackendServiceCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetTcpProxiesSetBackendServiceRequest struct {
// Service: The URL of the new BackendService resource for the
// targetTcpProxy.
Service string `json:"service,omitempty"`
// ForceSendFields is a list of field names (e.g. "Service") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Service") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetTcpProxiesSetBackendServiceRequest) MarshalJSON() ([]byte, error)
type TargetTcpProxiesSetProxyHeaderCall struct {
// contains filtered or unexported fields
}func (c *TargetTcpProxiesSetProxyHeaderCall) Context(ctx context.Context) *TargetTcpProxiesSetProxyHeaderCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetTcpProxiesSetProxyHeaderCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetTcpProxies.setProxyHeader" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetTcpProxiesSetProxyHeaderCall) Fields(s ...googleapi.Field) *TargetTcpProxiesSetProxyHeaderCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetTcpProxiesSetProxyHeaderCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetTcpProxiesSetProxyHeaderCall) RequestId(requestId string) *TargetTcpProxiesSetProxyHeaderCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetTcpProxiesSetProxyHeaderRequest struct {
// ProxyHeader: The new type of proxy header to append before sending
// data to the backend. NONE or PROXY_V1 are allowed.
//
// Possible values:
// "NONE"
// "PROXY_V1"
ProxyHeader string `json:"proxyHeader,omitempty"`
// ForceSendFields is a list of field names (e.g. "ProxyHeader") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ProxyHeader") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetTcpProxiesSetProxyHeaderRequest) MarshalJSON() ([]byte, error)
type TargetTcpProxy struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always
// compute#targetTcpProxy for target TCP proxies.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// ProxyHeader: Specifies the type of proxy header to append before
// sending data to the backend, either NONE or PROXY_V1. The default is
// NONE.
//
// Possible values:
// "NONE"
// "PROXY_V1"
ProxyHeader string `json:"proxyHeader,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Service: URL to the BackendService resource.
Service string `json:"service,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}TargetTcpProxy: A TargetTcpProxy resource. This resource defines a TCP proxy. (== resource_for beta.targetTcpProxies ==) (== resource_for v1.targetTcpProxies ==)
func (s *TargetTcpProxy) MarshalJSON() ([]byte, error)
type TargetTcpProxyList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of TargetTcpProxy resources.
Items []*TargetTcpProxy `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *TargetTcpProxyListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetTcpProxyList: Contains a list of TargetTcpProxy resources.
func (s *TargetTcpProxyList) MarshalJSON() ([]byte, error)
type TargetTcpProxyListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetTcpProxyListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetTcpProxyListWarning: [Output Only] Informational warning message.
func (s *TargetTcpProxyListWarning) MarshalJSON() ([]byte, error)
type TargetTcpProxyListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetTcpProxyListWarningData) MarshalJSON() ([]byte, error)
type TargetVpnGateway struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// ForwardingRules: [Output Only] A list of URLs to the ForwardingRule
// resources. ForwardingRules are created using
// compute.forwardingRules.insert and associated to a VPN gateway.
ForwardingRules []string `json:"forwardingRules,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of resource. Always compute#targetVpnGateway
// for target VPN gateways.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// Network: URL of the network to which this VPN gateway is attached.
// Provided by the client when the VPN gateway is created.
Network string `json:"network,omitempty"`
// Region: [Output Only] URL of the region where the target VPN gateway
// resides.
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Status: [Output Only] The status of the VPN gateway.
//
// Possible values:
// "CREATING"
// "DELETING"
// "FAILED"
// "READY"
Status string `json:"status,omitempty"`
// Tunnels: [Output Only] A list of URLs to VpnTunnel resources.
// VpnTunnels are created using compute.vpntunnels.insert method and
// associated to a VPN gateway.
Tunnels []string `json:"tunnels,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}TargetVpnGateway: Represents a Target VPN gateway resource. (== resource_for beta.targetVpnGateways ==) (== resource_for v1.targetVpnGateways ==)
func (s *TargetVpnGateway) MarshalJSON() ([]byte, error)
type TargetVpnGatewayAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of TargetVpnGateway resources.
Items map[string]TargetVpnGatewaysScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#targetVpnGateway
// for target VPN gateways.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *TargetVpnGatewayAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetVpnGatewayAggregatedList) MarshalJSON() ([]byte, error)
type TargetVpnGatewayAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetVpnGatewayAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetVpnGatewayAggregatedListWarning: [Output Only] Informational warning message.
func (s *TargetVpnGatewayAggregatedListWarning) MarshalJSON() ([]byte, error)
type TargetVpnGatewayAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetVpnGatewayAggregatedListWarningData) MarshalJSON() ([]byte, error)
type TargetVpnGatewayList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of TargetVpnGateway resources.
Items []*TargetVpnGateway `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#targetVpnGateway
// for target VPN gateways.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *TargetVpnGatewayListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetVpnGatewayList: Contains a list of TargetVpnGateway resources.
func (s *TargetVpnGatewayList) MarshalJSON() ([]byte, error)
type TargetVpnGatewayListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetVpnGatewayListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetVpnGatewayListWarning: [Output Only] Informational warning message.
func (s *TargetVpnGatewayListWarning) MarshalJSON() ([]byte, error)
type TargetVpnGatewayListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetVpnGatewayListWarningData) MarshalJSON() ([]byte, error)
type TargetVpnGatewaysAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *TargetVpnGatewaysAggregatedListCall) Context(ctx context.Context) *TargetVpnGatewaysAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetVpnGatewaysAggregatedListCall) Do(opts ...googleapi.CallOption) (*TargetVpnGatewayAggregatedList, error)
Do executes the "compute.targetVpnGateways.aggregatedList" call. Exactly one of *TargetVpnGatewayAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetVpnGatewayAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetVpnGatewaysAggregatedListCall) Fields(s ...googleapi.Field) *TargetVpnGatewaysAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetVpnGatewaysAggregatedListCall) Filter(filter string) *TargetVpnGatewaysAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *TargetVpnGatewaysAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetVpnGatewaysAggregatedListCall) IfNoneMatch(entityTag string) *TargetVpnGatewaysAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *TargetVpnGatewaysAggregatedListCall) MaxResults(maxResults int64) *TargetVpnGatewaysAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *TargetVpnGatewaysAggregatedListCall) OrderBy(orderBy string) *TargetVpnGatewaysAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *TargetVpnGatewaysAggregatedListCall) PageToken(pageToken string) *TargetVpnGatewaysAggregatedListCall
PageToken sets the optional parameter "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.
func (c *TargetVpnGatewaysAggregatedListCall) Pages(ctx context.Context, f func(*TargetVpnGatewayAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type TargetVpnGatewaysDeleteCall struct {
// contains filtered or unexported fields
}func (c *TargetVpnGatewaysDeleteCall) Context(ctx context.Context) *TargetVpnGatewaysDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetVpnGatewaysDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetVpnGateways.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetVpnGatewaysDeleteCall) Fields(s ...googleapi.Field) *TargetVpnGatewaysDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetVpnGatewaysDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetVpnGatewaysDeleteCall) RequestId(requestId string) *TargetVpnGatewaysDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetVpnGatewaysGetCall struct {
// contains filtered or unexported fields
}func (c *TargetVpnGatewaysGetCall) Context(ctx context.Context) *TargetVpnGatewaysGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetVpnGatewaysGetCall) Do(opts ...googleapi.CallOption) (*TargetVpnGateway, error)
Do executes the "compute.targetVpnGateways.get" call. Exactly one of *TargetVpnGateway or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetVpnGateway.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetVpnGatewaysGetCall) Fields(s ...googleapi.Field) *TargetVpnGatewaysGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetVpnGatewaysGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetVpnGatewaysGetCall) IfNoneMatch(entityTag string) *TargetVpnGatewaysGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type TargetVpnGatewaysInsertCall struct {
// contains filtered or unexported fields
}func (c *TargetVpnGatewaysInsertCall) Context(ctx context.Context) *TargetVpnGatewaysInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetVpnGatewaysInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.targetVpnGateways.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetVpnGatewaysInsertCall) Fields(s ...googleapi.Field) *TargetVpnGatewaysInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetVpnGatewaysInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetVpnGatewaysInsertCall) RequestId(requestId string) *TargetVpnGatewaysInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type TargetVpnGatewaysListCall struct {
// contains filtered or unexported fields
}func (c *TargetVpnGatewaysListCall) Context(ctx context.Context) *TargetVpnGatewaysListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *TargetVpnGatewaysListCall) Do(opts ...googleapi.CallOption) (*TargetVpnGatewayList, error)
Do executes the "compute.targetVpnGateways.list" call. Exactly one of *TargetVpnGatewayList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *TargetVpnGatewayList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *TargetVpnGatewaysListCall) Fields(s ...googleapi.Field) *TargetVpnGatewaysListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *TargetVpnGatewaysListCall) Filter(filter string) *TargetVpnGatewaysListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *TargetVpnGatewaysListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *TargetVpnGatewaysListCall) IfNoneMatch(entityTag string) *TargetVpnGatewaysListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *TargetVpnGatewaysListCall) MaxResults(maxResults int64) *TargetVpnGatewaysListCall
MaxResults sets the optional parameter "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)
func (c *TargetVpnGatewaysListCall) OrderBy(orderBy string) *TargetVpnGatewaysListCall
OrderBy sets the optional parameter "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.
func (c *TargetVpnGatewaysListCall) PageToken(pageToken string) *TargetVpnGatewaysListCall
PageToken sets the optional parameter "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.
func (c *TargetVpnGatewaysListCall) Pages(ctx context.Context, f func(*TargetVpnGatewayList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type TargetVpnGatewaysScopedList struct {
// TargetVpnGateways: [Output Only] List of target vpn gateways
// contained in this scope.
TargetVpnGateways []*TargetVpnGateway `json:"targetVpnGateways,omitempty"`
// Warning: [Output Only] Informational warning which replaces the list
// of addresses when the list is empty.
Warning *TargetVpnGatewaysScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "TargetVpnGateways")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "TargetVpnGateways") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *TargetVpnGatewaysScopedList) MarshalJSON() ([]byte, error)
type TargetVpnGatewaysScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*TargetVpnGatewaysScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}TargetVpnGatewaysScopedListWarning: [Output Only] Informational warning which replaces the list of addresses when the list is empty.
func (s *TargetVpnGatewaysScopedListWarning) MarshalJSON() ([]byte, error)
type TargetVpnGatewaysScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TargetVpnGatewaysScopedListWarningData) MarshalJSON() ([]byte, error)
type TargetVpnGatewaysService struct {
// contains filtered or unexported fields
}func NewTargetVpnGatewaysService(s *Service) *TargetVpnGatewaysService
func (r *TargetVpnGatewaysService) AggregatedList(project string) *TargetVpnGatewaysAggregatedListCall
AggregatedList: Retrieves an aggregated list of target VPN gateways.
func (r *TargetVpnGatewaysService) Delete(project string, region string, targetVpnGateway string) *TargetVpnGatewaysDeleteCall
Delete: Deletes the specified target VPN gateway.
func (r *TargetVpnGatewaysService) Get(project string, region string, targetVpnGateway string) *TargetVpnGatewaysGetCall
Get: Returns the specified target VPN gateway. Get a list of available target VPN gateways by making a list() request.
func (r *TargetVpnGatewaysService) Insert(project string, region string, targetvpngateway *TargetVpnGateway) *TargetVpnGatewaysInsertCall
Insert: Creates a target VPN gateway in the specified project and region using the data included in the request.
func (r *TargetVpnGatewaysService) List(project string, region string) *TargetVpnGatewaysListCall
List: Retrieves a list of target VPN gateways available to the specified project and region.
type TestFailure struct {
ActualService string `json:"actualService,omitempty"`
ExpectedService string `json:"expectedService,omitempty"`
Host string `json:"host,omitempty"`
Path string `json:"path,omitempty"`
// ForceSendFields is a list of field names (e.g. "ActualService") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "ActualService") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *TestFailure) MarshalJSON() ([]byte, error)
type UrlMap struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// DefaultService: The URL of the BackendService resource if none of the
// hostRules match.
DefaultService string `json:"defaultService,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// Fingerprint: Fingerprint of this resource. A hash of the contents
// stored in this object. This field is used in optimistic locking. This
// field will be ignored when inserting a UrlMap. An up-to-date
// fingerprint must be provided in order to update the UrlMap.
Fingerprint string `json:"fingerprint,omitempty"`
// HostRules: The list of HostRules to use against the URL.
HostRules []*HostRule `json:"hostRules,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#urlMaps for
// url maps.
Kind string `json:"kind,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// PathMatchers: The list of named PathMatchers to use against the URL.
PathMatchers []*PathMatcher `json:"pathMatchers,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Tests: The list of expected URL mappings. Request to update this
// UrlMap will succeed only if all of the test cases pass.
Tests []*UrlMapTest `json:"tests,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}UrlMap: A UrlMap resource. This resource defines the mapping from URL to the BackendService resource, based on the "longest-match" of the URL's host and path.
type UrlMapList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of UrlMap resources.
Items []*UrlMap `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *UrlMapListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}UrlMapList: Contains a list of UrlMap resources.
func (s *UrlMapList) MarshalJSON() ([]byte, error)
type UrlMapListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*UrlMapListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}UrlMapListWarning: [Output Only] Informational warning message.
func (s *UrlMapListWarning) MarshalJSON() ([]byte, error)
type UrlMapListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *UrlMapListWarningData) MarshalJSON() ([]byte, error)
type UrlMapReference struct {
UrlMap string `json:"urlMap,omitempty"`
// ForceSendFields is a list of field names (e.g. "UrlMap") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "UrlMap") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *UrlMapReference) MarshalJSON() ([]byte, error)
type UrlMapTest struct {
// Description: Description of this test case.
Description string `json:"description,omitempty"`
// Host: Host portion of the URL.
Host string `json:"host,omitempty"`
// Path: Path portion of the URL.
Path string `json:"path,omitempty"`
// Service: Expected BackendService resource the given URL should be
// mapped to.
Service string `json:"service,omitempty"`
// ForceSendFields is a list of field names (e.g. "Description") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Description") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}UrlMapTest: Message for the expected URL mappings.
func (s *UrlMapTest) MarshalJSON() ([]byte, error)
type UrlMapValidationResult struct {
LoadErrors []string `json:"loadErrors,omitempty"`
// LoadSucceeded: Whether the given UrlMap can be successfully loaded.
// If false, 'loadErrors' indicates the reasons.
LoadSucceeded bool `json:"loadSucceeded,omitempty"`
TestFailures []*TestFailure `json:"testFailures,omitempty"`
// TestPassed: If successfully loaded, this field indicates whether the
// test passed. If false, 'testFailures's indicate the reason of
// failure.
TestPassed bool `json:"testPassed,omitempty"`
// ForceSendFields is a list of field names (e.g. "LoadErrors") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "LoadErrors") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}UrlMapValidationResult: Message representing the validation result for a UrlMap.
func (s *UrlMapValidationResult) MarshalJSON() ([]byte, error)
type UrlMapsDeleteCall struct {
// contains filtered or unexported fields
}func (c *UrlMapsDeleteCall) Context(ctx context.Context) *UrlMapsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *UrlMapsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.urlMaps.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *UrlMapsDeleteCall) Fields(s ...googleapi.Field) *UrlMapsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *UrlMapsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *UrlMapsDeleteCall) RequestId(requestId string) *UrlMapsDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type UrlMapsGetCall struct {
// contains filtered or unexported fields
}func (c *UrlMapsGetCall) Context(ctx context.Context) *UrlMapsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *UrlMapsGetCall) Do(opts ...googleapi.CallOption) (*UrlMap, error)
Do executes the "compute.urlMaps.get" call. Exactly one of *UrlMap or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *UrlMap.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *UrlMapsGetCall) Fields(s ...googleapi.Field) *UrlMapsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *UrlMapsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *UrlMapsGetCall) IfNoneMatch(entityTag string) *UrlMapsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type UrlMapsInsertCall struct {
// contains filtered or unexported fields
}func (c *UrlMapsInsertCall) Context(ctx context.Context) *UrlMapsInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *UrlMapsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.urlMaps.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *UrlMapsInsertCall) Fields(s ...googleapi.Field) *UrlMapsInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *UrlMapsInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *UrlMapsInsertCall) RequestId(requestId string) *UrlMapsInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type UrlMapsInvalidateCacheCall struct {
// contains filtered or unexported fields
}func (c *UrlMapsInvalidateCacheCall) Context(ctx context.Context) *UrlMapsInvalidateCacheCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *UrlMapsInvalidateCacheCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.urlMaps.invalidateCache" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *UrlMapsInvalidateCacheCall) Fields(s ...googleapi.Field) *UrlMapsInvalidateCacheCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *UrlMapsInvalidateCacheCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *UrlMapsInvalidateCacheCall) RequestId(requestId string) *UrlMapsInvalidateCacheCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type UrlMapsListCall struct {
// contains filtered or unexported fields
}func (c *UrlMapsListCall) Context(ctx context.Context) *UrlMapsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *UrlMapsListCall) Do(opts ...googleapi.CallOption) (*UrlMapList, error)
Do executes the "compute.urlMaps.list" call. Exactly one of *UrlMapList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *UrlMapList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *UrlMapsListCall) Fields(s ...googleapi.Field) *UrlMapsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *UrlMapsListCall) Filter(filter string) *UrlMapsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *UrlMapsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *UrlMapsListCall) IfNoneMatch(entityTag string) *UrlMapsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *UrlMapsListCall) MaxResults(maxResults int64) *UrlMapsListCall
MaxResults sets the optional parameter "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)
func (c *UrlMapsListCall) OrderBy(orderBy string) *UrlMapsListCall
OrderBy sets the optional parameter "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.
func (c *UrlMapsListCall) PageToken(pageToken string) *UrlMapsListCall
PageToken sets the optional parameter "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.
func (c *UrlMapsListCall) Pages(ctx context.Context, f func(*UrlMapList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type UrlMapsPatchCall struct {
// contains filtered or unexported fields
}func (c *UrlMapsPatchCall) Context(ctx context.Context) *UrlMapsPatchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *UrlMapsPatchCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.urlMaps.patch" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *UrlMapsPatchCall) Fields(s ...googleapi.Field) *UrlMapsPatchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *UrlMapsPatchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *UrlMapsPatchCall) RequestId(requestId string) *UrlMapsPatchCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type UrlMapsService struct {
// contains filtered or unexported fields
}func NewUrlMapsService(s *Service) *UrlMapsService
func (r *UrlMapsService) Delete(project string, urlMap string) *UrlMapsDeleteCall
Delete: Deletes the specified UrlMap resource. For details, see https://cloud.google.com/compute/docs/reference/latest/urlMaps/delete
func (r *UrlMapsService) Get(project string, urlMap string) *UrlMapsGetCall
Get: Returns the specified UrlMap resource. Get a list of available URL maps by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/urlMaps/get
func (r *UrlMapsService) Insert(project string, urlmap *UrlMap) *UrlMapsInsertCall
Insert: Creates a UrlMap resource in the specified project using the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/urlMaps/insert
func (r *UrlMapsService) InvalidateCache(project string, urlMap string, cacheinvalidationrule *CacheInvalidationRule) *UrlMapsInvalidateCacheCall
InvalidateCache: Initiates a cache invalidation operation, invalidating the specified path, scoped to the specified UrlMap.
func (r *UrlMapsService) List(project string) *UrlMapsListCall
List: Retrieves the list of UrlMap resources available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/urlMaps/list
func (r *UrlMapsService) Patch(project string, urlMap string, urlmap *UrlMap) *UrlMapsPatchCall
Patch: Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. For details, see https://cloud.google.com/compute/docs/reference/latest/urlMaps/patch
func (r *UrlMapsService) Update(project string, urlMap string, urlmap *UrlMap) *UrlMapsUpdateCall
Update: Updates the specified UrlMap resource with the data included in the request. For details, see https://cloud.google.com/compute/docs/reference/latest/urlMaps/update
func (r *UrlMapsService) Validate(project string, urlMap string, urlmapsvalidaterequest *UrlMapsValidateRequest) *UrlMapsValidateCall
Validate: Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap. For details, see https://cloud.google.com/compute/docs/reference/latest/urlMaps/validate
type UrlMapsUpdateCall struct {
// contains filtered or unexported fields
}func (c *UrlMapsUpdateCall) Context(ctx context.Context) *UrlMapsUpdateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *UrlMapsUpdateCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.urlMaps.update" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *UrlMapsUpdateCall) Fields(s ...googleapi.Field) *UrlMapsUpdateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *UrlMapsUpdateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *UrlMapsUpdateCall) RequestId(requestId string) *UrlMapsUpdateCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type UrlMapsValidateCall struct {
// contains filtered or unexported fields
}func (c *UrlMapsValidateCall) Context(ctx context.Context) *UrlMapsValidateCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *UrlMapsValidateCall) Do(opts ...googleapi.CallOption) (*UrlMapsValidateResponse, error)
Do executes the "compute.urlMaps.validate" call. Exactly one of *UrlMapsValidateResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *UrlMapsValidateResponse.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *UrlMapsValidateCall) Fields(s ...googleapi.Field) *UrlMapsValidateCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *UrlMapsValidateCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type UrlMapsValidateRequest struct {
// Resource: Content of the UrlMap to be validated.
Resource *UrlMap `json:"resource,omitempty"`
// ForceSendFields is a list of field names (e.g. "Resource") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Resource") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *UrlMapsValidateRequest) MarshalJSON() ([]byte, error)
type UrlMapsValidateResponse struct {
Result *UrlMapValidationResult `json:"result,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Result") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Result") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *UrlMapsValidateResponse) MarshalJSON() ([]byte, error)
type UsageExportLocation struct {
// BucketName: The name of an existing bucket in Cloud Storage where the
// usage report object is stored. The Google Service Account is granted
// write access to this bucket. This can either be the bucket name by
// itself, such as example-bucket, or the bucket name with gs:// or
// https://storage.googleapis.com/ in front of it, such as
// gs://example-bucket.
BucketName string `json:"bucketName,omitempty"`
// ReportNamePrefix: An optional prefix for the name of the usage report
// object stored in bucketName. If not supplied, defaults to usage. The
// report is stored as a CSV file named
// report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the
// usage according to Pacific Time. If you supply a prefix, it should
// conform to Cloud Storage object naming conventions.
ReportNamePrefix string `json:"reportNamePrefix,omitempty"`
// ForceSendFields is a list of field names (e.g. "BucketName") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "BucketName") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}UsageExportLocation: The location in Cloud Storage and naming method of the daily usage report. Contains bucket_name and report_name prefix.
func (s *UsageExportLocation) MarshalJSON() ([]byte, error)
type VpnTunnel struct {
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Description: An optional description of this resource. Provide this
// property when you create the resource.
Description string `json:"description,omitempty"`
// DetailedStatus: [Output Only] Detailed status message for the VPN
// tunnel.
DetailedStatus string `json:"detailedStatus,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// IkeVersion: IKE protocol version to use when establishing the VPN
// tunnel with peer VPN gateway. Acceptable IKE versions are 1 or 2.
// Default version is 2.
IkeVersion int64 `json:"ikeVersion,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#vpnTunnel for
// VPN tunnels.
Kind string `json:"kind,omitempty"`
// LocalTrafficSelector: Local traffic selector to use when establishing
// the VPN tunnel with peer VPN gateway. The value should be a CIDR
// formatted string, for example: 192.168.0.0/16. The ranges should be
// disjoint. Only IPv4 is supported.
LocalTrafficSelector []string `json:"localTrafficSelector,omitempty"`
// Name: Name of the resource. Provided by the client when the resource
// is created. The name must be 1-63 characters long, and comply with
// RFC1035. Specifically, the name must be 1-63 characters long and
// match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means
// the first character must be a lowercase letter, and all following
// characters must be a dash, lowercase letter, or digit, except the
// last character, which cannot be a dash.
Name string `json:"name,omitempty"`
// PeerIp: IP address of the peer VPN gateway. Only IPv4 is supported.
PeerIp string `json:"peerIp,omitempty"`
// Region: [Output Only] URL of the region where the VPN tunnel resides.
Region string `json:"region,omitempty"`
// RemoteTrafficSelector: Remote traffic selectors to use when
// establishing the VPN tunnel with peer VPN gateway. The value should
// be a CIDR formatted string, for example: 192.168.0.0/16. The ranges
// should be disjoint. Only IPv4 is supported.
RemoteTrafficSelector []string `json:"remoteTrafficSelector,omitempty"`
// Router: URL of router resource to be used for dynamic routing.
Router string `json:"router,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// SharedSecret: Shared secret used to set the secure session between
// the Cloud VPN gateway and the peer VPN gateway.
string `json:"sharedSecret,omitempty"`
// SharedSecretHash: Hash of the shared secret.
string `json:"sharedSecretHash,omitempty"`
// Status: [Output Only] The status of the VPN tunnel.
//
// Possible values:
// "ALLOCATING_RESOURCES"
// "AUTHORIZATION_ERROR"
// "DEPROVISIONING"
// "ESTABLISHED"
// "FAILED"
// "FIRST_HANDSHAKE"
// "NEGOTIATION_FAILURE"
// "NETWORK_ERROR"
// "NO_INCOMING_PACKETS"
// "PROVISIONING"
// "REJECTED"
// "WAITING_FOR_FULL_CONFIG"
Status string `json:"status,omitempty"`
// TargetVpnGateway: URL of the VPN gateway with which this VPN tunnel
// is associated. Provided by the client when the VPN tunnel is created.
TargetVpnGateway string `json:"targetVpnGateway,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "CreationTimestamp")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "CreationTimestamp") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}VpnTunnel: VPN tunnel resource. (== resource_for beta.vpnTunnels ==) (== resource_for v1.vpnTunnels ==)
type VpnTunnelAggregatedList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of VpnTunnelsScopedList resources.
Items map[string]VpnTunnelsScopedList `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#vpnTunnel for
// VPN tunnels.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *VpnTunnelAggregatedListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *VpnTunnelAggregatedList) MarshalJSON() ([]byte, error)
type VpnTunnelAggregatedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*VpnTunnelAggregatedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}VpnTunnelAggregatedListWarning: [Output Only] Informational warning message.
func (s *VpnTunnelAggregatedListWarning) MarshalJSON() ([]byte, error)
type VpnTunnelAggregatedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *VpnTunnelAggregatedListWarningData) MarshalJSON() ([]byte, error)
type VpnTunnelList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of VpnTunnel resources.
Items []*VpnTunnel `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#vpnTunnel for
// VPN tunnels.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *VpnTunnelListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}VpnTunnelList: Contains a list of VpnTunnel resources.
func (s *VpnTunnelList) MarshalJSON() ([]byte, error)
type VpnTunnelListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*VpnTunnelListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}VpnTunnelListWarning: [Output Only] Informational warning message.
func (s *VpnTunnelListWarning) MarshalJSON() ([]byte, error)
type VpnTunnelListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *VpnTunnelListWarningData) MarshalJSON() ([]byte, error)
type VpnTunnelsAggregatedListCall struct {
// contains filtered or unexported fields
}func (c *VpnTunnelsAggregatedListCall) Context(ctx context.Context) *VpnTunnelsAggregatedListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *VpnTunnelsAggregatedListCall) Do(opts ...googleapi.CallOption) (*VpnTunnelAggregatedList, error)
Do executes the "compute.vpnTunnels.aggregatedList" call. Exactly one of *VpnTunnelAggregatedList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *VpnTunnelAggregatedList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *VpnTunnelsAggregatedListCall) Fields(s ...googleapi.Field) *VpnTunnelsAggregatedListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *VpnTunnelsAggregatedListCall) Filter(filter string) *VpnTunnelsAggregatedListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *VpnTunnelsAggregatedListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *VpnTunnelsAggregatedListCall) IfNoneMatch(entityTag string) *VpnTunnelsAggregatedListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *VpnTunnelsAggregatedListCall) MaxResults(maxResults int64) *VpnTunnelsAggregatedListCall
MaxResults sets the optional parameter "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)
func (c *VpnTunnelsAggregatedListCall) OrderBy(orderBy string) *VpnTunnelsAggregatedListCall
OrderBy sets the optional parameter "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.
func (c *VpnTunnelsAggregatedListCall) PageToken(pageToken string) *VpnTunnelsAggregatedListCall
PageToken sets the optional parameter "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.
func (c *VpnTunnelsAggregatedListCall) Pages(ctx context.Context, f func(*VpnTunnelAggregatedList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type VpnTunnelsDeleteCall struct {
// contains filtered or unexported fields
}func (c *VpnTunnelsDeleteCall) Context(ctx context.Context) *VpnTunnelsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *VpnTunnelsDeleteCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.vpnTunnels.delete" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *VpnTunnelsDeleteCall) Fields(s ...googleapi.Field) *VpnTunnelsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *VpnTunnelsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *VpnTunnelsDeleteCall) RequestId(requestId string) *VpnTunnelsDeleteCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type VpnTunnelsGetCall struct {
// contains filtered or unexported fields
}func (c *VpnTunnelsGetCall) Context(ctx context.Context) *VpnTunnelsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *VpnTunnelsGetCall) Do(opts ...googleapi.CallOption) (*VpnTunnel, error)
Do executes the "compute.vpnTunnels.get" call. Exactly one of *VpnTunnel or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *VpnTunnel.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *VpnTunnelsGetCall) Fields(s ...googleapi.Field) *VpnTunnelsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *VpnTunnelsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *VpnTunnelsGetCall) IfNoneMatch(entityTag string) *VpnTunnelsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type VpnTunnelsInsertCall struct {
// contains filtered or unexported fields
}func (c *VpnTunnelsInsertCall) Context(ctx context.Context) *VpnTunnelsInsertCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *VpnTunnelsInsertCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.vpnTunnels.insert" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *VpnTunnelsInsertCall) Fields(s ...googleapi.Field) *VpnTunnelsInsertCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *VpnTunnelsInsertCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *VpnTunnelsInsertCall) RequestId(requestId string) *VpnTunnelsInsertCall
RequestId sets the optional parameter "requestId": An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed.
For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
type VpnTunnelsListCall struct {
// contains filtered or unexported fields
}func (c *VpnTunnelsListCall) Context(ctx context.Context) *VpnTunnelsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *VpnTunnelsListCall) Do(opts ...googleapi.CallOption) (*VpnTunnelList, error)
Do executes the "compute.vpnTunnels.list" call. Exactly one of *VpnTunnelList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *VpnTunnelList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *VpnTunnelsListCall) Fields(s ...googleapi.Field) *VpnTunnelsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *VpnTunnelsListCall) Filter(filter string) *VpnTunnelsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *VpnTunnelsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *VpnTunnelsListCall) IfNoneMatch(entityTag string) *VpnTunnelsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *VpnTunnelsListCall) MaxResults(maxResults int64) *VpnTunnelsListCall
MaxResults sets the optional parameter "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)
func (c *VpnTunnelsListCall) OrderBy(orderBy string) *VpnTunnelsListCall
OrderBy sets the optional parameter "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.
func (c *VpnTunnelsListCall) PageToken(pageToken string) *VpnTunnelsListCall
PageToken sets the optional parameter "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.
func (c *VpnTunnelsListCall) Pages(ctx context.Context, f func(*VpnTunnelList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type VpnTunnelsScopedList struct {
// VpnTunnels: List of vpn tunnels contained in this scope.
VpnTunnels []*VpnTunnel `json:"vpnTunnels,omitempty"`
// Warning: Informational warning which replaces the list of addresses
// when the list is empty.
Warning *VpnTunnelsScopedListWarning `json:"warning,omitempty"`
// ForceSendFields is a list of field names (e.g. "VpnTunnels") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "VpnTunnels") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *VpnTunnelsScopedList) MarshalJSON() ([]byte, error)
type VpnTunnelsScopedListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*VpnTunnelsScopedListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}VpnTunnelsScopedListWarning: Informational warning which replaces the list of addresses when the list is empty.
func (s *VpnTunnelsScopedListWarning) MarshalJSON() ([]byte, error)
type VpnTunnelsScopedListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *VpnTunnelsScopedListWarningData) MarshalJSON() ([]byte, error)
type VpnTunnelsService struct {
// contains filtered or unexported fields
}func NewVpnTunnelsService(s *Service) *VpnTunnelsService
func (r *VpnTunnelsService) AggregatedList(project string) *VpnTunnelsAggregatedListCall
AggregatedList: Retrieves an aggregated list of VPN tunnels.
func (r *VpnTunnelsService) Delete(project string, region string, vpnTunnel string) *VpnTunnelsDeleteCall
Delete: Deletes the specified VpnTunnel resource.
func (r *VpnTunnelsService) Get(project string, region string, vpnTunnel string) *VpnTunnelsGetCall
Get: Returns the specified VpnTunnel resource. Get a list of available VPN tunnels by making a list() request.
func (r *VpnTunnelsService) Insert(project string, region string, vpntunnel *VpnTunnel) *VpnTunnelsInsertCall
Insert: Creates a VpnTunnel resource in the specified project and region using the data included in the request.
func (r *VpnTunnelsService) List(project string, region string) *VpnTunnelsListCall
List: Retrieves a list of VpnTunnel resources contained in the specified project and region.
type XpnHostList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: [Output Only] A list of shared VPC host project URLs.
Items []*Project `json:"items,omitempty"`
// Kind: [Output Only] Type of resource. Always compute#xpnHostList for
// lists of shared VPC hosts.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *XpnHostListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *XpnHostList) MarshalJSON() ([]byte, error)
type XpnHostListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*XpnHostListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}XpnHostListWarning: [Output Only] Informational warning message.
func (s *XpnHostListWarning) MarshalJSON() ([]byte, error)
type XpnHostListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *XpnHostListWarningData) MarshalJSON() ([]byte, error)
type XpnResourceId struct {
// Id: The ID of the service resource. In the case of projects, this
// field matches the project ID (e.g., my-project), not the project
// number (e.g., 12345678).
Id string `json:"id,omitempty"`
// Type: The type of the service resource.
//
// Possible values:
// "PROJECT"
// "XPN_RESOURCE_TYPE_UNSPECIFIED"
Type string `json:"type,omitempty"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}XpnResourceId: Service resource (a.k.a service project) ID.
func (s *XpnResourceId) MarshalJSON() ([]byte, error)
type Zone struct {
// AvailableCpuPlatforms: [Output Only] Available cpu/platform
// selections for the zone.
AvailableCpuPlatforms []string `json:"availableCpuPlatforms,omitempty"`
// CreationTimestamp: [Output Only] Creation timestamp in RFC3339 text
// format.
CreationTimestamp string `json:"creationTimestamp,omitempty"`
// Deprecated: [Output Only] The deprecation status associated with this
// zone.
Deprecated *DeprecationStatus `json:"deprecated,omitempty"`
// Description: [Output Only] Textual description of the resource.
Description string `json:"description,omitempty"`
// Id: [Output Only] The unique identifier for the resource. This
// identifier is defined by the server.
Id uint64 `json:"id,omitempty,string"`
// Kind: [Output Only] Type of the resource. Always compute#zone for
// zones.
Kind string `json:"kind,omitempty"`
// Name: [Output Only] Name of the resource.
Name string `json:"name,omitempty"`
// Region: [Output Only] Full URL reference to the region which hosts
// the zone.
Region string `json:"region,omitempty"`
// SelfLink: [Output Only] Server-defined URL for the resource.
SelfLink string `json:"selfLink,omitempty"`
// Status: [Output Only] Status of the zone, either UP or DOWN.
//
// Possible values:
// "DOWN"
// "UP"
Status string `json:"status,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g.
// "AvailableCpuPlatforms") to unconditionally include in API requests.
// By default, fields with empty values are omitted from API requests.
// However, any non-pointer, non-interface field appearing in
// ForceSendFields will be sent to the server regardless of whether the
// field is empty or not. This may be used to include empty fields in
// Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "AvailableCpuPlatforms") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}Zone: A Zone resource. (== resource_for beta.zones ==) (== resource_for v1.zones ==)
type ZoneList struct {
// Id: [Output Only] Unique identifier for the resource; defined by the
// server.
Id string `json:"id,omitempty"`
// Items: A list of Zone resources.
Items []*Zone `json:"items,omitempty"`
// Kind: Type of resource.
Kind string `json:"kind,omitempty"`
// NextPageToken: [Output Only] This token allows you to get the next
// page of results for list requests. If the number of results is larger
// than maxResults, use the nextPageToken as a value for the query
// parameter pageToken in the next list request. Subsequent list
// requests will have their own nextPageToken to continue paging through
// the results.
NextPageToken string `json:"nextPageToken,omitempty"`
// SelfLink: [Output Only] Server-defined URL for this resource.
SelfLink string `json:"selfLink,omitempty"`
// Warning: [Output Only] Informational warning message.
Warning *ZoneListWarning `json:"warning,omitempty"`
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi.ServerResponse `json:"-"`
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ZoneList: Contains a list of zone resources.
type ZoneListWarning struct {
// Code: [Output Only] A warning code, if applicable. For example,
// Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in
// the response.
//
// Possible values:
// "CLEANUP_FAILED"
// "DEPRECATED_RESOURCE_USED"
// "DEPRECATED_TYPE_USED"
// "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
// "EXPERIMENTAL_TYPE_USED"
// "EXTERNAL_API_WARNING"
// "FIELD_VALUE_OVERRIDEN"
// "INJECTED_KERNELS_DEPRECATED"
// "MISSING_TYPE_DEPENDENCY"
// "NEXT_HOP_ADDRESS_NOT_ASSIGNED"
// "NEXT_HOP_CANNOT_IP_FORWARD"
// "NEXT_HOP_INSTANCE_NOT_FOUND"
// "NEXT_HOP_INSTANCE_NOT_ON_NETWORK"
// "NEXT_HOP_NOT_RUNNING"
// "NOT_CRITICAL_ERROR"
// "NO_RESULTS_ON_PAGE"
// "REQUIRED_TOS_AGREEMENT"
// "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING"
// "RESOURCE_NOT_DELETED"
// "SCHEMA_VALIDATION_IGNORED"
// "SINGLE_INSTANCE_PROPERTY_TEMPLATE"
// "UNDECLARED_PROPERTIES"
// "UNREACHABLE"
Code string `json:"code,omitempty"`
// Data: [Output Only] Metadata about this warning in key: value format.
// For example:
// "data": [ { "key": "scope", "value": "zones/us-east1-d" }
Data []*ZoneListWarningData `json:"data,omitempty"`
// Message: [Output Only] A human-readable description of the warning
// code.
Message string `json:"message,omitempty"`
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}ZoneListWarning: [Output Only] Informational warning message.
func (s *ZoneListWarning) MarshalJSON() ([]byte, error)
type ZoneListWarningData struct {
// Key: [Output Only] A key that provides more detail on the warning
// being returned. For example, for warnings where there are no results
// in a list request for a particular zone, this key might be scope and
// the key value might be the zone name. Other examples might be a key
// indicating a deprecated resource and a suggested replacement, or a
// warning about invalid network settings (for example, if an instance
// attempts to perform IP forwarding but is not enabled for IP
// forwarding).
Key string `json:"key,omitempty"`
// Value: [Output Only] A warning data value corresponding to the key.
Value string `json:"value,omitempty"`
// ForceSendFields is a list of field names (e.g. "Key") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "Key") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields []string `json:"-"`
}func (s *ZoneListWarningData) MarshalJSON() ([]byte, error)
type ZoneOperationsDeleteCall struct {
// contains filtered or unexported fields
}func (c *ZoneOperationsDeleteCall) Context(ctx context.Context) *ZoneOperationsDeleteCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ZoneOperationsDeleteCall) Do(opts ...googleapi.CallOption) error
Do executes the "compute.zoneOperations.delete" call.
func (c *ZoneOperationsDeleteCall) Fields(s ...googleapi.Field) *ZoneOperationsDeleteCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ZoneOperationsDeleteCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
type ZoneOperationsGetCall struct {
// contains filtered or unexported fields
}func (c *ZoneOperationsGetCall) Context(ctx context.Context) *ZoneOperationsGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ZoneOperationsGetCall) Do(opts ...googleapi.CallOption) (*Operation, error)
Do executes the "compute.zoneOperations.get" call. Exactly one of *Operation or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Operation.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ZoneOperationsGetCall) Fields(s ...googleapi.Field) *ZoneOperationsGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ZoneOperationsGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ZoneOperationsGetCall) IfNoneMatch(entityTag string) *ZoneOperationsGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type ZoneOperationsListCall struct {
// contains filtered or unexported fields
}func (c *ZoneOperationsListCall) Context(ctx context.Context) *ZoneOperationsListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ZoneOperationsListCall) Do(opts ...googleapi.CallOption) (*OperationList, error)
Do executes the "compute.zoneOperations.list" call. Exactly one of *OperationList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *OperationList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ZoneOperationsListCall) Fields(s ...googleapi.Field) *ZoneOperationsListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ZoneOperationsListCall) Filter(filter string) *ZoneOperationsListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *ZoneOperationsListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ZoneOperationsListCall) IfNoneMatch(entityTag string) *ZoneOperationsListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *ZoneOperationsListCall) MaxResults(maxResults int64) *ZoneOperationsListCall
MaxResults sets the optional parameter "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)
func (c *ZoneOperationsListCall) OrderBy(orderBy string) *ZoneOperationsListCall
OrderBy sets the optional parameter "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.
func (c *ZoneOperationsListCall) PageToken(pageToken string) *ZoneOperationsListCall
PageToken sets the optional parameter "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.
func (c *ZoneOperationsListCall) Pages(ctx context.Context, f func(*OperationList) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type ZoneOperationsService struct {
// contains filtered or unexported fields
}func NewZoneOperationsService(s *Service) *ZoneOperationsService
func (r *ZoneOperationsService) Delete(project string, zone string, operation string) *ZoneOperationsDeleteCall
Delete: Deletes the specified zone-specific Operations resource. For details, see https://cloud.google.com/compute/docs/reference/latest/zoneOperations/delete
func (r *ZoneOperationsService) Get(project string, zone string, operation string) *ZoneOperationsGetCall
Get: Retrieves the specified zone-specific Operations resource. For details, see https://cloud.google.com/compute/docs/reference/latest/zoneOperations/get
func (r *ZoneOperationsService) List(project string, zone string) *ZoneOperationsListCall
List: Retrieves a list of Operation resources contained within the specified zone. For details, see https://cloud.google.com/compute/docs/reference/latest/zoneOperations/list
type ZoneSetLabelsRequest struct {
// LabelFingerprint: The fingerprint of the previous set of labels for
// this resource, used to detect conflicts. The fingerprint is initially
// generated by Compute Engine and changes after every request to modify
// or update labels. You must always provide an up-to-date fingerprint
// hash in order to update or change labels. Make a get() request to the
// resource to get the latest fingerprint.
LabelFingerprint string `json:"labelFingerprint,omitempty"`
// Labels: The labels to set for this resource.
Labels map[string]string `json:"labels,omitempty"`
// ForceSendFields is a list of field names (e.g. "LabelFingerprint") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields []string `json:"-"`
// NullFields is a list of field names (e.g. "LabelFingerprint") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields []string `json:"-"`
}func (s *ZoneSetLabelsRequest) MarshalJSON() ([]byte, error)
type ZonesGetCall struct {
// contains filtered or unexported fields
}func (c *ZonesGetCall) Context(ctx context.Context) *ZonesGetCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ZonesGetCall) Do(opts ...googleapi.CallOption) (*Zone, error)
Do executes the "compute.zones.get" call. Exactly one of *Zone or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *Zone.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ZonesGetCall) Fields(s ...googleapi.Field) *ZonesGetCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ZonesGetCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ZonesGetCall) IfNoneMatch(entityTag string) *ZonesGetCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type ZonesListCall struct {
// contains filtered or unexported fields
}func (c *ZonesListCall) Context(ctx context.Context) *ZonesListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (c *ZonesListCall) Do(opts ...googleapi.CallOption) (*ZoneList, error)
Do executes the "compute.zones.list" call. Exactly one of *ZoneList or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *ZoneList.ServerResponse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (c *ZonesListCall) Fields(s ...googleapi.Field) *ZonesListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (c *ZonesListCall) Filter(filter string) *ZonesListCall
Filter sets the optional parameter "filter": Sets a filter {expression} for filtering listed resources. Your {expression} must be in the format: field_name comparison_string literal_string.
The field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
For example, to filter for instances that do not have a name of example-instance, you would use name ne example-instance.
You can filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. Use filtering on nested fields to take advantage of labels to organize and search for results based on label values.
To filter on multiple expressions, provide each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.
func (c *ZonesListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (c *ZonesListCall) IfNoneMatch(entityTag string) *ZonesListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (c *ZonesListCall) MaxResults(maxResults int64) *ZonesListCall
MaxResults sets the optional parameter "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)
func (c *ZonesListCall) OrderBy(orderBy string) *ZonesListCall
OrderBy sets the optional parameter "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.
func (c *ZonesListCall) PageToken(pageToken string) *ZonesListCall
PageToken sets the optional parameter "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.
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type ZonesService struct {
// contains filtered or unexported fields
}func NewZonesService(s *Service) *ZonesService
func (r *ZonesService) Get(project string, zone string) *ZonesGetCall
Get: Returns the specified Zone resource. Get a list of available zones by making a list() request. For details, see https://cloud.google.com/compute/docs/reference/latest/zones/get
func (r *ZonesService) List(project string) *ZonesListCall
List: Retrieves the list of Zone resources available to the specified project. For details, see https://cloud.google.com/compute/docs/reference/latest/zones/list
Package compute imports 13 packages (graph) and is imported by 537 packages. Updated 2018-01-04. Refresh now. Tools for package owners.