feat(composer): update the API

#### composer:v1beta1 The following keys were added: - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.description - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.flatPath - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.httpMethod - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.id - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.parameterOrder - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.parameters.environment.description - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.parameters.environment.location - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.parameters.environment.pattern - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.parameters.environment.required - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.parameters.environment.type - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.path - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.request.$ref - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.response.$ref - resources.projects.resources.locations.resources.environments.methods.loadSnapshot.scopes - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.description - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.flatPath - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.httpMethod - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.id - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.parameterOrder - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.parameters.environment.description - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.parameters.environment.location - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.parameters.environment.pattern - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.parameters.environment.required - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.parameters.environment.type - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.path - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.request.$ref - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.response.$ref - resources.projects.resources.locations.resources.environments.methods.saveSnapshot.scopes - schemas.LoadSnapshotRequest.description - schemas.LoadSnapshotRequest.id - schemas.LoadSnapshotRequest.properties.skipPypiPackagesInstallation.description - schemas.LoadSnapshotRequest.properties.skipPypiPackagesInstallation.type - schemas.LoadSnapshotRequest.properties.snapshotPath.description - schemas.LoadSnapshotRequest.properties.snapshotPath.type - schemas.LoadSnapshotRequest.type - schemas.SaveSnapshotRequest.description - schemas.SaveSnapshotRequest.id - schemas.SaveSnapshotRequest.properties.snapshotLocation.description - schemas.SaveSnapshotRequest.properties.snapshotLocation.type - schemas.SaveSnapshotRequest.type The following keys were changed: - schemas.CheckUpgradeRequest.properties.imageVersion.description - schemas.Empty.description - schemas.NodeConfig.properties.diskSizeGb.description - schemas.SoftwareConfig.properties.imageVersion.description #### composer:v1 The following keys were changed: - schemas.Empty.description - schemas.NodeConfig.properties.diskSizeGb.description - schemas.SoftwareConfig.properties.imageVersion.description
googleapis · Apr 11, 2022 · e3ddd11 · e3ddd11
1 parent b8bb545
commit e3ddd11
Show file tree

Hide file tree

Showing 4 changed files with 431 additions and 16 deletions.
diff --git a/discovery/composer-v1.json b/discovery/composer-v1.json
@@ -406,7 +406,7 @@
       }
     }
   },
-  "revision": "20220307",
+  "revision": "20220402",
   "rootUrl": "https://composer.googleapis.com/",
   "schemas": {
     "AllowedIpRange": {
@@ -501,7 +501,7 @@
       "type": "object"
     },
     "Empty": {
-      "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.",
+      "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }",
       "id": "Empty",
       "properties": {},
       "type": "object"
@@ -790,7 +790,7 @@
       "id": "NodeConfig",
       "properties": {
         "diskSizeGb": {
-          "description": "Optional. The disk size in GB used for node VMs. Minimum size is 20GB. If unspecified, defaults to 100GB. Cannot be updated. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*.",
+          "description": "Optional. The disk size in GB used for node VMs. Minimum size is 30GB. If unspecified, defaults to 100GB. Cannot be updated. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*.",
           "format": "int32",
           "type": "integer"
         },
@@ -1044,7 +1044,7 @@
           "type": "object"
         },
         "imageVersion": {
-          "description": "The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\\.[0-9]+\\.[0-9]+(-preview\\.[0-9]+)?)?|latest)-airflow-([0-9]+\\.[0-9]+(\\.[0-9]+)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major and minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview).",
+          "description": "The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\\.[0-9]+\\.[0-9]+(-preview\\.[0-9]+)?)?|latest)-airflow-([0-9]+(\\.[0-9]+(\\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview).",
           "type": "string"
         },
         "pypiPackages": {

diff --git a/discovery/composer-v1beta1.json b/discovery/composer-v1beta1.json
@@ -253,6 +253,34 @@
                     "https://www.googleapis.com/auth/cloud-platform"
                   ]
                 },
+                "loadSnapshot": {
+                  "description": "Loads a snapshot of a Cloud Composer environment. As a result of this operation, a snapshot of environment's specified in LoadSnapshotRequest is loaded into the environment.",
+                  "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}:loadSnapshot",
+                  "httpMethod": "POST",
+                  "id": "composer.projects.locations.environments.loadSnapshot",
+                  "parameterOrder": [
+                    "environment"
+                  ],
+                  "parameters": {
+                    "environment": {
+                      "description": "The resource name of the target environment in the form: \"projects/{projectId}/locations/{locationId}/environments/{environmentId}\"",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/environments/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1beta1/{+environment}:loadSnapshot",
+                  "request": {
+                    "$ref": "LoadSnapshotRequest"
+                  },
+                  "response": {
+                    "$ref": "Operation"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/cloud-platform"
+                  ]
+                },
                 "patch": {
                   "description": "Update an environment.",
                   "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}",
@@ -314,6 +342,34 @@
                   "scopes": [
                     "https://www.googleapis.com/auth/cloud-platform"
                   ]
+                },
+                "saveSnapshot": {
+                  "description": "Creates a snapshots of a Cloud Composer environment. As a result of this operation, snapshot of environment's state is stored in a location specified in the SaveSnapshotRequest.",
+                  "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}:saveSnapshot",
+                  "httpMethod": "POST",
+                  "id": "composer.projects.locations.environments.saveSnapshot",
+                  "parameterOrder": [
+                    "environment"
+                  ],
+                  "parameters": {
+                    "environment": {
+                      "description": "The resource name of the source environment in the form: \"projects/{projectId}/locations/{locationId}/environments/{environmentId}\"",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/environments/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1beta1/{+environment}:saveSnapshot",
+                  "request": {
+                    "$ref": "SaveSnapshotRequest"
+                  },
+                  "response": {
+                    "$ref": "Operation"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/cloud-platform"
+                  ]
                 }
               }
             },
@@ -462,7 +518,7 @@
       }
     }
   },
