Blame - docs/dyn/compute_v1.targetPools.html - platform/external/python/google-api-python-client

blob: 3feedb4e04c15fa9a63ebef246b4cf3710d1835f [file] [log] [blame]

John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	1	<html><body>
				2	<style>
				3
				4	body, h1, h2, h3, div, span, p, pre, a {
				5	margin: 0;
				6	padding: 0;
				7	border: 0;
				8	font-weight: inherit;
				9	font-style: inherit;
				10	font-size: 100%;
				11	font-family: inherit;
				12	vertical-align: baseline;
				13	}
				14
				15	body {
				16	font-size: 13px;
				17	padding: 1em;
				18	}
				19
				20	h1 {
				21	font-size: 26px;
				22	margin-bottom: 1em;
				23	}
				24
				25	h2 {
				26	font-size: 24px;
				27	margin-bottom: 1em;
				28	}
				29
				30	h3 {
				31	font-size: 20px;
				32	margin-bottom: 1em;
				33	margin-top: 1em;
				34	}
				35
				36	pre, code {
				37	line-height: 1.5;
				38	font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
				39	}
				40
				41	pre {
				42	margin-top: 0.5em;
				43	}
				44
				45	h1, h2, h3, p {
				46	font-family: Arial, sans serif;
				47	}
				48
				49	h1, h2, h3 {
				50	border-bottom: solid #CCC 1px;
				51	}
				52
				53	.toc_element {
				54	margin-top: 0.5em;
				55	}
				56
				57	.firstline {
				58	margin-left: 2 em;
				59	}
				60
				61	.method {
				62	margin-top: 1em;
				63	border: solid 1px #CCC;
				64	padding: 1em;
				65	background: #EEE;
				66	}
				67
				68	.details {
				69	font-weight: bold;
				70	font-size: 14px;
				71	}
				72
				73	</style>
				74
				75	<h1><a href="compute_v1.html">Compute Engine API</a> . <a href="compute_v1.targetPools.html">targetPools</a></h1>
				76	<h2>Instance Methods</h2>
				77	<p class="toc_element">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	78	<code><a href="#addHealthCheck">addHealthCheck(project, region, targetPool, body=None, requestId=None)</a></code></p>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	79	<p class="firstline">Adds health check URLs to a target pool.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	80	<p class="toc_element">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	81	<code><a href="#addInstance">addInstance(project, region, targetPool, body=None, requestId=None)</a></code></p>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	82	<p class="firstline">Adds an instance to a target pool.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	83	<p class="toc_element">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	84	<code><a href="#aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None)</a></code></p>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	85	<p class="firstline">Retrieves an aggregated list of target pools.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	86	<p class="toc_element">
				87	<code><a href="#aggregatedList_next">aggregatedList_next(previous_request, previous_response)</a></code></p>
				88	<p class="firstline">Retrieves the next page of results.</p>
				89	<p class="toc_element">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	90	<code><a href="#close">close()</a></code></p>
				91	<p class="firstline">Close httplib2 connections.</p>
				92	<p class="toc_element">
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	93	<code><a href="#delete">delete(project, region, targetPool, requestId=None)</a></code></p>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	94	<p class="firstline">Deletes the specified target pool.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	95	<p class="toc_element">
				96	<code><a href="#get">get(project, region, targetPool)</a></code></p>
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	97	<p class="firstline">Returns the specified target pool. Gets a list of available target pools by making a list() request.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	98	<p class="toc_element">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	99	<code><a href="#getHealth">getHealth(project, region, targetPool, body=None)</a></code></p>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	100	<p class="firstline">Gets the most recent health check results for each IP for the instance that is referenced by the given target pool.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	101	<p class="toc_element">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	102	<code><a href="#insert">insert(project, region, body=None, requestId=None)</a></code></p>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	103	<p class="firstline">Creates a target pool in the specified project and region using the data included in the request.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	104	<p class="toc_element">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	105	<code><a href="#list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None)</a></code></p>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	106	<p class="firstline">Retrieves a list of target pools available to the specified project and region.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	107	<p class="toc_element">
				108	<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
				109	<p class="firstline">Retrieves the next page of results.</p>
				110	<p class="toc_element">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	111	<code><a href="#removeHealthCheck">removeHealthCheck(project, region, targetPool, body=None, requestId=None)</a></code></p>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	112	<p class="firstline">Removes health check URL from a target pool.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	113	<p class="toc_element">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	114	<code><a href="#removeInstance">removeInstance(project, region, targetPool, body=None, requestId=None)</a></code></p>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	115	<p class="firstline">Removes instance URL from a target pool.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	116	<p class="toc_element">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	117	<code><a href="#setBackup">setBackup(project, region, targetPool, body=None, failoverRatio=None, requestId=None)</a></code></p>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	118	<p class="firstline">Changes a backup target pool's configurations.</p>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	119	<h3>Method Details</h3>
				120	<div class="method">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	121	<code class="details" id="addHealthCheck">addHealthCheck(project, region, targetPool, body=None, requestId=None)</code>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	122	<pre>Adds health check URLs to a target pool.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	123
				124	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	125	project: string, Project ID for this request. (required)
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	126	region: string, Name of the region scoping this request. (required)
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	127	targetPool: string, Name of the target pool to add a health check to. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	128	body: object, The request body.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	129	The object takes the form of:
				130
				131	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	132	"healthChecks": [ # The HttpHealthCheck to add to the target pool.
				133	{ # A full or valid partial URL to a health check. For example, the following are valid URLs:
				134	# - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check
				135	# - projects/project-id/global/httpHealthChecks/health-check
				136	# - global/httpHealthChecks/health-check
				137	"healthCheck": "A String",
				138	},
				139	],
				140	}
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	141
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	142	requestId: string, 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.
				143
				144	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.
				145
				146	The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	147
				148	Returns:
				149	An object of the form:
				150
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	151	{ # Represents an Operation resource.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	152	#
				153	# Google Compute Engine has three Operation resources:
				154	#
				155	# * [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) * [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) * [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations)
				156	#
				157	# You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses.
				158	#
				159	# Operations can be global, regional or zonal.
				160	# - For global operations, use the `globalOperations` resource.
				161	# - For regional operations, use the `regionOperations` resource.
				162	# - For zonal operations, use the `zonalOperations` resource.
				163	#
				164	# For more information, read Global, Regional, and Zonal Resources. (== resource_for {$api_version}.globalOperations ==) (== resource_for {$api_version}.regionOperations ==) (== resource_for {$api_version}.zoneOperations ==)
				165	"clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
				166	"creationTimestamp": "A String", # [Deprecated] This field is deprecated.
				167	"description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
				168	"endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
				169	"error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
				170	"errors": [ # [Output Only] The array of errors encountered while processing this operation.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	171	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	172	"code": "A String", # [Output Only] The error type identifier for this error.
				173	"location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
				174	"message": "A String", # [Output Only] An optional, human-readable error message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	175	},
				176	],
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	177	},
				178	"httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
				179	"httpErrorStatusCode": 42, # [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.
				180	"id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
				181	"insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
				182	"kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
				183	"name": "A String", # [Output Only] Name of the operation.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	184	"operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	185	"operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
				186	"progress": 42, # [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.
				187	"region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
				188	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				189	"startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
				190	"status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
				191	"statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
				192	"targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
				193	"targetLink": "A String", # [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.
				194	"user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com`.
				195	"warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
				196	{
				197	"code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
				198	"data": [ # [Output Only] Metadata about this warning in key: value format. For example:
				199	# "data": [ { "key": "scope", "value": "zones/us-east1-d" }
				200	{
				201	"key": "A String", # [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).
				202	"value": "A String", # [Output Only] A warning data value corresponding to the key.
				203	},
				204	],
				205	"message": "A String", # [Output Only] A human-readable description of the warning code.
				206	},
				207	],
				208	"zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
				209	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	210	</div>
				211
				212	<div class="method">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	213	<code class="details" id="addInstance">addInstance(project, region, targetPool, body=None, requestId=None)</code>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	214	<pre>Adds an instance to a target pool.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	215
				216	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	217	project: string, Project ID for this request. (required)
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	218	region: string, Name of the region scoping this request. (required)
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	219	targetPool: string, Name of the TargetPool resource to add instances to. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	220	body: object, The request body.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	221	The object takes the form of:
				222
				223	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	224	"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:
				225	# - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name
				226	# - projects/project-id/zones/zone/instances/instance-name
				227	# - zones/zone/instances/instance-name
				228	{
				229	"instance": "A String", # The URL for a specific instance.
				230	},
				231	],
				232	}
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	233
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	234	requestId: string, 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.
				235
				236	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.
				237
				238	The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	239
				240	Returns:
				241	An object of the form:
				242
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	243	{ # Represents an Operation resource.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	244	#
				245	# Google Compute Engine has three Operation resources:
				246	#
				247	# * [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) * [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) * [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations)
				248	#
				249	# You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses.
				250	#
				251	# Operations can be global, regional or zonal.
				252	# - For global operations, use the `globalOperations` resource.
				253	# - For regional operations, use the `regionOperations` resource.
				254	# - For zonal operations, use the `zonalOperations` resource.
				255	#
				256	# For more information, read Global, Regional, and Zonal Resources. (== resource_for {$api_version}.globalOperations ==) (== resource_for {$api_version}.regionOperations ==) (== resource_for {$api_version}.zoneOperations ==)
				257	"clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
				258	"creationTimestamp": "A String", # [Deprecated] This field is deprecated.
				259	"description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
				260	"endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
				261	"error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
				262	"errors": [ # [Output Only] The array of errors encountered while processing this operation.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	263	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	264	"code": "A String", # [Output Only] The error type identifier for this error.
				265	"location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
				266	"message": "A String", # [Output Only] An optional, human-readable error message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	267	},
				268	],
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	269	},
				270	"httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
				271	"httpErrorStatusCode": 42, # [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.
				272	"id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
				273	"insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
				274	"kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
				275	"name": "A String", # [Output Only] Name of the operation.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	276	"operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	277	"operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
				278	"progress": 42, # [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.
				279	"region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
				280	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				281	"startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
				282	"status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
				283	"statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
				284	"targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
				285	"targetLink": "A String", # [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.
				286	"user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com`.
				287	"warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
				288	{
				289	"code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
				290	"data": [ # [Output Only] Metadata about this warning in key: value format. For example:
				291	# "data": [ { "key": "scope", "value": "zones/us-east1-d" }
				292	{
				293	"key": "A String", # [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).
				294	"value": "A String", # [Output Only] A warning data value corresponding to the key.
				295	},
				296	],
				297	"message": "A String", # [Output Only] A human-readable description of the warning code.
				298	},
				299	],
				300	"zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
				301	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	302	</div>
				303
				304	<div class="method">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	305	<code class="details" id="aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None)</code>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	306	<pre>Retrieves an aggregated list of target pools.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	307
				308	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	309	project: string, Project ID for this request. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	310	filter: string, A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
