OLD | NEW |
1 { | 1 { |
2 "auth": { | 2 "auth": { |
3 "oauth2": { | 3 "oauth2": { |
4 "scopes": { | 4 "scopes": { |
5 "https://www.googleapis.com/auth/cloudruntimeconfig": { | 5 "https://www.googleapis.com/auth/cloudruntimeconfig": { |
6 "description": "Manage your Google Cloud Platform services'
runtime configuration" | 6 "description": "Manage your Google Cloud Platform services'
runtime configuration" |
7 }, | 7 }, |
8 "https://www.googleapis.com/auth/cloud-platform": { | 8 "https://www.googleapis.com/auth/cloud-platform": { |
9 "description": "View and manage your data across Google Clou
d Platform services" | 9 "description": "View and manage your data across Google Clou
d Platform services" |
10 } | 10 } |
(...skipping 10 matching lines...) Expand all Loading... |
21 "icons": { | 21 "icons": { |
22 "x16": "http://www.google.com/images/icons/product/search-16.gif", | 22 "x16": "http://www.google.com/images/icons/product/search-16.gif", |
23 "x32": "http://www.google.com/images/icons/product/search-32.gif" | 23 "x32": "http://www.google.com/images/icons/product/search-32.gif" |
24 }, | 24 }, |
25 "id": "runtimeconfig:v1beta1", | 25 "id": "runtimeconfig:v1beta1", |
26 "kind": "discovery#restDescription", | 26 "kind": "discovery#restDescription", |
27 "name": "runtimeconfig", | 27 "name": "runtimeconfig", |
28 "ownerDomain": "google.com", | 28 "ownerDomain": "google.com", |
29 "ownerName": "Google", | 29 "ownerName": "Google", |
30 "parameters": { | 30 "parameters": { |
| 31 "alt": { |
| 32 "default": "json", |
| 33 "description": "Data format for response.", |
| 34 "enum": [ |
| 35 "json", |
| 36 "media", |
| 37 "proto" |
| 38 ], |
| 39 "enumDescriptions": [ |
| 40 "Responses with Content-Type of application/json", |
| 41 "Media download with context-dependent Content-Type", |
| 42 "Responses with Content-Type of application/x-protobuf" |
| 43 ], |
| 44 "location": "query", |
| 45 "type": "string" |
| 46 }, |
| 47 "key": { |
| 48 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", |
| 49 "location": "query", |
| 50 "type": "string" |
| 51 }, |
| 52 "access_token": { |
| 53 "description": "OAuth access token.", |
| 54 "location": "query", |
| 55 "type": "string" |
| 56 }, |
| 57 "quotaUser": { |
| 58 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters.", |
| 59 "location": "query", |
| 60 "type": "string" |
| 61 }, |
31 "pp": { | 62 "pp": { |
32 "default": "true", | 63 "default": "true", |
33 "description": "Pretty-print response.", | 64 "description": "Pretty-print response.", |
34 "location": "query", | 65 "location": "query", |
35 "type": "boolean" | 66 "type": "boolean" |
36 }, | 67 }, |
| 68 "oauth_token": { |
| 69 "description": "OAuth 2.0 token for the current user.", |
| 70 "location": "query", |
| 71 "type": "string" |
| 72 }, |
37 "bearer_token": { | 73 "bearer_token": { |
38 "description": "OAuth bearer token.", | 74 "description": "OAuth bearer token.", |
39 "location": "query", | 75 "location": "query", |
40 "type": "string" | 76 "type": "string" |
41 }, | 77 }, |
42 "oauth_token": { | |
43 "description": "OAuth 2.0 token for the current user.", | |
44 "location": "query", | |
45 "type": "string" | |
46 }, | |
47 "upload_protocol": { | 78 "upload_protocol": { |
48 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", | 79 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", |
49 "location": "query", | 80 "location": "query", |
50 "type": "string" | 81 "type": "string" |
51 }, | 82 }, |
52 "prettyPrint": { | 83 "prettyPrint": { |
53 "default": "true", | 84 "default": "true", |
54 "description": "Returns response with indentations and line breaks."
, | 85 "description": "Returns response with indentations and line breaks."
, |
55 "location": "query", | 86 "location": "query", |
56 "type": "boolean" | 87 "type": "boolean" |
(...skipping 18 matching lines...) Expand all Loading... |
75 "enum": [ | 106 "enum": [ |
76 "1", | 107 "1", |
77 "2" | 108 "2" |
78 ], | 109 ], |
79 "enumDescriptions": [ | 110 "enumDescriptions": [ |
80 "v1 error format", | 111 "v1 error format", |
81 "v2 error format" | 112 "v2 error format" |
82 ], | 113 ], |
83 "location": "query", | 114 "location": "query", |
84 "type": "string" | 115 "type": "string" |
85 }, | |
86 "alt": { | |
87 "default": "json", | |
88 "description": "Data format for response.", | |
89 "enum": [ | |
90 "json", | |
91 "media", | |
92 "proto" | |
93 ], | |
94 "enumDescriptions": [ | |
95 "Responses with Content-Type of application/json", | |
96 "Media download with context-dependent Content-Type", | |
97 "Responses with Content-Type of application/x-protobuf" | |
98 ], | |
99 "location": "query", | |
100 "type": "string" | |
101 }, | |
102 "key": { | |
103 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", | |
104 "location": "query", | |
105 "type": "string" | |
106 }, | |
107 "access_token": { | |
108 "description": "OAuth access token.", | |
109 "location": "query", | |
110 "type": "string" | |
111 }, | |
112 "quotaUser": { | |
113 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters.", | |
114 "location": "query", | |
115 "type": "string" | |
116 } | 116 } |
117 }, | 117 }, |
118 "protocol": "rest", | 118 "protocol": "rest", |
119 "resources": { | 119 "resources": { |
120 "projects": { | 120 "projects": { |
121 "resources": { | 121 "resources": { |
122 "configs": { | 122 "configs": { |
123 "methods": { | 123 "methods": { |
124 "getIamPolicy": { | |
125 "description": "Gets the access control policy for a
resource.\nReturns an empty policy if the resource exists and does not have a p
olicy\nset.", | |
126 "httpMethod": "GET", | |
127 "id": "runtimeconfig.projects.configs.getIamPolicy", | |
128 "parameterOrder": [ | |
129 "resource" | |
130 ], | |
131 "parameters": { | |
132 "resource": { | |
133 "description": "REQUIRED: The resource for w
hich the policy is being requested.\nSee the operation documentation for the app
ropriate value for this field.", | |
134 "location": "path", | |
135 "pattern": "^projects/[^/]+/configs/[^/]+$", | |
136 "required": true, | |
137 "type": "string" | |
138 } | |
139 }, | |
140 "path": "v1beta1/{+resource}:getIamPolicy", | |
141 "response": { | |
142 "$ref": "Policy" | |
143 }, | |
144 "scopes": [ | |
145 "https://www.googleapis.com/auth/cloud-platform"
, | |
146 "https://www.googleapis.com/auth/cloudruntimecon
fig" | |
147 ] | |
148 }, | |
149 "get": { | |
150 "description": "Gets information about a RuntimeConf
ig resource.", | |
151 "httpMethod": "GET", | |
152 "id": "runtimeconfig.projects.configs.get", | |
153 "parameterOrder": [ | |
154 "name" | |
155 ], | |
156 "parameters": { | |
157 "name": { | |
158 "description": "The name of the RuntimeConfi
g resource to retrieve, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG
_NAME]`", | |
159 "location": "path", | |
160 "pattern": "^projects/[^/]+/configs/[^/]+$", | |
161 "required": true, | |
162 "type": "string" | |
163 } | |
164 }, | |
165 "path": "v1beta1/{+name}", | |
166 "response": { | |
167 "$ref": "RuntimeConfig" | |
168 }, | |
169 "scopes": [ | |
170 "https://www.googleapis.com/auth/cloud-platform"
, | |
171 "https://www.googleapis.com/auth/cloudruntimecon
fig" | |
172 ] | |
173 }, | |
174 "update": { | 124 "update": { |
175 "description": "Updates a RuntimeConfig resource. Th
e configuration must exist beforehand.", | 125 "description": "Updates a RuntimeConfig resource. Th
e configuration must exist beforehand.", |
176 "httpMethod": "PUT", | 126 "httpMethod": "PUT", |
177 "id": "runtimeconfig.projects.configs.update", | 127 "id": "runtimeconfig.projects.configs.update", |
178 "parameterOrder": [ | 128 "parameterOrder": [ |
179 "name" | 129 "name" |
180 ], | 130 ], |
181 "parameters": { | 131 "parameters": { |
182 "name": { | 132 "name": { |
183 "description": "The name of the RuntimeConfi
g resource to update, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_N
AME]`", | 133 "description": "The name of the RuntimeConfi
g resource to update, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_N
AME]`", |
(...skipping 69 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
253 ] | 203 ] |
254 }, | 204 }, |
255 "list": { | 205 "list": { |
256 "description": "Lists all the RuntimeConfig resource
s within project.", | 206 "description": "Lists all the RuntimeConfig resource
s within project.", |
257 "httpMethod": "GET", | 207 "httpMethod": "GET", |
258 "id": "runtimeconfig.projects.configs.list", | 208 "id": "runtimeconfig.projects.configs.list", |
259 "parameterOrder": [ | 209 "parameterOrder": [ |
260 "parent" | 210 "parent" |
261 ], | 211 ], |
262 "parameters": { | 212 "parameters": { |
263 "pageToken": { | |
264 "description": "Specifies a page token to us
e. Set `pageToken` to a `nextPageToken`\nreturned by a previous list request to
get the next page of results.", | |
265 "location": "query", | |
266 "type": "string" | |
267 }, | |
268 "pageSize": { | 213 "pageSize": { |
269 "description": "Specifies the number of resu
lts to return per page. If there are fewer\nelements than the specified number,
returns all elements.", | 214 "description": "Specifies the number of resu
lts to return per page. If there are fewer\nelements than the specified number,
returns all elements.", |
270 "format": "int32", | 215 "format": "int32", |
271 "location": "query", | 216 "location": "query", |
272 "type": "integer" | 217 "type": "integer" |
273 }, | 218 }, |
274 "parent": { | 219 "parent": { |
275 "description": "The [project ID](https://sup
port.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)\nfor this request,
in the format `projects/[PROJECT_ID]`.", | 220 "description": "The [project ID](https://sup
port.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)\nfor this request,
in the format `projects/[PROJECT_ID]`.", |
276 "location": "path", | 221 "location": "path", |
277 "pattern": "^projects/[^/]+$", | 222 "pattern": "^projects/[^/]+$", |
278 "required": true, | 223 "required": true, |
279 "type": "string" | 224 "type": "string" |
| 225 }, |
| 226 "pageToken": { |
| 227 "description": "Specifies a page token to us
e. Set `pageToken` to a `nextPageToken`\nreturned by a previous list request to
get the next page of results.", |
| 228 "location": "query", |
| 229 "type": "string" |
280 } | 230 } |
281 }, | 231 }, |
282 "path": "v1beta1/{+parent}/configs", | 232 "path": "v1beta1/{+parent}/configs", |
283 "response": { | 233 "response": { |
284 "$ref": "ListConfigsResponse" | 234 "$ref": "ListConfigsResponse" |
285 }, | 235 }, |
286 "scopes": [ | 236 "scopes": [ |
287 "https://www.googleapis.com/auth/cloud-platform"
, | 237 "https://www.googleapis.com/auth/cloud-platform"
, |
288 "https://www.googleapis.com/auth/cloudruntimecon
fig" | 238 "https://www.googleapis.com/auth/cloudruntimecon
fig" |
289 ] | 239 ] |
290 }, | 240 }, |
| 241 "create": { |
| 242 "description": "Creates a new RuntimeConfig resource
. The configuration name must be\nunique within project.", |
| 243 "httpMethod": "POST", |
| 244 "id": "runtimeconfig.projects.configs.create", |
| 245 "parameterOrder": [ |
| 246 "parent" |
| 247 ], |
| 248 "parameters": { |
| 249 "requestId": { |
| 250 "description": "An optional but recommended
unique `request_id`. If the server\nreceives two `create()` requests with the s
ame\n`request_id`, then the second request will be ignored and the\nfirst resour
ce created and stored in the backend is returned.\nEmpty `request_id` fields are
ignored.\n\nIt is responsibility of the client to ensure uniqueness of the\n`re
quest_id` strings.\n\n`request_id` strings are limited to 64 characters.", |
| 251 "location": "query", |
| 252 "type": "string" |
| 253 }, |
| 254 "parent": { |
| 255 "description": "The [project ID](https://sup
port.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)\nfor this request,
in the format `projects/[PROJECT_ID]`.", |
| 256 "location": "path", |
| 257 "pattern": "^projects/[^/]+$", |
| 258 "required": true, |
| 259 "type": "string" |
| 260 } |
| 261 }, |
| 262 "path": "v1beta1/{+parent}/configs", |
| 263 "request": { |
| 264 "$ref": "RuntimeConfig" |
| 265 }, |
| 266 "response": { |
| 267 "$ref": "RuntimeConfig" |
| 268 }, |
| 269 "scopes": [ |
| 270 "https://www.googleapis.com/auth/cloud-platform"
, |
| 271 "https://www.googleapis.com/auth/cloudruntimecon
fig" |
| 272 ] |
| 273 }, |
291 "setIamPolicy": { | 274 "setIamPolicy": { |
292 "description": "Sets the access control policy on th
e specified resource. Replaces any\nexisting policy.", | 275 "description": "Sets the access control policy on th
e specified resource. Replaces any\nexisting policy.", |
293 "httpMethod": "POST", | 276 "httpMethod": "POST", |
294 "id": "runtimeconfig.projects.configs.setIamPolicy", | 277 "id": "runtimeconfig.projects.configs.setIamPolicy", |
295 "parameterOrder": [ | 278 "parameterOrder": [ |
296 "resource" | 279 "resource" |
297 ], | 280 ], |
298 "parameters": { | 281 "parameters": { |
299 "resource": { | 282 "resource": { |
300 "description": "REQUIRED: The resource for w
hich the policy is being specified.\nSee the operation documentation for the app
ropriate value for this field.", | 283 "description": "REQUIRED: The resource for w
hich the policy is being specified.\nSee the operation documentation for the app
ropriate value for this field.", |
301 "location": "path", | 284 "location": "path", |
302 "pattern": "^projects/[^/]+/configs/[^/]+$", | 285 "pattern": "^projects/[^/]+/configs/[^/]+$", |
303 "required": true, | 286 "required": true, |
304 "type": "string" | 287 "type": "string" |
305 } | 288 } |
306 }, | 289 }, |
307 "path": "v1beta1/{+resource}:setIamPolicy", | 290 "path": "v1beta1/{+resource}:setIamPolicy", |
308 "request": { | 291 "request": { |
309 "$ref": "SetIamPolicyRequest" | 292 "$ref": "SetIamPolicyRequest" |
310 }, | 293 }, |
311 "response": { | 294 "response": { |
312 "$ref": "Policy" | 295 "$ref": "Policy" |
313 }, | 296 }, |
314 "scopes": [ | 297 "scopes": [ |
315 "https://www.googleapis.com/auth/cloud-platform"
, | 298 "https://www.googleapis.com/auth/cloud-platform"
, |
316 "https://www.googleapis.com/auth/cloudruntimecon
fig" | 299 "https://www.googleapis.com/auth/cloudruntimecon
fig" |
317 ] | 300 ] |
318 }, | 301 }, |
319 "create": { | 302 "getIamPolicy": { |
320 "description": "Creates a new RuntimeConfig resource
. The configuration name must be\nunique within project.", | 303 "description": "Gets the access control policy for a
resource.\nReturns an empty policy if the resource exists and does not have a p
olicy\nset.", |
321 "httpMethod": "POST", | 304 "httpMethod": "GET", |
322 "id": "runtimeconfig.projects.configs.create", | 305 "id": "runtimeconfig.projects.configs.getIamPolicy", |
323 "parameterOrder": [ | 306 "parameterOrder": [ |
324 "parent" | 307 "resource" |
325 ], | 308 ], |
326 "parameters": { | 309 "parameters": { |
327 "requestId": { | 310 "resource": { |
328 "description": "An optional but recommended
unique `request_id`. If the server\nreceives two `create()` requests with the s
ame\n`request_id`, then the second request will be ignored and the\nfirst resour
ce created and stored in the backend is returned.\nEmpty `request_id` fields are
ignored.\n\nIt is responsibility of the client to ensure uniqueness of the\n`re
quest_id` strings.\n\n`request_id` strings are limited to 64 characters.", | 311 "description": "REQUIRED: The resource for w
hich the policy is being requested.\nSee the operation documentation for the app
ropriate value for this field.", |
329 "location": "query", | |
330 "type": "string" | |
331 }, | |
332 "parent": { | |
333 "description": "The [project ID](https://sup
port.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)\nfor this request,
in the format `projects/[PROJECT_ID]`.", | |
334 "location": "path", | 312 "location": "path", |
335 "pattern": "^projects/[^/]+$", | 313 "pattern": "^projects/[^/]+/configs/[^/]+$", |
336 "required": true, | 314 "required": true, |
337 "type": "string" | 315 "type": "string" |
338 } | 316 } |
339 }, | 317 }, |
340 "path": "v1beta1/{+parent}/configs", | 318 "path": "v1beta1/{+resource}:getIamPolicy", |
341 "request": { | 319 "response": { |
342 "$ref": "RuntimeConfig" | 320 "$ref": "Policy" |
343 }, | 321 }, |
| 322 "scopes": [ |
| 323 "https://www.googleapis.com/auth/cloud-platform"
, |
| 324 "https://www.googleapis.com/auth/cloudruntimecon
fig" |
| 325 ] |
| 326 }, |
| 327 "get": { |
| 328 "description": "Gets information about a RuntimeConf
ig resource.", |
| 329 "httpMethod": "GET", |
| 330 "id": "runtimeconfig.projects.configs.get", |
| 331 "parameterOrder": [ |
| 332 "name" |
| 333 ], |
| 334 "parameters": { |
| 335 "name": { |
| 336 "description": "The name of the RuntimeConfi
g resource to retrieve, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG
_NAME]`", |
| 337 "location": "path", |
| 338 "pattern": "^projects/[^/]+/configs/[^/]+$", |
| 339 "required": true, |
| 340 "type": "string" |
| 341 } |
| 342 }, |
| 343 "path": "v1beta1/{+name}", |
344 "response": { | 344 "response": { |
345 "$ref": "RuntimeConfig" | 345 "$ref": "RuntimeConfig" |
346 }, | 346 }, |
347 "scopes": [ | 347 "scopes": [ |
348 "https://www.googleapis.com/auth/cloud-platform"
, | 348 "https://www.googleapis.com/auth/cloud-platform"
, |
349 "https://www.googleapis.com/auth/cloudruntimecon
fig" | 349 "https://www.googleapis.com/auth/cloudruntimecon
fig" |
350 ] | 350 ] |
351 } | 351 } |
352 }, | 352 }, |
353 "resources": { | 353 "resources": { |
354 "waiters": { | 354 "variables": { |
355 "methods": { | 355 "methods": { |
356 "get": { | 356 "get": { |
357 "description": "Gets information about a sin
gle waiter.", | 357 "description": "Gets information about a sin
gle variable.", |
358 "httpMethod": "GET", | 358 "httpMethod": "GET", |
359 "id": "runtimeconfig.projects.configs.waiter
s.get", | 359 "id": "runtimeconfig.projects.configs.variab
les.get", |
360 "parameterOrder": [ | 360 "parameterOrder": [ |
361 "name" | 361 "name" |
362 ], | 362 ], |
363 "parameters": { | 363 "parameters": { |
364 "name": { | 364 "name": { |
365 "description": "The fully-qualified
name of the Waiter resource object to retrieve, in the\nformat:\n\n`projects/[PR
OJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]`", | 365 "description": "The name of the vari
able to return, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_NAME]/v
ariables/[VARIBLE_NAME]`", |
366 "location": "path", | 366 "location": "path", |
367 "pattern": "^projects/[^/]+/configs/
[^/]+/waiters/[^/]+$", | 367 "pattern": "^projects/[^/]+/configs/
[^/]+/variables/.+$", |
368 "required": true, | 368 "required": true, |
369 "type": "string" | 369 "type": "string" |
370 } | 370 } |
371 }, | 371 }, |
372 "path": "v1beta1/{+name}", | 372 "path": "v1beta1/{+name}", |
373 "response": { | 373 "response": { |
374 "$ref": "Waiter" | 374 "$ref": "Variable" |
375 }, | 375 }, |
376 "scopes": [ | 376 "scopes": [ |
377 "https://www.googleapis.com/auth/cloud-p
latform", | 377 "https://www.googleapis.com/auth/cloud-p
latform", |
378 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 378 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
379 ] | 379 ] |
380 }, | 380 }, |
381 "list": { | 381 "watch": { |
382 "description": "List waiters within the give
n configuration.", | 382 "description": "Watches a specific variable
and waits for a change in the variable's value.\nWhen there is a change, this me
thod returns the new value or times out.\n\nIf a variable is deleted while being
watched, the `variableState` state is\nset to `DELETED` and the method returns
the last known variable `value`.\n\nIf you set the deadline for watching to a la
rger value than internal timeout\n(60 seconds), the current variable value is re
turned and the `variableState`\nwill be `VARIABLE_STATE_UNSPECIFIED`.\n\nTo lear
n more about creating a watcher, read the\n[Watching a Variable for Changes](/de
ployment-manager/runtime-configurator/watching-a-variable)\ndocumentation.", |
383 "httpMethod": "GET", | 383 "httpMethod": "POST", |
384 "id": "runtimeconfig.projects.configs.waiter
s.list", | 384 "id": "runtimeconfig.projects.configs.variab
les.watch", |
385 "parameterOrder": [ | 385 "parameterOrder": [ |
386 "parent" | 386 "name" |
387 ], | 387 ], |
388 "parameters": { | 388 "parameters": { |
389 "parent": { | 389 "name": { |
390 "description": "The path to the conf
iguration for which you want to get a list of waiters.\nThe configuration must e
xist beforehand; the path must by in the format:\n\n`projects/[PROJECT_ID]/confi
gs/[CONFIG_NAME]`", | 390 "description": "The name of the vari
able to watch, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_NAME]`", |
391 "location": "path", | 391 "location": "path", |
392 "pattern": "^projects/[^/]+/configs/
[^/]+$", | 392 "pattern": "^projects/[^/]+/configs/
[^/]+/variables/.+$", |
393 "required": true, | 393 "required": true, |
394 "type": "string" | 394 "type": "string" |
395 }, | |
396 "pageToken": { | |
397 "description": "Specifies a page tok
en to use. Set `pageToken` to a `nextPageToken`\nreturned by a previous list req
uest to get the next page of results.", | |
398 "location": "query", | |
399 "type": "string" | |
400 }, | |
401 "pageSize": { | |
402 "description": "Specifies the number
of results to return per page. If there are fewer\nelements than the specified
number, returns all elements.", | |
403 "format": "int32", | |
404 "location": "query", | |
405 "type": "integer" | |
406 } | 395 } |
407 }, | 396 }, |
408 "path": "v1beta1/{+parent}/waiters", | 397 "path": "v1beta1/{+name}:watch", |
| 398 "request": { |
| 399 "$ref": "WatchVariableRequest" |
| 400 }, |
409 "response": { | 401 "response": { |
410 "$ref": "ListWaitersResponse" | 402 "$ref": "Variable" |
411 }, | 403 }, |
412 "scopes": [ | 404 "scopes": [ |
413 "https://www.googleapis.com/auth/cloud-p
latform", | 405 "https://www.googleapis.com/auth/cloud-p
latform", |
414 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 406 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
415 ] | 407 ] |
416 }, | 408 }, |
417 "create": { | 409 "update": { |
418 "description": "Creates a Waiter resource. T
his operation returns a long-running Operation\nresource which can be polled for
completion. However, a waiter with the\ngiven name will exist (and can be retri
eved) prior to the operation\ncompleting. If the operation fails, the failed Wai
ter resource will\nstill exist and must be deleted prior to subsequent creation
attempts.", | 410 "description": "Updates an existing variable
with a new value.", |
419 "httpMethod": "POST", | 411 "httpMethod": "PUT", |
420 "id": "runtimeconfig.projects.configs.waiter
s.create", | 412 "id": "runtimeconfig.projects.configs.variab
les.update", |
421 "parameterOrder": [ | 413 "parameterOrder": [ |
422 "parent" | 414 "name" |
423 ], | 415 ], |
424 "parameters": { | 416 "parameters": { |
425 "requestId": { | 417 "name": { |
426 "description": "An optional but reco
mmended unique `request_id`. If the server\nreceives two `create()` requests wi
th the same\n`request_id`, then the second request will be ignored and the\nfirs
t resource created and stored in the backend is returned.\nEmpty `request_id` fi
elds are ignored.\n\nIt is responsibility of the client to ensure uniqueness of
the\n`request_id` strings.\n\n`request_id` strings are limited to 64 characters.
", | 418 "description": "The name of the vari
able to update, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_NAME]/v
ariables/[VARIABLE_NAME]`", |
427 "location": "query", | |
428 "type": "string" | |
429 }, | |
430 "parent": { | |
431 "description": "The path to the conf
iguration that will own the waiter.\nThe configuration must exist beforehand; th
e path must by in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_NAME]`."
, | |
432 "location": "path", | 419 "location": "path", |
433 "pattern": "^projects/[^/]+/configs/
[^/]+$", | 420 "pattern": "^projects/[^/]+/configs/
[^/]+/variables/.+$", |
434 "required": true, | 421 "required": true, |
435 "type": "string" | 422 "type": "string" |
436 } | 423 } |
437 }, | 424 }, |
438 "path": "v1beta1/{+parent}/waiters", | 425 "path": "v1beta1/{+name}", |
439 "request": { | 426 "request": { |
440 "$ref": "Waiter" | 427 "$ref": "Variable" |
441 }, | 428 }, |
442 "response": { | 429 "response": { |
443 "$ref": "Operation" | 430 "$ref": "Variable" |
444 }, | 431 }, |
445 "scopes": [ | 432 "scopes": [ |
446 "https://www.googleapis.com/auth/cloud-p
latform", | 433 "https://www.googleapis.com/auth/cloud-p
latform", |
447 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 434 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
448 ] | 435 ] |
449 }, | 436 }, |
450 "testIamPermissions": { | 437 "testIamPermissions": { |
451 "description": "Returns permissions that a c
aller has on the specified resource.\nIf the resource does not exist, this will
return an empty set of\npermissions, not a NOT_FOUND error.\n\nNote: This operat
ion is designed to be used for building permission-aware\nUIs and command-line t
ools, not for authorization checking. This operation\nmay \"fail open\" without
warning.", | 438 "description": "Returns permissions that a c
aller has on the specified resource.\nIf the resource does not exist, this will
return an empty set of\npermissions, not a NOT_FOUND error.\n\nNote: This operat
ion is designed to be used for building permission-aware\nUIs and command-line t
ools, not for authorization checking. This operation\nmay \"fail open\" without
warning.", |
452 "httpMethod": "POST", | 439 "httpMethod": "POST", |
453 "id": "runtimeconfig.projects.configs.waiter
s.testIamPermissions", | 440 "id": "runtimeconfig.projects.configs.variab
les.testIamPermissions", |
454 "parameterOrder": [ | 441 "parameterOrder": [ |
455 "resource" | 442 "resource" |
456 ], | 443 ], |
457 "parameters": { | 444 "parameters": { |
458 "resource": { | 445 "resource": { |
459 "description": "REQUIRED: The resour
ce for which the policy detail is being requested.\nSee the operation documentat
ion for the appropriate value for this field.", | 446 "description": "REQUIRED: The resour
ce for which the policy detail is being requested.\nSee the operation documentat
ion for the appropriate value for this field.", |
460 "location": "path", | 447 "location": "path", |
461 "pattern": "^projects/[^/]+/configs/
[^/]+/waiters/[^/]+$", | 448 "pattern": "^projects/[^/]+/configs/
[^/]+/variables/.+$", |
462 "required": true, | 449 "required": true, |
463 "type": "string" | 450 "type": "string" |
464 } | 451 } |
465 }, | 452 }, |
466 "path": "v1beta1/{+resource}:testIamPermissi
ons", | 453 "path": "v1beta1/{+resource}:testIamPermissi
ons", |
467 "request": { | 454 "request": { |
468 "$ref": "TestIamPermissionsRequest" | 455 "$ref": "TestIamPermissionsRequest" |
469 }, | 456 }, |
470 "response": { | 457 "response": { |
471 "$ref": "TestIamPermissionsResponse" | 458 "$ref": "TestIamPermissionsResponse" |
472 }, | 459 }, |
473 "scopes": [ | 460 "scopes": [ |
474 "https://www.googleapis.com/auth/cloud-p
latform", | 461 "https://www.googleapis.com/auth/cloud-p
latform", |
475 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 462 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
476 ] | 463 ] |
477 }, | 464 }, |
478 "delete": { | 465 "delete": { |
479 "description": "Deletes the waiter with the
specified name.", | 466 "description": "Deletes a variable or multip
le variables.\n\nIf you specify a variable name, then that variable is deleted.
If you\nspecify a prefix and `recursive` is true, then all variables with that\n
prefix are deleted. You must set a `recursive` to true if you delete\nvariables
by prefix.", |
480 "httpMethod": "DELETE", | 467 "httpMethod": "DELETE", |
481 "id": "runtimeconfig.projects.configs.waiter
s.delete", | 468 "id": "runtimeconfig.projects.configs.variab
les.delete", |
482 "parameterOrder": [ | 469 "parameterOrder": [ |
483 "name" | 470 "name" |
484 ], | 471 ], |
485 "parameters": { | 472 "parameters": { |
| 473 "recursive": { |
| 474 "description": "Set to `true` to rec
ursively delete multiple variables with the same\nprefix.", |
| 475 "location": "query", |
| 476 "type": "boolean" |
| 477 }, |
486 "name": { | 478 "name": { |
487 "description": "The Waiter resource
to delete, in the format:\n\n `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waite
rs/[WAITER_NAME]`", | 479 "description": "The name of the vari
able to delete, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_NAME]/v
ariables/[VARIABLE_NAME]`", |
488 "location": "path", | 480 "location": "path", |
489 "pattern": "^projects/[^/]+/configs/
[^/]+/waiters/[^/]+$", | 481 "pattern": "^projects/[^/]+/configs/
[^/]+/variables/.+$", |
490 "required": true, | 482 "required": true, |
491 "type": "string" | 483 "type": "string" |
492 } | 484 } |
493 }, | 485 }, |
494 "path": "v1beta1/{+name}", | 486 "path": "v1beta1/{+name}", |
495 "response": { | 487 "response": { |
496 "$ref": "Empty" | 488 "$ref": "Empty" |
497 }, | 489 }, |
498 "scopes": [ | 490 "scopes": [ |
499 "https://www.googleapis.com/auth/cloud-p
latform", | 491 "https://www.googleapis.com/auth/cloud-p
latform", |
500 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 492 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
501 ] | 493 ] |
502 } | 494 }, |
503 } | 495 "list": { |
504 }, | 496 "description": "Lists variables within given
a configuration, matching any provided filters.\nThis only lists variable names
, not the values, unless `return_values` is\ntrue, in which case only variables
that user has IAM permission to GetVariable\nwill be returned.", |
505 "operations": { | |
506 "methods": { | |
507 "get": { | |
508 "description": "Gets the latest state of a l
ong-running operation. Clients can use this\nmethod to poll the operation resul
t at intervals as recommended by the API\nservice.", | |
509 "httpMethod": "GET", | 497 "httpMethod": "GET", |
510 "id": "runtimeconfig.projects.configs.operat
ions.get", | 498 "id": "runtimeconfig.projects.configs.variab
les.list", |
511 "parameterOrder": [ | 499 "parameterOrder": [ |
512 "name" | 500 "parent" |
513 ], | 501 ], |
514 "parameters": { | 502 "parameters": { |
515 "name": { | 503 "pageSize": { |
516 "description": "The name of the oper
ation resource.", | 504 "description": "Specifies the number
of results to return per page. If there are fewer\nelements than the specified
number, returns all elements.", |
| 505 "format": "int32", |
| 506 "location": "query", |
| 507 "type": "integer" |
| 508 }, |
| 509 "parent": { |
| 510 "description": "The path to the Runt
imeConfig resource for which you want to list variables.\nThe configuration must
exist beforehand; the path must by in the format:\n\n`projects/[PROJECT_ID]/con
figs/[CONFIG_NAME]`", |
517 "location": "path", | 511 "location": "path", |
518 "pattern": "^projects/[^/]+/configs/
[^/]+/operations/.+$", | 512 "pattern": "^projects/[^/]+/configs/
[^/]+$", |
519 "required": true, | 513 "required": true, |
520 "type": "string" | 514 "type": "string" |
| 515 }, |
| 516 "filter": { |
| 517 "description": "Filters variables by
matching the specified filter. For example:\n\n`projects/example-project/config
/[CONFIG_NAME]/variables/example-variable`.", |
| 518 "location": "query", |
| 519 "type": "string" |
| 520 }, |
| 521 "returnValues": { |
| 522 "description": "The flag indicates w
hether the user wants to return values of variables.\nIf true, then only those v
ariables that user has IAM GetVariable permission\nwill be returned along with t
heir values.", |
| 523 "location": "query", |
| 524 "type": "boolean" |
| 525 }, |
| 526 "pageToken": { |
| 527 "description": "Specifies a page tok
en to use. Set `pageToken` to a `nextPageToken`\nreturned by a previous list req
uest to get the next page of results.", |
| 528 "location": "query", |
| 529 "type": "string" |
521 } | 530 } |
522 }, | 531 }, |
523 "path": "v1beta1/{+name}", | 532 "path": "v1beta1/{+parent}/variables", |
524 "response": { | 533 "response": { |
525 "$ref": "Operation" | 534 "$ref": "ListVariablesResponse" |
526 }, | 535 }, |
527 "scopes": [ | 536 "scopes": [ |
528 "https://www.googleapis.com/auth/cloud-p
latform", | 537 "https://www.googleapis.com/auth/cloud-p
latform", |
529 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 538 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
530 ] | 539 ] |
531 }, | 540 }, |
532 "testIamPermissions": { | 541 "create": { |
533 "description": "Returns permissions that a c
aller has on the specified resource.\nIf the resource does not exist, this will
return an empty set of\npermissions, not a NOT_FOUND error.\n\nNote: This operat
ion is designed to be used for building permission-aware\nUIs and command-line t
ools, not for authorization checking. This operation\nmay \"fail open\" without
warning.", | 542 "description": "Creates a variable within th
e given configuration. You cannot create\na variable with a name that is a prefi
x of an existing variable name, or a\nname that has an existing variable name as
a prefix.\n\nTo learn more about creating a variable, read the\n[Setting and Ge
tting Data](/deployment-manager/runtime-configurator/set-and-get-variables)\ndoc
umentation.", |
534 "httpMethod": "POST", | 543 "httpMethod": "POST", |
535 "id": "runtimeconfig.projects.configs.operat
ions.testIamPermissions", | 544 "id": "runtimeconfig.projects.configs.variab
les.create", |
536 "parameterOrder": [ | 545 "parameterOrder": [ |
537 "resource" | 546 "parent" |
538 ], | 547 ], |
539 "parameters": { | 548 "parameters": { |
540 "resource": { | 549 "requestId": { |
541 "description": "REQUIRED: The resour
ce for which the policy detail is being requested.\nSee the operation documentat
ion for the appropriate value for this field.", | 550 "description": "An optional but reco
mmended unique `request_id`. If the server\nreceives two `create()` requests wi
th the same\n`request_id`, then the second request will be ignored and the\nfirs
t resource created and stored in the backend is returned.\nEmpty `request_id` fi
elds are ignored.\n\nIt is responsibility of the client to ensure uniqueness of
the\n`request_id` strings.\n\n`request_id` strings are limited to 64 characters.
", |
| 551 "location": "query", |
| 552 "type": "string" |
| 553 }, |
| 554 "parent": { |
| 555 "description": "The path to the Ruti
meConfig resource that this variable should belong to.\nThe configuration must e
xist beforehand; the path must by in the format:\n\n`projects/[PROJECT_ID]/confi
gs/[CONFIG_NAME]`", |
542 "location": "path", | 556 "location": "path", |
543 "pattern": "^projects/[^/]+/configs/
[^/]+/operations/.+$", | 557 "pattern": "^projects/[^/]+/configs/
[^/]+$", |
544 "required": true, | 558 "required": true, |
545 "type": "string" | 559 "type": "string" |
546 } | 560 } |
547 }, | 561 }, |
548 "path": "v1beta1/{+resource}:testIamPermissi
ons", | 562 "path": "v1beta1/{+parent}/variables", |
549 "request": { | 563 "request": { |
550 "$ref": "TestIamPermissionsRequest" | 564 "$ref": "Variable" |
551 }, | 565 }, |
552 "response": { | 566 "response": { |
553 "$ref": "TestIamPermissionsResponse" | 567 "$ref": "Variable" |
554 }, | 568 }, |
555 "scopes": [ | 569 "scopes": [ |
556 "https://www.googleapis.com/auth/cloud-p
latform", | 570 "https://www.googleapis.com/auth/cloud-p
latform", |
557 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 571 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
558 ] | 572 ] |
559 } | 573 } |
560 } | 574 } |
561 }, | 575 }, |
562 "variables": { | 576 "waiters": { |
563 "methods": { | 577 "methods": { |
564 "get": { | 578 "get": { |
565 "description": "Gets information about a sin
gle variable.", | 579 "description": "Gets information about a sin
gle waiter.", |
566 "httpMethod": "GET", | 580 "httpMethod": "GET", |
567 "id": "runtimeconfig.projects.configs.variab
les.get", | 581 "id": "runtimeconfig.projects.configs.waiter
s.get", |
568 "parameterOrder": [ | 582 "parameterOrder": [ |
569 "name" | 583 "name" |
570 ], | 584 ], |
571 "parameters": { | 585 "parameters": { |
572 "name": { | 586 "name": { |
573 "description": "The name of the vari
able to return, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_NAME]/v
ariables/[VARIBLE_NAME]`", | 587 "description": "The fully-qualified
name of the Waiter resource object to retrieve, in the\nformat:\n\n`projects/[PR
OJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]`", |
574 "location": "path", | 588 "location": "path", |
575 "pattern": "^projects/[^/]+/configs/
[^/]+/variables/.+$", | 589 "pattern": "^projects/[^/]+/configs/
[^/]+/waiters/[^/]+$", |
576 "required": true, | 590 "required": true, |
577 "type": "string" | 591 "type": "string" |
578 } | 592 } |
579 }, | 593 }, |
580 "path": "v1beta1/{+name}", | 594 "path": "v1beta1/{+name}", |
581 "response": { | 595 "response": { |
582 "$ref": "Variable" | 596 "$ref": "Waiter" |
583 }, | 597 }, |
584 "scopes": [ | 598 "scopes": [ |
585 "https://www.googleapis.com/auth/cloud-p
latform", | 599 "https://www.googleapis.com/auth/cloud-p
latform", |
586 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 600 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
587 ] | 601 ] |
588 }, | 602 }, |
589 "watch": { | 603 "list": { |
590 "description": "Watches a specific variable
and waits for a change in the variable's value.\nWhen there is a change, this me
thod returns the new value or times out.\n\nIf a variable is deleted while being
watched, the `variableState` state is\nset to `DELETED` and the method returns
the last known variable `value`.\n\nIf you set the deadline for watching to a la
rger value than internal timeout\n(60 seconds), the current variable value is re
turned and the `variableState`\nwill be `VARIABLE_STATE_UNSPECIFIED`.\n\nTo lear
n more about creating a watcher, read the\n[Watching a Variable for Changes](/de
ployment-manager/runtime-configurator/watching-a-variable)\ndocumentation.", | 604 "description": "List waiters within the give
n configuration.", |
591 "httpMethod": "POST", | 605 "httpMethod": "GET", |
592 "id": "runtimeconfig.projects.configs.variab
les.watch", | 606 "id": "runtimeconfig.projects.configs.waiter
s.list", |
593 "parameterOrder": [ | 607 "parameterOrder": [ |
594 "name" | 608 "parent" |
595 ], | 609 ], |
596 "parameters": { | 610 "parameters": { |
597 "name": { | 611 "parent": { |
598 "description": "The name of the vari
able to watch, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_NAME]`", | 612 "description": "The path to the conf
iguration for which you want to get a list of waiters.\nThe configuration must e
xist beforehand; the path must by in the format:\n\n`projects/[PROJECT_ID]/confi
gs/[CONFIG_NAME]`", |
599 "location": "path", | 613 "location": "path", |
600 "pattern": "^projects/[^/]+/configs/
[^/]+/variables/.+$", | 614 "pattern": "^projects/[^/]+/configs/
[^/]+$", |
601 "required": true, | 615 "required": true, |
602 "type": "string" | 616 "type": "string" |
| 617 }, |
| 618 "pageToken": { |
| 619 "description": "Specifies a page tok
en to use. Set `pageToken` to a `nextPageToken`\nreturned by a previous list req
uest to get the next page of results.", |
| 620 "location": "query", |
| 621 "type": "string" |
| 622 }, |
| 623 "pageSize": { |
| 624 "description": "Specifies the number
of results to return per page. If there are fewer\nelements than the specified
number, returns all elements.", |
| 625 "format": "int32", |
| 626 "location": "query", |
| 627 "type": "integer" |
603 } | 628 } |
604 }, | 629 }, |
605 "path": "v1beta1/{+name}:watch", | 630 "path": "v1beta1/{+parent}/waiters", |
606 "request": { | |
607 "$ref": "WatchVariableRequest" | |
608 }, | |
609 "response": { | 631 "response": { |
610 "$ref": "Variable" | 632 "$ref": "ListWaitersResponse" |
611 }, | 633 }, |
612 "scopes": [ | 634 "scopes": [ |
613 "https://www.googleapis.com/auth/cloud-p
latform", | 635 "https://www.googleapis.com/auth/cloud-p
latform", |
614 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 636 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
615 ] | 637 ] |
616 }, | 638 }, |
617 "update": { | 639 "create": { |
618 "description": "Updates an existing variable
with a new value.", | 640 "description": "Creates a Waiter resource. T
his operation returns a long-running Operation\nresource which can be polled for
completion. However, a waiter with the\ngiven name will exist (and can be retri
eved) prior to the operation\ncompleting. If the operation fails, the failed Wai
ter resource will\nstill exist and must be deleted prior to subsequent creation
attempts.", |
619 "httpMethod": "PUT", | 641 "httpMethod": "POST", |
620 "id": "runtimeconfig.projects.configs.variab
les.update", | 642 "id": "runtimeconfig.projects.configs.waiter
s.create", |
621 "parameterOrder": [ | 643 "parameterOrder": [ |
622 "name" | 644 "parent" |
623 ], | 645 ], |
624 "parameters": { | 646 "parameters": { |
625 "name": { | 647 "requestId": { |
626 "description": "The name of the vari
able to update, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_NAME]/v
ariables/[VARIABLE_NAME]`", | 648 "description": "An optional but reco
mmended unique `request_id`. If the server\nreceives two `create()` requests wi
th the same\n`request_id`, then the second request will be ignored and the\nfirs
t resource created and stored in the backend is returned.\nEmpty `request_id` fi
elds are ignored.\n\nIt is responsibility of the client to ensure uniqueness of
the\n`request_id` strings.\n\n`request_id` strings are limited to 64 characters.
", |
| 649 "location": "query", |
| 650 "type": "string" |
| 651 }, |
| 652 "parent": { |
| 653 "description": "The path to the conf
iguration that will own the waiter.\nThe configuration must exist beforehand; th
e path must by in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_NAME]`."
, |
627 "location": "path", | 654 "location": "path", |
628 "pattern": "^projects/[^/]+/configs/
[^/]+/variables/.+$", | 655 "pattern": "^projects/[^/]+/configs/
[^/]+$", |
629 "required": true, | 656 "required": true, |
630 "type": "string" | 657 "type": "string" |
631 } | 658 } |
632 }, | 659 }, |
633 "path": "v1beta1/{+name}", | 660 "path": "v1beta1/{+parent}/waiters", |
634 "request": { | 661 "request": { |
635 "$ref": "Variable" | 662 "$ref": "Waiter" |
636 }, | 663 }, |
637 "response": { | 664 "response": { |
638 "$ref": "Variable" | 665 "$ref": "Operation" |
639 }, | 666 }, |
640 "scopes": [ | 667 "scopes": [ |
641 "https://www.googleapis.com/auth/cloud-p
latform", | 668 "https://www.googleapis.com/auth/cloud-p
latform", |
642 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 669 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
643 ] | 670 ] |
644 }, | 671 }, |
645 "testIamPermissions": { | 672 "testIamPermissions": { |
646 "description": "Returns permissions that a c
aller has on the specified resource.\nIf the resource does not exist, this will
return an empty set of\npermissions, not a NOT_FOUND error.\n\nNote: This operat
ion is designed to be used for building permission-aware\nUIs and command-line t
ools, not for authorization checking. This operation\nmay \"fail open\" without
warning.", | 673 "description": "Returns permissions that a c
aller has on the specified resource.\nIf the resource does not exist, this will
return an empty set of\npermissions, not a NOT_FOUND error.\n\nNote: This operat
ion is designed to be used for building permission-aware\nUIs and command-line t
ools, not for authorization checking. This operation\nmay \"fail open\" without
warning.", |
647 "httpMethod": "POST", | 674 "httpMethod": "POST", |
648 "id": "runtimeconfig.projects.configs.variab
les.testIamPermissions", | 675 "id": "runtimeconfig.projects.configs.waiter
s.testIamPermissions", |
649 "parameterOrder": [ | 676 "parameterOrder": [ |
650 "resource" | 677 "resource" |
651 ], | 678 ], |
652 "parameters": { | 679 "parameters": { |
653 "resource": { | 680 "resource": { |
654 "description": "REQUIRED: The resour
ce for which the policy detail is being requested.\nSee the operation documentat
ion for the appropriate value for this field.", | 681 "description": "REQUIRED: The resour
ce for which the policy detail is being requested.\nSee the operation documentat
ion for the appropriate value for this field.", |
655 "location": "path", | 682 "location": "path", |
656 "pattern": "^projects/[^/]+/configs/
[^/]+/variables/.+$", | 683 "pattern": "^projects/[^/]+/configs/
[^/]+/waiters/[^/]+$", |
657 "required": true, | 684 "required": true, |
658 "type": "string" | 685 "type": "string" |
659 } | 686 } |
660 }, | 687 }, |
661 "path": "v1beta1/{+resource}:testIamPermissi
ons", | 688 "path": "v1beta1/{+resource}:testIamPermissi
ons", |
662 "request": { | 689 "request": { |
663 "$ref": "TestIamPermissionsRequest" | 690 "$ref": "TestIamPermissionsRequest" |
664 }, | 691 }, |
665 "response": { | 692 "response": { |
666 "$ref": "TestIamPermissionsResponse" | 693 "$ref": "TestIamPermissionsResponse" |
667 }, | 694 }, |
668 "scopes": [ | 695 "scopes": [ |
669 "https://www.googleapis.com/auth/cloud-p
latform", | 696 "https://www.googleapis.com/auth/cloud-p
latform", |
670 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 697 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
671 ] | 698 ] |
672 }, | 699 }, |
673 "delete": { | 700 "delete": { |
674 "description": "Deletes a variable or multip
le variables.\n\nIf you specify a variable name, then that variable is deleted.
If you\nspecify a prefix and `recursive` is true, then all variables with that\n
prefix are deleted. You must set a `recursive` to true if you delete\nvariables
by prefix.", | 701 "description": "Deletes the waiter with the
specified name.", |
675 "httpMethod": "DELETE", | 702 "httpMethod": "DELETE", |
676 "id": "runtimeconfig.projects.configs.variab
les.delete", | 703 "id": "runtimeconfig.projects.configs.waiter
s.delete", |
677 "parameterOrder": [ | 704 "parameterOrder": [ |
678 "name" | 705 "name" |
679 ], | 706 ], |
680 "parameters": { | 707 "parameters": { |
681 "recursive": { | |
682 "description": "Set to `true` to rec
ursively delete multiple variables with the same\nprefix.", | |
683 "location": "query", | |
684 "type": "boolean" | |
685 }, | |
686 "name": { | 708 "name": { |
687 "description": "The name of the vari
able to delete, in the format:\n\n`projects/[PROJECT_ID]/configs/[CONFIG_NAME]/v
ariables/[VARIABLE_NAME]`", | 709 "description": "The Waiter resource
to delete, in the format:\n\n `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waite
rs/[WAITER_NAME]`", |
688 "location": "path", | 710 "location": "path", |
689 "pattern": "^projects/[^/]+/configs/
[^/]+/variables/.+$", | 711 "pattern": "^projects/[^/]+/configs/
[^/]+/waiters/[^/]+$", |
690 "required": true, | 712 "required": true, |
691 "type": "string" | 713 "type": "string" |
692 } | 714 } |
693 }, | 715 }, |
694 "path": "v1beta1/{+name}", | 716 "path": "v1beta1/{+name}", |
695 "response": { | 717 "response": { |
696 "$ref": "Empty" | 718 "$ref": "Empty" |
697 }, | 719 }, |
698 "scopes": [ | 720 "scopes": [ |
699 "https://www.googleapis.com/auth/cloud-p
latform", | 721 "https://www.googleapis.com/auth/cloud-p
latform", |
700 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 722 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
701 ] | 723 ] |
702 }, | 724 } |
703 "list": { | 725 } |
704 "description": "Lists variables within given
a configuration, matching any provided filters.\nThis only lists variable names
, not the values, unless `return_values` is\ntrue, in which case only variables
that user has IAM permission to GetVariable\nwill be returned.", | 726 }, |
| 727 "operations": { |
| 728 "methods": { |
| 729 "get": { |
| 730 "description": "Gets the latest state of a l
ong-running operation. Clients can use this\nmethod to poll the operation resul
t at intervals as recommended by the API\nservice.", |
705 "httpMethod": "GET", | 731 "httpMethod": "GET", |
706 "id": "runtimeconfig.projects.configs.variab
les.list", | 732 "id": "runtimeconfig.projects.configs.operat
ions.get", |
707 "parameterOrder": [ | 733 "parameterOrder": [ |
708 "parent" | 734 "name" |
709 ], | 735 ], |
710 "parameters": { | 736 "parameters": { |
711 "parent": { | 737 "name": { |
712 "description": "The path to the Runt
imeConfig resource for which you want to list variables.\nThe configuration must
exist beforehand; the path must by in the format:\n\n`projects/[PROJECT_ID]/con
figs/[CONFIG_NAME]`", | 738 "description": "The name of the oper
ation resource.", |
713 "location": "path", | 739 "location": "path", |
714 "pattern": "^projects/[^/]+/configs/
[^/]+$", | 740 "pattern": "^projects/[^/]+/configs/
[^/]+/operations/.+$", |
715 "required": true, | 741 "required": true, |
716 "type": "string" | 742 "type": "string" |
717 }, | |
718 "filter": { | |
719 "description": "Filters variables by
matching the specified filter. For example:\n\n`projects/example-project/config
/[CONFIG_NAME]/variables/example-variable`.", | |
720 "location": "query", | |
721 "type": "string" | |
722 }, | |
723 "returnValues": { | |
724 "description": "The flag indicates w
hether the user wants to return values of variables.\nIf true, then only those v
ariables that user has IAM GetVariable permission\nwill be returned along with t
heir values.", | |
725 "location": "query", | |
726 "type": "boolean" | |
727 }, | |
728 "pageToken": { | |
729 "description": "Specifies a page tok
en to use. Set `pageToken` to a `nextPageToken`\nreturned by a previous list req
uest to get the next page of results.", | |
730 "location": "query", | |
731 "type": "string" | |
732 }, | |
733 "pageSize": { | |
734 "description": "Specifies the number
of results to return per page. If there are fewer\nelements than the specified
number, returns all elements.", | |
735 "format": "int32", | |
736 "location": "query", | |
737 "type": "integer" | |
738 } | 743 } |
739 }, | 744 }, |
740 "path": "v1beta1/{+parent}/variables", | 745 "path": "v1beta1/{+name}", |
741 "response": { | 746 "response": { |
742 "$ref": "ListVariablesResponse" | 747 "$ref": "Operation" |
743 }, | 748 }, |
744 "scopes": [ | 749 "scopes": [ |
745 "https://www.googleapis.com/auth/cloud-p
latform", | 750 "https://www.googleapis.com/auth/cloud-p
latform", |
746 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 751 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
747 ] | 752 ] |
748 }, | 753 }, |
749 "create": { | 754 "testIamPermissions": { |
750 "description": "Creates a variable within th
e given configuration. You cannot create\na variable with a name that is a prefi
x of an existing variable name, or a\nname that has an existing variable name as
a prefix.\n\nTo learn more about creating a variable, read the\n[Setting and Ge
tting Data](/deployment-manager/runtime-configurator/set-and-get-variables)\ndoc
umentation.", | 755 "description": "Returns permissions that a c
aller has on the specified resource.\nIf the resource does not exist, this will
return an empty set of\npermissions, not a NOT_FOUND error.\n\nNote: This operat
ion is designed to be used for building permission-aware\nUIs and command-line t
ools, not for authorization checking. This operation\nmay \"fail open\" without
warning.", |
751 "httpMethod": "POST", | 756 "httpMethod": "POST", |
752 "id": "runtimeconfig.projects.configs.variab
les.create", | 757 "id": "runtimeconfig.projects.configs.operat
ions.testIamPermissions", |
753 "parameterOrder": [ | 758 "parameterOrder": [ |
754 "parent" | 759 "resource" |
755 ], | 760 ], |
756 "parameters": { | 761 "parameters": { |
757 "requestId": { | 762 "resource": { |
758 "description": "An optional but reco
mmended unique `request_id`. If the server\nreceives two `create()` requests wi
th the same\n`request_id`, then the second request will be ignored and the\nfirs
t resource created and stored in the backend is returned.\nEmpty `request_id` fi
elds are ignored.\n\nIt is responsibility of the client to ensure uniqueness of
the\n`request_id` strings.\n\n`request_id` strings are limited to 64 characters.
", | 763 "description": "REQUIRED: The resour
ce for which the policy detail is being requested.\nSee the operation documentat
ion for the appropriate value for this field.", |
759 "location": "query", | |
760 "type": "string" | |
761 }, | |
762 "parent": { | |
763 "description": "The path to the Ruti
meConfig resource that this variable should belong to.\nThe configuration must e
xist beforehand; the path must by in the format:\n\n`projects/[PROJECT_ID]/confi
gs/[CONFIG_NAME]`", | |
764 "location": "path", | 764 "location": "path", |
765 "pattern": "^projects/[^/]+/configs/
[^/]+$", | 765 "pattern": "^projects/[^/]+/configs/
[^/]+/operations/.+$", |
766 "required": true, | 766 "required": true, |
767 "type": "string" | 767 "type": "string" |
768 } | 768 } |
769 }, | 769 }, |
770 "path": "v1beta1/{+parent}/variables", | 770 "path": "v1beta1/{+resource}:testIamPermissi
ons", |
771 "request": { | 771 "request": { |
772 "$ref": "Variable" | 772 "$ref": "TestIamPermissionsRequest" |
773 }, | 773 }, |
774 "response": { | 774 "response": { |
775 "$ref": "Variable" | 775 "$ref": "TestIamPermissionsResponse" |
776 }, | 776 }, |
777 "scopes": [ | 777 "scopes": [ |
778 "https://www.googleapis.com/auth/cloud-p
latform", | 778 "https://www.googleapis.com/auth/cloud-p
latform", |
779 "https://www.googleapis.com/auth/cloudru
ntimeconfig" | 779 "https://www.googleapis.com/auth/cloudru
ntimeconfig" |
780 ] | 780 ] |
781 } | 781 } |
782 } | 782 } |
783 } | 783 } |
784 } | 784 } |
785 } | 785 } |
786 } | 786 } |
787 } | 787 } |
788 }, | 788 }, |
789 "revision": "20170620", | 789 "revision": "20170816", |
790 "rootUrl": "https://runtimeconfig.googleapis.com/", | 790 "rootUrl": "https://runtimeconfig.googleapis.com/", |
791 "schemas": { | 791 "schemas": { |
792 "Operation": { | |
793 "description": "This resource represents a long-running operation th
at is the result of a\nnetwork API call.", | |
794 "id": "Operation", | |
795 "properties": { | |
796 "response": { | |
797 "additionalProperties": { | |
798 "description": "Properties of the object. Contains field
@type with type URL.", | |
799 "type": "any" | |
800 }, | |
801 "description": "The normal response of the operation in case
of success. If the original\nmethod returns no data on success, such as `Delet
e`, the response is\n`google.protobuf.Empty`. If the original method is standar
d\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmet
hods, the response should have the type `XxxResponse`, where `Xxx`\nis the origi
nal method name. For example, if the original method name\nis `TakeSnapshot()`,
the inferred response type is\n`TakeSnapshotResponse`.", | |
802 "type": "object" | |
803 }, | |
804 "name": { | |
805 "description": "The server-assigned name, which is only uniq
ue within the same service that\noriginally returns it. If you use the default H
TTP mapping, the\n`name` should have the format of `operations/some/unique/name`
.", | |
806 "type": "string" | |
807 }, | |
808 "error": { | |
809 "$ref": "Status", | |
810 "description": "The error result of the operation in case of
failure or cancellation." | |
811 }, | |
812 "metadata": { | |
813 "additionalProperties": { | |
814 "description": "Properties of the object. Contains field
@type with type URL.", | |
815 "type": "any" | |
816 }, | |
817 "description": "Service-specific metadata associated with th
e operation. It typically\ncontains progress information and common metadata su
ch as create time.\nSome services might not provide such metadata. Any method t
hat returns a\nlong-running operation should document the metadata type, if any.
", | |
818 "type": "object" | |
819 }, | |
820 "done": { | |
821 "description": "If the value is `false`, it means the operat
ion is still in progress.\nIf true, the operation is completed, and either `erro
r` or `response` is\navailable.", | |
822 "type": "boolean" | |
823 } | |
824 }, | |
825 "type": "object" | |
826 }, | |
827 "SetIamPolicyRequest": { | 792 "SetIamPolicyRequest": { |
828 "description": "Request message for `SetIamPolicy` method.", | 793 "description": "Request message for `SetIamPolicy` method.", |
829 "id": "SetIamPolicyRequest", | 794 "id": "SetIamPolicyRequest", |
830 "properties": { | 795 "properties": { |
831 "policy": { | 796 "policy": { |
832 "$ref": "Policy", | 797 "$ref": "Policy", |
833 "description": "REQUIRED: The complete policy to be applied
to the `resource`. The size of\nthe policy is limited to a few 10s of KB. An emp
ty policy is a\nvalid policy but certain Cloud Platform services (such as Projec
ts)\nmight reject them." | 798 "description": "REQUIRED: The complete policy to be applied
to the `resource`. The size of\nthe policy is limited to a few 10s of KB. An emp
ty policy is a\nvalid policy but certain Cloud Platform services (such as Projec
ts)\nmight reject them." |
834 } | 799 } |
835 }, | 800 }, |
836 "type": "object" | 801 "type": "object" |
837 }, | 802 }, |
838 "Status": { | 803 "Status": { |
839 "description": "The `Status` type defines a logical error model that
is suitable for different\nprogramming environments, including REST APIs and RP
C APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is desig
ned to be:\n\n- Simple to use and understand for most users\n- Flexible enough t
o meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pie
ces of data: error code, error message,\nand error details. The error code shoul
d be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes
if needed. The\nerror message should be a developer-facing English message tha
t helps\ndevelopers *understand* and *resolve* the error. If a localized user-fa
cing\nerror message is needed, put the localized message in the error details or
\nlocalize it in the client. The optional error details may contain arbitrary\ni
nformation about the error. There is a predefined set of error detail types\nin
the package `google.rpc` that can be used for common error conditions.\n\n# Lang
uage mapping\n\nThe `Status` message is the logical representation of the error
model, but it\nis not necessarily the actual wire format. When the `Status` mess
age is\nexposed in different client libraries and different wire protocols, it c
an be\nmapped differently. For example, it will likely be mapped to some excepti
ons\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n
\nThe error model and the `Status` message can be used in a variety of\nenvironm
ents, either with or without APIs, to provide a\nconsistent developer experience
across different environments.\n\nExample uses of this error model include:\n\n
- Partial errors. If a service needs to return partial errors to the client,\n
it may embed the `Status` in the normal response to indicate the partial\n
errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step m
ay\n have a `Status` message for error reporting.\n\n- Batch operations. If a
client uses batch request and batch response, the\n `Status` message should
be used directly inside batch response, one for\n each error sub-response.\n\
n- Asynchronous operations. If an API call embeds asynchronous operation\n re
sults in its response, the status of those operations should be\n represented
directly using the `Status` message.\n\n- Logging. If some API errors are store
d in logs, the message `Status` could\n be used directly after any stripping
needed for security/privacy reasons.", | 804 "description": "The `Status` type defines a logical error model that
is suitable for different\nprogramming environments, including REST APIs and RP
C APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is desig
ned to be:\n\n- Simple to use and understand for most users\n- Flexible enough t
o meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pie
ces of data: error code, error message,\nand error details. The error code shoul
d be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes
if needed. The\nerror message should be a developer-facing English message tha
t helps\ndevelopers *understand* and *resolve* the error. If a localized user-fa
cing\nerror message is needed, put the localized message in the error details or
\nlocalize it in the client. The optional error details may contain arbitrary\ni
nformation about the error. There is a predefined set of error detail types\nin
the package `google.rpc` that can be used for common error conditions.\n\n# Lang
uage mapping\n\nThe `Status` message is the logical representation of the error
model, but it\nis not necessarily the actual wire format. When the `Status` mess
age is\nexposed in different client libraries and different wire protocols, it c
an be\nmapped differently. For example, it will likely be mapped to some excepti
ons\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n
\nThe error model and the `Status` message can be used in a variety of\nenvironm
ents, either with or without APIs, to provide a\nconsistent developer experience
across different environments.\n\nExample uses of this error model include:\n\n
- Partial errors. If a service needs to return partial errors to the client,\n
it may embed the `Status` in the normal response to indicate the partial\n
errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step m
ay\n have a `Status` message for error reporting.\n\n- Batch operations. If a
client uses batch request and batch response, the\n `Status` message should
be used directly inside batch response, one for\n each error sub-response.\n\
n- Asynchronous operations. If an API call embeds asynchronous operation\n re
sults in its response, the status of those operations should be\n represented
directly using the `Status` message.\n\n- Logging. If some API errors are store
d in logs, the message `Status` could\n be used directly after any stripping
needed for security/privacy reasons.", |
840 "id": "Status", | 805 "id": "Status", |
841 "properties": { | 806 "properties": { |
| 807 "code": { |
| 808 "description": "The status code, which should be an enum val
ue of google.rpc.Code.", |
| 809 "format": "int32", |
| 810 "type": "integer" |
| 811 }, |
| 812 "message": { |
| 813 "description": "A developer-facing error message, which shou
ld be in English. Any\nuser-facing error message should be localized and sent in
the\ngoogle.rpc.Status.details field, or localized by the client.", |
| 814 "type": "string" |
| 815 }, |
842 "details": { | 816 "details": { |
843 "description": "A list of messages that carry the error deta
ils. There will be a\ncommon set of message types for APIs to use.", | 817 "description": "A list of messages that carry the error deta
ils. There is a common set of\nmessage types for APIs to use.", |
844 "items": { | 818 "items": { |
845 "additionalProperties": { | 819 "additionalProperties": { |
846 "description": "Properties of the object. Contains f
ield @type with type URL.", | 820 "description": "Properties of the object. Contains f
ield @type with type URL.", |
847 "type": "any" | 821 "type": "any" |
848 }, | 822 }, |
849 "type": "object" | 823 "type": "object" |
850 }, | 824 }, |
851 "type": "array" | 825 "type": "array" |
852 }, | |
853 "code": { | |
854 "description": "The status code, which should be an enum val
ue of google.rpc.Code.", | |
855 "format": "int32", | |
856 "type": "integer" | |
857 }, | |
858 "message": { | |
859 "description": "A developer-facing error message, which shou
ld be in English. Any\nuser-facing error message should be localized and sent in
the\ngoogle.rpc.Status.details field, or localized by the client.", | |
860 "type": "string" | |
861 } | 826 } |
862 }, | 827 }, |
863 "type": "object" | 828 "type": "object" |
864 }, | 829 }, |
865 "Binding": { | 830 "Binding": { |
866 "description": "Associates `members` with a `role`.", | 831 "description": "Associates `members` with a `role`.", |
867 "id": "Binding", | 832 "id": "Binding", |
868 "properties": { | 833 "properties": { |
869 "role": { | |
870 "description": "Role that is assigned to `members`.\nFor exa
mple, `roles/viewer`, `roles/editor`, or `roles/owner`.\nRequired", | |
871 "type": "string" | |
872 }, | |
873 "members": { | 834 "members": { |
874 "description": "Specifies the identities requesting access f
or a Cloud Platform resource.\n`members` can have the following values:\n\n* `al
lUsers`: A special identifier that represents anyone who is\n on the internet;
with or without a Google account.\n\n* `allAuthenticatedUsers`: A special ident
ifier that represents anyone\n who is authenticated with a Google account or a
service account.\n\n* `user:{emailid}`: An email address that represents a spec
ific Google\n account. For example, `alice@gmail.com` or `joe@example.com`.\n\
n\n* `serviceAccount:{emailid}`: An email address that represents a service\n
account. For example, `my-other-app@appspot.gserviceaccount.com`.\n\n* `group:{e
mailid}`: An email address that represents a Google group.\n For example, `adm
ins@example.com`.\n\n\n* `domain:{domain}`: A Google Apps domain name that repre
sents all the\n users of that domain. For example, `google.com` or `example.co
m`.\n\n", | 835 "description": "Specifies the identities requesting access f
or a Cloud Platform resource.\n`members` can have the following values:\n\n* `al
lUsers`: A special identifier that represents anyone who is\n on the internet;
with or without a Google account.\n\n* `allAuthenticatedUsers`: A special ident
ifier that represents anyone\n who is authenticated with a Google account or a
service account.\n\n* `user:{emailid}`: An email address that represents a spec
ific Google\n account. For example, `alice@gmail.com` or `joe@example.com`.\n\
n\n* `serviceAccount:{emailid}`: An email address that represents a service\n
account. For example, `my-other-app@appspot.gserviceaccount.com`.\n\n* `group:{e
mailid}`: An email address that represents a Google group.\n For example, `adm
ins@example.com`.\n\n\n* `domain:{domain}`: A Google Apps domain name that repre
sents all the\n users of that domain. For example, `google.com` or `example.co
m`.\n\n", |
875 "items": { | 836 "items": { |
876 "type": "string" | 837 "type": "string" |
877 }, | 838 }, |
878 "type": "array" | 839 "type": "array" |
| 840 }, |
| 841 "role": { |
| 842 "description": "Role that is assigned to `members`.\nFor exa
mple, `roles/viewer`, `roles/editor`, or `roles/owner`.\nRequired", |
| 843 "type": "string" |
879 } | 844 } |
880 }, | 845 }, |
881 "type": "object" | 846 "type": "object" |
882 }, | 847 }, |
| 848 "Empty": { |
| 849 "description": "A generic empty message that you can re-use to avoid
defining duplicated\nempty messages in your APIs. A typical example is to use i
t as the request\nor the response type of an API method. For instance:\n\n se
rvice Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty
);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", |
| 850 "id": "Empty", |
| 851 "properties": {}, |
| 852 "type": "object" |
| 853 }, |
883 "Cardinality": { | 854 "Cardinality": { |
884 "description": "A Cardinality condition for the Waiter resource. A c
ardinality condition is\nmet when the number of variables under a specified path
prefix reaches a\npredefined number. For example, if you set a Cardinality cond
ition where\nthe `path` is set to `/foo` and the number of paths is set to 2, th
e\nfollowing variables would meet the condition in a RuntimeConfig resource:\n\n
+ `/foo/variable1 = \"value1\"`\n+ `/foo/variable2 = \"value2\"`\n+ `/bar/variab
le3 = \"value3\"`\n\nIt would not would not satisify the same condition with the
`number` set to\n3, however, because there is only 2 paths that start with `/fo
o`.\nCardinality conditions are recursive; all subtrees under the specific\npath
prefix are counted.", | 855 "description": "A Cardinality condition for the Waiter resource. A c
ardinality condition is\nmet when the number of variables under a specified path
prefix reaches a\npredefined number. For example, if you set a Cardinality cond
ition where\nthe `path` is set to `/foo` and the number of paths is set to 2, th
e\nfollowing variables would meet the condition in a RuntimeConfig resource:\n\n
+ `/foo/variable1 = \"value1\"`\n+ `/foo/variable2 = \"value2\"`\n+ `/bar/variab
le3 = \"value3\"`\n\nIt would not would not satisify the same condition with the
`number` set to\n3, however, because there is only 2 paths that start with `/fo
o`.\nCardinality conditions are recursive; all subtrees under the specific\npath
prefix are counted.", |
885 "id": "Cardinality", | 856 "id": "Cardinality", |
886 "properties": { | 857 "properties": { |
887 "number": { | 858 "number": { |
888 "description": "The number variables under the `path` that m
ust exist to meet this\ncondition. Defaults to 1 if not specified.", | 859 "description": "The number variables under the `path` that m
ust exist to meet this\ncondition. Defaults to 1 if not specified.", |
889 "format": "int32", | 860 "format": "int32", |
890 "type": "integer" | 861 "type": "integer" |
891 }, | 862 }, |
892 "path": { | 863 "path": { |
893 "description": "The root of the variable subtree to monitor.
For example, `/foo`.", | 864 "description": "The root of the variable subtree to monitor.
For example, `/foo`.", |
894 "type": "string" | 865 "type": "string" |
895 } | 866 } |
896 }, | 867 }, |
897 "type": "object" | 868 "type": "object" |
898 }, | 869 }, |
899 "Empty": { | |
900 "description": "A generic empty message that you can re-use to avoid
defining duplicated\nempty messages in your APIs. A typical example is to use i
t as the request\nor the response type of an API method. For instance:\n\n se
rvice Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty
);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", | |
901 "id": "Empty", | |
902 "properties": {}, | |
903 "type": "object" | |
904 }, | |
905 "ListConfigsResponse": { | 870 "ListConfigsResponse": { |
906 "description": "`ListConfigs()` returns the following response. The
order of returned\nobjects is arbitrary; that is, it is not ordered in any parti
cular way.", | 871 "description": "`ListConfigs()` returns the following response. The
order of returned\nobjects is arbitrary; that is, it is not ordered in any parti
cular way.", |
907 "id": "ListConfigsResponse", | 872 "id": "ListConfigsResponse", |
908 "properties": { | 873 "properties": { |
| 874 "nextPageToken": { |
| 875 "description": "This token allows you to get the next page o
f results for list requests.\nIf the number of results is larger than `pageSize`
, use the `nextPageToken`\nas a value for the query parameter `pageToken` in the
next list request.\nSubsequent list requests will have their own `nextPageToken
` to continue\npaging through the results", |
| 876 "type": "string" |
| 877 }, |
909 "configs": { | 878 "configs": { |
910 "description": "A list of the configurations in the project.
The order of returned\nobjects is arbitrary; that is, it is not ordered in any
particular way.", | 879 "description": "A list of the configurations in the project.
The order of returned\nobjects is arbitrary; that is, it is not ordered in any
particular way.", |
911 "items": { | 880 "items": { |
912 "$ref": "RuntimeConfig" | 881 "$ref": "RuntimeConfig" |
913 }, | 882 }, |
914 "type": "array" | 883 "type": "array" |
915 }, | |
916 "nextPageToken": { | |
917 "description": "This token allows you to get the next page o
f results for list requests.\nIf the number of results is larger than `pageSize`
, use the `nextPageToken`\nas a value for the query parameter `pageToken` in the
next list request.\nSubsequent list requests will have their own `nextPageToken
` to continue\npaging through the results", | |
918 "type": "string" | |
919 } | 884 } |
920 }, | 885 }, |
921 "type": "object" | 886 "type": "object" |
922 }, | 887 }, |
923 "EndCondition": { | 888 "EndCondition": { |
924 "description": "The condition that a Waiter resource is waiting for.
", | 889 "description": "The condition that a Waiter resource is waiting for.
", |
925 "id": "EndCondition", | 890 "id": "EndCondition", |
926 "properties": { | 891 "properties": { |
927 "cardinality": { | 892 "cardinality": { |
928 "$ref": "Cardinality", | 893 "$ref": "Cardinality", |
(...skipping 31 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
960 "description": "This token allows you to get the next page o
f results for list requests.\nIf the number of results is larger than `pageSize`
, use the `nextPageToken`\nas a value for the query parameter `pageToken` in the
next list request.\nSubsequent list requests will have their own `nextPageToken
` to continue\npaging through the results", | 925 "description": "This token allows you to get the next page o
f results for list requests.\nIf the number of results is larger than `pageSize`
, use the `nextPageToken`\nas a value for the query parameter `pageToken` in the
next list request.\nSubsequent list requests will have their own `nextPageToken
` to continue\npaging through the results", |
961 "type": "string" | 926 "type": "string" |
962 } | 927 } |
963 }, | 928 }, |
964 "type": "object" | 929 "type": "object" |
965 }, | 930 }, |
966 "RuntimeConfig": { | 931 "RuntimeConfig": { |
967 "description": "A RuntimeConfig resource is the primary resource in
the Cloud RuntimeConfig\nservice. A RuntimeConfig resource consists of metadata
and a hierarchy of\nvariables.", | 932 "description": "A RuntimeConfig resource is the primary resource in
the Cloud RuntimeConfig\nservice. A RuntimeConfig resource consists of metadata
and a hierarchy of\nvariables.", |
968 "id": "RuntimeConfig", | 933 "id": "RuntimeConfig", |
969 "properties": { | 934 "properties": { |
| 935 "description": { |
| 936 "description": "An optional description of the RuntimeConfig
object.", |
| 937 "type": "string" |
| 938 }, |
970 "name": { | 939 "name": { |
971 "description": "The resource name of a runtime config. The n
ame must have the format:\n\n projects/[PROJECT_ID]/configs/[CONFIG_NAME]\n\n
The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an\narbitr
ary name that matches RFC 1035 segment specification. The length of\n`[CONFIG_NA
ME]` must be less than 64 bytes.\n\nYou pick the RuntimeConfig resource name, bu
t the server will validate that\nthe name adheres to this format. After you crea
te the resource, you cannot\nchange the resource's name.", | 940 "description": "The resource name of a runtime config. The n
ame must have the format:\n\n projects/[PROJECT_ID]/configs/[CONFIG_NAME]\n\n
The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an\narbitr
ary name that matches RFC 1035 segment specification. The length of\n`[CONFIG_NA
ME]` must be less than 64 bytes.\n\nYou pick the RuntimeConfig resource name, bu
t the server will validate that\nthe name adheres to this format. After you crea
te the resource, you cannot\nchange the resource's name.", |
972 "type": "string" | 941 "type": "string" |
973 }, | |
974 "description": { | |
975 "description": "An optional description of the RuntimeConfig
object.", | |
976 "type": "string" | |
977 } | 942 } |
978 }, | 943 }, |
979 "type": "object" | 944 "type": "object" |
980 }, | 945 }, |
981 "WatchVariableRequest": { | 946 "WatchVariableRequest": { |
982 "description": "Request for the `WatchVariable()` method.", | 947 "description": "Request for the `WatchVariable()` method.", |
983 "id": "WatchVariableRequest", | 948 "id": "WatchVariableRequest", |
984 "properties": { | 949 "properties": { |
985 "newerThan": { | 950 "newerThan": { |
986 "description": "If specified, checks the current timestamp o
f the variable and if the\ncurrent timestamp is newer than `newerThan` timestamp
, the method returns\nimmediately.\n\nIf not specified or the variable has an ol
der timestamp, the watcher waits\nfor a the value to change before returning.", | 951 "description": "If specified, checks the current timestamp o
f the variable and if the\ncurrent timestamp is newer than `newerThan` timestamp
, the method returns\nimmediately.\n\nIf not specified or the variable has an ol
der timestamp, the watcher waits\nfor a the value to change before returning.", |
(...skipping 14 matching lines...) Expand all Loading... |
1001 "waiters": { | 966 "waiters": { |
1002 "description": "Found waiters in the project.", | 967 "description": "Found waiters in the project.", |
1003 "items": { | 968 "items": { |
1004 "$ref": "Waiter" | 969 "$ref": "Waiter" |
1005 }, | 970 }, |
1006 "type": "array" | 971 "type": "array" |
1007 } | 972 } |
1008 }, | 973 }, |
1009 "type": "object" | 974 "type": "object" |
1010 }, | 975 }, |
| 976 "TestIamPermissionsRequest": { |
| 977 "description": "Request message for `TestIamPermissions` method.", |
| 978 "id": "TestIamPermissionsRequest", |
| 979 "properties": { |
| 980 "permissions": { |
| 981 "description": "The set of permissions to check for the `res
ource`. Permissions with\nwildcards (such as '*' or 'storage.*') are not allowed
. For more\ninformation see\n[IAM Overview](https://cloud.google.com/iam/docs/ov
erview#permissions).", |
| 982 "items": { |
| 983 "type": "string" |
| 984 }, |
| 985 "type": "array" |
| 986 } |
| 987 }, |
| 988 "type": "object" |
| 989 }, |
1011 "Waiter": { | 990 "Waiter": { |
1012 "description": "A Waiter resource waits for some end condition withi
n a RuntimeConfig resource\nto be met before it returns. For example, assume you
have a distributed\nsystem where each node writes to a Variable resource indidi
cating the node's\nreadiness as part of the startup process.\n\nYou then configu
re a Waiter resource with the success condition set to wait\nuntil some number o
f nodes have checked in. Afterwards, your application\nruns some arbitrary code
after the condition has been met and the waiter\nreturns successfully.\n\nOnce c
reated, a Waiter resource is immutable.\n\nTo learn more about using waiters, re
ad the\n[Creating a Waiter](/deployment-manager/runtime-configurator/creating-a-
waiter)\ndocumentation.", | 991 "description": "A Waiter resource waits for some end condition withi
n a RuntimeConfig resource\nto be met before it returns. For example, assume you
have a distributed\nsystem where each node writes to a Variable resource indidi
cating the node's\nreadiness as part of the startup process.\n\nYou then configu
re a Waiter resource with the success condition set to wait\nuntil some number o
f nodes have checked in. Afterwards, your application\nruns some arbitrary code
after the condition has been met and the waiter\nreturns successfully.\n\nOnce c
reated, a Waiter resource is immutable.\n\nTo learn more about using waiters, re
ad the\n[Creating a Waiter](/deployment-manager/runtime-configurator/creating-a-
waiter)\ndocumentation.", |
1013 "id": "Waiter", | 992 "id": "Waiter", |
1014 "properties": { | 993 "properties": { |
| 994 "name": { |
| 995 "description": "The name of the Waiter resource, in the form
at:\n\n projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]\n\n
The `[PROJECT_ID]` must be a valid Google Cloud project ID,\nthe `[CONFIG_NAME]`
must be a valid RuntimeConfig resource, the\n`[WAITER_NAME]` must match RFC 103
5 segment specification, and the length\nof `[WAITER_NAME]` must be less than 64
bytes.\n\nAfter you create a Waiter resource, you cannot change the resource na
me.", |
| 996 "type": "string" |
| 997 }, |
1015 "error": { | 998 "error": { |
1016 "$ref": "Status", | 999 "$ref": "Status", |
1017 "description": "[Output Only] If the waiter ended due to a f
ailure or timeout, this value\nwill be set." | 1000 "description": "[Output Only] If the waiter ended due to a f
ailure or timeout, this value\nwill be set." |
1018 }, | 1001 }, |
1019 "failure": { | 1002 "failure": { |
1020 "$ref": "EndCondition", | 1003 "$ref": "EndCondition", |
1021 "description": "[Optional] The failure condition of this wai
ter. If this condition is met,\n`done` will be set to `true` and the `error` cod
e will be set to `ABORTED`.\nThe failure condition takes precedence over the suc
cess condition. If both\nconditions are met, a failure will be indicated. This v
alue is optional; if\nno failure condition is set, the only failure scenario wil
l be a timeout." | 1004 "description": "[Optional] The failure condition of this wai
ter. If this condition is met,\n`done` will be set to `true` and the `error` cod
e will be set to `ABORTED`.\nThe failure condition takes precedence over the suc
cess condition. If both\nconditions are met, a failure will be indicated. This v
alue is optional; if\nno failure condition is set, the only failure scenario wil
l be a timeout." |
1022 }, | 1005 }, |
1023 "success": { | 1006 "success": { |
1024 "$ref": "EndCondition", | 1007 "$ref": "EndCondition", |
1025 "description": "[Required] The success condition. If this co
ndition is met, `done` will be\nset to `true` and the `error` value will remain
unset. The failure condition\ntakes precedence over the success condition. If bo
th conditions are met, a\nfailure will be indicated." | 1008 "description": "[Required] The success condition. If this co
ndition is met, `done` will be\nset to `true` and the `error` value will remain
unset. The failure condition\ntakes precedence over the success condition. If bo
th conditions are met, a\nfailure will be indicated." |
1026 }, | 1009 }, |
1027 "createTime": { | 1010 "createTime": { |
1028 "description": "[Output Only] The instant at which this Wait
er resource was created. Adding\nthe value of `timeout` to this instant yields t
he timeout deadline for the\nwaiter.", | 1011 "description": "[Output Only] The instant at which this Wait
er resource was created. Adding\nthe value of `timeout` to this instant yields t
he timeout deadline for the\nwaiter.", |
1029 "format": "google-datetime", | 1012 "format": "google-datetime", |
1030 "type": "string" | 1013 "type": "string" |
1031 }, | 1014 }, |
1032 "done": { | 1015 "done": { |
1033 "description": "[Output Only] If the value is `false`, it me
ans the waiter is still waiting\nfor one of its conditions to be met.\n\nIf true
, the waiter has finished. If the waiter finished due to a timeout\nor failure,
`error` will be set.", | 1016 "description": "[Output Only] If the value is `false`, it me
ans the waiter is still waiting\nfor one of its conditions to be met.\n\nIf true
, the waiter has finished. If the waiter finished due to a timeout\nor failure,
`error` will be set.", |
1034 "type": "boolean" | 1017 "type": "boolean" |
1035 }, | 1018 }, |
1036 "timeout": { | 1019 "timeout": { |
1037 "description": "[Required] Specifies the timeout of the wait
er in seconds, beginning from\nthe instant that `waiters().create` method is cal
led. If this time elapses\nbefore the success or failure conditions are met, the
waiter fails and sets\nthe `error` code to `DEADLINE_EXCEEDED`.", | 1020 "description": "[Required] Specifies the timeout of the wait
er in seconds, beginning from\nthe instant that `waiters().create` method is cal
led. If this time elapses\nbefore the success or failure conditions are met, the
waiter fails and sets\nthe `error` code to `DEADLINE_EXCEEDED`.", |
1038 "format": "google-duration", | 1021 "format": "google-duration", |
1039 "type": "string" | 1022 "type": "string" |
1040 }, | |
1041 "name": { | |
1042 "description": "The name of the Waiter resource, in the form
at:\n\n projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]\n\n
The `[PROJECT_ID]` must be a valid Google Cloud project ID,\nthe `[CONFIG_NAME]`
must be a valid RuntimeConfig resource, the\n`[WAITER_NAME]` must match RFC 103
5 segment specification, and the length\nof `[WAITER_NAME]` must be less than 64
bytes.\n\nAfter you create a Waiter resource, you cannot change the resource na
me.", | |
1043 "type": "string" | |
1044 } | 1023 } |
1045 }, | 1024 }, |
1046 "type": "object" | 1025 "type": "object" |
1047 }, | |
1048 "TestIamPermissionsRequest": { | |
1049 "description": "Request message for `TestIamPermissions` method.", | |
1050 "id": "TestIamPermissionsRequest", | |
1051 "properties": { | |
1052 "permissions": { | |
1053 "description": "The set of permissions to check for the `res
ource`. Permissions with\nwildcards (such as '*' or 'storage.*') are not allowed
. For more\ninformation see\n[IAM Overview](https://cloud.google.com/iam/docs/ov
erview#permissions).", | |
1054 "items": { | |
1055 "type": "string" | |
1056 }, | |
1057 "type": "array" | |
1058 } | |
1059 }, | |
1060 "type": "object" | |
1061 }, | |
1062 "Policy": { | |
1063 "description": "Defines an Identity and Access Management (IAM) poli
cy. It is used to\nspecify access control policies for Cloud Platform resources.
\n\n\nA `Policy` consists of a list of `bindings`. A `Binding` binds a list of\n
`members` to a `role`, where the members can be user accounts, Google groups,\nG
oogle domains, and service accounts. A `role` is a named list of permissions\nde
fined by IAM.\n\n**Example**\n\n {\n \"bindings\": [\n {\n
\"role\": \"roles/owner\",\n \"members\": [\n \"user:mike
@example.com\",\n \"group:admins@example.com\",\n \"domain
:google.com\",\n \"serviceAccount:my-other-app@appspot.gserviceaccoun
t.com\",\n ]\n },\n {\n \"role\": \"roles/viewer
\",\n \"members\": [\"user:sean@example.com\"]\n }\n ]\n
}\n\nFor a description of IAM and its features, see the\n[IAM developer's guide
](https://cloud.google.com/iam).", | |
1064 "id": "Policy", | |
1065 "properties": { | |
1066 "bindings": { | |
1067 "description": "Associates a list of `members` to a `role`.\
n`bindings` with no members will result in an error.", | |
1068 "items": { | |
1069 "$ref": "Binding" | |
1070 }, | |
1071 "type": "array" | |
1072 }, | |
1073 "etag": { | |
1074 "description": "`etag` is used for optimistic concurrency co
ntrol as a way to help\nprevent simultaneous updates of a policy from overwritin
g each other.\nIt is strongly suggested that systems make use of the `etag` in t
he\nread-modify-write cycle to perform policy updates in order to avoid race\nco
nditions: An `etag` is returned in the response to `getIamPolicy`, and\nsystems
are expected to put that etag in the request to `setIamPolicy` to\nensure that t
heir change will be applied to the same version of the policy.\n\nIf no `etag` i
s provided in the call to `setIamPolicy`, then the existing\npolicy is overwritt
en blindly.", | |
1075 "format": "byte", | |
1076 "type": "string" | |
1077 }, | |
1078 "version": { | |
1079 "description": "Version of the `Policy`. The default version
is 0.", | |
1080 "format": "int32", | |
1081 "type": "integer" | |
1082 } | |
1083 }, | |
1084 "type": "object" | |
1085 }, | 1026 }, |
1086 "Variable": { | 1027 "Variable": { |
1087 "description": "Describes a single variable within a RuntimeConfig r
esource.\nThe name denotes the hierarchical variable name. For example,\n`ports/
serving_port` is a valid variable name. The variable value is an\nopaque string
and only leaf variables can have values (that is, variables\nthat do not have an
y child variables).", | 1028 "description": "Describes a single variable within a RuntimeConfig r
esource.\nThe name denotes the hierarchical variable name. For example,\n`ports/
serving_port` is a valid variable name. The variable value is an\nopaque string
and only leaf variables can have values (that is, variables\nthat do not have an
y child variables).", |
1088 "id": "Variable", | 1029 "id": "Variable", |
1089 "properties": { | 1030 "properties": { |
1090 "text": { | |
1091 "description": "The string value of the variable. The length
of the value must be less\nthan 4096 bytes. Empty values are also accepted. For
example,\n`text: \"my text value\"`. The string must be valid UTF-8.", | |
1092 "type": "string" | |
1093 }, | |
1094 "value": { | 1031 "value": { |
1095 "description": "The binary value of the variable. The length
of the value must be less\nthan 4096 bytes. Empty values are also accepted. The
value must be\nbase64 encoded. Only one of `value` or `text` can be set.", | 1032 "description": "The binary value of the variable. The length
of the value must be less\nthan 4096 bytes. Empty values are also accepted. The
value must be\nbase64 encoded. Only one of `value` or `text` can be set.", |
1096 "format": "byte", | 1033 "format": "byte", |
1097 "type": "string" | 1034 "type": "string" |
1098 }, | 1035 }, |
1099 "state": { | 1036 "state": { |
1100 "description": "[Ouput only] The current state of the variab
le. The variable state indicates\nthe outcome of the `variables().watch` call an
d is visible through the\n`get` and `list` calls.", | 1037 "description": "[Ouput only] The current state of the variab
le. The variable state indicates\nthe outcome of the `variables().watch` call an
d is visible through the\n`get` and `list` calls.", |
1101 "enum": [ | 1038 "enum": [ |
1102 "VARIABLE_STATE_UNSPECIFIED", | 1039 "VARIABLE_STATE_UNSPECIFIED", |
1103 "UPDATED", | 1040 "UPDATED", |
1104 "DELETED" | 1041 "DELETED" |
1105 ], | 1042 ], |
1106 "enumDescriptions": [ | 1043 "enumDescriptions": [ |
1107 "Default variable state.", | 1044 "Default variable state.", |
1108 "The variable was updated, while `variables().watch` was
executing.", | 1045 "The variable was updated, while `variables().watch` was
executing.", |
1109 "The variable was deleted, while `variables().watch` was
executing." | 1046 "The variable was deleted, while `variables().watch` was
executing." |
1110 ], | 1047 ], |
1111 "type": "string" | 1048 "type": "string" |
1112 }, | 1049 }, |
1113 "updateTime": { | 1050 "updateTime": { |
1114 "description": "[Output Only] The time of the last variable
update.", | 1051 "description": "[Output Only] The time of the last variable
update.", |
1115 "format": "google-datetime", | 1052 "format": "google-datetime", |
1116 "type": "string" | 1053 "type": "string" |
1117 }, | 1054 }, |
1118 "name": { | 1055 "name": { |
1119 "description": "The name of the variable resource, in the fo
rmat:\n\n projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAM
E]\n\nThe `[PROJECT_ID]` must be a valid project ID, `[CONFIG_NAME]` must be a\n
valid RuntimeConfig reource and `[VARIABLE_NAME]` follows Unix file system\nfile
path naming.\n\nThe `[VARIABLE_NAME]` can contain ASCII letters, numbers, slash
es and\ndashes. Slashes are used as path element separators and are not part of
the\n`[VARIABLE_NAME]` itself, so `[VARIABLE_NAME]` must contain at least one\nn
on-slash character. Multiple slashes are coalesced into single slash\ncharacter.
Each path segment should follow RFC 1035 segment specification.\nThe length of
a `[VARIABLE_NAME]` must be less than 256 bytes.\n\nOnce you create a variable,
you cannot change the variable name.", | 1056 "description": "The name of the variable resource, in the fo
rmat:\n\n projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAM
E]\n\nThe `[PROJECT_ID]` must be a valid project ID, `[CONFIG_NAME]` must be a\n
valid RuntimeConfig reource and `[VARIABLE_NAME]` follows Unix file system\nfile
path naming.\n\nThe `[VARIABLE_NAME]` can contain ASCII letters, numbers, slash
es and\ndashes. Slashes are used as path element separators and are not part of
the\n`[VARIABLE_NAME]` itself, so `[VARIABLE_NAME]` must contain at least one\nn
on-slash character. Multiple slashes are coalesced into single slash\ncharacter.
Each path segment should follow RFC 1035 segment specification.\nThe length of
a `[VARIABLE_NAME]` must be less than 256 bytes.\n\nOnce you create a variable,
you cannot change the variable name.", |
1120 "type": "string" | 1057 "type": "string" |
| 1058 }, |
| 1059 "text": { |
| 1060 "description": "The string value of the variable. The length
of the value must be less\nthan 4096 bytes. Empty values are also accepted. For
example,\n`text: \"my text value\"`. The string must be valid UTF-8.", |
| 1061 "type": "string" |
1121 } | 1062 } |
1122 }, | 1063 }, |
1123 "type": "object" | 1064 "type": "object" |
| 1065 }, |
| 1066 "Policy": { |
| 1067 "description": "Defines an Identity and Access Management (IAM) poli
cy. It is used to\nspecify access control policies for Cloud Platform resources.
\n\n\nA `Policy` consists of a list of `bindings`. A `Binding` binds a list of\n
`members` to a `role`, where the members can be user accounts, Google groups,\nG
oogle domains, and service accounts. A `role` is a named list of permissions\nde
fined by IAM.\n\n**Example**\n\n {\n \"bindings\": [\n {\n
\"role\": \"roles/owner\",\n \"members\": [\n \"user:mike
@example.com\",\n \"group:admins@example.com\",\n \"domain
:google.com\",\n \"serviceAccount:my-other-app@appspot.gserviceaccoun
t.com\",\n ]\n },\n {\n \"role\": \"roles/viewer
\",\n \"members\": [\"user:sean@example.com\"]\n }\n ]\n
}\n\nFor a description of IAM and its features, see the\n[IAM developer's guide
](https://cloud.google.com/iam).", |
| 1068 "id": "Policy", |
| 1069 "properties": { |
| 1070 "etag": { |
| 1071 "description": "`etag` is used for optimistic concurrency co
ntrol as a way to help\nprevent simultaneous updates of a policy from overwritin
g each other.\nIt is strongly suggested that systems make use of the `etag` in t
he\nread-modify-write cycle to perform policy updates in order to avoid race\nco
nditions: An `etag` is returned in the response to `getIamPolicy`, and\nsystems
are expected to put that etag in the request to `setIamPolicy` to\nensure that t
heir change will be applied to the same version of the policy.\n\nIf no `etag` i
s provided in the call to `setIamPolicy`, then the existing\npolicy is overwritt
en blindly.", |
| 1072 "format": "byte", |
| 1073 "type": "string" |
| 1074 }, |
| 1075 "version": { |
| 1076 "description": "Version of the `Policy`. The default version
is 0.", |
| 1077 "format": "int32", |
| 1078 "type": "integer" |
| 1079 }, |
| 1080 "bindings": { |
| 1081 "description": "Associates a list of `members` to a `role`.\
n`bindings` with no members will result in an error.", |
| 1082 "items": { |
| 1083 "$ref": "Binding" |
| 1084 }, |
| 1085 "type": "array" |
| 1086 } |
| 1087 }, |
| 1088 "type": "object" |
| 1089 }, |
| 1090 "Operation": { |
| 1091 "description": "This resource represents a long-running operation th
at is the result of a\nnetwork API call.", |
| 1092 "id": "Operation", |
| 1093 "properties": { |
| 1094 "done": { |
| 1095 "description": "If the value is `false`, it means the operat
ion is still in progress.\nIf true, the operation is completed, and either `erro
r` or `response` is\navailable.", |
| 1096 "type": "boolean" |
| 1097 }, |
| 1098 "response": { |
| 1099 "additionalProperties": { |
| 1100 "description": "Properties of the object. Contains field
@type with type URL.", |
| 1101 "type": "any" |
| 1102 }, |
| 1103 "description": "The normal response of the operation in case
of success. If the original\nmethod returns no data on success, such as `Delet
e`, the response is\n`google.protobuf.Empty`. If the original method is standar
d\n`Get`/`Create`/`Update`, the response should be the resource. For other\nmet
hods, the response should have the type `XxxResponse`, where `Xxx`\nis the origi
nal method name. For example, if the original method name\nis `TakeSnapshot()`,
the inferred response type is\n`TakeSnapshotResponse`.", |
| 1104 "type": "object" |
| 1105 }, |
| 1106 "name": { |
| 1107 "description": "The server-assigned name, which is only uniq
ue within the same service that\noriginally returns it. If you use the default H
TTP mapping, the\n`name` should have the format of `operations/some/unique/name`
.", |
| 1108 "type": "string" |
| 1109 }, |
| 1110 "error": { |
| 1111 "$ref": "Status", |
| 1112 "description": "The error result of the operation in case of
failure or cancellation." |
| 1113 }, |
| 1114 "metadata": { |
| 1115 "additionalProperties": { |
| 1116 "description": "Properties of the object. Contains field
@type with type URL.", |
| 1117 "type": "any" |
| 1118 }, |
| 1119 "description": "Service-specific metadata associated with th
e operation. It typically\ncontains progress information and common metadata su
ch as create time.\nSome services might not provide such metadata. Any method t
hat returns a\nlong-running operation should document the metadata type, if any.
", |
| 1120 "type": "object" |
| 1121 } |
| 1122 }, |
| 1123 "type": "object" |
1124 } | 1124 } |
1125 }, | 1125 }, |
1126 "servicePath": "", | 1126 "servicePath": "", |
1127 "title": "Google Cloud Runtime Configuration API", | 1127 "title": "Google Cloud Runtime Configuration API", |
1128 "version": "v1beta1" | 1128 "version": "v1beta1" |
1129 } | 1129 } |
OLD | NEW |