feat(appengine): update the api

#### appengine:v1 The following keys were added: - resources.apps.methods.listRuntimes (Total Keys: 12) - schemas.Date (Total Keys: 8) - schemas.ListRuntimesResponse (Total Keys: 5) - schemas.Runtime (Total Keys: 10)
googleapis · Nov 7, 2023 · bb23d81 · bb23d81
1 parent 3926750
commit bb23d81
Show file tree

Hide file tree

Showing 3 changed files with 203 additions and 2 deletions.
diff --git a/docs/dyn/appengine_v1.apps.html b/docs/dyn/appengine_v1.apps.html
@@ -118,6 +118,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#get">get(appsId, includeExtraData=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets information about an application.</p>
+<p class="toc_element">
+  <code><a href="#listRuntimes">listRuntimes(appsId, environment=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Lists all the available runtimes for the application.</p>
 <p class="toc_element">
   <code><a href="#patch">patch(appsId, body=None, updateMask=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Updates the specified Application resource. You can update the following fields: auth_domain - Google authentication domain for controlling user access to the application. default_cookie_expiration - Cookie expiration policy for the application. iap - Identity-Aware Proxy properties for the application.</p>
@@ -257,6 +260,55 @@ <h3>Method Details</h3>
 }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="listRuntimes">listRuntimes(appsId, environment=None, x__xgafv=None)</code>
+  <pre>Lists all the available runtimes for the application.
+
+Args:
+  appsId: string, Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp. (required)
+  environment: string, Optional. The environment of the Application.
+    Allowed values
+      ENVIRONMENT_UNSPECIFIED - Default value.
+      STANDARD - App Engine Standard.
+      FLEXIBLE - App Engine Flexible
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for Applications.ListRuntimes.
+  &quot;nextPageToken&quot;: &quot;A String&quot;, # Continuation token for fetching the next page of results.
+  &quot;runtimes&quot;: [ # The runtimes available to the requested application.
+    { # Runtime versions for App Engine.
+      &quot;decommissionedDate&quot;: { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: A full date, with non-zero year, month, and day values. A month and day, with a zero year (for example, an anniversary). A year on its own, with a zero month and a zero day. A year and month, with a zero day (for example, a credit card expiration date).Related types: google.type.TimeOfDay google.type.DateTime google.protobuf.Timestamp # Date when Runtime is decommissioned.
+        &quot;day&quot;: 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn&#x27;t significant.
+        &quot;month&quot;: 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        &quot;year&quot;: 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      &quot;deprecationDate&quot;: { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: A full date, with non-zero year, month, and day values. A month and day, with a zero year (for example, an anniversary). A year on its own, with a zero month and a zero day. A year and month, with a zero day (for example, a credit card expiration date).Related types: google.type.TimeOfDay google.type.DateTime google.protobuf.Timestamp # Date when Runtime is deprecated.
+        &quot;day&quot;: 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn&#x27;t significant.
+        &quot;month&quot;: 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        &quot;year&quot;: 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      &quot;endOfSupportDate&quot;: { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: A full date, with non-zero year, month, and day values. A month and day, with a zero year (for example, an anniversary). A year on its own, with a zero month and a zero day. A year and month, with a zero day (for example, a credit card expiration date).Related types: google.type.TimeOfDay google.type.DateTime google.protobuf.Timestamp # Date when Runtime is end of support.
+        &quot;day&quot;: 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn&#x27;t significant.
+        &quot;month&quot;: 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        &quot;year&quot;: 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+      &quot;environment&quot;: &quot;A String&quot;, # The environment of the runtime.
+      &quot;name&quot;: &quot;A String&quot;, # The name of the runtime, e.g., &#x27;go113&#x27;, &#x27;nodejs12&#x27;, etc.
+      &quot;stage&quot;: &quot;A String&quot;, # The stage of life this runtime is in, e.g., BETA, GA, etc.
+      &quot;warnings&quot;: [ # Warning messages, e.g., a deprecation warning.
+        &quot;A String&quot;,
+      ],
+    },
+  ],
+}</pre>
+</div>
+
 <div class="method">
     <code class="details" id="patch">patch(appsId, body=None, updateMask=None, x__xgafv=None)</code>
   <pre>Updates the specified Application resource. You can update the following fields: auth_domain - Google authentication domain for controlling user access to the application. default_cookie_expiration - Cookie expiration policy for the application. iap - Identity-Aware Proxy properties for the application.

diff --git a/googleapiclient/discovery_cache/documents/appengine.v1.json b/googleapiclient/discovery_cache/documents/appengine.v1.json
@@ -171,6 +171,47 @@
             "https://www.googleapis.com/auth/cloud-platform.read-only"
           ]
         },
+        "listRuntimes": {
+          "description": "Lists all the available runtimes for the application.",
+          "flatPath": "v1/apps/{appsId}:listRuntimes",
+          "httpMethod": "GET",
+          "id": "appengine.apps.listRuntimes",
+          "parameterOrder": [
+            "appsId"
+          ],
+          "parameters": {
+            "appsId": {
+              "description": "Part of `parent`. Required. Name of the parent Application resource. Example: apps/myapp.",
+              "location": "path",
+              "required": true,
+              "type": "string"
+            },
+            "environment": {
+              "description": "Optional. The environment of the Application.",
+              "enum": [
+                "ENVIRONMENT_UNSPECIFIED",
+                "STANDARD",
+                "FLEXIBLE"
+              ],
+              "enumDescriptions": [
+                "Default value.",
+                "App Engine Standard.",
+                "App Engine Flexible"
+              ],
+              "location": "query",
+              "type": "string"
+            }
+          },
+          "path": "v1/apps/{appsId}:listRuntimes",
+          "response": {
+            "$ref": "ListRuntimesResponse"
+          },
+          "scopes": [
+            "https://www.googleapis.com/auth/appengine.admin",
+            "https://www.googleapis.com/auth/cloud-platform",
+            "https://www.googleapis.com/auth/cloud-platform.read-only"
+          ]
+        },
         "patch": {
           "description": "Updates the specified Application resource. You can update the following fields: auth_domain - Google authentication domain for controlling user access to the application. default_cookie_expiration - Cookie expiration policy for the application. iap - Identity-Aware Proxy properties for the application.",
           "flatPath": "v1/apps/{appsId}",
@@ -1610,7 +1651,7 @@
       }
     }
   },
