Blame - docs/dyn/remotebuildexecution_v1alpha.projects.instances.html - platform/external/python/google-api-python-client

2020-10-06 16:46:05 -0700

[diff] [blame]

83

<code><a href="#close">close()</a></code></p>

84

<p class="firstline">Close httplib2 connections.</p>

85

Dan O'Meara

dd49464

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

[diff] [blame]

86

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

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

87

<p class="firstline">Creates a new instance in the specified region. Returns a long running operation which contains an instance on completion. While the long running operation is in progress, any call to `GetInstance` returns an instance in state `CREATING`.</p>

Bu Sun Kim

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

[diff] [blame]

88

89

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

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

90

<p class="firstline">Deletes the specified instance. Returns a long running operation which contains a `google.protobuf.Empty` response on completion. Deleting an instance with worker pools in it will delete these worker pools.</p>

Bu Sun Kim

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

[diff] [blame]

91

92

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

93

<p class="firstline">Returns the specified instance.</p>

94

95

<code><a href="#list">list(parent, x__xgafv=None)</a></code></p>

96

<p class="firstline">Lists instances in a project.</p>

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

97

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

98

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

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

99

<p class="firstline">Updates the specified instance. Returns a long running operation which contains the updated instance in the response on completion.</p>

Bu Sun Kim

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

[diff] [blame]

100

<h3>Method Details</h3>

101

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

102

<code class="details" id="close">close()</code>

103

<pre>Close httplib2 connections.</pre>

</div>

Dan O'Meara

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

[diff] [blame]

107

<code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

108

<pre>Creates a new instance in the specified region. Returns a long running operation which contains an instance on completion. While the long running operation is in progress, any call to `GetInstance` returns an instance in state `CREATING`.

Bu Sun Kim

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

[diff] [blame]

109

110

Args:

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

111

parent: string, Resource name of the project containing the instance. Format: `projects/[PROJECT_ID]`. (required)

Dan O'Meara

dd49464

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

[diff] [blame]

112

body: object, The request body.

Bu Sun Kim

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

[diff] [blame]

113

The object takes the form of:

114

115

{ # The request used for `CreateInstance`.

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

116

"instanceId": "A String", # ID of the created instance. A valid `instance_id` must: be 6-50 characters long, contain only lowercase letters, digits, hyphens and underscores, start with a lowercase letter, and end with a lowercase letter or a digit.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

117

"parent": "A String", # Resource name of the project containing the instance. Format: `projects/[PROJECT_ID]`.

118

"instance": { # Instance conceptually encapsulates all Remote Build Execution resources for remote builds. An instance consists of storage and compute resources (for example, `ContentAddressableStorage`, `ActionCache`, `WorkerPools`) used for running remote builds. All Remote Build Execution API calls are scoped to an instance. # Specifies the instance to create. The name in the instance, if specified in the instance, is ignored.

119

"location": "A String", # The location is a GCP region. Currently only `us-central1` is supported.

120

"name": "A String", # Output only. Instance resource name formatted as: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. Name should not be populated when creating an instance since it is provided in the `instance_id` field.

121

"featurePolicy": { # FeaturePolicy defines features allowed to be used on RBE instances, as well as instance-wide behavior changes that take effect without opt-in or opt-out at usage time. # The policy to define whether or not RBE features can be used or how they can be used.

122

"dockerPrivileged": { # Defines whether a feature can be used or what values are accepted. # Whether dockerPrivileged can be used.

123

"policy": "A String", # The policy of the feature.

124

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"containerImageSources": { # Defines whether a feature can be used or what values are accepted. # Which container image sources are allowed. Currently only RBE-supported registry (gcr.io) is allowed. One can allow all repositories under a project or one specific repository only. E.g. container_image_sources { policy: RESTRICTED allowed_values: [ "gcr.io/project-foo", "gcr.io/project-bar/repo-baz", ] } will allow any repositories under "gcr.io/project-foo" plus the repository "gcr.io/project-bar/repo-baz". Default (UNSPECIFIED) is equivalent to any source is allowed.

129

"policy": "A String", # The policy of the feature.

130

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerAddCapabilities": { # Defines whether a feature can be used or what values are accepted. # Whether dockerAddCapabilities can be used or what capabilities are allowed.

135

"policy": "A String", # The policy of the feature.

136

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerRuntime": { # Defines whether a feature can be used or what values are accepted. # Whether dockerRuntime is allowed to be set or what runtimes are allowed. Note linux_isolation takes precedence, and if set, docker_runtime values may be rejected if they are incompatible with the selected isolation.

141

"policy": "A String", # The policy of the feature.

142

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerChrootPath": { # Defines whether a feature can be used or what values are accepted. # Whether dockerChrootPath can be used.

147

"policy": "A String", # The policy of the feature.

148

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerSiblingContainers": { # Defines whether a feature can be used or what values are accepted. # Whether dockerSiblingContainers can be used.

153

"policy": "A String", # The policy of the feature.

154

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerRunAsRoot": { # Defines whether a feature can be used or what values are accepted. # Whether dockerRunAsRoot can be used.

159

"policy": "A String", # The policy of the feature.

160

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerNetwork": { # Defines whether a feature can be used or what values are accepted. # Whether dockerNetwork can be used or what network modes are allowed. E.g. one may allow `off` value only via `allowed_values`.

165

"policy": "A String", # The policy of the feature.

166

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"linuxIsolation": "A String", # linux_isolation allows overriding the docker runtime used for containers started on Linux.

171

},

172

"state": "A String", # Output only. State of the instance.

173

"loggingEnabled": True or False, # Output only. Whether stack driver logging is enabled for the instance.

174

},

Bu Sun Kim

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

[diff] [blame]

175

}

176

177

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

184

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

185

{ # This resource represents a long-running operation that is the result of a network API call.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

186

"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}`.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

187

"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 `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`.

188

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

189

},

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

190

"error": { # 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.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

191

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

192

"message": "A String", # 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.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

193

"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.

Bu Sun Kim

4ed7d3f

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

[diff] [blame]

194

{

195

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

196

},

197

],

Bu Sun Kim

d059ad8

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

[diff] [blame]

198

},

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

199

"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.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

200

"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.

201

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

202

},

