Update docs for 1.4.2 release
diff --git a/docs/dyn/compute_v1.snapshots.html b/docs/dyn/compute_v1.snapshots.html
index b8bd840..12834f2 100644
--- a/docs/dyn/compute_v1.snapshots.html
+++ b/docs/dyn/compute_v1.snapshots.html
@@ -76,31 +76,33 @@
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#delete">delete(project, snapshot)</a></code></p>
-<p class="firstline">Deletes the specified persistent disk snapshot resource.</p>
+<p class="firstline">Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot.</p>
<p class="toc_element">
<code><a href="#get">get(project, snapshot)</a></code></p>
-<p class="firstline">Returns the specified persistent disk snapshot resource.</p>
+<p class="firstline">Returns the specified Snapshot resource.</p>
<p class="toc_element">
<code><a href="#list">list(project, maxResults=None, pageToken=None, filter=None)</a></code></p>
-<p class="firstline">Retrieves the list of persistent disk snapshot resources contained within the specified project.</p>
+<p class="firstline">Retrieves the list of Snapshot resources contained within the specified project.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="delete">delete(project, snapshot)</code>
- <pre>Deletes the specified persistent disk snapshot resource.
+ <pre>Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot.
+
+For more information, see Deleting snaphots.
Args:
project: string, Name of the project scoping this request. (required)
- snapshot: string, Name of the persistent disk snapshot resource to delete. (required)
+ snapshot: string, Name of the Snapshot resource to delete. (required)
Returns:
An object of the form:
- { # An operation resource, used to manage asynchronous API requests.
+ { # An Operation resource, used to manage asynchronous API requests.
"targetId": "A String", # [Output Only] Unique target ID which identifies a particular incarnation of the target.
- "clientOperationId": "A String", # [Output Only] An optional identifier specified by the client when the mutation was initiated. Must be unique for all operation resources in the project.
+ "clientOperationId": "A String", # [Output Only] An optional identifier specified by the client when the mutation was initiated. Must be unique for all Operation resources in the project.
"creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
"id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
"zone": "A String", # [Output Only] URL of the zone where the operation resides.
@@ -138,78 +140,82 @@
],
},
"endTime": "A String", # [Output Only] The time that this operation was completed. This is in RFC3339 text format.
- "selfLink": "A String", # [Output Only] Server defined URL for the resource.
+ "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
"targetLink": "A String", # [Output Only] URL of the resource the operation is mutating.
}</pre>
</div>
<div class="method">
<code class="details" id="get">get(project, snapshot)</code>
- <pre>Returns the specified persistent disk snapshot resource.
+ <pre>Returns the specified Snapshot resource.
Args:
project: string, Name of the project scoping this request. (required)
- snapshot: string, Name of the persistent disk snapshot resource to return. (required)
+ snapshot: string, Name of the Snapshot resource to return. (required)
Returns:
An object of the form:
{ # A persistent disk snapshot resource.
- "status": "A String", # The status of the persistent disk snapshot (output only).
- "kind": "compute#snapshot", # Type of the resource.
- "storageBytes": "A String", # A size of the the storage used by the snapshot. As snapshots share storage this number is expected to change with snapshot creation/deletion.
+ "status": "A String", # [Output Only] The status of the snapshot.
+ "kind": "compute#snapshot", # [Output Only] Type of the resource. Always compute#snapshot for Snapshot resources.
+ "storageBytes": "A String", # [Output Only] A size of the the storage used by the snapshot. As snapshots share storage, this number is expected to change with snapshot creation/deletion.
"description": "A String", # An optional textual description of the resource; provided by the client when the resource is created.
"sourceDisk": "A String", # The source disk used to create this snapshot.
- "storageBytesStatus": "A String", # An indicator whether storageBytes is in a stable state, or it is being adjusted as a result of shared storage reallocation.
- "sourceDiskId": "A String", # The 'id' value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name.
- "diskSizeGb": "A String", # Size of the persistent disk snapshot, specified in GB (output only).
+ "storageBytesStatus": "A String", # [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation.
+ "sourceDiskId": "A String", # [Output Only] The ID value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name.
+ "diskSizeGb": "A String", # [Output Only] Size of the snapshot, specified in GB.
"licenses": [ # Public visible licenses.
"A String",
],
- "creationTimestamp": "A String", # Creation timestamp in RFC3339 text format (output only).
- "id": "A String", # Unique identifier for the resource; defined by the server (output only).
- "selfLink": "A String", # Server defined URL for the resource (output only).
- "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.
+ "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+ "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+ "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+ "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.
}</pre>
</div>
<div class="method">
<code class="details" id="list">list(project, maxResults=None, pageToken=None, filter=None)</code>
- <pre>Retrieves the list of persistent disk snapshot resources contained within the specified project.
+ <pre>Retrieves the list of Snapshot resources contained within the specified project.
Args:
project: string, Name of the project scoping this request. (required)
maxResults: integer, Maximum count of results to be returned.
- pageToken: string, Tag returned by a previous list request when that list was truncated to maxResults. Used to continue a previous list request.
- filter: string, Filter expression for filtering listed resources.
+ pageToken: string, Specifies a page token to use. Use this parameter if you want to list the next page of results. Set pageToken to the nextPageToken returned by a previous list request.
+ filter: string, Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: FIELD_NAME COMPARISON_STRING LITERAL_STRING.
+
+The FIELD_NAME is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The COMPARISON_STRING must be either eq (equals) or ne (not equals). The LITERAL_STRING is the string value to filter to. The literal value must be valid for the type of field (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.
+
+For example, filter=name ne example-instance.
Returns:
An object of the form:
- { # Contains a list of persistent disk snapshot resources.
- "nextPageToken": "A String", # A token used to continue a truncated list request (output only).
+ { # Contains a list of Snapshot resources.
+ "nextPageToken": "A String", # [Output Only] A token used to continue a truncated list request.
"items": [ # A list of Snapshot resources.
{ # A persistent disk snapshot resource.
- "status": "A String", # The status of the persistent disk snapshot (output only).
- "kind": "compute#snapshot", # Type of the resource.
- "storageBytes": "A String", # A size of the the storage used by the snapshot. As snapshots share storage this number is expected to change with snapshot creation/deletion.
+ "status": "A String", # [Output Only] The status of the snapshot.
+ "kind": "compute#snapshot", # [Output Only] Type of the resource. Always compute#snapshot for Snapshot resources.
+ "storageBytes": "A String", # [Output Only] A size of the the storage used by the snapshot. As snapshots share storage, this number is expected to change with snapshot creation/deletion.
"description": "A String", # An optional textual description of the resource; provided by the client when the resource is created.
"sourceDisk": "A String", # The source disk used to create this snapshot.
- "storageBytesStatus": "A String", # An indicator whether storageBytes is in a stable state, or it is being adjusted as a result of shared storage reallocation.
- "sourceDiskId": "A String", # The 'id' value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name.
- "diskSizeGb": "A String", # Size of the persistent disk snapshot, specified in GB (output only).
+ "storageBytesStatus": "A String", # [Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation.
+ "sourceDiskId": "A String", # [Output Only] The ID value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name.
+ "diskSizeGb": "A String", # [Output Only] Size of the snapshot, specified in GB.
"licenses": [ # Public visible licenses.
"A String",
],
- "creationTimestamp": "A String", # Creation timestamp in RFC3339 text format (output only).
- "id": "A String", # Unique identifier for the resource; defined by the server (output only).
- "selfLink": "A String", # Server defined URL for the resource (output only).
- "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.
+ "creationTimestamp": "A String", # [Output Only] Creation timestamp in RFC3339 text format.
+ "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server.
+ "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+ "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.
},
],
"kind": "compute#snapshotList", # Type of resource.
- "id": "A String", # Unique identifier for the resource; defined by the server (output only).
- "selfLink": "A String", # Server defined URL for this resource (output only).
+ "id": "A String", # [Output Only] Unique identifier for the resource. Defined by the server.
+ "selfLink": "A String", # [Output Only] Server-defined URL for this resource.
}</pre>
</div>