From 04b23d9cb93758f31467b465290b5077f0d9aec3 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 1 Nov 2022 07:09:35 +0000 Subject: [PATCH] feat(baremetalsolution): update the api #### baremetalsolution:v2 The following keys were added: - resources.projects.resources.locations.resources.volumes.resources.snapshots.methods.create (Total Keys: 12) - resources.projects.resources.locations.resources.volumes.resources.snapshots.methods.delete (Total Keys: 11) - resources.projects.resources.locations.resources.volumes.resources.snapshots.methods.get (Total Keys: 11) - resources.projects.resources.locations.resources.volumes.resources.snapshots.methods.list (Total Keys: 16) - resources.projects.resources.locations.resources.volumes.resources.snapshots.methods.restoreVolumeSnapshot (Total Keys: 12) - schemas.ListVolumeSnapshotsResponse (Total Keys: 7) - schemas.RestoreVolumeSnapshotRequest (Total Keys: 2) - schemas.VolumeSnapshot (Total Keys: 12) --- ...olution_v2.projects.locations.volumes.html | 5 + ....projects.locations.volumes.snapshots.html | 102 ++++---- .../documents/baremetalsolution.v1.json | 2 +- .../documents/baremetalsolution.v2.json | 225 +++++++++++++++++- 4 files changed, 281 insertions(+), 53 deletions(-) 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 @@

Instance Methods

Returns the luns Resource.

+

+ snapshots() +

+

Returns the snapshots Resource.

+

close()

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 @@

Instance Methods

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.

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.

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.

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.

Method Details

close() @@ -103,20 +103,20 @@

Method Details

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": "",