Bu Sun Kim

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

[diff] [blame]

}</pre>

</div>

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

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

208

<pre>Deletes the specified instance. Returns a long running operation which contains a `google.protobuf.Empty` response on completion. Deleting an instance with worker pools in it will delete these worker pools.

Bu Sun Kim

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

[diff] [blame]

209

210

Args:

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

211

name: string, Name of the instance to delete. Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. (required)

Bu Sun Kim

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

[diff] [blame]

212

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

219

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

220

{ # This resource represents a long-running operation that is the result of a network API call.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

221

"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}`.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

222

"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 `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`.

223

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

224

},

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

225

"error": { # 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.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

226

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

227

"message": "A String", # 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.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

228

"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.

Bu Sun Kim

4ed7d3f

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

[diff] [blame]

229

{

230

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

231

},

232

],

Bu Sun Kim

d059ad8

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

[diff] [blame]

233

},

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

234

"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.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

235

"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.

236

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

237

},

Bu Sun Kim

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

[diff] [blame]

}</pre>

</div>

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

243

<pre>Returns the specified instance.

244

245

Args:

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

246

name: string, Name of the instance to retrieve. Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. (required)

Bu Sun Kim

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

[diff] [blame]

247

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

254

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

255

{ # Instance conceptually encapsulates all Remote Build Execution resources for remote builds. An instance consists of storage and compute resources (for example, `ContentAddressableStorage`, `ActionCache`, `WorkerPools`) used for running remote builds. All Remote Build Execution API calls are scoped to an instance.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

256

"location": "A String", # The location is a GCP region. Currently only `us-central1` is supported.

257

"name": "A String", # Output only. Instance resource name formatted as: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. Name should not be populated when creating an instance since it is provided in the `instance_id` field.

258

"featurePolicy": { # FeaturePolicy defines features allowed to be used on RBE instances, as well as instance-wide behavior changes that take effect without opt-in or opt-out at usage time. # The policy to define whether or not RBE features can be used or how they can be used.

259

"dockerPrivileged": { # Defines whether a feature can be used or what values are accepted. # Whether dockerPrivileged can be used.

260

"policy": "A String", # The policy of the feature.

261

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

262

"A String",

263

],

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

264

},

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

265

"containerImageSources": { # Defines whether a feature can be used or what values are accepted. # Which container image sources are allowed. Currently only RBE-supported registry (gcr.io) is allowed. One can allow all repositories under a project or one specific repository only. E.g. container_image_sources { policy: RESTRICTED allowed_values: [ "gcr.io/project-foo", "gcr.io/project-bar/repo-baz", ] } will allow any repositories under "gcr.io/project-foo" plus the repository "gcr.io/project-bar/repo-baz". Default (UNSPECIFIED) is equivalent to any source is allowed.

266

"policy": "A String", # The policy of the feature.

267

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerAddCapabilities": { # Defines whether a feature can be used or what values are accepted. # Whether dockerAddCapabilities can be used or what capabilities are allowed.

272

"policy": "A String", # The policy of the feature.

273

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerRuntime": { # Defines whether a feature can be used or what values are accepted. # Whether dockerRuntime is allowed to be set or what runtimes are allowed. Note linux_isolation takes precedence, and if set, docker_runtime values may be rejected if they are incompatible with the selected isolation.

278

"policy": "A String", # The policy of the feature.

279

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerChrootPath": { # Defines whether a feature can be used or what values are accepted. # Whether dockerChrootPath can be used.

284

"policy": "A String", # The policy of the feature.

285

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerSiblingContainers": { # Defines whether a feature can be used or what values are accepted. # Whether dockerSiblingContainers can be used.

290

"policy": "A String", # The policy of the feature.

291

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerRunAsRoot": { # Defines whether a feature can be used or what values are accepted. # Whether dockerRunAsRoot can be used.

296

"policy": "A String", # The policy of the feature.

297

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerNetwork": { # Defines whether a feature can be used or what values are accepted. # Whether dockerNetwork can be used or what network modes are allowed. E.g. one may allow `off` value only via `allowed_values`.

302

"policy": "A String", # The policy of the feature.

303

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"linuxIsolation": "A String", # linux_isolation allows overriding the docker runtime used for containers started on Linux.

308

},

309

"state": "A String", # Output only. State of the instance.

310

"loggingEnabled": True or False, # Output only. Whether stack driver logging is enabled for the instance.

311

}</pre>

