feat(storage): update the API

#### storage:v1 The following keys were added: - resources.buckets.methods.restore.parameters.projection.description - resources.buckets.methods.restore.parameters.projection.enum - resources.buckets.methods.restore.parameters.projection.enumDescriptions - resources.buckets.methods.restore.parameters.projection.location - resources.buckets.methods.restore.parameters.projection.type - resources.buckets.methods.restore.response.$ref - resources.objects.methods.move.description - resources.objects.methods.move.httpMethod - resources.objects.methods.move.id - resources.objects.methods.move.parameterOrder - resources.objects.methods.move.parameters.bucket.description - resources.objects.methods.move.parameters.bucket.location - resources.objects.methods.move.parameters.bucket.required - resources.objects.methods.move.parameters.bucket.type - resources.objects.methods.move.parameters.destinationObject.description - resources.objects.methods.move.parameters.destinationObject.location - resources.objects.methods.move.parameters.destinationObject.required - resources.objects.methods.move.parameters.destinationObject.type - resources.objects.methods.move.parameters.ifGenerationMatch.description - resources.objects.methods.move.parameters.ifGenerationMatch.format - resources.objects.methods.move.parameters.ifGenerationMatch.location - resources.objects.methods.move.parameters.ifGenerationMatch.type - resources.objects.methods.move.parameters.ifGenerationNotMatch.description - resources.objects.methods.move.parameters.ifGenerationNotMatch.format - resources.objects.methods.move.parameters.ifGenerationNotMatch.location - resources.objects.methods.move.parameters.ifGenerationNotMatch.type - resources.objects.methods.move.parameters.ifMetagenerationMatch.description - resources.objects.methods.move.parameters.ifMetagenerationMatch.format - resources.objects.methods.move.parameters.ifMetagenerationMatch.location - resources.objects.methods.move.parameters.ifMetagenerationMatch.type - resources.objects.methods.move.parameters.ifMetagenerationNotMatch.description - resources.objects.methods.move.parameters.ifMetagenerationNotMatch.format - resources.objects.methods.move.parameters.ifMetagenerationNotMatch.location - resources.objects.methods.move.parameters.ifMetagenerationNotMatch.type - resources.objects.methods.move.parameters.ifSourceGenerationMatch.description - resources.objects.methods.move.parameters.ifSourceGenerationMatch.format - resources.objects.methods.move.parameters.ifSourceGenerationMatch.location - resources.objects.methods.move.parameters.ifSourceGenerationMatch.type - resources.objects.methods.move.parameters.ifSourceGenerationNotMatch.description - resources.objects.methods.move.parameters.ifSourceGenerationNotMatch.format - resources.objects.methods.move.parameters.ifSourceGenerationNotMatch.location - resources.objects.methods.move.parameters.ifSourceGenerationNotMatch.type - resources.objects.methods.move.parameters.ifSourceMetagenerationMatch.description - resources.objects.methods.move.parameters.ifSourceMetagenerationMatch.format - resources.objects.methods.move.parameters.ifSourceMetagenerationMatch.location - resources.objects.methods.move.parameters.ifSourceMetagenerationMatch.type - resources.objects.methods.move.parameters.ifSourceMetagenerationNotMatch.description - resources.objects.methods.move.parameters.ifSourceMetagenerationNotMatch.format - resources.objects.methods.move.parameters.ifSourceMetagenerationNotMatch.location - resources.objects.methods.move.parameters.ifSourceMetagenerationNotMatch.type - resources.objects.methods.move.parameters.sourceObject.description - resources.objects.methods.move.parameters.sourceObject.location - resources.objects.methods.move.parameters.sourceObject.required - resources.objects.methods.move.parameters.sourceObject.type - resources.objects.methods.move.parameters.userProject.description - resources.objects.methods.move.parameters.userProject.location - resources.objects.methods.move.parameters.userProject.type - resources.objects.methods.move.path - resources.objects.methods.move.response.$ref - resources.objects.methods.move.scopes - resources.operations.methods.advanceRelocateBucket.description - resources.operations.methods.advanceRelocateBucket.httpMethod - resources.operations.methods.advanceRelocateBucket.id - resources.operations.methods.advanceRelocateBucket.parameterOrder - resources.operations.methods.advanceRelocateBucket.parameters.bucket.description - resources.operations.methods.advanceRelocateBucket.parameters.bucket.location - resources.operations.methods.advanceRelocateBucket.parameters.bucket.required - resources.operations.methods.advanceRelocateBucket.parameters.bucket.type - resources.operations.methods.advanceRelocateBucket.parameters.operationId.description - resources.operations.methods.advanceRelocateBucket.parameters.operationId.location - resources.operations.methods.advanceRelocateBucket.parameters.operationId.required - resources.operations.methods.advanceRelocateBucket.parameters.operationId.type - resources.operations.methods.advanceRelocateBucket.path - resources.operations.methods.advanceRelocateBucket.request.$ref - resources.operations.methods.advanceRelocateBucket.scopes - schemas.AdvanceRelocateBucketOperationRequest.description - schemas.AdvanceRelocateBucketOperationRequest.id - schemas.AdvanceRelocateBucketOperationRequest.properties.expireTime.description - schemas.AdvanceRelocateBucketOperationRequest.properties.expireTime.format - schemas.AdvanceRelocateBucketOperationRequest.properties.expireTime.type - schemas.AdvanceRelocateBucketOperationRequest.properties.ttl.description - schemas.AdvanceRelocateBucketOperationRequest.properties.ttl.format - schemas.AdvanceRelocateBucketOperationRequest.properties.ttl.type - schemas.AdvanceRelocateBucketOperationRequest.type - schemas.Object.properties.timeFinalized.description - schemas.Object.properties.timeFinalized.format - schemas.Object.properties.timeFinalized.type
googleapis · Jan 29, 2025 · 487bfb4 · 487bfb4
1 parent fa3846b
commit 487bfb4
Show file tree

