diff --git a/docs/dyn/baremetalsolution_v2.projects.locations.volumes.html b/docs/dyn/baremetalsolution_v2.projects.locations.volumes.html index 51a452cc355..390626237d0 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.volumes.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.volumes.html @@ -79,6 +79,11 @@
Returns the luns Resource.
+
+ snapshots()
+
Returns the snapshots Resource.
+Close httplib2 connections.
diff --git a/docs/dyn/baremetalsolution_v2.projects.locations.volumes.snapshots.html b/docs/dyn/baremetalsolution_v2.projects.locations.volumes.snapshots.html index 15f0c44e584..bbfefefc5ac 100644 --- a/docs/dyn/baremetalsolution_v2.projects.locations.volumes.snapshots.html +++ b/docs/dyn/baremetalsolution_v2.projects.locations.volumes.snapshots.html @@ -79,22 +79,22 @@Close httplib2 connections.
create(parent, body=None, x__xgafv=None)
Create a storage volume snapshot in a containing volume.
+Takes a snapshot of a boot volume. Returns INVALID_ARGUMENT if called for a non-boot volume.
-Deletes a storage volume snapshot for a given volume.
+Deletes a volume snapshot. Returns INVALID_ARGUMENT if called for a non-boot volume.
-Get details of a single storage volume snapshot.
+Returns the specified snapshot resource. Returns INVALID_ARGUMENT if called for a non-boot volume.
list(parent, pageSize=None, pageToken=None, x__xgafv=None)
List storage volume snapshots for given storage volume.
+Retrieves the list of snapshots for the specified volume. Returns a response with an empty list of snapshots if called for a non-boot volume.
- list_next(previous_request, previous_response)
list_next()
Retrieves the next page of results.
restoreVolumeSnapshot(volumeSnapshot, body=None, x__xgafv=None)
Restore a storage volume snapshot to its containing volume.
+Uses the specified snapshot to restore its parent volume. Returns INVALID_ARGUMENT if called for a non-boot volume.
close()
@@ -103,20 +103,20 @@ create(parent, body=None, x__xgafv=None)
- Create a storage volume snapshot in a containing volume. +Takes a snapshot of a boot volume. Returns INVALID_ARGUMENT if called for a non-boot volume. Args: parent: string, Required. The volume to snapshot. (required) body: object, The request body. The object takes the form of: -{ # Snapshot registered for a given storage volume. - "createTime": "A String", # Output only. The creation time of the storage volume snapshot. - "description": "A String", # The description of the storage volume snapshot. - "id": "A String", # An identifier for the snapshot, generated by the backend. - "name": "A String", # Output only. The name of the storage volume snapshot. - "sizeBytes": "A String", # The size of the storage volume snapshot, in bytes. - "storageVolume": "A String", # The storage volume this snapshot belongs to. +{ # A snapshot of a volume. Only boot volumes can have snapshots. + "createTime": "A String", # Output only. The creation time of the snapshot. + "description": "A String", # The description of the snapshot. + "id": "A String", # Output only. An identifier for the snapshot, generated by the backend. + "name": "A String", # The name of the snapshot. + "storageVolume": "A String", # Output only. The name of the volume which this snapshot belongs to. + "type": "A String", # Output only. The type of the snapshot which indicates whether it was scheduled or manual/ad-hoc. } x__xgafv: string, V1 error format. @@ -127,19 +127,19 @@Method Details
Returns: An object of the form: - { # Snapshot registered for a given storage volume. - "createTime": "A String", # Output only. The creation time of the storage volume snapshot. - "description": "A String", # The description of the storage volume snapshot. - "id": "A String", # An identifier for the snapshot, generated by the backend. - "name": "A String", # Output only. The name of the storage volume snapshot. - "sizeBytes": "A String", # The size of the storage volume snapshot, in bytes. - "storageVolume": "A String", # The storage volume this snapshot belongs to. + { # A snapshot of a volume. Only boot volumes can have snapshots. + "createTime": "A String", # Output only. The creation time of the snapshot. + "description": "A String", # The description of the snapshot. + "id": "A String", # Output only. An identifier for the snapshot, generated by the backend. + "name": "A String", # The name of the snapshot. + "storageVolume": "A String", # Output only. The name of the volume which this snapshot belongs to. + "type": "A String", # Output only. The type of the snapshot which indicates whether it was scheduled or manual/ad-hoc. }
delete(name, x__xgafv=None)
- Deletes a storage volume snapshot for a given volume. +Deletes a volume snapshot. Returns INVALID_ARGUMENT if called for a non-boot volume. Args: name: string, Required. The name of the snapshot to delete. (required) @@ -157,10 +157,10 @@Method Details
get(name, x__xgafv=None)
-Get details of a single storage volume snapshot. +Returns the specified snapshot resource. Returns INVALID_ARGUMENT if called for a non-boot volume. Args: - name: string, Required. Name of the resource. (required) + name: string, Required. The name of the snapshot. (required) x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -169,19 +169,19 @@Method Details
Returns: An object of the form: - { # Snapshot registered for a given storage volume. - "createTime": "A String", # Output only. The creation time of the storage volume snapshot. - "description": "A String", # The description of the storage volume snapshot. - "id": "A String", # An identifier for the snapshot, generated by the backend. - "name": "A String", # Output only. The name of the storage volume snapshot. - "sizeBytes": "A String", # The size of the storage volume snapshot, in bytes. - "storageVolume": "A String", # The storage volume this snapshot belongs to. + { # A snapshot of a volume. Only boot volumes can have snapshots. + "createTime": "A String", # Output only. The creation time of the snapshot. + "description": "A String", # The description of the snapshot. + "id": "A String", # Output only. An identifier for the snapshot, generated by the backend. + "name": "A String", # The name of the snapshot. + "storageVolume": "A String", # Output only. The name of the volume which this snapshot belongs to. + "type": "A String", # Output only. The type of the snapshot which indicates whether it was scheduled or manual/ad-hoc. }list(parent, pageSize=None, pageToken=None, x__xgafv=None)
-List storage volume snapshots for given storage volume. +Retrieves the list of snapshots for the specified volume. Returns a response with an empty list of snapshots if called for a non-boot volume. Args: parent: string, Required. Parent value for ListVolumesRequest. (required) @@ -195,44 +195,44 @@Method Details
Returns: An object of the form: - { # Response message containing the list of storage volume snapshots. + { # Response message containing the list of volume snapshots. "nextPageToken": "A String", # A token identifying a page of results from the server. "unreachable": [ # Locations that could not be reached. "A String", ], - "volumeSnapshots": [ # The list of storage volumes. - { # Snapshot registered for a given storage volume. - "createTime": "A String", # Output only. The creation time of the storage volume snapshot. - "description": "A String", # The description of the storage volume snapshot. - "id": "A String", # An identifier for the snapshot, generated by the backend. - "name": "A String", # Output only. The name of the storage volume snapshot. - "sizeBytes": "A String", # The size of the storage volume snapshot, in bytes. - "storageVolume": "A String", # The storage volume this snapshot belongs to. + "volumeSnapshots": [ # The list of snapshots. + { # A snapshot of a volume. Only boot volumes can have snapshots. + "createTime": "A String", # Output only. The creation time of the snapshot. + "description": "A String", # The description of the snapshot. + "id": "A String", # Output only. An identifier for the snapshot, generated by the backend. + "name": "A String", # The name of the snapshot. + "storageVolume": "A String", # Output only. The name of the volume which this snapshot belongs to. + "type": "A String", # Output only. The type of the snapshot which indicates whether it was scheduled or manual/ad-hoc. }, ], }-list_next(previous_request, previous_response)
+list_next()
Retrieves the next page of results. -Args: - previous_request: The request for the previous page. (required) - previous_response: The response from the request for the previous page. (required) + Args: + previous_request: The request for the previous page. (required) + previous_response: The response from the request for the previous page. (required) -Returns: - A request object that you can call 'execute()' on to request the next - page. Returns None if there are no more items in the collection. -+ Returns: + A request object that you can call 'execute()' on to request the next + page. Returns None if there are no more items in the collection. +restoreVolumeSnapshot(volumeSnapshot, body=None, x__xgafv=None)
-Restore a storage volume snapshot to its containing volume. +Uses the specified snapshot to restore its parent volume. Returns INVALID_ARGUMENT if called for a non-boot volume. Args: - volumeSnapshot: string, Required. Name of the resource. (required) + volumeSnapshot: string, Required. Name of the snapshot which will be used to restore its parent volume. (required) body: object, The request body. The object takes the form of: diff --git a/googleapiclient/discovery_cache/documents/baremetalsolution.v1.json b/googleapiclient/discovery_cache/documents/baremetalsolution.v1.json index 1824a78aaf2..d6101830202 100644 --- a/googleapiclient/discovery_cache/documents/baremetalsolution.v1.json +++ b/googleapiclient/discovery_cache/documents/baremetalsolution.v1.json @@ -228,7 +228,7 @@ } } }, - "revision": "20220928", + "revision": "20221025", "rootUrl": "https://baremetalsolution.googleapis.com/", "schemas": { "CancelOperationRequest": { diff --git a/googleapiclient/discovery_cache/documents/baremetalsolution.v2.json b/googleapiclient/discovery_cache/documents/baremetalsolution.v2.json index 19f14cec8a3..19226721d60 100644 --- a/googleapiclient/discovery_cache/documents/baremetalsolution.v2.json +++ b/googleapiclient/discovery_cache/documents/baremetalsolution.v2.json @@ -1283,6 +1283,152 @@ ] } } + }, + "snapshots": { + "methods": { + "create": { + "description": "Takes a snapshot of a boot volume. Returns INVALID_ARGUMENT if called for a non-boot volume.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/snapshots", + "httpMethod": "POST", + "id": "baremetalsolution.projects.locations.volumes.snapshots.create", + "parameterOrder": [ + "parent" + ], + "parameters": { + "parent": { + "description": "Required. The volume to snapshot.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/snapshots", + "request": { + "$ref": "VolumeSnapshot" + }, + "response": { + "$ref": "VolumeSnapshot" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "delete": { + "description": "Deletes a volume snapshot. Returns INVALID_ARGUMENT if called for a non-boot volume.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/snapshots/{snapshotsId}", + "httpMethod": "DELETE", + "id": "baremetalsolution.projects.locations.volumes.snapshots.delete", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the snapshot to delete.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+/snapshots/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "get": { + "description": "Returns the specified snapshot resource. Returns INVALID_ARGUMENT if called for a non-boot volume.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/snapshots/{snapshotsId}", + "httpMethod": "GET", + "id": "baremetalsolution.projects.locations.volumes.snapshots.get", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The name of the snapshot.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+/snapshots/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+name}", + "response": { + "$ref": "VolumeSnapshot" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "list": { + "description": "Retrieves the list of snapshots for the specified volume. Returns a response with an empty list of snapshots if called for a non-boot volume.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/snapshots", + "httpMethod": "GET", + "id": "baremetalsolution.projects.locations.volumes.snapshots.list", + "parameterOrder": [ + "parent" + ], + "parameters": { + "pageSize": { + "description": "Requested page size. The server might return fewer items than requested. If unspecified, server will pick an appropriate default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "A token identifying a page of results from the server.", + "location": "query", + "type": "string" + }, + "parent": { + "description": "Required. Parent value for ListVolumesRequest.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+parent}/snapshots", + "response": { + "$ref": "ListVolumeSnapshotsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "restoreVolumeSnapshot": { + "description": "Uses the specified snapshot to restore its parent volume. Returns INVALID_ARGUMENT if called for a non-boot volume.", + "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/volumes/{volumesId}/snapshots/{snapshotsId}:restoreVolumeSnapshot", + "httpMethod": "POST", + "id": "baremetalsolution.projects.locations.volumes.snapshots.restoreVolumeSnapshot", + "parameterOrder": [ + "volumeSnapshot" + ], + "parameters": { + "volumeSnapshot": { + "description": "Required. Name of the snapshot which will be used to restore its parent volume.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/volumes/[^/]+/snapshots/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v2/{+volumeSnapshot}:restoreVolumeSnapshot", + "request": { + "$ref": "RestoreVolumeSnapshotRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + } + } } } } @@ -1291,7 +1437,7 @@ } } }, - "revision": "20220928", + "revision": "20221025", "rootUrl": "https://baremetalsolution.googleapis.com/", "schemas": { "AllowedClient": { @@ -1844,6 +1990,31 @@ }, "type": "object" }, + "ListVolumeSnapshotsResponse": { + "description": "Response message containing the list of volume snapshots.", + "id": "ListVolumeSnapshotsResponse", + "properties": { + "nextPageToken": { + "description": "A token identifying a page of results from the server.", + "type": "string" + }, + "unreachable": { + "description": "Locations that could not be reached.", + "items": { + "type": "string" + }, + "type": "array" + }, + "volumeSnapshots": { + "description": "The list of snapshots.", + "items": { + "$ref": "VolumeSnapshot" + }, + "type": "array" + } + }, + "type": "object" + }, "ListVolumesResponse": { "description": "Response message containing the list of storage volumes.", "id": "ListVolumesResponse", @@ -2743,6 +2914,12 @@ }, "type": "object" }, + "RestoreVolumeSnapshotRequest": { + "description": "Message for restoring a volume snapshot.", + "id": "RestoreVolumeSnapshotRequest", + "properties": {}, + "type": "object" + }, "SSHKey": { "description": "An SSH key, used for authorizing with the interactive serial console feature.", "id": "SSHKey", @@ -3204,6 +3381,52 @@ } }, "type": "object" + }, + "VolumeSnapshot": { + "description": "A snapshot of a volume. Only boot volumes can have snapshots.", + "id": "VolumeSnapshot", + "properties": { + "createTime": { + "description": "Output only. The creation time of the snapshot.", + "format": "google-datetime", + "readOnly": true, + "type": "string" + }, + "description": { + "description": "The description of the snapshot.", + "type": "string" + }, + "id": { + "description": "Output only. An identifier for the snapshot, generated by the backend.", + "readOnly": true, + "type": "string" + }, + "name": { + "description": "The name of the snapshot.", + "type": "string" + }, + "storageVolume": { + "description": "Output only. The name of the volume which this snapshot belongs to.", + "readOnly": true, + "type": "string" + }, + "type": { + "description": "Output only. The type of the snapshot which indicates whether it was scheduled or manual/ad-hoc.", + "enum": [ + "SNAPSHOT_TYPE_UNSPECIFIED", + "AD_HOC", + "SCHEDULED" + ], + "enumDescriptions": [ + "Type is not specified.", + "Snapshot was taken manually by user.", + "Snapshot was taken automatically as a part of a snapshot schedule." + ], + "readOnly": true, + "type": "string" + } + }, + "type": "object" } }, "servicePath": "",