-  "revision": "20231024",
+  "revision": "20231030",
   "rootUrl": "https://appengine.googleapis.com/",
   "schemas": {
     "ApiConfigHandler": {
@@ -2096,6 +2137,28 @@
       },
       "type": "object"
     },
+    "Date": {
+      "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: A full date, with non-zero year, month, and day values. A month and day, with a zero year (for example, an anniversary). A year on its own, with a zero month and a zero day. A year and month, with a zero day (for example, a credit card expiration date).Related types: google.type.TimeOfDay google.type.DateTime google.protobuf.Timestamp",
+      "id": "Date",
+      "properties": {
+        "day": {
+          "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "month": {
+          "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "year": {
+          "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.",
+          "format": "int32",
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
     "DebugInstanceRequest": {
       "description": "Request message for Instances.DebugInstance.",
       "id": "DebugInstanceRequest",
@@ -2701,6 +2764,24 @@
       },
       "type": "object"
     },
+    "ListRuntimesResponse": {
+      "description": "Response message for Applications.ListRuntimes.",
+      "id": "ListRuntimesResponse",
+      "properties": {
+        "nextPageToken": {
+          "description": "Continuation token for fetching the next page of results.",
+          "type": "string"
+        },
+        "runtimes": {
+          "description": "The runtimes available to the requested application.",
+          "items": {
+            "$ref": "Runtime"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "ListServicesResponse": {
       "description": "Response message for Services.ListServices.",
       "id": "ListServicesResponse",
@@ -3431,6 +3512,74 @@
       },
       "type": "object"
     },
+    "Runtime": {
+      "description": "Runtime versions for App Engine.",
+      "id": "Runtime",
+      "properties": {
+        "decommissionedDate": {
+          "$ref": "Date",
+          "description": "Date when Runtime is decommissioned."
+        },
+        "deprecationDate": {
+          "$ref": "Date",
+          "description": "Date when Runtime is deprecated."
+        },
+        "endOfSupportDate": {
+          "$ref": "Date",
+          "description": "Date when Runtime is end of support."
+        },
+        "environment": {
+          "description": "The environment of the runtime.",
+          "enum": [
+            "ENVIRONMENT_UNSPECIFIED",
+            "STANDARD",
+            "FLEXIBLE"
+          ],
+          "enumDescriptions": [
+            "Default value.",
+            "App Engine Standard.",
+            "App Engine Flexible"
+          ],
+          "type": "string"
+        },
+        "name": {
+          "description": "The name of the runtime, e.g., 'go113', 'nodejs12', etc.",
+          "type": "string"
+        },
+        "stage": {
+          "description": "The stage of life this runtime is in, e.g., BETA, GA, etc.",
+          "enum": [
+            "RUNTIME_STAGE_UNSPECIFIED",
+            "DEVELOPMENT",
+            "ALPHA",
+            "BETA",
+            "GA",
+            "DEPRECATED",
+            "DECOMMISSIONED",
+            "END_OF_SUPPORT"
+          ],
+          "enumDescriptions": [
+            "Not specified.",
+            "The runtime is in development.",
+            "The runtime is in the Alpha stage.",
+            "The runtime is in the Beta stage.",
+            "The runtime is generally available.",
+            "The runtime is deprecated.",
+            "The runtime is no longer supported.",
+            "The runtime is end of support."
+          ],
+          "type": "string"
+        },
+        "warnings": {
+          "description": "Warning messages, e.g., a deprecation warning.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "ScriptHandler": {
       "description": "Executes a script to handle the request that matches the URL pattern.",
       "id": "ScriptHandler",

diff --git a/googleapiclient/discovery_cache/documents/appengine.v1beta.json b/googleapiclient/discovery_cache/documents/appengine.v1beta.json
@@ -1859,7 +1859,7 @@
       }
     }
   },
-  "revision": "20231024",
+  "revision": "20231030",
   "rootUrl": "https://appengine.googleapis.com/",
   "schemas": {
     "ApiConfigHandler": {