Bu Sun Kim

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

[diff] [blame]

</div>

<code class="details" id="list">list(parent, x__xgafv=None)</code>

316

<pre>Lists instances in a project.

317

318

Args:

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

319

parent: string, Resource name of the project. Format: `projects/[PROJECT_ID]`. (required)

Bu Sun Kim

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

[diff] [blame]

320

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

327

328

{

Bu Sun Kim

6502091

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

[diff] [blame]

329

"instances": [ # The list of instances in a given project.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

330

{ # Instance conceptually encapsulates all Remote Build Execution resources for remote builds. An instance consists of storage and compute resources (for example, `ContentAddressableStorage`, `ActionCache`, `WorkerPools`) used for running remote builds. All Remote Build Execution API calls are scoped to an instance.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

331

"location": "A String", # The location is a GCP region. Currently only `us-central1` is supported.

332

"name": "A String", # Output only. Instance resource name formatted as: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. Name should not be populated when creating an instance since it is provided in the `instance_id` field.

333

"featurePolicy": { # FeaturePolicy defines features allowed to be used on RBE instances, as well as instance-wide behavior changes that take effect without opt-in or opt-out at usage time. # The policy to define whether or not RBE features can be used or how they can be used.

334

"dockerPrivileged": { # Defines whether a feature can be used or what values are accepted. # Whether dockerPrivileged can be used.

335

"policy": "A String", # The policy of the feature.

336

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

337

"A String",

338

],

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

339

},

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

340

"containerImageSources": { # Defines whether a feature can be used or what values are accepted. # Which container image sources are allowed. Currently only RBE-supported registry (gcr.io) is allowed. One can allow all repositories under a project or one specific repository only. E.g. container_image_sources { policy: RESTRICTED allowed_values: [ "gcr.io/project-foo", "gcr.io/project-bar/repo-baz", ] } will allow any repositories under "gcr.io/project-foo" plus the repository "gcr.io/project-bar/repo-baz". Default (UNSPECIFIED) is equivalent to any source is allowed.

341

"policy": "A String", # The policy of the feature.

342

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerAddCapabilities": { # Defines whether a feature can be used or what values are accepted. # Whether dockerAddCapabilities can be used or what capabilities are allowed.

347

"policy": "A String", # The policy of the feature.

348

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerRuntime": { # Defines whether a feature can be used or what values are accepted. # Whether dockerRuntime is allowed to be set or what runtimes are allowed. Note linux_isolation takes precedence, and if set, docker_runtime values may be rejected if they are incompatible with the selected isolation.

353

"policy": "A String", # The policy of the feature.

354

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerChrootPath": { # Defines whether a feature can be used or what values are accepted. # Whether dockerChrootPath can be used.

359

"policy": "A String", # The policy of the feature.

360

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerSiblingContainers": { # Defines whether a feature can be used or what values are accepted. # Whether dockerSiblingContainers can be used.

365

"policy": "A String", # The policy of the feature.

366

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerRunAsRoot": { # Defines whether a feature can be used or what values are accepted. # Whether dockerRunAsRoot can be used.

371

"policy": "A String", # The policy of the feature.

372

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerNetwork": { # Defines whether a feature can be used or what values are accepted. # Whether dockerNetwork can be used or what network modes are allowed. E.g. one may allow `off` value only via `allowed_values`.

377

"policy": "A String", # The policy of the feature.

378

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"linuxIsolation": "A String", # linux_isolation allows overriding the docker runtime used for containers started on Linux.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

383

},

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

384

"state": "A String", # Output only. State of the instance.

385

"loggingEnabled": True or False, # Output only. Whether stack driver logging is enabled for the instance.

386

},

Bu Sun Kim

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

[diff] [blame]

],

}</pre>