Takashi Matsuo	0669410	2015-09-11 13:55:40 -0700	[diff] [blame]	311
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	312	For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.
Takashi Matsuo	0669410	2015-09-11 13:55:40 -0700	[diff] [blame]	313
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	314	You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	315
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	316	To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	317	includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	318	maxResults: integer, 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`)
				319	orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
				320
				321	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.
				322
				323	Currently, only sorting by `name` or `creationTimestamp desc` is supported.
				324	pageToken: string, Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	325	returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	326
				327	Returns:
				328	An object of the form:
				329
				330	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	331	"id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
				332	"items": { # A list of TargetPool resources.
				333	"a_key": { # Name of the scope containing this set of target pools.
				334	"targetPools": [ # A list of target pools contained in this scope.
				335	{ # Represents a Target Pool resource.
				336	#
				337	# Target pools are used for network TCP/UDP load balancing. A target pool references member instances, an associated legacy HttpHealthCheck resource, and, optionally, a backup target pool. For more information, read Using target pools. (== resource_for {$api_version}.targetPools ==)
				338	"backupPool": "A String", # The server-defined URL for the resource. 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].
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	339	#
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	340	# 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.
				341	#
				342	# 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.
				343	"creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
				344	"description": "A String", # An optional description of this resource. Provide this property when you create the resource.
				345	"failoverRatio": 3.14, # 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].
				346	#
				347	# 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.
				348	#
				349	# 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.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	350	"healthChecks": [ # The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. Only legacy HttpHealthChecks are supported. Only one health check may be specified.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	351	"A String",
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	352	],
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	353	"id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
				354	"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.
				355	"A String",
				356	],
				357	"kind": "compute#targetPool", # [Output Only] Type of the resource. Always compute#targetPool for target pools.
				358	"name": "A String", # 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.
				359	"region": "A String", # [Output Only] URL of the region where the target pool resides.
				360	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				361	"sessionAffinity": "A String", # Session affinity option, must be one of the following values:
				362	# NONE: Connections from the same client IP may go to any instance in the pool.
				363	# CLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy.
				364	# 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.
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	365	},
				366	],
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	367	"warning": { # Informational warning which replaces the list of addresses when the list is empty.
				368	"code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
				369	"data": [ # [Output Only] Metadata about this warning in key: value format. For example:
				370	# "data": [ { "key": "scope", "value": "zones/us-east1-d" }
				371	{
				372	"key": "A String", # [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).
				373	"value": "A String", # [Output Only] A warning data value corresponding to the key.
				374	},
				375	],
				376	"message": "A String", # [Output Only] A human-readable description of the warning code.
				377	},
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	378	},
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	379	},
				380	"kind": "compute#targetPoolAggregatedList", # [Output Only] Type of resource. Always compute#targetPoolAggregatedList for aggregated lists of target pools.
				381	"nextPageToken": "A String", # [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.
				382	"selfLink": "A String", # [Output Only] Server-defined URL for this resource.
				383	"unreachables": [ # [Output Only] Unreachable resources.
				384	"A String",
				385	],
				386	"warning": { # [Output Only] Informational warning message.
				387	"code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
				388	"data": [ # [Output Only] Metadata about this warning in key: value format. For example:
				389	# "data": [ { "key": "scope", "value": "zones/us-east1-d" }
				390	{
				391	"key": "A String", # [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).
				392	"value": "A String", # [Output Only] A warning data value corresponding to the key.
				393	},
				394	],
				395	"message": "A String", # [Output Only] A human-readable description of the warning code.
				396	},
				397	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	398	</div>
				399
				400	<div class="method">
				401	<code class="details" id="aggregatedList_next">aggregatedList_next(previous_request, previous_response)</code>
				402	<pre>Retrieves the next page of results.
				403
				404	Args:
				405	previous_request: The request for the previous page. (required)
				406	previous_response: The response from the request for the previous page. (required)
				407
				408	Returns:
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	409	A request object that you can call 'execute()' on to request the next
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	410	page. Returns None if there are no more items in the collection.
				411	</pre>
				412	</div>
				413
				414	<div class="method">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	415	<code class="details" id="close">close()</code>
				416	<pre>Close httplib2 connections.</pre>
				417	</div>
				418
				419	<div class="method">
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	420	<code class="details" id="delete">delete(project, region, targetPool, requestId=None)</code>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	421	<pre>Deletes the specified target pool.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	422
				423	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	424	project: string, Project ID for this request. (required)
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	425	region: string, Name of the region scoping this request. (required)
				426	targetPool: string, Name of the TargetPool resource to delete. (required)
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	427	requestId: string, 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.
				428
				429	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.
				430
				431	The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	432
				433	Returns:
				434	An object of the form:
				435
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	436	{ # Represents an Operation resource.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	437	#
				438	# Google Compute Engine has three Operation resources:
				439	#
				440	# * [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) * [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) * [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations)
				441	#
				442	# You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses.
				443	#
				444	# Operations can be global, regional or zonal.
				445	# - For global operations, use the `globalOperations` resource.
				446	# - For regional operations, use the `regionOperations` resource.
				447	# - For zonal operations, use the `zonalOperations` resource.
				448	#
				449	# For more information, read Global, Regional, and Zonal Resources. (== resource_for {$api_version}.globalOperations ==) (== resource_for {$api_version}.regionOperations ==) (== resource_for {$api_version}.zoneOperations ==)
				450	"clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
				451	"creationTimestamp": "A String", # [Deprecated] This field is deprecated.
				452	"description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
				453	"endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
				454	"error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
				455	"errors": [ # [Output Only] The array of errors encountered while processing this operation.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	456	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	457	"code": "A String", # [Output Only] The error type identifier for this error.
				458	"location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
				459	"message": "A String", # [Output Only] An optional, human-readable error message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	460	},
				461	],
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	462	},
				463	"httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
				464	"httpErrorStatusCode": 42, # [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.
				465	"id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
				466	"insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
				467	"kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
				468	"name": "A String", # [Output Only] Name of the operation.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	469	"operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	470	"operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
				471	"progress": 42, # [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.
				472	"region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
				473	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				474	"startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
				475	"status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
				476	"statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
				477	"targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
				478	"targetLink": "A String", # [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.
				479	"user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com`.
				480	"warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
				481	{
				482	"code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
				483	"data": [ # [Output Only] Metadata about this warning in key: value format. For example:
				484	# "data": [ { "key": "scope", "value": "zones/us-east1-d" }
				485	{
				486	"key": "A String", # [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).
				487	"value": "A String", # [Output Only] A warning data value corresponding to the key.
				488	},
				489	],
				490	"message": "A String", # [Output Only] A human-readable description of the warning code.
				491	},
				492	],
				493	"zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
				494	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	495	</div>
				496
				497	<div class="method">
				498	<code class="details" id="get">get(project, region, targetPool)</code>
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	499	<pre>Returns the specified target pool. Gets a list of available target pools by making a list() request.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	500
				501	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	502	project: string, Project ID for this request. (required)
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	503	region: string, Name of the region scoping this request. (required)
				504	targetPool: string, Name of the TargetPool resource to return. (required)
				505
				506	Returns:
				507	An object of the form:
				508
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	509	{ # Represents a Target Pool resource.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	510	#
				511	# Target pools are used for network TCP/UDP load balancing. A target pool references member instances, an associated legacy HttpHealthCheck resource, and, optionally, a backup target pool. For more information, read Using target pools. (== resource_for {$api_version}.targetPools ==)
				512	"backupPool": "A String", # The server-defined URL for the resource. 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].
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	513	#
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	514	# 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.
				515	#
				516	# 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.
				517	"creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
				518	"description": "A String", # An optional description of this resource. Provide this property when you create the resource.
				519	"failoverRatio": 3.14, # 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].
				520	#
				521	# 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.
				522	#
				523	# 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.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	524	"healthChecks": [ # The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. Only legacy HttpHealthChecks are supported. Only one health check may be specified.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	525	"A String",
				526	],
				527	"id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
				528	"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.
				529	"A String",
				530	],
				531	"kind": "compute#targetPool", # [Output Only] Type of the resource. Always compute#targetPool for target pools.
				532	"name": "A String", # 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.
				533	"region": "A String", # [Output Only] URL of the region where the target pool resides.
				534	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				535	"sessionAffinity": "A String", # Session affinity option, must be one of the following values:
				536	# NONE: Connections from the same client IP may go to any instance in the pool.
				537	# CLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy.
				538	# 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.
				539	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	540	</div>
				541
				542	<div class="method">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	543	<code class="details" id="getHealth">getHealth(project, region, targetPool, body=None)</code>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	544	<pre>Gets the most recent health check results for each IP for the instance that is referenced by the given target pool.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	545
				546	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	547	project: string, Project ID for this request. (required)
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	548	region: string, Name of the region scoping this request. (required)
				549	targetPool: string, Name of the TargetPool resource to which the queried instance belongs. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	550	body: object, The request body.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	551	The object takes the form of:
				552
				553	{
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	554	"instance": "A String", # The URL for a specific instance.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	555	}
				556
				557
				558	Returns:
				559	An object of the form:
				560
				561	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	562	"healthStatus": [
				563	{
				564	"annotations": { # Metadata defined as annotations for network endpoint.
				565	"a_key": "A String",
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	566	},
Anthonios Partheniou	10f4b67	2021-04-13 14:47:53 -0400	[diff] [blame^]	567	"forwardingRule": "A String", # URL of the forwarding rule associated with the health status of the instance.
				568	"forwardingRuleIp": "A String", # A forwarding rule IP address assigned to this instance.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	569	"healthState": "A String", # Health state of the instance.
				570	"instance": "A String", # URL of the instance resource.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	571	"ipAddress": "A String", # For target pool based Network Load Balancing, it indicates the forwarding rule's IP address assigned to this instance. For other types of load balancing, the field indicates VM internal ip.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	572	"port": 42, # The named port of the instance group, not necessarily the port that is health-checked.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	573	"weight": "A String",
				574	"weightError": "A String",
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	575	},
				576	],
				577	"kind": "compute#targetPoolInstanceHealth", # [Output Only] Type of resource. Always compute#targetPoolInstanceHealth when checking the health of an instance.
				578	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	579	</div>
				580
				581	<div class="method">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	582	<code class="details" id="insert">insert(project, region, body=None, requestId=None)</code>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	583	<pre>Creates a target pool in the specified project and region using the data included in the request.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	584
				585	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	586	project: string, Project ID for this request. (required)
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	587	region: string, Name of the region scoping this request. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	588	body: object, The request body.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	589	The object takes the form of:
				590
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	591	{ # Represents a Target Pool resource.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	592	#
				593	# Target pools are used for network TCP/UDP load balancing. A target pool references member instances, an associated legacy HttpHealthCheck resource, and, optionally, a backup target pool. For more information, read Using target pools. (== resource_for {$api_version}.targetPools ==)
Bu Sun Kim	673ec5c	2020-11-16 11:05:03 -0700	[diff] [blame]	594	"backupPool": "A String", # The server-defined URL for the resource. 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].
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	595	#
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	596	# 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.
				597	#
				598	# 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.
				599	"creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
				600	"description": "A String", # An optional description of this resource. Provide this property when you create the resource.
				601	"failoverRatio": 3.14, # 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].
				602	#
				603	# 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.
				604	#
				605	# 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.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	606	"healthChecks": [ # The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. Only legacy HttpHealthChecks are supported. Only one health check may be specified.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	607	"A String",
				608	],
				609	"id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
				610	"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.
				611	"A String",
				612	],
				613	"kind": "compute#targetPool", # [Output Only] Type of the resource. Always compute#targetPool for target pools.
				614	"name": "A String", # 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.
				615	"region": "A String", # [Output Only] URL of the region where the target pool resides.
				616	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				617	"sessionAffinity": "A String", # Session affinity option, must be one of the following values:
				618	# NONE: Connections from the same client IP may go to any instance in the pool.
				619	# CLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy.
				620	# 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.
				621	}
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	622
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	623	requestId: string, 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.
				624
				625	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.
				626
				627	The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	628
				629	Returns:
				630	An object of the form:
				631
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	632	{ # Represents an Operation resource.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	633	#
				634	# Google Compute Engine has three Operation resources:
				635	#
				636	# * [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) * [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) * [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations)
				637	#
				638	# You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses.
				639	#
				640	# Operations can be global, regional or zonal.
				641	# - For global operations, use the `globalOperations` resource.
				642	# - For regional operations, use the `regionOperations` resource.
				643	# - For zonal operations, use the `zonalOperations` resource.
				644	#
				645	# For more information, read Global, Regional, and Zonal Resources. (== resource_for {$api_version}.globalOperations ==) (== resource_for {$api_version}.regionOperations ==) (== resource_for {$api_version}.zoneOperations ==)
				646	"clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
				647	"creationTimestamp": "A String", # [Deprecated] This field is deprecated.
				648	"description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
				649	"endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
				650	"error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
				651	"errors": [ # [Output Only] The array of errors encountered while processing this operation.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	652	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	653	"code": "A String", # [Output Only] The error type identifier for this error.
				654	"location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
				655	"message": "A String", # [Output Only] An optional, human-readable error message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	656	},
				657	],
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	658	},
				659	"httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
				660	"httpErrorStatusCode": 42, # [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.
				661	"id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
				662	"insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
				663	"kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
				664	"name": "A String", # [Output Only] Name of the operation.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	665	"operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	666	"operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
				667	"progress": 42, # [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.
				668	"region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
				669	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				670	"startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
				671	"status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
				672	"statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
				673	"targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
				674	"targetLink": "A String", # [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.
				675	"user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com`.
				676	"warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
				677	{
				678	"code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
				679	"data": [ # [Output Only] Metadata about this warning in key: value format. For example:
				680	# "data": [ { "key": "scope", "value": "zones/us-east1-d" }
				681	{
				682	"key": "A String", # [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).
				683	"value": "A String", # [Output Only] A warning data value corresponding to the key.
				684	},
				685	],
				686	"message": "A String", # [Output Only] A human-readable description of the warning code.
				687	},
				688	],
				689	"zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
				690	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	691	</div>
				692
				693	<div class="method">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame]	694	<code class="details" id="list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None)</code>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	695	<pre>Retrieves a list of target pools available to the specified project and region.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	696
				697	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	698	project: string, Project ID for this request. (required)
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	699	region: string, Name of the region scoping this request. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	700	filter: string, A filter expression that filters resources listed in the response. The expression must specify the field name, a comparison operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
Takashi Matsuo	0669410	2015-09-11 13:55:40 -0700	[diff] [blame]	701
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	702	For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`.
Takashi Matsuo	0669410	2015-09-11 13:55:40 -0700	[diff] [blame]	703
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	704	You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels.
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	705
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	706	To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.automaticRestart = true) ```
				707	maxResults: integer, 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`)
				708	orderBy: string, Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name.
				709
				710	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.
				711
				712	Currently, only sorting by `name` or `creationTimestamp desc` is supported.
				713	pageToken: string, Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	714	returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case of failure. The default value is false.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	715
				716	Returns:
				717	An object of the form:
				718
				719	{ # Contains a list of TargetPool resources.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	720	"id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
				721	"items": [ # A list of TargetPool resources.
				722	{ # Represents a Target Pool resource.
				723	#
				724	# Target pools are used for network TCP/UDP load balancing. A target pool references member instances, an associated legacy HttpHealthCheck resource, and, optionally, a backup target pool. For more information, read Using target pools. (== resource_for {$api_version}.targetPools ==)
				725	"backupPool": "A String", # The server-defined URL for the resource. 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].
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	726	#
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	727	# 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.
				728	#
				729	# 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.
				730	"creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
				731	"description": "A String", # An optional description of this resource. Provide this property when you create the resource.
				732	"failoverRatio": 3.14, # 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].
				733	#
				734	# 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.
				735	#
				736	# 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.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	737	"healthChecks": [ # The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. Only legacy HttpHealthChecks are supported. Only one health check may be specified.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	738	"A String",
				739	],
				740	"id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
				741	"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.
				742	"A String",
				743	],
				744	"kind": "compute#targetPool", # [Output Only] Type of the resource. Always compute#targetPool for target pools.
				745	"name": "A String", # 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.
				746	"region": "A String", # [Output Only] URL of the region where the target pool resides.
				747	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				748	"sessionAffinity": "A String", # Session affinity option, must be one of the following values:
				749	# NONE: Connections from the same client IP may go to any instance in the pool.
				750	# CLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy.
				751	# 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.
				752	},
				753	],
				754	"kind": "compute#targetPoolList", # [Output Only] Type of resource. Always compute#targetPoolList for lists of target pools.
				755	"nextPageToken": "A String", # [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.
				756	"selfLink": "A String", # [Output Only] Server-defined URL for this resource.
				757	"warning": { # [Output Only] Informational warning message.
				758	"code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
				759	"data": [ # [Output Only] Metadata about this warning in key: value format. For example:
				760	# "data": [ { "key": "scope", "value": "zones/us-east1-d" }
				761	{
				762	"key": "A String", # [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).
				763	"value": "A String", # [Output Only] A warning data value corresponding to the key.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	764	},
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	765	],
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	766	"message": "A String", # [Output Only] A human-readable description of the warning code.
				767	},
				768	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	769	</div>
				770
				771	<div class="method">
				772	<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
				773	<pre>Retrieves the next page of results.
				774
				775	Args:
				776	previous_request: The request for the previous page. (required)
				777	previous_response: The response from the request for the previous page. (required)
				778
				779	Returns:
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	780	A request object that you can call 'execute()' on to request the next
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	781	page. Returns None if there are no more items in the collection.
				782	</pre>
				783	</div>
				784
				785	<div class="method">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	786	<code class="details" id="removeHealthCheck">removeHealthCheck(project, region, targetPool, body=None, requestId=None)</code>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	787	<pre>Removes health check URL from a target pool.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	788
				789	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	790	project: string, Project ID for this request. (required)
				791	region: string, Name of the region for this request. (required)
				792	targetPool: string, Name of the target pool to remove health checks from. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	793	body: object, The request body.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	794	The object takes the form of:
				795
				796	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	797	"healthChecks": [ # Health check URL to be removed. This can be a full or valid partial URL. For example, the following are valid URLs:
				798	# - https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check
				799	# - projects/project/global/httpHealthChecks/health-check
				800	# - global/httpHealthChecks/health-check
				801	{ # A full or valid partial URL to a health check. For example, the following are valid URLs:
				802	# - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check
				803	# - projects/project-id/global/httpHealthChecks/health-check
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	804	# - global/httpHealthChecks/health-check
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	805	"healthCheck": "A String",
				806	},
				807	],
				808	}
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	809
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	810	requestId: string, 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.
				811
				812	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.
				813
				814	The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	815
				816	Returns:
				817	An object of the form:
				818
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	819	{ # Represents an Operation resource.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	820	#
				821	# Google Compute Engine has three Operation resources:
				822	#
				823	# * [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) * [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) * [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations)
				824	#
				825	# You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses.
				826	#
				827	# Operations can be global, regional or zonal.
				828	# - For global operations, use the `globalOperations` resource.
				829	# - For regional operations, use the `regionOperations` resource.
				830	# - For zonal operations, use the `zonalOperations` resource.
				831	#
				832	# For more information, read Global, Regional, and Zonal Resources. (== resource_for {$api_version}.globalOperations ==) (== resource_for {$api_version}.regionOperations ==) (== resource_for {$api_version}.zoneOperations ==)
				833	"clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
				834	"creationTimestamp": "A String", # [Deprecated] This field is deprecated.
				835	"description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
				836	"endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
				837	"error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
				838	"errors": [ # [Output Only] The array of errors encountered while processing this operation.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	839	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	840	"code": "A String", # [Output Only] The error type identifier for this error.
				841	"location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
				842	"message": "A String", # [Output Only] An optional, human-readable error message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	843	},
				844	],
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	845	},
				846	"httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
				847	"httpErrorStatusCode": 42, # [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.
				848	"id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
				849	"insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
				850	"kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
				851	"name": "A String", # [Output Only] Name of the operation.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	852	"operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	853	"operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
				854	"progress": 42, # [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.
				855	"region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
				856	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				857	"startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
				858	"status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
				859	"statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
				860	"targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
				861	"targetLink": "A String", # [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.
				862	"user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com`.
				863	"warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
				864	{
				865	"code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
				866	"data": [ # [Output Only] Metadata about this warning in key: value format. For example:
				867	# "data": [ { "key": "scope", "value": "zones/us-east1-d" }
				868	{
				869	"key": "A String", # [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).
				870	"value": "A String", # [Output Only] A warning data value corresponding to the key.
				871	},
				872	],
				873	"message": "A String", # [Output Only] A human-readable description of the warning code.
				874	},
				875	],
				876	"zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
				877	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	878	</div>
				879
				880	<div class="method">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	881	<code class="details" id="removeInstance">removeInstance(project, region, targetPool, body=None, requestId=None)</code>
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	882	<pre>Removes instance URL from a target pool.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	883
				884	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	885	project: string, Project ID for this request. (required)
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	886	region: string, Name of the region scoping this request. (required)
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	887	targetPool: string, Name of the TargetPool resource to remove instances from. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	888	body: object, The request body.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	889	The object takes the form of:
				890
				891	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	892	"instances": [ # URLs of the instances to be removed from target pool.
				893	{
				894	"instance": "A String", # The URL for a specific instance.
				895	},
				896	],
				897	}
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	898
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	899	requestId: string, 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.
				900
				901	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.
				902
				903	The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	904
				905	Returns:
				906	An object of the form:
				907
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	908	{ # Represents an Operation resource.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	909	#
				910	# Google Compute Engine has three Operation resources:
				911	#
				912	# * [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) * [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) * [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations)
				913	#
				914	# You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses.
				915	#
				916	# Operations can be global, regional or zonal.
				917	# - For global operations, use the `globalOperations` resource.
				918	# - For regional operations, use the `regionOperations` resource.
				919	# - For zonal operations, use the `zonalOperations` resource.
				920	#
				921	# For more information, read Global, Regional, and Zonal Resources. (== resource_for {$api_version}.globalOperations ==) (== resource_for {$api_version}.regionOperations ==) (== resource_for {$api_version}.zoneOperations ==)
				922	"clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
				923	"creationTimestamp": "A String", # [Deprecated] This field is deprecated.
				924	"description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
				925	"endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
				926	"error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
				927	"errors": [ # [Output Only] The array of errors encountered while processing this operation.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	928	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	929	"code": "A String", # [Output Only] The error type identifier for this error.
				930	"location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
				931	"message": "A String", # [Output Only] An optional, human-readable error message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	932	},
				933	],
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	934	},
				935	"httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
				936	"httpErrorStatusCode": 42, # [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.
				937	"id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
				938	"insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
				939	"kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
				940	"name": "A String", # [Output Only] Name of the operation.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	941	"operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	942	"operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
				943	"progress": 42, # [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.
				944	"region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
				945	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				946	"startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
				947	"status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
				948	"statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
				949	"targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
				950	"targetLink": "A String", # [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.
				951	"user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com`.
				952	"warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
				953	{
				954	"code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
				955	"data": [ # [Output Only] Metadata about this warning in key: value format. For example:
				956	# "data": [ { "key": "scope", "value": "zones/us-east1-d" }
				957	{
				958	"key": "A String", # [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).
				959	"value": "A String", # [Output Only] A warning data value corresponding to the key.
				960	},
				961	],
				962	"message": "A String", # [Output Only] A human-readable description of the warning code.
				963	},
				964	],
				965	"zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
				966	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	967	</div>
				968
				969	<div class="method">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	970	<code class="details" id="setBackup">setBackup(project, region, targetPool, body=None, failoverRatio=None, requestId=None)</code>
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	971	<pre>Changes a backup target pool's configurations.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	972
				973	Args:
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	974	project: string, Project ID for this request. (required)
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	975	region: string, Name of the region scoping this request. (required)
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	976	targetPool: string, Name of the TargetPool resource to set a backup pool for. (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	977	body: object, The request body.
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	978	The object takes the form of:
				979
				980	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	981	"target": "A String",
				982	}
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	983
Jon Wayne Parrott	36e41bc	2016-02-19 16:02:29 -0800	[diff] [blame]	984	failoverRatio: number, New failoverRatio value for the target pool.
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	985	requestId: string, 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.
				986
				987	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.
				988
				989	The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	990
				991	Returns:
				992	An object of the form:
				993
