Blame - docs/dyn/cloudshell_v1alpha1.users.environments.html - platform/external/python/google-api-python-client

2020-05-01 07:42:23 -0700

[diff] [blame]

83

<code><a href="#authorize">authorize(name, body=None, x__xgafv=None)</a></code></p>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

84

<p class="firstline">Sends OAuth credentials to a running environment on behalf of a user. When</p>

85

86

<code><a href="#get">get(name, x__xgafv=None)</a></code></p>

87

<p class="firstline">Gets an environment. Returns NOT_FOUND if the environment does not exist.</p>

88

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

89

<code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

90

<p class="firstline">Updates an existing environment.</p>

91

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

92

<code><a href="#start">start(name, body=None, x__xgafv=None)</a></code></p>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

93

<p class="firstline">Starts an existing environment, allowing clients to connect to it. The</p>

94

<h3>Method Details</h3>

95

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

96

<code class="details" id="authorize">authorize(name, body=None, x__xgafv=None)</code>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

97

<pre>Sends OAuth credentials to a running environment on behalf of a user. When

98

this completes, the environment will be authorized to run various Google

99

Cloud command line tools without requiring the user to manually

authenticate.

Args:

name: string, Name of the resource that should receive the credentials, for example

104

`users/me/environments/default` or

105

`users/someone@example.com/environments/default`. (required)

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

106

body: object, The request body.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

107

The object takes the form of:

108

109

{ # Request message for AuthorizeEnvironment.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

110

"expireTime": "A String", # The time when the credentials expire. If not set, defaults to one hour from

111

# when the server received the request.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

112

"accessToken": "A String", # The OAuth access token that should be sent to the environment.

113

"idToken": "A String", # The OAuth ID token that should be sent to the environment.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

114

}

115

116

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

123

124

{ # A generic empty message that you can re-use to avoid defining duplicated

125

# empty messages in your APIs. A typical example is to use it as the request

126

# or the response type of an API method. For instance:

127

#

128

# service Foo {

129

# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);

130

# }

131

#

132

# The JSON representation for `Empty` is empty JSON object `{}`.

}</pre>

</div>

<code class="details" id="get">get(name, x__xgafv=None)</code>

138

<pre>Gets an environment. Returns NOT_FOUND if the environment does not exist.

139

140

Args:

141

name: string, Name of the requested resource, for example `users/me/environments/default`

142

or `users/someone@example.com/environments/default`. (required)

143

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

150

151

{ # A Cloud Shell environment, which is defined as the combination of a Docker

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

152

# image specifying what is installed on the environment and a home directory

153

# containing the user's data that will remain across sessions. Each user has a

154

# single environment with the ID "default".

155

"sshPort": 42, # Output only. Port to which clients can connect to initiate SSH sessions

156

# with the environment.

157

"webHost": "A String", # Output only. Host to which clients can connect to initiate HTTPS or WSS

158

# connections with the environment.

159

"webPorts": [ # Output only. Ports to which clients can connect to initiate HTTPS or WSS

160

# connections with the environment.

161

42,

162

],

163

"id": "A String", # Output only. The environment's identifier, unique among the user's

164

# environments.

165

"size": "A String", # Indicates the size of the backing VM running the environment. If set to

166

# something other than DEFAULT, it will be reverted to the default VM size

167

# after vm_size_expire_time.

168

"sshHost": "A String", # Output only. Host to which clients can connect to initiate SSH sessions

169

# with the environment.

170

"publicKeys": [ # Output only. Public keys associated with the environment. Clients can

171

# connect to this environment via SSH only if they possess a private key

172

# corresponding to at least one of these public keys. Keys can be added to or

173

# removed from the environment using the CreatePublicKey and DeletePublicKey

174

# methods.

175

{ # A public SSH key, corresponding to a private SSH key held by the client.

176

"format": "A String", # Required. Format of this key's content.

177

"name": "A String", # Output only. Full name of this resource, in the format

178

# `users/{owner_email}/environments/{environment_id}/publicKeys/{key_id}`.

179

# `{owner_email}` is the email address of the user to whom the key belongs.

180

# `{environment_id}` is the identifier of the environment to which the key

181

# grants access. `{key_id}` is the unique identifier of the key. For example,

182

# `users/someone@example.com/environments/default/publicKeys/myKey`.

183

"key": "A String", # Required. Content of this key.

184

},

185

],

186

"vmSizeExpireTime": "A String", # Output only. The time when the Environment will expire back to the default

187

# VM size.

188

"sshUsername": "A String", # Output only. Username that clients should use when initiating SSH sessions

189

# with the environment.

190

"state": "A String", # Output only. Current execution state of this environment.

191

"name": "A String", # Output only. Full name of this resource, in the format

192

# `users/{owner_email}/environments/{environment_id}`. `{owner_email}` is the

193

# email address of the user to whom this environment belongs, and

194

# `{environment_id}` is the identifier of this environment. For example,

195

# `users/someone@example.com/environments/default`.

196

"dockerImage": "A String", # Required. Full path to the Docker image used to run this environment, e.g.

197

# "gcr.io/dev-con/cloud-devshell:latest".

198

}</pre>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

