feat(composer): update the api

#### composer:v1

The following keys were added:
- resources.projects.resources.locations.resources.environments.methods.checkUpgrade (Total Keys: 12)
- schemas.CheckUpgradeRequest (Total Keys: 3)

Author: yoshi-automation

docs/dyn/composer_v1.projects.locations.environments.html

@@ -89,6 +89,9 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the workloads Resource.</p>
 
+<p class="toc_element">
+  <code><a href="#checkUpgrade">checkUpgrade(environment, body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Check if an upgrade operation on the environment will succeed. In case of problems detailed info can be found in the returned Operation.</p>
 <p class="toc_element">
   <code><a href="#close">close()</a></code></p>
 <p class="firstline">Close httplib2 connections.</p>
@@ -132,6 +135,48 @@ <h2>Instance Methods</h2>
   <code><a href="#stopAirflowCommand">stopAirflowCommand(environment, body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Stops Airflow CLI command execution.</p>
 <h3>Method Details</h3>
+<div class="method">
+    <code class="details" id="checkUpgrade">checkUpgrade(environment, body=None, x__xgafv=None)</code>
+  <pre>Check if an upgrade operation on the environment will succeed. In case of problems detailed info can be found in the returned Operation.
+
+Args:
+  environment: string, Required. The resource name of the environment to check upgrade for, in the form: &quot;projects/{projectId}/locations/{locationId}/environments/{environmentId}&quot; (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request to check whether image upgrade will succeed.
+  &quot;imageVersion&quot;: &quot;A String&quot;, # Optional. 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).
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # This resource represents a long-running operation that is the result of a network API call.
+  &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+  &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+    &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
+    &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+      {
+        &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
+      },
+    ],
+    &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+  },
+  &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+    &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
+  },
+  &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+  &quot;response&quot;: { # The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
+  },
+}</pre>
+</div>
+
 <div class="method">
     <code class="details" id="close">close()</code>
   <pre>Close httplib2 connections.</pre>

googleapiclient/discovery_cache/documents/composer.v1.json

@@ -111,6 +111,34 @@
 "resources": {
 "environments": {
 "methods": {
+"checkUpgrade": {
+"description": "Check if an upgrade operation on the environment will succeed. In case of problems detailed info can be found in the returned Operation.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}:checkUpgrade",
+"httpMethod": "POST",
+"id": "composer.projects.locations.environments.checkUpgrade",
+"parameterOrder": [
+"environment"
+],
+"parameters": {
+"environment": {
+"description": "Required. The resource name of the environment to check upgrade for, in the form: \"projects/{projectId}/locations/{locationId}/environments/{environmentId}\"",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/environments/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+environment}:checkUpgrade",
+"request": {
+"$ref": "CheckUpgradeRequest"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "create": {
 "description": "Create a new environment.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments",
@@ -938,7 +966,7 @@
 }
 }
 },
-"revision": "20240512",
+"revision": "20240520",
 "rootUrl": "https://composer.googleapis.com/",
 "schemas": {
 "AirflowMetadataRetentionPolicyConfig": {
@@ -982,6 +1010,17 @@
 },
 "type": "object"
 },
+"CheckUpgradeRequest": {
+"description": "Request to check whether image upgrade will succeed.",
+"id": "CheckUpgradeRequest",
+"properties": {
+"imageVersion": {
+"description": "Optional. 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"
+}
+},
+"type": "object"
+},
 "CheckUpgradeResponse": {
 "description": "Message containing information about the result of an upgrade check operation.",
 "id": "CheckUpgradeResponse",

googleapiclient/discovery_cache/documents/composer.v1beta1.json

@@ -994,7 +994,7 @@
 }
 }
 },
-"revision": "20240512",
+"revision": "20240520",
 "rootUrl": "https://composer.googleapis.com/",
 "schemas": {
 "AirflowMetadataRetentionPolicyConfig": {