chore: regens API reference docs (#889)
diff --git a/docs/dyn/cloudshell_v1alpha1.users.environments.html b/docs/dyn/cloudshell_v1alpha1.users.environments.html
index f215a96..26b37cd 100644
--- a/docs/dyn/cloudshell_v1alpha1.users.environments.html
+++ b/docs/dyn/cloudshell_v1alpha1.users.environments.html
@@ -80,20 +80,20 @@
<p class="firstline">Returns the publicKeys Resource.</p>
<p class="toc_element">
- <code><a href="#authorize">authorize(name, body, x__xgafv=None)</a></code></p>
+ <code><a href="#authorize">authorize(name, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Sends OAuth credentials to a running environment on behalf of a user. When</p>
<p class="toc_element">
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Gets an environment. Returns NOT_FOUND if the environment does not exist.</p>
<p class="toc_element">
- <code><a href="#patch">patch(name, body, updateMask=None, x__xgafv=None)</a></code></p>
+ <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
<p class="firstline">Updates an existing environment.</p>
<p class="toc_element">
- <code><a href="#start">start(name, body, x__xgafv=None)</a></code></p>
+ <code><a href="#start">start(name, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Starts an existing environment, allowing clients to connect to it. The</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="authorize">authorize(name, body, x__xgafv=None)</code>
+ <code class="details" id="authorize">authorize(name, body=None, x__xgafv=None)</code>
<pre>Sends OAuth credentials to a running environment on behalf of a user. When
this completes, the environment will be authorized to run various Google
Cloud command line tools without requiring the user to manually
@@ -103,7 +103,7 @@
name: string, Name of the resource that should receive the credentials, for example
`users/me/environments/default` or
`users/someone@example.com/environments/default`. (required)
- body: object, The request body. (required)
+ body: object, The request body.
The object takes the form of:
{ # Request message for AuthorizeEnvironment.
@@ -157,6 +157,10 @@
# email address of the user to whom this environment belongs, and
# `{environment_id}` is the identifier of this environment. For example,
# `users/someone@example.com/environments/default`.
+ "webHost": "A String", # Output only. Host to which clients can connect to initiate HTTPS or WSS
+ # connections with the environment.
+ "vmSizeExpireTime": "A String", # Output only. The time when the Environment will expire back to the default
+ # VM size.
"dockerImage": "A String", # Required. Full path to the Docker image used to run this environment, e.g.
# "gcr.io/dev-con/cloud-devshell:latest".
"publicKeys": [ # Output only. Public keys associated with the environment. Clients can
@@ -182,19 +186,27 @@
# with the environment.
"sshUsername": "A String", # Output only. Username that clients should use when initiating SSH sessions
# with the environment.
- "id": "A String", # Output only. The environment's identifier, which is always "default".
+ "webPorts": [ # Output only. Ports to which clients can connect to initiate HTTPS or WSS
+ # connections with the environment.
+ 42,
+ ],
+ "id": "A String", # Output only. The environment's identifier, unique among the user's
+ # environments.
+ "size": "A String", # Indicates the size of the backing VM running the environment. If set to
+ # something other than DEFAULT, it will be reverted to the default VM size
+ # after vm_size_expire_time.
}</pre>
</div>
<div class="method">
- <code class="details" id="patch">patch(name, body, updateMask=None, x__xgafv=None)</code>
+ <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
<pre>Updates an existing environment.
Args:
name: string, Name of the resource to be updated, for example
`users/me/environments/default` or
`users/someone@example.com/environments/default`. (required)
- body: object, The request body. (required)
+ body: object, The request body.
The object takes the form of:
{ # A Cloud Shell environment, which is defined as the combination of a Docker
@@ -206,6 +218,10 @@
# email address of the user to whom this environment belongs, and
# `{environment_id}` is the identifier of this environment. For example,
# `users/someone@example.com/environments/default`.
+ "webHost": "A String", # Output only. Host to which clients can connect to initiate HTTPS or WSS
+ # connections with the environment.
+ "vmSizeExpireTime": "A String", # Output only. The time when the Environment will expire back to the default
+ # VM size.
"dockerImage": "A String", # Required. Full path to the Docker image used to run this environment, e.g.
# "gcr.io/dev-con/cloud-devshell:latest".
"publicKeys": [ # Output only. Public keys associated with the environment. Clients can
@@ -231,7 +247,15 @@
# with the environment.
"sshUsername": "A String", # Output only. Username that clients should use when initiating SSH sessions
# with the environment.
- "id": "A String", # Output only. The environment's identifier, which is always "default".
+ "webPorts": [ # Output only. Ports to which clients can connect to initiate HTTPS or WSS
+ # connections with the environment.
+ 42,
+ ],
+ "id": "A String", # Output only. The environment's identifier, unique among the user's
+ # environments.
+ "size": "A String", # Indicates the size of the backing VM running the environment. If set to
+ # something other than DEFAULT, it will be reverted to the default VM size
+ # after vm_size_expire_time.
}
updateMask: string, Mask specifying which fields in the environment should be updated.
@@ -252,6 +276,10 @@
# email address of the user to whom this environment belongs, and
# `{environment_id}` is the identifier of this environment. For example,
# `users/someone@example.com/environments/default`.
+ "webHost": "A String", # Output only. Host to which clients can connect to initiate HTTPS or WSS
+ # connections with the environment.
+ "vmSizeExpireTime": "A String", # Output only. The time when the Environment will expire back to the default
+ # VM size.
"dockerImage": "A String", # Required. Full path to the Docker image used to run this environment, e.g.
# "gcr.io/dev-con/cloud-devshell:latest".
"publicKeys": [ # Output only. Public keys associated with the environment. Clients can
@@ -277,12 +305,20 @@
# with the environment.
"sshUsername": "A String", # Output only. Username that clients should use when initiating SSH sessions
# with the environment.
- "id": "A String", # Output only. The environment's identifier, which is always "default".
+ "webPorts": [ # Output only. Ports to which clients can connect to initiate HTTPS or WSS
+ # connections with the environment.
+ 42,
+ ],
+ "id": "A String", # Output only. The environment's identifier, unique among the user's
+ # environments.
+ "size": "A String", # Indicates the size of the backing VM running the environment. If set to
+ # something other than DEFAULT, it will be reverted to the default VM size
+ # after vm_size_expire_time.
}</pre>
</div>
<div class="method">
- <code class="details" id="start">start(name, body, x__xgafv=None)</code>
+ <code class="details" id="start">start(name, body=None, x__xgafv=None)</code>
<pre>Starts an existing environment, allowing clients to connect to it. The
returned operation will contain an instance of StartEnvironmentMetadata in
its metadata field. Users can wait for the environment to start by polling
@@ -294,7 +330,7 @@
name: string, Name of the resource that should be started, for example
`users/me/environments/default` or
`users/someone@example.com/environments/default`. (required)
- body: object, The request body. (required)
+ body: object, The request body.
The object takes the form of:
{ # Request message for StartEnvironment.
@@ -314,6 +350,15 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
+ "metadata": { # 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.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "done": 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.
"response": { # The normal response of the operation in case of success. If the original
# method returns no data on success, such as `Delete`, the response is
# `google.protobuf.Empty`. If the original method is standard
@@ -324,15 +369,6 @@
# `TakeSnapshotResponse`.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
- "metadata": { # 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.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- "done": 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.
"name": "A String", # 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}`.