</div>

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

202

<code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

203

<pre>Updates an existing environment.

204

205

Args:

206

name: string, Name of the resource to be updated, for example

207

`users/me/environments/default` or

208

`users/someone@example.com/environments/default`. (required)

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

209

body: object, The request body.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

210

The object takes the form of:

211

212

{ # A Cloud Shell environment, which is defined as the combination of a Docker

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

213

# image specifying what is installed on the environment and a home directory

214

# containing the user's data that will remain across sessions. Each user has a

215

# single environment with the ID "default".

216

"sshPort": 42, # Output only. Port to which clients can connect to initiate SSH sessions

217

# with the environment.

218

"webHost": "A String", # Output only. Host to which clients can connect to initiate HTTPS or WSS

219

# connections with the environment.

220

"webPorts": [ # Output only. Ports to which clients can connect to initiate HTTPS or WSS

221

# connections with the environment.

222

42,

223

],

224

"id": "A String", # Output only. The environment's identifier, unique among the user's

225

# environments.

226

"size": "A String", # Indicates the size of the backing VM running the environment. If set to

227

# something other than DEFAULT, it will be reverted to the default VM size

228

# after vm_size_expire_time.

229

"sshHost": "A String", # Output only. Host to which clients can connect to initiate SSH sessions

230

# with the environment.

231

"publicKeys": [ # Output only. Public keys associated with the environment. Clients can

232

# connect to this environment via SSH only if they possess a private key

233

# corresponding to at least one of these public keys. Keys can be added to or

234

# removed from the environment using the CreatePublicKey and DeletePublicKey

235

# methods.

236

{ # A public SSH key, corresponding to a private SSH key held by the client.

237

"format": "A String", # Required. Format of this key's content.

238

"name": "A String", # Output only. Full name of this resource, in the format

239

# `users/{owner_email}/environments/{environment_id}/publicKeys/{key_id}`.

240

# `{owner_email}` is the email address of the user to whom the key belongs.

241

# `{environment_id}` is the identifier of the environment to which the key

242

# grants access. `{key_id}` is the unique identifier of the key. For example,

243

# `users/someone@example.com/environments/default/publicKeys/myKey`.

244

"key": "A String", # Required. Content of this key.

245

},

246

],

247

"vmSizeExpireTime": "A String", # Output only. The time when the Environment will expire back to the default

248

# VM size.

249

"sshUsername": "A String", # Output only. Username that clients should use when initiating SSH sessions

250

# with the environment.

251

"state": "A String", # Output only. Current execution state of this environment.

252

"name": "A String", # Output only. Full name of this resource, in the format

253

# `users/{owner_email}/environments/{environment_id}`. `{owner_email}` is the

254

# email address of the user to whom this environment belongs, and

255

# `{environment_id}` is the identifier of this environment. For example,

256

# `users/someone@example.com/environments/default`.

257

"dockerImage": "A String", # Required. Full path to the Docker image used to run this environment, e.g.

258

# "gcr.io/dev-con/cloud-devshell:latest".

259

}

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

260

261

updateMask: string, Mask specifying which fields in the environment should be updated.

262

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

269

270

{ # A Cloud Shell environment, which is defined as the combination of a Docker

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

271

# image specifying what is installed on the environment and a home directory

272

# containing the user's data that will remain across sessions. Each user has a

273

# single environment with the ID "default".

274

"sshPort": 42, # Output only. Port to which clients can connect to initiate SSH sessions

275

# with the environment.

276

"webHost": "A String", # Output only. Host to which clients can connect to initiate HTTPS or WSS

277

# connections with the environment.

278

"webPorts": [ # Output only. Ports to which clients can connect to initiate HTTPS or WSS

279

# connections with the environment.

280

42,

281

],

282

"id": "A String", # Output only. The environment's identifier, unique among the user's

283

# environments.

284

"size": "A String", # Indicates the size of the backing VM running the environment. If set to

285

# something other than DEFAULT, it will be reverted to the default VM size

286

# after vm_size_expire_time.

287

"sshHost": "A String", # Output only. Host to which clients can connect to initiate SSH sessions

288

# with the environment.

289

"publicKeys": [ # Output only. Public keys associated with the environment. Clients can

290

# connect to this environment via SSH only if they possess a private key

291

# corresponding to at least one of these public keys. Keys can be added to or

292

# removed from the environment using the CreatePublicKey and DeletePublicKey

293

# methods.

294

{ # A public SSH key, corresponding to a private SSH key held by the client.

295

"format": "A String", # Required. Format of this key's content.

296

"name": "A String", # Output only. Full name of this resource, in the format

297

# `users/{owner_email}/environments/{environment_id}/publicKeys/{key_id}`.

298

# `{owner_email}` is the email address of the user to whom the key belongs.

299

# `{environment_id}` is the identifier of the environment to which the key

300

# grants access. `{key_id}` is the unique identifier of the key. For example,

301

# `users/someone@example.com/environments/default/publicKeys/myKey`.

302

"key": "A String", # Required. Content of this key.

303

},

304

],

305

"vmSizeExpireTime": "A String", # Output only. The time when the Environment will expire back to the default

306

# VM size.

307

"sshUsername": "A String", # Output only. Username that clients should use when initiating SSH sessions

308

# with the environment.

309

"state": "A String", # Output only. Current execution state of this environment.

310

"name": "A String", # Output only. Full name of this resource, in the format

311

# `users/{owner_email}/environments/{environment_id}`. `{owner_email}` is the

312

# email address of the user to whom this environment belongs, and

313

# `{environment_id}` is the identifier of this environment. For example,

314

# `users/someone@example.com/environments/default`.

315

"dockerImage": "A String", # Required. Full path to the Docker image used to run this environment, e.g.

316

# "gcr.io/dev-con/cloud-devshell:latest".

317

}</pre>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

