Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / d059ad881c7ae58c67931c48788d0bd7343ab16c / . / docs / dyn / remotebuildexecution_v1alpha.projects.instances.html
blob: 3bfead7dc7c95cbe0f899f488df9f9bf07158e92 [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="remotebuildexecution_v1alpha.html">Remote Build Execution API</a> . <a href="remotebuildexecution_v1alpha.projects.html">projects</a> . <a href="remotebuildexecution_v1alpha.projects.instances.html">instances</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="remotebuildexecution_v1alpha.projects.instances.workerpools.html">workerpools()</a></code>
79</p>
80<p class="firstline">Returns the workerpools Resource.</p>
81
82<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]83 <code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]84<p class="firstline">Creates a new instance in the specified region.</p>
85<p class="toc_element">
86 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
87<p class="firstline">Deletes the specified instance.</p>
88<p class="toc_element">
89 <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
90<p class="firstline">Returns the specified instance.</p>
91<p class="toc_element">
92 <code><a href="#list">list(parent, x__xgafv=None)</a></code></p>
93<p class="firstline">Lists instances in a project.</p>
94<h3>Method Details</h3>
95<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]96 <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]97 <pre>Creates a new instance in the specified region.
98Returns a long running operation which contains an instance on completion.
99While the long running operation is in progress, any call to `GetInstance`
100returns an instance in state `CREATING`.
101
102Args:
103 parent: string, Resource name of the project containing the instance.
104Format: `projects/[PROJECT_ID]`. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]105 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]106 The object takes the form of:
107
108{ # The request used for `CreateInstance`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]109 &quot;instance&quot;: { # Instance conceptually encapsulates all Remote Build Execution resources # Specifies the instance to create.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]110 # The name in the instance, if specified in the instance, is ignored.
111 # for remote builds.
112 # An instance consists of storage and compute resources (for example,
113 # `ContentAddressableStorage`, `ActionCache`, `WorkerPools`) used for
114 # running remote builds.
115 # All Remote Build Execution API calls are scoped to an instance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]116 &quot;location&quot;: &quot;A String&quot;, # The location is a GCP region. Currently only `us-central1` is supported.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]117 &quot;loggingEnabled&quot;: True or False, # Output only. Whether stack driver logging is enabled for the instance.
118 &quot;name&quot;: &quot;A String&quot;, # Output only. Instance resource name formatted as:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]119 # `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
120 # Name should not be populated when creating an instance since it is provided
121 # in the `instance_id` field.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame^]122 &quot;state&quot;: &quot;A String&quot;, # Output only. State of the instance.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]123 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame^]124 &quot;parent&quot;: &quot;A String&quot;, # Resource name of the project containing the instance.
125 # Format: `projects/[PROJECT_ID]`.
126 &quot;instanceId&quot;: &quot;A String&quot;, # ID of the created instance.
127 # A valid `instance_id` must:
128 # be 6-50 characters long,
129 # contain only lowercase letters, digits, hyphens and underscores,
130 # start with a lowercase letter, and
131 # end with a lowercase letter or a digit.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]132 }
133
134 x__xgafv: string, V1 error format.
135 Allowed values
136 1 - v1 error format
137 2 - v2 error format
138
139Returns:
140 An object of the form:
141
142 { # This resource represents a long-running operation that is the result of a
143 # network API call.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame^]144 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
145 # If `true`, the operation is completed, and either `error` or `response` is
146 # available.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]147 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
148 # different programming environments, including REST APIs and RPC APIs. It is
149 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
150 # three pieces of data: error code, error message, and error details.
151 #
152 # You can find out more about this error model and how to work with it in the
153 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame^]154 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
155 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
156 # user-facing error message should be localized and sent in the
157 # google.rpc.Status.details field, or localized by the client.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]158 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
159 # message types for APIs to use.
160 {
161 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
162 },
163 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]164 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]165 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]166 # method returns no data on success, such as `Delete`, the response is
167 # `google.protobuf.Empty`. If the original method is standard
168 # `Get`/`Create`/`Update`, the response should be the resource. For other
169 # methods, the response should have the type `XxxResponse`, where `Xxx`
170 # is the original method name. For example, if the original method name
171 # is `TakeSnapshot()`, the inferred response type is
172 # `TakeSnapshotResponse`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]173 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]174 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame^]175 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
176 # originally returns it. If you use the default HTTP mapping, the
177 # `name` should be a resource name ending with `operations/{unique_id}`.
178 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
179 # contains progress information and common metadata such as create time.
180 # Some services might not provide such metadata. Any method that returns a
181 # long-running operation should document the metadata type, if any.
182 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
183 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]184 }</pre>
185</div>
186
187<div class="method">
188 <code class="details" id="delete">delete(name, x__xgafv=None)</code>
189 <pre>Deletes the specified instance.
190Returns a long running operation which contains a `google.protobuf.Empty`
191response on completion.
192Deleting an instance with worker pools in it will delete these worker
193pools.
194
195Args:
196 name: string, Name of the instance to delete.
197Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. (required)
198 x__xgafv: string, V1 error format.
199 Allowed values
200 1 - v1 error format
201 2 - v2 error format
202
203Returns:
204 An object of the form:
205
206 { # This resource represents a long-running operation that is the result of a
207 # network API call.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame^]208 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
209 # If `true`, the operation is completed, and either `error` or `response` is
210 # available.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]211 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
212 # different programming environments, including REST APIs and RPC APIs. It is
213 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
214 # three pieces of data: error code, error message, and error details.
215 #
216 # You can find out more about this error model and how to work with it in the
217 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame^]218 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
219 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
220 # user-facing error message should be localized and sent in the
221 # google.rpc.Status.details field, or localized by the client.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]222 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
223 # message types for APIs to use.
224 {
225 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
226 },
227 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]228 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]229 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]230 # method returns no data on success, such as `Delete`, the response is
231 # `google.protobuf.Empty`. If the original method is standard
232 # `Get`/`Create`/`Update`, the response should be the resource. For other
233 # methods, the response should have the type `XxxResponse`, where `Xxx`
234 # is the original method name. For example, if the original method name
235 # is `TakeSnapshot()`, the inferred response type is
236 # `TakeSnapshotResponse`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]237 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]238 },
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame^]239 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
240 # originally returns it. If you use the default HTTP mapping, the
241 # `name` should be a resource name ending with `operations/{unique_id}`.
242 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
243 # contains progress information and common metadata such as create time.
244 # Some services might not provide such metadata. Any method that returns a
245 # long-running operation should document the metadata type, if any.
246 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
247 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]248 }</pre>
249</div>
250
251<div class="method">
252 <code class="details" id="get">get(name, x__xgafv=None)</code>
253 <pre>Returns the specified instance.
254
255Args:
256 name: string, Name of the instance to retrieve.
257Format: `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`. (required)
258 x__xgafv: string, V1 error format.
259 Allowed values
260 1 - v1 error format
261 2 - v2 error format
262
263Returns:
264 An object of the form:
265
266 { # Instance conceptually encapsulates all Remote Build Execution resources
267 # for remote builds.
268 # An instance consists of storage and compute resources (for example,
269 # `ContentAddressableStorage`, `ActionCache`, `WorkerPools`) used for
270 # running remote builds.
271 # All Remote Build Execution API calls are scoped to an instance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]272 &quot;location&quot;: &quot;A String&quot;, # The location is a GCP region. Currently only `us-central1` is supported.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]273 &quot;loggingEnabled&quot;: True or False, # Output only. Whether stack driver logging is enabled for the instance.
274 &quot;name&quot;: &quot;A String&quot;, # Output only. Instance resource name formatted as:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]275 # `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
276 # Name should not be populated when creating an instance since it is provided
277 # in the `instance_id` field.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame^]278 &quot;state&quot;: &quot;A String&quot;, # Output only. State of the instance.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]279 }</pre>
280</div>
281
282<div class="method">
283 <code class="details" id="list">list(parent, x__xgafv=None)</code>
284 <pre>Lists instances in a project.
285
286Args:
287 parent: string, Resource name of the project.
288Format: `projects/[PROJECT_ID]`. (required)
289 x__xgafv: string, V1 error format.
290 Allowed values
291 1 - v1 error format
292 2 - v2 error format
293
294Returns:
295 An object of the form:
296
297 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]298 &quot;instances&quot;: [ # The list of instances in a given project.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]299 { # Instance conceptually encapsulates all Remote Build Execution resources
300 # for remote builds.
301 # An instance consists of storage and compute resources (for example,
302 # `ContentAddressableStorage`, `ActionCache`, `WorkerPools`) used for
303 # running remote builds.
304 # All Remote Build Execution API calls are scoped to an instance.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]305 &quot;location&quot;: &quot;A String&quot;, # The location is a GCP region. Currently only `us-central1` is supported.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]306 &quot;loggingEnabled&quot;: True or False, # Output only. Whether stack driver logging is enabled for the instance.
307 &quot;name&quot;: &quot;A String&quot;, # Output only. Instance resource name formatted as:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]308 # `projects/[PROJECT_ID]/instances/[INSTANCE_ID]`.
309 # Name should not be populated when creating an instance since it is provided
310 # in the `instance_id` field.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700[diff] [blame^]311 &quot;state&quot;: &quot;A String&quot;, # Output only. State of the instance.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]312 },
313 ],
314 }</pre>
315</div>
316
317</body></html>