-  "revision": "20220307",
+  "revision": "20220402",
   "rootUrl": "https://composer.googleapis.com/",
   "schemas": {
     "AllowedIpRange": {
@@ -485,7 +541,7 @@
       "id": "CheckUpgradeRequest",
       "properties": {
         "imageVersion": {
-          "description": "The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\\.[0-9]+\\.[0-9]+(-preview\\.[0-9]+)?)?|latest)-airflow-([0-9]+\\.[0-9]+(\\.[0-9]+)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major and minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview).",
+          "description": "The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\\.[0-9]+\\.[0-9]+(-preview\\.[0-9]+)?)?|latest)-airflow-([0-9]+(\\.[0-9]+(\\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview).",
           "type": "string"
         }
       },
@@ -583,7 +639,7 @@
       "type": "object"
     },
     "Empty": {
-      "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.",
+      "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }",
       "id": "Empty",
       "properties": {},
       "type": "object"
@@ -856,6 +912,21 @@
       },
       "type": "object"
     },
+    "LoadSnapshotRequest": {
+      "description": "Request to load a snapshot into a Cloud Composer environment.",
+      "id": "LoadSnapshotRequest",
+      "properties": {
+        "skipPypiPackagesInstallation": {
+          "description": "Whether or not to skip installing Pypi packages when loading the environment's state.",
+          "type": "boolean"
+        },
+        "snapshotPath": {
+          "description": "A Cloud Storage path to a snapshot to load, e.g.: \"gs://my-bucket/snapshots/project_location_environment_timestamp\".",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "LoadSnapshotResponse": {
       "description": "Response to LoadSnapshotRequest.",
       "id": "LoadSnapshotResponse",
@@ -906,7 +977,7 @@
       "id": "NodeConfig",
       "properties": {
         "diskSizeGb": {
-          "description": "Optional. The disk size in GB used for node VMs. Minimum size is 20GB. If unspecified, defaults to 100GB. Cannot be updated. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*.",
+          "description": "Optional. The disk size in GB used for node VMs. Minimum size is 30GB. If unspecified, defaults to 100GB. Cannot be updated. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*.",
           "format": "int32",
           "type": "integer"
         },
@@ -1131,6 +1202,17 @@
       "properties": {},
       "type": "object"
     },
+    "SaveSnapshotRequest": {
+      "description": "Request to create a snapshot of a Cloud Composer environment.",
+      "id": "SaveSnapshotRequest",
+      "properties": {
+        "snapshotLocation": {
+          "description": "Location in a Cloud Storage where the snapshot is going to be stored, e.g.: \"gs://my-bucket/snapshots\".",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "SaveSnapshotResponse": {
       "description": "Response to SaveSnapshotRequest.",
       "id": "SaveSnapshotResponse",
@@ -1188,7 +1270,7 @@
           "type": "object"
         },
         "imageVersion": {
-          "description": "The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\\.[0-9]+\\.[0-9]+(-preview\\.[0-9]+)?)?|latest)-airflow-([0-9]+\\.[0-9]+(\\.[0-9]+)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major and minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview).",
+          "description": "The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\\.[0-9]+\\.[0-9]+(-preview\\.[0-9]+)?)?|latest)-airflow-([0-9]+(\\.[0-9]+(\\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview).",
           "type": "string"
         },
         "pypiPackages": {