Hide file tree

Showing 2 changed files with 437 additions and 13 deletions.
diff --git a/discovery/storage-v1.json b/discovery/storage-v1.json
@@ -93,7 +93,7 @@
       "location": "us-west4"
     }
   ],
-  "etag": "\"3133363239393031373133303332303839383336\"",
+  "etag": "\"3133343838373034343130353038353234313337\"",
   "icons": {
     "x16": "https://www.google.com/images/icons/product/cloud_storage-16.png",
     "x32": "https://www.google.com/images/icons/product/cloud_storage-32.png"
@@ -1129,13 +1129,29 @@
               "required": true,
               "type": "string"
             },
+            "projection": {
+              "description": "Set of properties to return. Defaults to full.",
+              "enum": [
+                "full",
+                "noAcl"
+              ],
+              "enumDescriptions": [
+                "Include all properties.",
+                "Omit owner, acl and defaultObjectAcl properties."
+              ],
+              "location": "query",
+              "type": "string"
+            },
             "userProject": {
               "description": "The project to be billed for this request. Required for Requester Pays buckets.",
               "location": "query",
               "type": "string"
             }
           },
           "path": "b/{bucket}/restore",
+          "response": {
+            "$ref": "Bucket"
+          },
           "scopes": [
             "https://www.googleapis.com/auth/cloud-platform",
             "https://www.googleapis.com/auth/devstorage.full_control",
@@ -3208,6 +3224,98 @@
           ],
           "supportsSubscription": true
         },