</div>

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

321

<code class="details" id="start">start(name, body=None, x__xgafv=None)</code>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

322

<pre>Starts an existing environment, allowing clients to connect to it. The

323

returned operation will contain an instance of StartEnvironmentMetadata in

324

its metadata field. Users can wait for the environment to start by polling

325

this operation via GetOperation. Once the environment has finished starting

326

and is ready to accept connections, the operation will contain a

327

StartEnvironmentResponse in its response field.

328

329

Args:

330

name: string, Name of the resource that should be started, for example

331

`users/me/environments/default` or

332

`users/someone@example.com/environments/default`. (required)

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

333

body: object, The request body.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

334

The object takes the form of:

335

336

{ # Request message for StartEnvironment.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

337

"publicKeys": [ # Public keys that should be added to the environment before it is started.

338

{ # A public SSH key, corresponding to a private SSH key held by the client.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

339

"format": "A String", # Required. Format of this key's content.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

340

"name": "A String", # Output only. Full name of this resource, in the format

341

# `users/{owner_email}/environments/{environment_id}/publicKeys/{key_id}`.

342

# `{owner_email}` is the email address of the user to whom the key belongs.

343

# `{environment_id}` is the identifier of the environment to which the key

344

# grants access. `{key_id}` is the unique identifier of the key. For example,

345

# `users/someone@example.com/environments/default/publicKeys/myKey`.

346

"key": "A String", # Required. Content of this key.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

347

},

348

],

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

349

"accessToken": "A String", # The initial access token passed to the environment. If this is present and

350

# valid, the environment will be pre-authenticated with gcloud so that the

351

# user can run gcloud commands in Cloud Shell without having to log in. This

352

# code can be updated later by calling AuthorizeEnvironment.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

353

}

354

355

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

362

363

{ # This resource represents a long-running operation that is the result of a

364

# network API call.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

365

"error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.

366

# different programming environments, including REST APIs and RPC APIs. It is

367

# used by [gRPC](https://github.com/grpc). Each `Status` message contains

368

# three pieces of data: error code, error message, and error details.

369

#

370

# You can find out more about this error model and how to work with it in the

371

# [API Design Guide](https://cloud.google.com/apis/design/errors).

372

"details": [ # A list of messages that carry the error details. There is a common set of

373

# message types for APIs to use.

374

{

375

"a_key": "", # Properties of the object. Contains field @type with type URL.

376

},

377

],

378

"code": 42, # The status code, which should be an enum value of google.rpc.Code.

379

"message": "A String", # A developer-facing error message, which should be in English. Any

380

# user-facing error message should be localized and sent in the

381

# google.rpc.Status.details field, or localized by the client.

382

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

383

"name": "A String", # The server-assigned name, which is only unique within the same service that

384

# originally returns it. If you use the default HTTP mapping, the

385

# `name` should be a resource name ending with `operations/{unique_id}`.

386

"done": True or False, # If the value is `false`, it means the operation is still in progress.

387

# If `true`, the operation is completed, and either `error` or `response` is

388

# available.

Bu Sun Kim

4ed7d3f

2020-05-27 12:20:54 -0700

[diff] [blame]

389

"metadata": { # Service-specific metadata associated with the operation. It typically

390

# contains progress information and common metadata such as create time.

391

# Some services might not provide such metadata. Any method that returns a

392

# long-running operation should document the metadata type, if any.

393

"a_key": "", # Properties of the object. Contains field @type with type URL.

394

},

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

395

"response": { # The normal response of the operation in case of success. If the original

396

# method returns no data on success, such as `Delete`, the response is

397

# `google.protobuf.Empty`. If the original method is standard

398

# `Get`/`Create`/`Update`, the response should be the resource. For other

399

# methods, the response should have the type `XxxResponse`, where `Xxx`

400

# is the original method name. For example, if the original method name

401

# is `TakeSnapshot()`, the inferred response type is

402

# `TakeSnapshotResponse`.

403

"a_key": "", # Properties of the object. Contains field @type with type URL.

404

},

Bu Sun Kim