Bu Sun Kim	715bd7f	2019-06-14 16:50:42 -0700	[diff] [blame]	994	{ # Represents an Operation resource.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	995	#
				996	# Google Compute Engine has three Operation resources:
				997	#
				998	# * [Global](/compute/docs/reference/rest/{$api_version}/globalOperations) * [Regional](/compute/docs/reference/rest/{$api_version}/regionOperations) * [Zonal](/compute/docs/reference/rest/{$api_version}/zoneOperations)
				999	#
				1000	# You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses.
				1001	#
				1002	# Operations can be global, regional or zonal.
				1003	# - For global operations, use the `globalOperations` resource.
				1004	# - For regional operations, use the `regionOperations` resource.
				1005	# - For zonal operations, use the `zonalOperations` resource.
				1006	#
				1007	# For more information, read Global, Regional, and Zonal Resources. (== resource_for {$api_version}.globalOperations ==) (== resource_for {$api_version}.regionOperations ==) (== resource_for {$api_version}.zoneOperations ==)
				1008	"clientOperationId": "A String", # [Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.
				1009	"creationTimestamp": "A String", # [Deprecated] This field is deprecated.
				1010	"description": "A String", # [Output Only] A textual description of the operation, which is set when the operation is created.
				1011	"endTime": "A String", # [Output Only] The time that this operation was completed. This value is in RFC3339 text format.
				1012	"error": { # [Output Only] If errors are generated during processing of the operation, this field will be populated.
				1013	"errors": [ # [Output Only] The array of errors encountered while processing this operation.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	1014	{
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	1015	"code": "A String", # [Output Only] The error type identifier for this error.
				1016	"location": "A String", # [Output Only] Indicates the field in the request that caused the error. This property is optional.
				1017	"message": "A String", # [Output Only] An optional, human-readable error message.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	1018	},
				1019	],
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	1020	},
				1021	"httpErrorMessage": "A String", # [Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.
				1022	"httpErrorStatusCode": 42, # [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.
				1023	"id": "A String", # [Output Only] The unique identifier for the operation. This identifier is defined by the server.
				1024	"insertTime": "A String", # [Output Only] The time that this operation was requested. This value is in RFC3339 text format.
				1025	"kind": "compute#operation", # [Output Only] Type of the resource. Always `compute#operation` for Operation resources.
				1026	"name": "A String", # [Output Only] Name of the operation.
yoshi-code-bot	b6dc1b9	2021-03-02 11:49:08 -0800	[diff] [blame]	1027	"operationGroupId": "A String", # [Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.
Yoshi Automation Bot	cc94ec8	2021-01-15 07:10:04 -0800	[diff] [blame]	1028	"operationType": "A String", # [Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.
				1029	"progress": 42, # [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.
				1030	"region": "A String", # [Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.
				1031	"selfLink": "A String", # [Output Only] Server-defined URL for the resource.
				1032	"startTime": "A String", # [Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.
				1033	"status": "A String", # [Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.
				1034	"statusMessage": "A String", # [Output Only] An optional textual description of the current status of the operation.
				1035	"targetId": "A String", # [Output Only] The unique target ID, which identifies a specific incarnation of the target resource.
				1036	"targetLink": "A String", # [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.
				1037	"user": "A String", # [Output Only] User who requested the operation, for example: `user@example.com`.
				1038	"warnings": [ # [Output Only] If warning messages are generated during processing of the operation, this field will be populated.
				1039	{
				1040	"code": "A String", # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
				1041	"data": [ # [Output Only] Metadata about this warning in key: value format. For example:
				1042	# "data": [ { "key": "scope", "value": "zones/us-east1-d" }
				1043	{
				1044	"key": "A String", # [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).
				1045	"value": "A String", # [Output Only] A warning data value corresponding to the key.
				1046	},
				1047	],
				1048	"message": "A String", # [Output Only] A human-readable description of the warning code.
				1049	},
				1050	],
				1051	"zone": "A String", # [Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.
				1052	}</pre>
John Asmuth	614db98	2014-04-24 15:46:26 -0400	[diff] [blame]	1053	</div>
				1054
				1055	</body></html>