</div>

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

391

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

392

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

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

393

<pre>Updates the specified instance. Returns a long running operation which contains the updated instance in the response on completion.

394

395

Args:

396

name: string, Output only. Instance resource name formatted as: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. Name should not be populated when creating an instance since it is provided in the `instance_id` field. (required)

397

body: object, The request body.

398

The object takes the form of:

399

400

{ # Instance conceptually encapsulates all Remote Build Execution resources for remote builds. An instance consists of storage and compute resources (for example, `ContentAddressableStorage`, `ActionCache`, `WorkerPools`) used for running remote builds. All Remote Build Execution API calls are scoped to an instance.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

401

"location": "A String", # The location is a GCP region. Currently only `us-central1` is supported.

402

"name": "A String", # Output only. Instance resource name formatted as: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. Name should not be populated when creating an instance since it is provided in the `instance_id` field.

403

"featurePolicy": { # FeaturePolicy defines features allowed to be used on RBE instances, as well as instance-wide behavior changes that take effect without opt-in or opt-out at usage time. # The policy to define whether or not RBE features can be used or how they can be used.

404

"dockerPrivileged": { # Defines whether a feature can be used or what values are accepted. # Whether dockerPrivileged can be used.

405

"policy": "A String", # The policy of the feature.

406

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

407

"A String",

408

],

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

409

},

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

410

"containerImageSources": { # Defines whether a feature can be used or what values are accepted. # Which container image sources are allowed. Currently only RBE-supported registry (gcr.io) is allowed. One can allow all repositories under a project or one specific repository only. E.g. container_image_sources { policy: RESTRICTED allowed_values: [ "gcr.io/project-foo", "gcr.io/project-bar/repo-baz", ] } will allow any repositories under "gcr.io/project-foo" plus the repository "gcr.io/project-bar/repo-baz". Default (UNSPECIFIED) is equivalent to any source is allowed.

411

"policy": "A String", # The policy of the feature.

412

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerAddCapabilities": { # Defines whether a feature can be used or what values are accepted. # Whether dockerAddCapabilities can be used or what capabilities are allowed.

417

"policy": "A String", # The policy of the feature.

418

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerRuntime": { # Defines whether a feature can be used or what values are accepted. # Whether dockerRuntime is allowed to be set or what runtimes are allowed. Note linux_isolation takes precedence, and if set, docker_runtime values may be rejected if they are incompatible with the selected isolation.

423

"policy": "A String", # The policy of the feature.

424

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerChrootPath": { # Defines whether a feature can be used or what values are accepted. # Whether dockerChrootPath can be used.

429

"policy": "A String", # The policy of the feature.

430

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerSiblingContainers": { # Defines whether a feature can be used or what values are accepted. # Whether dockerSiblingContainers can be used.

435

"policy": "A String", # The policy of the feature.

436

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerRunAsRoot": { # Defines whether a feature can be used or what values are accepted. # Whether dockerRunAsRoot can be used.

441

"policy": "A String", # The policy of the feature.

442

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"dockerNetwork": { # Defines whether a feature can be used or what values are accepted. # Whether dockerNetwork can be used or what network modes are allowed. E.g. one may allow `off` value only via `allowed_values`.

447

"policy": "A String", # The policy of the feature.

448

"allowedValues": [ # A list of acceptable values. Only effective when the policy is `RESTRICTED`.

"A String",

],

},

"linuxIsolation": "A String", # linux_isolation allows overriding the docker runtime used for containers started on Linux.

453

},

454

"state": "A String", # Output only. State of the instance.

455

"loggingEnabled": True or False, # Output only. Whether stack driver logging is enabled for the instance.

456

}

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

457

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

458

loggingEnabled: boolean, Deprecated, use instance.logging_enabled instead. Whether to enable Stackdriver logging for this instance.

459

updateMask: string, The update mask applies to instance. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask If an empty update_mask is provided, only the non-default valued field in the worker pool field will be updated. Note that in order to update a field to the default value (zero, false, empty string) an explicit update_mask must be provided.

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

460

name1: string, Deprecated, use instance.Name instead. Name of the instance to update. Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

461

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

468

469

{ # This resource represents a long-running operation that is the result of a network API call.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

470

"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}`.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

471

"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 `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`.

472

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

473

},

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

474

"error": { # 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.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

475

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

476

"message": "A String", # 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.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

477

"details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.

478

{

479

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

480

},

481

],

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

482

},

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

483

"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.

Yoshi Automation Bot

2020-11-24 15:48:03 -0800

[diff] [blame^]

484

"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.

485

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

486

},

Dmitry Frenkel