+        "move": {
+          "description": "Moves the source object to the destination object in the same bucket.",
+          "httpMethod": "POST",
+          "id": "storage.objects.move",
+          "parameterOrder": [
+            "bucket",
+            "sourceObject",
+            "destinationObject"
+          ],
+          "parameters": {
+            "bucket": {
+              "description": "Name of the bucket in which the object resides.",
+              "location": "path",
+              "required": true,
+              "type": "string"
+            },
+            "destinationObject": {
+              "description": "Name of the destination object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).",
+              "location": "path",
+              "required": true,
+              "type": "string"
+            },
+            "ifGenerationMatch": {
+              "description": "Makes the operation conditional on whether the destination object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object. `ifGenerationMatch` and `ifGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.",
+              "format": "int64",
+              "location": "query",
+              "type": "string"
+            },
+            "ifGenerationNotMatch": {
+              "description": "Makes the operation conditional on whether the destination object's current generation does not match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.`ifGenerationMatch` and `ifGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.",
+              "format": "int64",
+              "location": "query",
+              "type": "string"
+            },
+            "ifMetagenerationMatch": {
+              "description": "Makes the operation conditional on whether the destination object's current metageneration matches the given value. `ifMetagenerationMatch` and `ifMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.",
+              "format": "int64",
+              "location": "query",
+              "type": "string"
+            },
+            "ifMetagenerationNotMatch": {
+              "description": "Makes the operation conditional on whether the destination object's current metageneration does not match the given value. `ifMetagenerationMatch` and `ifMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.",
+              "format": "int64",
+              "location": "query",
+              "type": "string"
+            },
+            "ifSourceGenerationMatch": {
+              "description": "Makes the operation conditional on whether the source object's current generation matches the given value. `ifSourceGenerationMatch` and `ifSourceGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.",
+              "format": "int64",
+              "location": "query",
+              "type": "string"
+            },
+            "ifSourceGenerationNotMatch": {
+              "description": "Makes the operation conditional on whether the source object's current generation does not match the given value. `ifSourceGenerationMatch` and `ifSourceGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.",
+              "format": "int64",
+              "location": "query",
+              "type": "string"
+            },
+            "ifSourceMetagenerationMatch": {
+              "description": "Makes the operation conditional on whether the source object's current metageneration matches the given value. `ifSourceMetagenerationMatch` and `ifSourceMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.",
+              "format": "int64",
+              "location": "query",
+              "type": "string"
+            },
+            "ifSourceMetagenerationNotMatch": {
+              "description": "Makes the operation conditional on whether the source object's current metageneration does not match the given value. `ifSourceMetagenerationMatch` and `ifSourceMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.",
+              "format": "int64",
+              "location": "query",
+              "type": "string"
+            },
+            "sourceObject": {
+              "description": "Name of the source object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).",
+              "location": "path",
+              "required": true,
+              "type": "string"
+            },
+            "userProject": {
+              "description": "The project to be billed for this request. Required for Requester Pays buckets.",
+              "location": "query",
+              "type": "string"
+            }
+          },
+          "path": "b/{bucket}/o/{sourceObject}/moveTo/o/{destinationObject}",
+          "response": {
+            "$ref": "Object"
+          },
+          "scopes": [
+            "https://www.googleapis.com/auth/cloud-platform",
+            "https://www.googleapis.com/auth/devstorage.full_control",
+            "https://www.googleapis.com/auth/devstorage.read_write"
+          ]
+        },
         "patch": {
           "description": "Patches an object's metadata.",
           "httpMethod": "PATCH",
@@ -3869,6 +3977,38 @@
     },
     "operations": {
       "methods": {
+        "advanceRelocateBucket": {
+          "description": "Starts asynchronous advancement of the relocate bucket operation in the case of required write downtime, to allow it to lock the bucket at the source location, and proceed with the bucket location swap. The server makes a best effort to advance the relocate bucket operation, but success is not guaranteed.",
+          "httpMethod": "POST",
+          "id": "storage.buckets.operations.advanceRelocateBucket",
+          "parameterOrder": [
+            "bucket",
+            "operationId"
+          ],
+          "parameters": {
+            "bucket": {
+              "description": "Name of the bucket to advance the relocate for.",
+              "location": "path",
+              "required": true,
+              "type": "string"
+            },
+            "operationId": {
+              "description": "ID of the operation resource.",
+              "location": "path",
+              "required": true,
+              "type": "string"
+            }
+          },
+          "path": "b/{bucket}/operations/{operationId}/advanceRelocateBucket",
+          "request": {
+            "$ref": "AdvanceRelocateBucketOperationRequest"
+          },
+          "scopes": [
+            "https://www.googleapis.com/auth/cloud-platform",
+            "https://www.googleapis.com/auth/devstorage.full_control",
+            "https://www.googleapis.com/auth/devstorage.read_write"
+          ]
+        },
         "cancel": {
           "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed.",
           "httpMethod": "POST",
@@ -4224,9 +4364,26 @@
       }
     }
   },
-  "revision": "20240924",
+  "revision": "20241206",
   "rootUrl": "https://storage.googleapis.com/",
   "schemas": {
+    "AdvanceRelocateBucketOperationRequest": {
+      "description": "An AdvanceRelocateBucketOperation request.",
+      "id": "AdvanceRelocateBucketOperationRequest",
+      "properties": {
+        "expireTime": {
+          "description": "Specifies the time when the relocation will revert to the sync stage if the relocation hasn't succeeded.",
+          "format": "date-time",
+          "type": "string"
+        },
+        "ttl": {
+          "description": "Specifies the duration after which the relocation will revert to the sync stage if the relocation hasn't succeeded. Optional, if not supplied, a default value of 12h will be used.",
+          "format": "google-duration",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "AnywhereCache": {
       "description": "An Anywhere Cache instance.",
       "id": "AnywhereCache",
@@ -5741,6 +5898,11 @@
           "format": "date-time",
           "type": "string"
         },
+        "timeFinalized": {
+          "description": "The time when the object was finalized.",
+          "format": "date-time",
+          "type": "string"
+        },
         "timeStorageClassUpdated": {
           "description": "The time at which the object's storage class was last changed. When the object is initially created, it will be set to timeCreated.",
           "format": "date-time",