Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(381)

Issues Search
    My Issues | Starred     Open | Closed | All

Side by Side Diff: discovery/googleapis_beta/cloudkms__v1beta1.json

Issue 2734843002: Api-roll 46: 2017-03-06 (Closed)
Patch Set: Created 3 years, 9 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « discovery/googleapis_beta/clouderrorreporting__v1beta1.json ('k') | discovery/googleapis_beta/cloudmonitoring__v2beta2.json » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 { 1 {
2 "auth": { 2 "auth": {
3 "oauth2": { 3 "oauth2": {
4 "scopes": { 4 "scopes": {
5 "https://www.googleapis.com/auth/cloud-platform": { 5 "https://www.googleapis.com/auth/cloud-platform": {
6 "description": "View and manage your data across Google Clou d Platform services" 6 "description": "View and manage your data across Google Clou d Platform services"
7 } 7 }
8 } 8 }
9 } 9 }
10 }, 10 },
11 "basePath": "", 11 "basePath": "",
12 "baseUrl": "https://cloudkms.googleapis.com/", 12 "baseUrl": "https://cloudkms.googleapis.com/",
13 "batchPath": "batch", 13 "batchPath": "batch",
14 "canonicalName": "Cloud KMS", 14 "canonicalName": "Cloud KMS",
15 "description": "Manages encryption for your cloud services the same way you do on-premise. You can generate, use, rotate, and destroy AES256 encryption keys .", 15 "description": "Manages encryption for your cloud services the same way you do on-premise. You can generate, use, rotate, and destroy AES256 encryption keys .",
16 "discoveryVersion": "v1", 16 "discoveryVersion": "v1",
17 "documentationLink": "https://cloud.google.com/kms/", 17 "documentationLink": "https://cloud.google.com/kms/",
18 "icons": { 18 "icons": {
19 "x16": "http://www.google.com/images/icons/product/search-16.gif", 19 "x16": "http://www.google.com/images/icons/product/search-16.gif",
20 "x32": "http://www.google.com/images/icons/product/search-32.gif" 20 "x32": "http://www.google.com/images/icons/product/search-32.gif"
21 }, 21 },
22 "id": "cloudkms:v1beta1", 22 "id": "cloudkms:v1beta1",
23 "kind": "discovery#restDescription", 23 "kind": "discovery#restDescription",
24 "name": "cloudkms", 24 "name": "cloudkms",
25 "ownerDomain": "google.com", 25 "ownerDomain": "google.com",
26 "ownerName": "Google", 26 "ownerName": "Google",
27 "parameters": { 27 "parameters": {
28 "fields": {
29 "description": "Selector specifying which fields to include in a par tial response.",
30 "location": "query",
31 "type": "string"
32 },
33 "uploadType": {
34 "description": "Legacy upload protocol for media (e.g. \"media\", \" multipart\").",
35 "location": "query",
36 "type": "string"
37 },
38 "callback": {
39 "description": "JSONP",
40 "location": "query",
41 "type": "string"
42 },
43 "$.xgafv": {
44 "description": "V1 error format.",
45 "enum": [
46 "1",
47 "2"
48 ],
49 "enumDescriptions": [
50 "v1 error format",
51 "v2 error format"
52 ],
53 "location": "query",
54 "type": "string"
55 },
56 "alt": { 28 "alt": {
57 "default": "json", 29 "default": "json",
58 "description": "Data format for response.", 30 "description": "Data format for response.",
59 "enum": [ 31 "enum": [
60 "json", 32 "json",
61 "media", 33 "media",
62 "proto" 34 "proto"
63 ], 35 ],
64 "enumDescriptions": [ 36 "enumDescriptions": [
65 "Responses with Content-Type of application/json", 37 "Responses with Content-Type of application/json",
66 "Media download with context-dependent Content-Type", 38 "Media download with context-dependent Content-Type",
67 "Responses with Content-Type of application/x-protobuf" 39 "Responses with Content-Type of application/x-protobuf"
68 ], 40 ],
69 "location": "query", 41 "location": "query",
70 "type": "string" 42 "type": "string"
71 }, 43 },
44 "key": {
45 "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.",
46 "location": "query",
47 "type": "string"
48 },
72 "access_token": { 49 "access_token": {
73 "description": "OAuth access token.", 50 "description": "OAuth access token.",
74 "location": "query", 51 "location": "query",
75 "type": "string" 52 "type": "string"
76 }, 53 },
77 "key": {
78 "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.",
79 "location": "query",
80 "type": "string"
81 },
82 "quotaUser": { 54 "quotaUser": {
83 "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.", 55 "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.",
84 "location": "query", 56 "location": "query",
85 "type": "string" 57 "type": "string"
86 }, 58 },
87 "pp": { 59 "pp": {
88 "default": "true", 60 "default": "true",
89 "description": "Pretty-print response.", 61 "description": "Pretty-print response.",
90 "location": "query", 62 "location": "query",
91 "type": "boolean" 63 "type": "boolean"
(...skipping 11 matching lines...) Expand all
103 "upload_protocol": { 75 "upload_protocol": {
104 "description": "Upload protocol for media (e.g. \"raw\", \"multipart \").", 76 "description": "Upload protocol for media (e.g. \"raw\", \"multipart \").",
105 "location": "query", 77 "location": "query",
106 "type": "string" 78 "type": "string"
107 }, 79 },
108 "prettyPrint": { 80 "prettyPrint": {
109 "default": "true", 81 "default": "true",
110 "description": "Returns response with indentations and line breaks." , 82 "description": "Returns response with indentations and line breaks." ,
111 "location": "query", 83 "location": "query",
112 "type": "boolean" 84 "type": "boolean"
85 },
86 "uploadType": {
87 "description": "Legacy upload protocol for media (e.g. \"media\", \" multipart\").",
88 "location": "query",
89 "type": "string"
90 },
91 "fields": {
92 "description": "Selector specifying which fields to include in a par tial response.",
93 "location": "query",
94 "type": "string"
95 },
96 "callback": {
97 "description": "JSONP",
98 "location": "query",
99 "type": "string"
100 },
101 "$.xgafv": {
102 "description": "V1 error format.",
103 "enum": [
104 "1",
105 "2"
106 ],
107 "enumDescriptions": [
108 "v1 error format",
109 "v2 error format"
110 ],
111 "location": "query",
112 "type": "string"
113 } 113 }
114 }, 114 },
115 "protocol": "rest", 115 "protocol": "rest",
116 "resources": { 116 "resources": {
117 "projects": { 117 "projects": {
118 "resources": { 118 "resources": {
119 "locations": { 119 "locations": {
120 "methods": { 120 "methods": {
121 "list": { 121 "list": {
122 "description": "Lists information about the supporte d locations for this service.", 122 "description": "Lists information about the supporte d locations for this service.",
123 "httpMethod": "GET", 123 "httpMethod": "GET",
124 "id": "cloudkms.projects.locations.list", 124 "id": "cloudkms.projects.locations.list",
125 "parameterOrder": [ 125 "parameterOrder": [
126 "name" 126 "name"
127 ], 127 ],
128 "parameters": { 128 "parameters": {
129 "filter": {
130 "description": "The standard list filter.",
131 "location": "query",
132 "type": "string"
133 },
134 "name": { 129 "name": {
135 "description": "The resource that owns the l ocations collection, if applicable.", 130 "description": "The resource that owns the l ocations collection, if applicable.",
136 "location": "path", 131 "location": "path",
137 "pattern": "^projects/[^/]+$", 132 "pattern": "^projects/[^/]+$",
138 "required": true, 133 "required": true,
139 "type": "string" 134 "type": "string"
140 }, 135 },
141 "pageToken": { 136 "pageToken": {
142 "description": "The standard list page token .", 137 "description": "The standard list page token .",
143 "location": "query", 138 "location": "query",
144 "type": "string" 139 "type": "string"
145 }, 140 },
146 "pageSize": { 141 "pageSize": {
147 "description": "The standard list page size. ", 142 "description": "The standard list page size. ",
148 "format": "int32", 143 "format": "int32",
149 "location": "query", 144 "location": "query",
150 "type": "integer" 145 "type": "integer"
146 },
147 "filter": {
148 "description": "The standard list filter.",
149 "location": "query",
150 "type": "string"
151 } 151 }
152 }, 152 },
153 "path": "v1beta1/{+name}/locations", 153 "path": "v1beta1/{+name}/locations",
154 "response": { 154 "response": {
155 "$ref": "ListLocationsResponse" 155 "$ref": "ListLocationsResponse"
156 }, 156 },
157 "scopes": [ 157 "scopes": [
158 "https://www.googleapis.com/auth/cloud-platform" 158 "https://www.googleapis.com/auth/cloud-platform"
159 ] 159 ]
160 }, 160 },
(...skipping 26 matching lines...) Expand all
187 "keyRings": { 187 "keyRings": {
188 "methods": { 188 "methods": {
189 "list": { 189 "list": {
190 "description": "Lists KeyRings.", 190 "description": "Lists KeyRings.",
191 "httpMethod": "GET", 191 "httpMethod": "GET",
192 "id": "cloudkms.projects.locations.keyRings. list", 192 "id": "cloudkms.projects.locations.keyRings. list",
193 "parameterOrder": [ 193 "parameterOrder": [
194 "parent" 194 "parent"
195 ], 195 ],
196 "parameters": { 196 "parameters": {
197 "parent": {
198 "description": "Required. The resour ce name of the location associated with the\nKeyRings, in the format `projects/* /locations/*`.",
199 "location": "path",
200 "pattern": "^projects/[^/]+/location s/[^/]+$",
201 "required": true,
202 "type": "string"
203 },
204 "pageToken": { 197 "pageToken": {
205 "description": "Optional pagination token, returned earlier via\nListKeyRingsResponse.next_page_token.", 198 "description": "Optional pagination token, returned earlier via\nListKeyRingsResponse.next_page_token.",
206 "location": "query", 199 "location": "query",
207 "type": "string" 200 "type": "string"
208 }, 201 },
209 "pageSize": { 202 "pageSize": {
210 "description": "Optional limit on th e number of KeyRings to include in the\nresponse. Further KeyRings can subseque ntly be obtained by\nincluding the ListKeyRingsResponse.next_page_token in a sub sequent\nrequest. If unspecified, the server will pick an appropriate default." , 203 "description": "Optional limit on th e number of KeyRings to include in the\nresponse. Further KeyRings can subseque ntly be obtained by\nincluding the ListKeyRingsResponse.next_page_token in a sub sequent\nrequest. If unspecified, the server will pick an appropriate default." ,
211 "format": "int32", 204 "format": "int32",
212 "location": "query", 205 "location": "query",
213 "type": "integer" 206 "type": "integer"
207 },
208 "parent": {
209 "description": "Required. The resour ce name of the location associated with the\nKeyRings, in the format `projects/* /locations/*`.",
210 "location": "path",
211 "pattern": "^projects/[^/]+/location s/[^/]+$",
212 "required": true,
213 "type": "string"
214 } 214 }
215 }, 215 },
216 "path": "v1beta1/{+parent}/keyRings", 216 "path": "v1beta1/{+parent}/keyRings",
217 "response": { 217 "response": {
218 "$ref": "ListKeyRingsResponse" 218 "$ref": "ListKeyRingsResponse"
219 }, 219 },
220 "scopes": [ 220 "scopes": [
221 "https://www.googleapis.com/auth/cloud-p latform" 221 "https://www.googleapis.com/auth/cloud-p latform"
222 ] 222 ]
223 }, 223 },
(...skipping 98 matching lines...) Expand 10 before | Expand all | Expand 10 after
322 }, 322 },
323 "path": "v1beta1/{+name}", 323 "path": "v1beta1/{+name}",
324 "response": { 324 "response": {
325 "$ref": "KeyRing" 325 "$ref": "KeyRing"
326 }, 326 },
327 "scopes": [ 327 "scopes": [
328 "https://www.googleapis.com/auth/cloud-p latform" 328 "https://www.googleapis.com/auth/cloud-p latform"
329 ] 329 ]
330 }, 330 },
331 "testIamPermissions": { 331 "testIamPermissions": {
332 "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.", 332 "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.",
333 "httpMethod": "POST", 333 "httpMethod": "POST",
334 "id": "cloudkms.projects.locations.keyRings. testIamPermissions", 334 "id": "cloudkms.projects.locations.keyRings. testIamPermissions",
335 "parameterOrder": [ 335 "parameterOrder": [
336 "resource" 336 "resource"
337 ], 337 ],
338 "parameters": { 338 "parameters": {
339 "resource": { 339 "resource": {
340 "description": "REQUIRED: The resour ce for which the policy detail is being requested.\n`resource` is usually specif ied as a path. For example, a Project\nresource is specified as `projects/{proje ct}`.", 340 "description": "REQUIRED: The resour ce for which the policy detail is being requested.\n`resource` is usually specif ied as a path. For example, a Project\nresource is specified as `projects/{proje ct}`.",
341 "location": "path", 341 "location": "path",
342 "pattern": "^projects/[^/]+/location s/[^/]+/keyRings/[^/]+$", 342 "pattern": "^projects/[^/]+/location s/[^/]+/keyRings/[^/]+$",
343 "required": true, 343 "required": true,
344 "type": "string" 344 "type": "string"
345 } 345 }
346 }, 346 },
347 "path": "v1beta1/{+resource}:testIamPermissi ons", 347 "path": "v1beta1/{+resource}:testIamPermissi ons",
348 "request": { 348 "request": {
349 "$ref": "TestIamPermissionsRequest" 349 "$ref": "TestIamPermissionsRequest"
350 }, 350 },
351 "response": { 351 "response": {
352 "$ref": "TestIamPermissionsResponse" 352 "$ref": "TestIamPermissionsResponse"
353 }, 353 },
354 "scopes": [ 354 "scopes": [
355 "https://www.googleapis.com/auth/cloud-p latform" 355 "https://www.googleapis.com/auth/cloud-p latform"
356 ] 356 ]
357 } 357 }
358 }, 358 },
359 "resources": { 359 "resources": {
360 "cryptoKeys": { 360 "cryptoKeys": {
361 "methods": { 361 "methods": {
362 "patch": { 362 "updatePrimaryVersion": {
363 "description": "Update a CryptoKey." , 363 "description": "Update the version o f a CryptoKey that will be used in Encrypt",
364 "httpMethod": "PATCH", 364 "httpMethod": "POST",
365 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.patch", 365 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.updatePrimaryVersion",
366 "parameterOrder": [ 366 "parameterOrder": [
367 "name" 367 "name"
368 ], 368 ],
369 "parameters": { 369 "parameters": {
370 "updateMask": {
371 "description": "Required lis t of fields to be updated in this request.",
372 "format": "google-fieldmask" ,
373 "location": "query",
374 "type": "string"
375 },
376 "name": { 370 "name": {
377 "description": "Output only. The resource name for this CryptoKey in the format\n`projects/*/locations/*/key Rings/*/cryptoKeys/*`.", 371 "description": "The resource name of the CryptoKey to update.",
378 "location": "path", 372 "location": "path",
379 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$", 373 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$",
380 "required": true, 374 "required": true,
381 "type": "string" 375 "type": "string"
382 } 376 }
383 }, 377 },
384 "path": "v1beta1/{+name}", 378 "path": "v1beta1/{+name}:updatePrima ryVersion",
385 "request": { 379 "request": {
386 "$ref": "CryptoKey" 380 "$ref": "UpdateCryptoKeyPrimaryV ersionRequest"
387 }, 381 },
388 "response": { 382 "response": {
389 "$ref": "CryptoKey" 383 "$ref": "CryptoKey"
390 }, 384 },
391 "scopes": [ 385 "scopes": [
392 "https://www.googleapis.com/auth /cloud-platform" 386 "https://www.googleapis.com/auth /cloud-platform"
393 ] 387 ]
394 }, 388 },
389 "getIamPolicy": {
390 "description": "Gets the access cont rol policy for a resource.\nReturns an empty policy if the resource exists and d oes not have a policy\nset.",
391 "httpMethod": "GET",
392 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.getIamPolicy",
393 "parameterOrder": [
394 "resource"
395 ],
396 "parameters": {
397 "resource": {
398 "description": "REQUIRED: Th e resource for which the policy is being requested.\n`resource` is usually speci fied as a path. For example, a Project\nresource is specified as `projects/{proj ect}`.",
399 "location": "path",
400 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$",
401 "required": true,
402 "type": "string"
403 }
404 },
405 "path": "v1beta1/{+resource}:getIamP olicy",
406 "response": {
407 "$ref": "Policy"
408 },
409 "scopes": [
410 "https://www.googleapis.com/auth /cloud-platform"
411 ]
412 },
395 "get": { 413 "get": {
396 "description": "Returns metadata for a given CryptoKey, as well as its\nprimary CryptoKeyVersion.", 414 "description": "Returns metadata for a given CryptoKey, as well as its\nprimary CryptoKeyVersion.",
397 "httpMethod": "GET", 415 "httpMethod": "GET",
398 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.get", 416 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.get",
399 "parameterOrder": [ 417 "parameterOrder": [
400 "name" 418 "name"
401 ], 419 ],
402 "parameters": { 420 "parameters": {
403 "name": { 421 "name": {
404 "description": "The name of the CryptoKey to get.", 422 "description": "The name of the CryptoKey to get.",
405 "location": "path", 423 "location": "path",
406 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$", 424 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$",
407 "required": true, 425 "required": true,
408 "type": "string" 426 "type": "string"
409 } 427 }
410 }, 428 },
411 "path": "v1beta1/{+name}", 429 "path": "v1beta1/{+name}",
412 "response": { 430 "response": {
413 "$ref": "CryptoKey" 431 "$ref": "CryptoKey"
414 }, 432 },
415 "scopes": [ 433 "scopes": [
416 "https://www.googleapis.com/auth /cloud-platform" 434 "https://www.googleapis.com/auth /cloud-platform"
417 ] 435 ]
418 }, 436 },
437 "patch": {
438 "description": "Update a CryptoKey." ,
439 "httpMethod": "PATCH",
440 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.patch",
441 "parameterOrder": [
442 "name"
443 ],
444 "parameters": {
445 "updateMask": {
446 "description": "Required lis t of fields to be updated in this request.",
447 "format": "google-fieldmask" ,
448 "location": "query",
449 "type": "string"
450 },
451 "name": {
452 "description": "Output only. The resource name for this CryptoKey in the format\n`projects/*/locations/*/key Rings/*/cryptoKeys/*`.",
453 "location": "path",
454 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$",
455 "required": true,
456 "type": "string"
457 }
458 },
459 "path": "v1beta1/{+name}",
460 "request": {
461 "$ref": "CryptoKey"
462 },
463 "response": {
464 "$ref": "CryptoKey"
465 },
466 "scopes": [
467 "https://www.googleapis.com/auth /cloud-platform"
468 ]
469 },
419 "testIamPermissions": { 470 "testIamPermissions": {
420 "description": "Returns permissions that a caller has on the specified resource.\nIf the resource does not exist, th is will return an empty set of\npermissions, not a NOT_FOUND error.", 471 "description": "Returns permissions that a caller has on the specified resource.\nIf the resource does not exist, th is will return an empty set of\npermissions, not a NOT_FOUND error.\n\nNote: Thi s operation is designed to be used for building permission-aware\nUIs and comman d-line tools, not for authorization checking. This operation\nmay \"fail open\" without warning.",
421 "httpMethod": "POST", 472 "httpMethod": "POST",
422 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.testIamPermissions", 473 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.testIamPermissions",
423 "parameterOrder": [ 474 "parameterOrder": [
424 "resource" 475 "resource"
425 ], 476 ],
426 "parameters": { 477 "parameters": {
427 "resource": { 478 "resource": {
428 "description": "REQUIRED: Th e resource for which the policy detail is being requested.\n`resource` is usuall y specified as a path. For example, a Project\nresource is specified as `project s/{project}`.", 479 "description": "REQUIRED: Th e resource for which the policy detail is being requested.\n`resource` is usuall y specified as a path. For example, a Project\nresource is specified as `project s/{project}`.",
429 "location": "path", 480 "location": "path",
430 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$", 481 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$",
(...skipping 40 matching lines...) Expand 10 before | Expand all | Expand 10 after
471 ] 522 ]
472 }, 523 },
473 "list": { 524 "list": {
474 "description": "Lists CryptoKeys.", 525 "description": "Lists CryptoKeys.",
475 "httpMethod": "GET", 526 "httpMethod": "GET",
476 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.list", 527 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.list",
477 "parameterOrder": [ 528 "parameterOrder": [
478 "parent" 529 "parent"
479 ], 530 ],
480 "parameters": { 531 "parameters": {
532 "parent": {
533 "description": "Required. Th e resource name of the KeyRing to list, in the format\n`projects/*/locations/*/k eyRings/*`.",
534 "location": "path",
535 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+$",
536 "required": true,
537 "type": "string"
538 },
481 "pageToken": { 539 "pageToken": {
482 "description": "Optional pag ination token, returned earlier via\nListCryptoKeysResponse.next_page_token.", 540 "description": "Optional pag ination token, returned earlier via\nListCryptoKeysResponse.next_page_token.",
483 "location": "query", 541 "location": "query",
484 "type": "string" 542 "type": "string"
485 }, 543 },
486 "pageSize": { 544 "pageSize": {
487 "description": "Optional lim it on the number of CryptoKeys to include in the\nresponse. Further CryptoKeys can subsequently be obtained by\nincluding the ListCryptoKeysResponse.next_page_ token in a subsequent\nrequest. If unspecified, the server will pick an appropr iate default.", 545 "description": "Optional lim it on the number of CryptoKeys to include in the\nresponse. Further CryptoKeys can subsequently be obtained by\nincluding the ListCryptoKeysResponse.next_page_ token in a subsequent\nrequest. If unspecified, the server will pick an appropr iate default.",
488 "format": "int32", 546 "format": "int32",
489 "location": "query", 547 "location": "query",
490 "type": "integer" 548 "type": "integer"
491 },
492 "parent": {
493 "description": "Required. Th e resource name of the KeyRing to list, in the format\n`projects/*/locations/*/k eyRings/*`.",
494 "location": "path",
495 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+$",
496 "required": true,
497 "type": "string"
498 } 549 }
499 }, 550 },
500 "path": "v1beta1/{+parent}/cryptoKey s", 551 "path": "v1beta1/{+parent}/cryptoKey s",
501 "response": { 552 "response": {
502 "$ref": "ListCryptoKeysResponse" 553 "$ref": "ListCryptoKeysResponse"
503 }, 554 },
504 "scopes": [ 555 "scopes": [
505 "https://www.googleapis.com/auth /cloud-platform" 556 "https://www.googleapis.com/auth /cloud-platform"
506 ] 557 ]
507 }, 558 },
(...skipping 25 matching lines...) Expand all
533 ] 584 ]
534 }, 585 },
535 "create": { 586 "create": {
536 "description": "Create a new CryptoK ey within a KeyRing.\n\nCryptoKey.purpose is required.", 587 "description": "Create a new CryptoK ey within a KeyRing.\n\nCryptoKey.purpose is required.",
537 "httpMethod": "POST", 588 "httpMethod": "POST",
538 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.create", 589 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.create",
539 "parameterOrder": [ 590 "parameterOrder": [
540 "parent" 591 "parent"
541 ], 592 ],
542 "parameters": { 593 "parameters": {
594 "cryptoKeyId": {
595 "description": "Required. It must be unique within a KeyRing and match the regular\nexpression `[a-zA-Z0-9_- ]{1,63}`",
596 "location": "query",
597 "type": "string"
598 },
543 "parent": { 599 "parent": {
544 "description": "Required. Th e name of the KeyRing associated with the\nCryptoKeys.", 600 "description": "Required. Th e name of the KeyRing associated with the\nCryptoKeys.",
545 "location": "path", 601 "location": "path",
546 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+$", 602 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+$",
547 "required": true, 603 "required": true,
548 "type": "string" 604 "type": "string"
549 },
550 "cryptoKeyId": {
551 "description": "Required. It must be unique within a KeyRing and match the regular\nexpression `[a-zA-Z0-9_- ]{1,63}`",
552 "location": "query",
553 "type": "string"
554 } 605 }
555 }, 606 },
556 "path": "v1beta1/{+parent}/cryptoKey s", 607 "path": "v1beta1/{+parent}/cryptoKey s",
557 "request": { 608 "request": {
558 "$ref": "CryptoKey" 609 "$ref": "CryptoKey"
559 }, 610 },
560 "response": { 611 "response": {
561 "$ref": "CryptoKey" 612 "$ref": "CryptoKey"
562 }, 613 },
563 "scopes": [ 614 "scopes": [
(...skipping 19 matching lines...) Expand all
583 "path": "v1beta1/{+resource}:setIamP olicy", 634 "path": "v1beta1/{+resource}:setIamP olicy",
584 "request": { 635 "request": {
585 "$ref": "SetIamPolicyRequest" 636 "$ref": "SetIamPolicyRequest"
586 }, 637 },
587 "response": { 638 "response": {
588 "$ref": "Policy" 639 "$ref": "Policy"
589 }, 640 },
590 "scopes": [ 641 "scopes": [
591 "https://www.googleapis.com/auth /cloud-platform" 642 "https://www.googleapis.com/auth /cloud-platform"
592 ] 643 ]
593 },
594 "updatePrimaryVersion": {
595 "description": "Update the version o f a CryptoKey that will be used in Encrypt",
596 "httpMethod": "POST",
597 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.updatePrimaryVersion",
598 "parameterOrder": [
599 "name"
600 ],
601 "parameters": {
602 "name": {
603 "description": "The resource name of the CryptoKey to update.",
604 "location": "path",
605 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$",
606 "required": true,
607 "type": "string"
608 }
609 },
610 "path": "v1beta1/{+name}:updatePrima ryVersion",
611 "request": {
612 "$ref": "UpdateCryptoKeyPrimaryV ersionRequest"
613 },
614 "response": {
615 "$ref": "CryptoKey"
616 },
617 "scopes": [
618 "https://www.googleapis.com/auth /cloud-platform"
619 ]
620 },
621 "getIamPolicy": {
622 "description": "Gets the access cont rol policy for a resource.\nReturns an empty policy if the resource exists and d oes not have a policy\nset.",
623 "httpMethod": "GET",
624 "id": "cloudkms.projects.locations.k eyRings.cryptoKeys.getIamPolicy",
625 "parameterOrder": [
626 "resource"
627 ],
628 "parameters": {
629 "resource": {
630 "description": "REQUIRED: Th e resource for which the policy is being requested.\n`resource` is usually speci fied as a path. For example, a Project\nresource is specified as `projects/{proj ect}`.",
631 "location": "path",
632 "pattern": "^projects/[^/]+/ locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$",
633 "required": true,
634 "type": "string"
635 }
636 },
637 "path": "v1beta1/{+resource}:getIamP olicy",
638 "response": {
639 "$ref": "Policy"
640 },
641 "scopes": [
642 "https://www.googleapis.com/auth /cloud-platform"
643 ]
644 } 644 }
645 }, 645 },
646 "resources": { 646 "resources": {
647 "cryptoKeyVersions": { 647 "cryptoKeyVersions": {
648 "methods": { 648 "methods": {
649 "list": { 649 "list": {
650 "description": "Lists Crypto KeyVersions.", 650 "description": "Lists Crypto KeyVersions.",
651 "httpMethod": "GET", 651 "httpMethod": "GET",
652 "id": "cloudkms.projects.loc ations.keyRings.cryptoKeys.cryptoKeyVersions.list", 652 "id": "cloudkms.projects.loc ations.keyRings.cryptoKeys.cryptoKeyVersions.list",
653 "parameterOrder": [ 653 "parameterOrder": [
654 "parent" 654 "parent"
655 ], 655 ],
656 "parameters": { 656 "parameters": {
657 "parent": {
658 "description": "Requ ired. The resource name of the CryptoKey to list, in the format\n`projects/*/loc ations/*/keyRings/*/cryptoKeys/*`.",
659 "location": "path",
660 "pattern": "^project s/[^/]+/locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$",
661 "required": true,
662 "type": "string"
663 },
657 "pageToken": { 664 "pageToken": {
658 "description": "Opti onal pagination token, returned earlier via\nListCryptoKeyVersionsResponse.next_ page_token.", 665 "description": "Opti onal pagination token, returned earlier via\nListCryptoKeyVersionsResponse.next_ page_token.",
659 "location": "query", 666 "location": "query",
660 "type": "string" 667 "type": "string"
661 }, 668 },
662 "pageSize": { 669 "pageSize": {
663 "description": "Opti onal limit on the number of CryptoKeyVersions to\ninclude in the response. Furth er CryptoKeyVersions can\nsubsequently be obtained by including the\nListCryptoK eyVersionsResponse.next_page_token in a subsequent request.\nIf unspecified, the server will pick an appropriate default.", 670 "description": "Opti onal limit on the number of CryptoKeyVersions to\ninclude in the response. Furth er CryptoKeyVersions can\nsubsequently be obtained by including the\nListCryptoK eyVersionsResponse.next_page_token in a subsequent request.\nIf unspecified, the server will pick an appropriate default.",
664 "format": "int32", 671 "format": "int32",
665 "location": "query", 672 "location": "query",
666 "type": "integer" 673 "type": "integer"
667 },
668 "parent": {
669 "description": "Requ ired. The resource name of the CryptoKey to list, in the format\n`projects/*/loc ations/*/keyRings/*/cryptoKeys/*`.",
670 "location": "path",
671 "pattern": "^project s/[^/]+/locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$",
672 "required": true,
673 "type": "string"
674 } 674 }
675 }, 675 },
676 "path": "v1beta1/{+parent}/c ryptoKeyVersions", 676 "path": "v1beta1/{+parent}/c ryptoKeyVersions",
677 "response": { 677 "response": {
678 "$ref": "ListCryptoKeyVe rsionsResponse" 678 "$ref": "ListCryptoKeyVe rsionsResponse"
679 }, 679 },
680 "scopes": [ 680 "scopes": [
681 "https://www.googleapis. com/auth/cloud-platform" 681 "https://www.googleapis. com/auth/cloud-platform"
682 ] 682 ]
683 }, 683 },
684 "destroy": { 684 "create": {
685 "description": "Schedule a C ryptoKeyVersion for destruction.\n\nUpon calling this method, CryptoKeyVersion.s tate will be set to\nDESTROY_SCHEDULED\nand destroy_time will be set to a time 2 4\nhours in the future, at which point the state\nwill be changed to\nDESTROYED, and the key\nmaterial will be irrevocably destroyed.\n\nBefore the destroy_time is reached,\nRestoreCryptoKeyVersion may be called to reverse the process.", 685 "description": "Create a new CryptoKeyVersion in a CryptoKey.\n\nThe server will assign the next sequential id. If unset,\nstate will be set to\nENABLED.",
686 "httpMethod": "POST", 686 "httpMethod": "POST",
687 "id": "cloudkms.projects.loc ations.keyRings.cryptoKeys.cryptoKeyVersions.destroy", 687 "id": "cloudkms.projects.loc ations.keyRings.cryptoKeys.cryptoKeyVersions.create",
688 "parameterOrder": [ 688 "parameterOrder": [
689 "name" 689 "parent"
690 ], 690 ],
691 "parameters": { 691 "parameters": {
692 "name": { 692 "parent": {
693 "description": "The resource name of the CryptoKeyVersion to destroy.", 693 "description": "Requ ired. The name of the CryptoKey associated with\nthe CryptoKeyVersions.",
694 "location": "path", 694 "location": "path",
695 "pattern": "^project s/[^/]+/locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+/cryptoKeyVersions/[^/]+$ ", 695 "pattern": "^project s/[^/]+/locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$",
696 "required": true, 696 "required": true,
697 "type": "string" 697 "type": "string"
698 } 698 }
699 }, 699 },
700 "path": "v1beta1/{+name}:des troy", 700 "path": "v1beta1/{+parent}/c ryptoKeyVersions",
701 "request": { 701 "request": {
702 "$ref": "DestroyCryptoKe yVersionRequest" 702 "$ref": "CryptoKeyVersio n"
703 }, 703 },
704 "response": { 704 "response": {
705 "$ref": "CryptoKeyVersio n" 705 "$ref": "CryptoKeyVersio n"
706 }, 706 },
707 "scopes": [ 707 "scopes": [
708 "https://www.googleapis. com/auth/cloud-platform" 708 "https://www.googleapis. com/auth/cloud-platform"
709 ] 709 ]
710 }, 710 },
711 "create": { 711 "destroy": {
712 "description": "Create a new CryptoKeyVersion in a CryptoKey.\n\nThe server will assign the next sequential id. If unset,\nstate will be set to\nENABLED.", 712 "description": "Schedule a C ryptoKeyVersion for destruction.\n\nUpon calling this method, CryptoKeyVersion.s tate will be set to\nDESTROY_SCHEDULED\nand destroy_time will be set to a time 2 4\nhours in the future, at which point the state\nwill be changed to\nDESTROYED, and the key\nmaterial will be irrevocably destroyed.\n\nBefore the destroy_time is reached,\nRestoreCryptoKeyVersion may be called to reverse the process.",
713 "httpMethod": "POST", 713 "httpMethod": "POST",
714 "id": "cloudkms.projects.loc ations.keyRings.cryptoKeys.cryptoKeyVersions.create", 714 "id": "cloudkms.projects.loc ations.keyRings.cryptoKeys.cryptoKeyVersions.destroy",
715 "parameterOrder": [ 715 "parameterOrder": [
716 "parent" 716 "name"
717 ], 717 ],
718 "parameters": { 718 "parameters": {
719 "parent": { 719 "name": {
720 "description": "Requ ired. The name of the CryptoKey associated with\nthe CryptoKeyVersions.", 720 "description": "The resource name of the CryptoKeyVersion to destroy.",
721 "location": "path", 721 "location": "path",
722 "pattern": "^project s/[^/]+/locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+$", 722 "pattern": "^project s/[^/]+/locations/[^/]+/keyRings/[^/]+/cryptoKeys/[^/]+/cryptoKeyVersions/[^/]+$ ",
723 "required": true, 723 "required": true,
724 "type": "string" 724 "type": "string"
725 } 725 }
726 }, 726 },
727 "path": "v1beta1/{+parent}/c ryptoKeyVersions", 727 "path": "v1beta1/{+name}:des troy",
728 "request": { 728 "request": {
729 "$ref": "CryptoKeyVersio n" 729 "$ref": "DestroyCryptoKe yVersionRequest"
730 }, 730 },
731 "response": { 731 "response": {
732 "$ref": "CryptoKeyVersio n" 732 "$ref": "CryptoKeyVersio n"
733 }, 733 },
734 "scopes": [ 734 "scopes": [
735 "https://www.googleapis. com/auth/cloud-platform" 735 "https://www.googleapis. com/auth/cloud-platform"
736 ] 736 ]
737 }, 737 },
738 "restore": { 738 "restore": {
739 "description": "Restore a Cr yptoKeyVersion in the\nDESTROY_SCHEDULED,\nstate.\n\nUpon restoration of the Cry ptoKeyVersion, state\nwill be set to DISABLED,\nand destroy_time will be cleared .", 739 "description": "Restore a Cr yptoKeyVersion in the\nDESTROY_SCHEDULED,\nstate.\n\nUpon restoration of the Cry ptoKeyVersion, state\nwill be set to DISABLED,\nand destroy_time will be cleared .",
(...skipping 83 matching lines...) Expand 10 before | Expand all | Expand 10 after
823 } 823 }
824 } 824 }
825 } 825 }
826 } 826 }
827 } 827 }
828 } 828 }
829 } 829 }
830 } 830 }
831 } 831 }
832 }, 832 },
833 "revision": "20170201", 833 "revision": "20170222",
834 "rootUrl": "https://cloudkms.googleapis.com/", 834 "rootUrl": "https://cloudkms.googleapis.com/",
835 "schemas": { 835 "schemas": {
836 "DecryptResponse": {
837 "description": "Response message for KeyManagementService.Decrypt.",
838 "id": "DecryptResponse",
839 "properties": {
840 "plaintext": {
841 "description": "The decrypted data originally supplied in En cryptRequest.plaintext.",
842 "format": "byte",
843 "type": "string"
844 }
845 },
846 "type": "object"
847 },
848 "TestIamPermissionsRequest": {
849 "description": "Request message for `TestIamPermissions` method.",
850 "id": "TestIamPermissionsRequest",
851 "properties": {
852 "permissions": {
853 "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).",
854 "items": {
855 "type": "string"
856 },
857 "type": "array"
858 }
859 },
860 "type": "object"
861 },
862 "Policy": {
863 "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).",
864 "id": "Policy",
865 "properties": {
866 "etag": {
867 "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.",
868 "format": "byte",
869 "type": "string"
870 },
871 "iamOwned": {
872 "type": "boolean"
873 },
874 "rules": {
875 "description": "If more than one rule is specified, the rule s are applied in the following\nmanner:\n- All matching LOG rules are always app lied.\n- If any DENY/DENY_WITH_LOG rule matches, permission is denied.\n Loggin g will be applied if one or more matching rule requires logging.\n- Otherwise, i f any ALLOW/ALLOW_WITH_LOG rule matches, permission is\n granted.\n Logging wi ll be applied if one or more matching rule requires logging.\n- Otherwise, if no rule applies, permission is denied.",
876 "items": {
877 "$ref": "Rule"
878 },
879 "type": "array"
880 },
881 "version": {
882 "description": "Version of the `Policy`. The default version is 0.",
883 "format": "int32",
884 "type": "integer"
885 },
886 "auditConfigs": {
887 "description": "Specifies cloud audit logging configuration for this policy.",
888 "items": {
889 "$ref": "AuditConfig"
890 },
891 "type": "array"
892 },
893 "bindings": {
894 "description": "Associates a list of `members` to a `role`.\ nMultiple `bindings` must not be specified for the same `role`.\n`bindings` with no members will result in an error.",
895 "items": {
896 "$ref": "Binding"
897 },
898 "type": "array"
899 }
900 },
901 "type": "object"
902 },
903 "ListLocationsResponse": {
904 "description": "The response message for Locations.ListLocations.",
905 "id": "ListLocationsResponse",
906 "properties": {
907 "locations": {
908 "description": "A list of locations that matches the specifi ed filter in the request.",
909 "items": {
910 "$ref": "Location"
911 },
912 "type": "array"
913 },
914 "nextPageToken": {
915 "description": "The standard List next-page token.",
916 "type": "string"
917 }
918 },
919 "type": "object"
920 },
921 "KeyRing": {
922 "description": "A KeyRing is a toplevel logical grouping of CryptoKe ys.",
923 "id": "KeyRing",
924 "properties": {
925 "createTime": {
926 "description": "Output only. The time at which this KeyRing was created.",
927 "format": "google-datetime",
928 "type": "string"
929 },
930 "name": {
931 "description": "Output only. The resource name for the KeyRi ng in the format\n`projects/*/locations/*/keyRings/*`.",
932 "type": "string"
933 }
934 },
935 "type": "object"
936 },
937 "EncryptResponse": {
938 "description": "Response message for KeyManagementService.Encrypt.",
939 "id": "EncryptResponse",
940 "properties": {
941 "name": {
942 "description": "The resource name of the CryptoKeyVersion us ed in encryption.",
943 "type": "string"
944 },
945 "ciphertext": {
946 "description": "The encrypted data.",
947 "format": "byte",
948 "type": "string"
949 }
950 },
951 "type": "object"
952 },
953 "RestoreCryptoKeyVersionRequest": {
954 "description": "Request message for KeyManagementService.RestoreCryp toKeyVersion.",
955 "id": "RestoreCryptoKeyVersionRequest",
956 "properties": {},
957 "type": "object"
958 },
959 "UpdateCryptoKeyPrimaryVersionRequest": {
960 "description": "Request message for KeyManagementService.UpdateCrypt oKeyPrimaryVersion.",
961 "id": "UpdateCryptoKeyPrimaryVersionRequest",
962 "properties": {
963 "cryptoKeyVersionId": {
964 "description": "The id of the child CryptoKeyVersion to use as primary.",
965 "type": "string"
966 }
967 },
968 "type": "object"
969 },
970 "ListKeyRingsResponse": {
971 "description": "Response message for KeyManagementService.ListKeyRin gs.",
972 "id": "ListKeyRingsResponse",
973 "properties": {
974 "nextPageToken": {
975 "description": "A token to retrieve next page of results. Pa ss this value in\nListKeyRingsRequest.page_token to retrieve the next page of re sults.",
976 "type": "string"
977 },
978 "totalSize": {
979 "description": "The total number of KeyRings that matched th e query.",
980 "format": "int32",
981 "type": "integer"
982 },
983 "keyRings": {
984 "description": "The list of KeyRings.",
985 "items": {
986 "$ref": "KeyRing"
987 },
988 "type": "array"
989 }
990 },
991 "type": "object"
992 },
993 "DataAccessOptions": {
994 "description": "Write a Data Access (Gin) log",
995 "id": "DataAccessOptions",
996 "properties": {},
997 "type": "object"
998 },
999 "AuditConfig": {
1000 "description": "Specifies the audit configuration for a service.\nIt consists of which permission types are logged, and what identities, if\nany, ar e exempted from logging.\nAn AuditConifg must have one or more AuditLogConfigs." ,
1001 "id": "AuditConfig",
1002 "properties": {
1003 "service": {
1004 "description": "Specifies a service that will be enabled for audit logging.\nFor example, `resourcemanager`, `storage`, `compute`.\n`allServ ices` is a special value that covers all services.",
1005 "type": "string"
1006 },
1007 "auditLogConfigs": {
1008 "description": "The configuration for logging of each type o f permission.\nNext ID: 4",
1009 "items": {
1010 "$ref": "AuditLogConfig"
1011 },
1012 "type": "array"
1013 },
1014 "exemptedMembers": {
1015 "description": "Specifies the identities that are exempted f rom \"data access\" audit\nlogging for the `service` specified above.\nFollows t he same format of Binding.members.\nThis field is deprecated in favor of per-per mission-type exemptions.",
1016 "items": {
1017 "type": "string"
1018 },
1019 "type": "array"
1020 }
1021 },
1022 "type": "object"
1023 },
1024 "CryptoKeyVersion": {
1025 "description": "A CryptoKeyVersion represents an individual cryptogr aphic key, and the\nassociated key material.\n\nIt can be used for cryptographic operations either directly, or via its\nparent CryptoKey, in which case the ser ver will choose the appropriate\nversion for the operation.",
1026 "id": "CryptoKeyVersion",
1027 "properties": {
1028 "createTime": {
1029 "description": "Output only. The time at which this CryptoKe yVersion was created.",
1030 "format": "google-datetime",
1031 "type": "string"
1032 },
1033 "state": {
1034 "description": "The current state of the CryptoKeyVersion.",
1035 "enum": [
1036 "CRYPTO_KEY_VERSION_STATE_UNSPECIFIED",
1037 "ENABLED",
1038 "DISABLED",
1039 "DESTROYED",
1040 "DESTROY_SCHEDULED"
1041 ],
1042 "enumDescriptions": [
1043 "Not specified.",
1044 "This version may be used in Encrypt and\nDecrypt reques ts.",
1045 "This version may not be used, but the key material is s till available,\nand the version can be placed back into the ENABLED state.",
1046 "This version is destroyed, and the key material is no l onger stored.\nA version may not leave this state once entered.",
1047 "This version is scheduled for destruction, and will be destroyed soon.\nCall\nRestoreCryptoKeyVersion\nto put it back into the DISABLED state."
1048 ],
1049 "type": "string"
1050 },
1051 "name": {
1052 "description": "Output only. The resource name for this Cryp toKeyVersion in the format\n`projects/*/locations/*/keyRings/*/cryptoKeys/*/cryp toKeyVersions/*`.",
1053 "type": "string"
1054 },
1055 "destroyEventTime": {
1056 "description": "Output only. The time this CryptoKeyVersion' s key material was\ndestroyed. Only present if state is\nDESTROYED.",
1057 "format": "google-datetime",
1058 "type": "string"
1059 },
1060 "destroyTime": {
1061 "description": "Output only. The time this CryptoKeyVersion' s key material is scheduled\nfor destruction. Only present if state is\nDESTROY_ SCHEDULED.",
1062 "format": "google-datetime",
1063 "type": "string"
1064 }
1065 },
1066 "type": "object"
1067 },
1068 "CloudAuditOptions": {
1069 "description": "Write a Cloud Audit log",
1070 "id": "CloudAuditOptions",
1071 "properties": {},
1072 "type": "object"
1073 },
1074 "Binding": {
1075 "description": "Associates `members` with a `role`.",
1076 "id": "Binding",
1077 "properties": {
1078 "members": {
1079 "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* `domain:{domain}`: A Google Apps domain name that represe nts all the\n users of that domain. For example, `google.com` or `example.com` .\n\n",
1080 "items": {
1081 "type": "string"
1082 },
1083 "type": "array"
1084 },
1085 "role": {
1086 "description": "Role that is assigned to `members`.\nFor exa mple, `roles/viewer`, `roles/editor`, or `roles/owner`.\nRequired",
1087 "type": "string"
1088 }
1089 },
1090 "type": "object"
1091 },
1092 "EncryptRequest": {
1093 "description": "Request message for KeyManagementService.Encrypt.",
1094 "id": "EncryptRequest",
1095 "properties": {
1096 "plaintext": {
1097 "description": "Required. The data to encrypt. Must be no la rger than 64KiB.",
1098 "format": "byte",
1099 "type": "string"
1100 },
1101 "additionalAuthenticatedData": {
1102 "description": "Optional data that, if specified, must also be provided during decryption\nthrough DecryptRequest.additional_authenticated_d ata. Must be no\nlarger than 64KiB.",
1103 "format": "byte",
1104 "type": "string"
1105 }
1106 },
1107 "type": "object"
1108 },
1109 "ListCryptoKeyVersionsResponse": {
1110 "description": "Response message for KeyManagementService.ListCrypto KeyVersions.",
1111 "id": "ListCryptoKeyVersionsResponse",
1112 "properties": {
1113 "totalSize": {
1114 "description": "The total number of CryptoKeyVersions that m atched the\nquery.",
1115 "format": "int32",
1116 "type": "integer"
1117 },
1118 "cryptoKeyVersions": {
1119 "description": "The list of CryptoKeyVersions.",
1120 "items": {
1121 "$ref": "CryptoKeyVersion"
1122 },
1123 "type": "array"
1124 },
1125 "nextPageToken": {
1126 "description": "A token to retrieve next page of results. Pa ss this value in\nListCryptoKeyVersionsRequest.page_token to retrieve the next p age of\nresults.",
1127 "type": "string"
1128 }
1129 },
1130 "type": "object"
1131 },
1132 "TestIamPermissionsResponse": {
1133 "description": "Response message for `TestIamPermissions` method.",
1134 "id": "TestIamPermissionsResponse",
1135 "properties": {
1136 "permissions": {
1137 "description": "A subset of `TestPermissionsRequest.permissi ons` that the caller is\nallowed.",
1138 "items": {
1139 "type": "string"
1140 },
1141 "type": "array"
1142 }
1143 },
1144 "type": "object"
1145 },
1146 "DestroyCryptoKeyVersionRequest": {
1147 "description": "Request message for KeyManagementService.DestroyCryp toKeyVersion.",
1148 "id": "DestroyCryptoKeyVersionRequest",
1149 "properties": {},
1150 "type": "object"
1151 },
1152 "CryptoKey": { 836 "CryptoKey": {
1153 "description": "A CryptoKey represents a logical key that can be use d for cryptographic\noperations.\n\nA CryptoKey is made up of one or more versio ns, which\nrepresent the actual key material used in cryptographic operations.", 837 "description": "A CryptoKey represents a logical key that can be use d for cryptographic\noperations.\n\nA CryptoKey is made up of one or more versio ns, which\nrepresent the actual key material used in cryptographic operations.",
1154 "id": "CryptoKey", 838 "id": "CryptoKey",
1155 "properties": { 839 "properties": {
1156 "createTime": {
1157 "description": "Output only. The time at which this CryptoKe y was created.",
1158 "format": "google-datetime",
1159 "type": "string"
1160 },
1161 "rotationPeriod": {
1162 "description": "next_rotation_time will be advanced by this period when the service\nautomatically rotates a key. Must be at least one day.\ n\nIf rotation_period is set, next_rotation_time must also be set.",
1163 "format": "google-duration",
1164 "type": "string"
1165 },
1166 "primary": {
1167 "$ref": "CryptoKeyVersion",
1168 "description": "Output only. A copy of the \"primary\" Crypt oKeyVersion that will be used\nby Encrypt when this CryptoKey is given\nin Encry ptRequest.name.\n\nThe CryptoKey's primary version can be updated via\nUpdateCry ptoKeyPrimaryVersion."
1169 },
1170 "name": {
1171 "description": "Output only. The resource name for this Cryp toKey in the format\n`projects/*/locations/*/keyRings/*/cryptoKeys/*`.",
1172 "type": "string"
1173 },
1174 "purpose": { 840 "purpose": {
1175 "description": "The immutable purpose of this CryptoKey. Cur rently, the only acceptable\npurpose is ENCRYPT_DECRYPT.", 841 "description": "The immutable purpose of this CryptoKey. Cur rently, the only acceptable\npurpose is ENCRYPT_DECRYPT.",
1176 "enum": [ 842 "enum": [
1177 "CRYPTO_KEY_PURPOSE_UNSPECIFIED", 843 "CRYPTO_KEY_PURPOSE_UNSPECIFIED",
1178 "ENCRYPT_DECRYPT" 844 "ENCRYPT_DECRYPT"
1179 ], 845 ],
1180 "enumDescriptions": [ 846 "enumDescriptions": [
1181 "Not specified.", 847 "Not specified.",
1182 "CryptoKeys with this purpose may be used with\nEncrypt and\nDecrypt." 848 "CryptoKeys with this purpose may be used with\nEncrypt and\nDecrypt."
1183 ], 849 ],
1184 "type": "string" 850 "type": "string"
1185 }, 851 },
1186 "nextRotationTime": { 852 "nextRotationTime": {
1187 "description": "At next_rotation_time, the Key Management Se rvice will automatically:\n\n1. Create a new version of this CryptoKey.\n2. Mark the new version as primary.\n\nKey rotations performed manually via\nCreateCryp toKeyVersion and\nUpdateCryptoKeyPrimaryVersion\ndo not affect next_rotation_tim e.", 853 "description": "At next_rotation_time, the Key Management Se rvice will automatically:\n\n1. Create a new version of this CryptoKey.\n2. Mark the new version as primary.\n\nKey rotations performed manually via\nCreateCryp toKeyVersion and\nUpdateCryptoKeyPrimaryVersion\ndo not affect next_rotation_tim e.",
1188 "format": "google-datetime", 854 "format": "google-datetime",
1189 "type": "string" 855 "type": "string"
856 },
857 "createTime": {
858 "description": "Output only. The time at which this CryptoKe y was created.",
859 "format": "google-datetime",
860 "type": "string"
861 },
862 "rotationPeriod": {
863 "description": "next_rotation_time will be advanced by this period when the service\nautomatically rotates a key. Must be at least one day.\ n\nIf rotation_period is set, next_rotation_time must also be set.",
864 "format": "google-duration",
865 "type": "string"
866 },
867 "primary": {
868 "$ref": "CryptoKeyVersion",
869 "description": "Output only. A copy of the \"primary\" Crypt oKeyVersion that will be used\nby Encrypt when this CryptoKey is given\nin Encry ptRequest.name.\n\nThe CryptoKey's primary version can be updated via\nUpdateCry ptoKeyPrimaryVersion."
870 },
871 "name": {
872 "description": "Output only. The resource name for this Cryp toKey in the format\n`projects/*/locations/*/keyRings/*/cryptoKeys/*`.",
873 "type": "string"
1190 } 874 }
1191 }, 875 },
1192 "type": "object" 876 "type": "object"
1193 }, 877 },
1194 "Rule": { 878 "Rule": {
1195 "description": "A rule to be applied in a Policy.", 879 "description": "A rule to be applied in a Policy.",
1196 "id": "Rule", 880 "id": "Rule",
1197 "properties": { 881 "properties": {
1198 "description": {
1199 "description": "Human-readable description of the rule.",
1200 "type": "string"
1201 },
1202 "conditions": {
1203 "description": "Additional restrictions that must be met",
1204 "items": {
1205 "$ref": "Condition"
1206 },
1207 "type": "array"
1208 },
1209 "logConfig": {
1210 "description": "The config returned to callers of tech.iam.I AM.CheckPolicy for any entries\nthat match the LOG action.",
1211 "items": {
1212 "$ref": "LogConfig"
1213 },
1214 "type": "array"
1215 },
1216 "in": { 882 "in": {
1217 "description": "If one or more 'in' clauses are specified, t he rule matches if\nthe PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.", 883 "description": "If one or more 'in' clauses are specified, t he rule matches if\nthe PRINCIPAL/AUTHORITY_SELECTOR is in at least one of these entries.",
1218 "items": { 884 "items": {
1219 "type": "string" 885 "type": "string"
1220 }, 886 },
1221 "type": "array" 887 "type": "array"
1222 }, 888 },
1223 "permissions": { 889 "permissions": {
1224 "description": "A permission is a string of form '<service>. <resource type>.<verb>'\n(e.g., 'storage.buckets.list'). A value of '*' matches all permissions,\nand a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.", 890 "description": "A permission is a string of form '<service>. <resource type>.<verb>'\n(e.g., 'storage.buckets.list'). A value of '*' matches all permissions,\nand a verb part of '*' (e.g., 'storage.buckets.*') matches all verbs.",
1225 "items": { 891 "items": {
(...skipping 20 matching lines...) Expand all
1246 "Matching 'Entries' tell IAM.Check callers to generate l ogs." 912 "Matching 'Entries' tell IAM.Check callers to generate l ogs."
1247 ], 913 ],
1248 "type": "string" 914 "type": "string"
1249 }, 915 },
1250 "notIn": { 916 "notIn": {
1251 "description": "If one or more 'not_in' clauses are specifie d, the rule matches\nif the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entri es.\nThe format for in and not_in entries is the same as for members in a\nBindi ng (see google/iam/v1/policy.proto).", 917 "description": "If one or more 'not_in' clauses are specifie d, the rule matches\nif the PRINCIPAL/AUTHORITY_SELECTOR is in none of the entri es.\nThe format for in and not_in entries is the same as for members in a\nBindi ng (see google/iam/v1/policy.proto).",
1252 "items": { 918 "items": {
1253 "type": "string" 919 "type": "string"
1254 }, 920 },
1255 "type": "array" 921 "type": "array"
922 },
923 "description": {
924 "description": "Human-readable description of the rule.",
925 "type": "string"
926 },
927 "conditions": {
928 "description": "Additional restrictions that must be met",
929 "items": {
930 "$ref": "Condition"
931 },
932 "type": "array"
933 },
934 "logConfig": {
935 "description": "The config returned to callers of tech.iam.I AM.CheckPolicy for any entries\nthat match the LOG action.",
936 "items": {
937 "$ref": "LogConfig"
938 },
939 "type": "array"
1256 } 940 }
1257 }, 941 },
1258 "type": "object" 942 "type": "object"
1259 }, 943 },
1260 "LogConfig": { 944 "LogConfig": {
1261 "description": "Specifies what kind of log the caller must write\nIn crement a streamz counter with the specified metric and field names.\n\nMetric n ames should start with a '/', generally be lowercase-only,\nand end in \"_count\ ". Field names should not contain an initial slash.\nThe actual exported metric names will have \"/iam/policy\" prepended.\n\nField names correspond to IAM requ est parameters and field values are\ntheir respective values.\n\nAt present the only supported field names are\n - \"iam_principal\", corresponding to IAMCont ext.principal;\n - \"\" (empty string), resulting in one aggretated counter wi th no field.\n\nExamples:\n counter { metric: \"/debug_access_count\" field: \ "iam_principal\" }\n ==> increment counter /iam/policy/backend_debug_access_cou nt\n {iam_principal=[value of IAMContext.principal]}\n\nA t this time we do not support:\n* multiple field names (though this may be suppo rted in the future)\n* decrementing the counter\n* incrementing it by anything o ther than 1", 945 "description": "Specifies what kind of log the caller must write\nIn crement a streamz counter with the specified metric and field names.\n\nMetric n ames should start with a '/', generally be lowercase-only,\nand end in \"_count\ ". Field names should not contain an initial slash.\nThe actual exported metric names will have \"/iam/policy\" prepended.\n\nField names correspond to IAM requ est parameters and field values are\ntheir respective values.\n\nAt present the only supported field names are\n - \"iam_principal\", corresponding to IAMCont ext.principal;\n - \"\" (empty string), resulting in one aggretated counter wi th no field.\n\nExamples:\n counter { metric: \"/debug_access_count\" field: \ "iam_principal\" }\n ==> increment counter /iam/policy/backend_debug_access_cou nt\n {iam_principal=[value of IAMContext.principal]}\n\nA t this time we do not support:\n* multiple field names (though this may be suppo rted in the future)\n* decrementing the counter\n* incrementing it by anything o ther than 1",
1262 "id": "LogConfig", 946 "id": "LogConfig",
1263 "properties": { 947 "properties": {
948 "counter": {
949 "$ref": "CounterOptions",
950 "description": "Counter options."
951 },
1264 "dataAccess": { 952 "dataAccess": {
1265 "$ref": "DataAccessOptions", 953 "$ref": "DataAccessOptions",
1266 "description": "Data access options." 954 "description": "Data access options."
1267 }, 955 },
1268 "cloudAudit": { 956 "cloudAudit": {
1269 "$ref": "CloudAuditOptions", 957 "$ref": "CloudAuditOptions",
1270 "description": "Cloud audit options." 958 "description": "Cloud audit options."
1271 },
1272 "counter": {
1273 "$ref": "CounterOptions",
1274 "description": "Counter options."
1275 } 959 }
1276 }, 960 },
1277 "type": "object" 961 "type": "object"
1278 }, 962 },
1279 "SetIamPolicyRequest": { 963 "SetIamPolicyRequest": {
1280 "description": "Request message for `SetIamPolicy` method.", 964 "description": "Request message for `SetIamPolicy` method.",
1281 "id": "SetIamPolicyRequest", 965 "id": "SetIamPolicyRequest",
1282 "properties": { 966 "properties": {
967 "policy": {
968 "$ref": "Policy",
969 "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."
970 },
1283 "updateMask": { 971 "updateMask": {
1284 "description": "OPTIONAL: A FieldMask specifying which field s of the policy to modify. Only\nthe fields in the mask will be modified. If no mask is provided, a default\nmask is used:\npaths: \"bindings, etag\"\nThis fiel d is only used by Cloud IAM.", 972 "description": "OPTIONAL: A FieldMask specifying which field s of the policy to modify. Only\nthe fields in the mask will be modified. If no mask is provided, a default\nmask is used:\npaths: \"bindings, etag\"\nThis fiel d is only used by Cloud IAM.",
1285 "format": "google-fieldmask", 973 "format": "google-fieldmask",
1286 "type": "string" 974 "type": "string"
1287 },
1288 "policy": {
1289 "$ref": "Policy",
1290 "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."
1291 } 975 }
1292 }, 976 },
1293 "type": "object" 977 "type": "object"
1294 }, 978 },
1295 "DecryptRequest": { 979 "DecryptRequest": {
1296 "description": "Request message for KeyManagementService.Decrypt.", 980 "description": "Request message for KeyManagementService.Decrypt.",
1297 "id": "DecryptRequest", 981 "id": "DecryptRequest",
1298 "properties": { 982 "properties": {
1299 "ciphertext": { 983 "ciphertext": {
1300 "description": "Required. The encrypted data originally retu rned in\nEncryptResponse.ciphertext.", 984 "description": "Required. The encrypted data originally retu rned in\nEncryptResponse.ciphertext.",
(...skipping 58 matching lines...) Expand 10 before | Expand all | Expand 10 after
1359 "format": "int32", 1043 "format": "int32",
1360 "type": "integer" 1044 "type": "integer"
1361 } 1045 }
1362 }, 1046 },
1363 "type": "object" 1047 "type": "object"
1364 }, 1048 },
1365 "Condition": { 1049 "Condition": {
1366 "description": "A condition to be met.", 1050 "description": "A condition to be met.",
1367 "id": "Condition", 1051 "id": "Condition",
1368 "properties": { 1052 "properties": {
1053 "iam": {
1054 "description": "Trusted attributes supplied by the IAM syste m.",
1055 "enum": [
1056 "NO_ATTR",
1057 "AUTHORITY",
1058 "ATTRIBUTION",
1059 "APPROVER"
1060 ],
1061 "enumDescriptions": [
1062 "Default non-attribute.",
1063 "Either principal or (if present) authority selector.",
1064 "The principal (even if an authority selector is present ), which\nmust only be used for attribution, not authorization.",
1065 "An approver (distinct from the requester) that has auth orized this\nrequest.\nWhen used with IN, the condition indicates that one of th e approvers\nassociated with the request matches the specified principal, or is a\nmember of the specified group. Approvers can only grant additional\naccess, a nd are thus only used in a strictly positive context\n(e.g. ALLOW/IN or DENY/NOT _IN).\nSee: go/rpc-security-policy-dynamicauth."
1066 ],
1067 "type": "string"
1068 },
1069 "values": {
1070 "description": "The objects of the condition. This is mutual ly exclusive with 'value'.",
1071 "items": {
1072 "type": "string"
1073 },
1074 "type": "array"
1075 },
1369 "op": { 1076 "op": {
1370 "description": "An operator to apply the subject with.", 1077 "description": "An operator to apply the subject with.",
1371 "enum": [ 1078 "enum": [
1372 "NO_OP", 1079 "NO_OP",
1373 "EQUALS", 1080 "EQUALS",
1374 "NOT_EQUALS", 1081 "NOT_EQUALS",
1375 "IN", 1082 "IN",
1376 "NOT_IN", 1083 "NOT_IN",
1377 "DISCHARGED" 1084 "DISCHARGED"
1378 ], 1085 ],
1379 "enumDescriptions": [ 1086 "enumDescriptions": [
1380 "Default no-op.", 1087 "Default no-op.",
1381 "DEPRECATED. Use IN instead.", 1088 "DEPRECATED. Use IN instead.",
1382 "DEPRECATED. Use NOT_IN instead.", 1089 "DEPRECATED. Use NOT_IN instead.",
1383 "Set-inclusion check.", 1090 "Set-inclusion check.",
1384 "Set-exclusion check.", 1091 "Set-exclusion check.",
1385 "Subject is discharged" 1092 "Subject is discharged"
1386 ], 1093 ],
1387 "type": "string" 1094 "type": "string"
1388 }, 1095 },
1389 "svc": { 1096 "svc": {
1390 "description": "Trusted attributes discharged by the service .", 1097 "description": "Trusted attributes discharged by the service .",
1391 "type": "string" 1098 "type": "string"
1392 }, 1099 },
1100 "value": {
1101 "description": "DEPRECATED. Use 'values' instead.",
1102 "type": "string"
1103 },
1393 "sys": { 1104 "sys": {
1394 "description": "Trusted attributes supplied by any service t hat owns resources and uses\nthe IAM system for access control.", 1105 "description": "Trusted attributes supplied by any service t hat owns resources and uses\nthe IAM system for access control.",
1395 "enum": [ 1106 "enum": [
1396 "NO_ATTR", 1107 "NO_ATTR",
1397 "REGION", 1108 "REGION",
1398 "SERVICE", 1109 "SERVICE",
1399 "NAME", 1110 "NAME",
1400 "IP" 1111 "IP"
1401 ], 1112 ],
1402 "enumDescriptions": [ 1113 "enumDescriptions": [
1403 "Default non-attribute type", 1114 "Default non-attribute type",
1404 "Region of the resource", 1115 "Region of the resource",
1405 "Service name", 1116 "Service name",
1406 "Resource name", 1117 "Resource name",
1407 "IP address of the caller" 1118 "IP address of the caller"
1408 ], 1119 ],
1409 "type": "string" 1120 "type": "string"
1410 },
1411 "value": {
1412 "description": "DEPRECATED. Use 'values' instead.",
1413 "type": "string"
1414 },
1415 "values": {
1416 "description": "The objects of the condition. This is mutual ly exclusive with 'value'.",
1417 "items": {
1418 "type": "string"
1419 },
1420 "type": "array"
1421 },
1422 "iam": {
1423 "description": "Trusted attributes supplied by the IAM syste m.",
1424 "enum": [
1425 "NO_ATTR",
1426 "AUTHORITY",
1427 "ATTRIBUTION"
1428 ],
1429 "enumDescriptions": [
1430 "Default non-attribute.",
1431 "Either principal or (if present) authority selector.",
1432 "The principal (even if an authority selector is present ), which\nmust only be used for attribution, not authorization."
1433 ],
1434 "type": "string"
1435 } 1121 }
1436 }, 1122 },
1437 "type": "object" 1123 "type": "object"
1438 }, 1124 },
1439 "CounterOptions": { 1125 "CounterOptions": {
1440 "description": "Options for counters", 1126 "description": "Options for counters",
1441 "id": "CounterOptions", 1127 "id": "CounterOptions",
1442 "properties": { 1128 "properties": {
1443 "metric": { 1129 "metric": {
1444 "description": "The metric to update.", 1130 "description": "The metric to update.",
1445 "type": "string" 1131 "type": "string"
1446 }, 1132 },
1447 "field": { 1133 "field": {
1448 "description": "The field value to attribute.", 1134 "description": "The field value to attribute.",
1449 "type": "string" 1135 "type": "string"
1450 } 1136 }
1451 }, 1137 },
1452 "type": "object" 1138 "type": "object"
1453 }, 1139 },
1454 "AuditLogConfig": { 1140 "AuditLogConfig": {
1455 "description": "Provides the configuration for logging a type of per missions.\nExample:\n\n {\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\",\n \"exempted_members\": [\n \"user:foo@gmail.com\"\n ]\n },\n {\n \"log_type \": \"DATA_WRITE\",\n }\n ]\n }\n\nThis enables 'DATA_READ' and ' DATA_WRITE' logging, while exempting\nfoo@gmail.com from DATA_READ logging.", 1141 "description": "Provides the configuration for logging a type of per missions.\nExample:\n\n {\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\",\n \"exempted_members\": [\n \"user:foo@gmail.com\"\n ]\n },\n {\n \"log_type \": \"DATA_WRITE\",\n }\n ]\n }\n\nThis enables 'DATA_READ' and ' DATA_WRITE' logging, while exempting\nfoo@gmail.com from DATA_READ logging.",
1456 "id": "AuditLogConfig", 1142 "id": "AuditLogConfig",
1457 "properties": { 1143 "properties": {
1458 "exemptedMembers": {
1459 "description": "Specifies the identities that do not cause l ogging for this type of\npermission.\nFollows the same format of Binding.members .",
1460 "items": {
1461 "type": "string"
1462 },
1463 "type": "array"
1464 },
1465 "logType": { 1144 "logType": {
1466 "description": "The log type that this config enables.", 1145 "description": "The log type that this config enables.",
1467 "enum": [ 1146 "enum": [
1468 "LOG_TYPE_UNSPECIFIED", 1147 "LOG_TYPE_UNSPECIFIED",
1469 "ADMIN_READ", 1148 "ADMIN_READ",
1470 "DATA_WRITE", 1149 "DATA_WRITE",
1471 "DATA_READ" 1150 "DATA_READ"
1472 ], 1151 ],
1473 "enumDescriptions": [ 1152 "enumDescriptions": [
1474 "Default case. Should never be this.", 1153 "Default case. Should never be this.",
1475 "Admin reads. Example: CloudIAM getIamPolicy", 1154 "Admin reads. Example: CloudIAM getIamPolicy",
1476 "Data writes. Example: CloudSQL Users create", 1155 "Data writes. Example: CloudSQL Users create",
1477 "Data reads. Example: CloudSQL Users list" 1156 "Data reads. Example: CloudSQL Users list"
1478 ], 1157 ],
1479 "type": "string" 1158 "type": "string"
1480 } 1159 },
1481 }, 1160 "exemptedMembers": {
1161 "description": "Specifies the identities that do not cause l ogging for this type of\npermission.\nFollows the same format of Binding.members .",
1162 "items": {
1163 "type": "string"
1164 },
1165 "type": "array"
1166 }
1167 },
1168 "type": "object"
1169 },
1170 "DecryptResponse": {
1171 "description": "Response message for KeyManagementService.Decrypt.",
1172 "id": "DecryptResponse",
1173 "properties": {
1174 "plaintext": {
1175 "description": "The decrypted data originally supplied in En cryptRequest.plaintext.",
1176 "format": "byte",
1177 "type": "string"
1178 }
1179 },
1180 "type": "object"
1181 },
1182 "TestIamPermissionsRequest": {
1183 "description": "Request message for `TestIamPermissions` method.",
1184 "id": "TestIamPermissionsRequest",
1185 "properties": {
1186 "permissions": {
1187 "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).",
1188 "items": {
1189 "type": "string"
1190 },
1191 "type": "array"
1192 }
1193 },
1194 "type": "object"
1195 },
1196 "Policy": {
1197 "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).",
1198 "id": "Policy",
1199 "properties": {
1200 "version": {
1201 "description": "Version of the `Policy`. The default version is 0.",
1202 "format": "int32",
1203 "type": "integer"
1204 },
1205 "auditConfigs": {
1206 "description": "Specifies cloud audit logging configuration for this policy.",
1207 "items": {
1208 "$ref": "AuditConfig"
1209 },
1210 "type": "array"
1211 },
1212 "bindings": {
1213 "description": "Associates a list of `members` to a `role`.\ nMultiple `bindings` must not be specified for the same `role`.\n`bindings` with no members will result in an error.",
1214 "items": {
1215 "$ref": "Binding"
1216 },
1217 "type": "array"
1218 },
1219 "etag": {
1220 "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.",
1221 "format": "byte",
1222 "type": "string"
1223 },
1224 "iamOwned": {
1225 "type": "boolean"
1226 },
1227 "rules": {
1228 "description": "If more than one rule is specified, the rule s are applied in the following\nmanner:\n- All matching LOG rules are always app lied.\n- If any DENY/DENY_WITH_LOG rule matches, permission is denied.\n Loggin g will be applied if one or more matching rule requires logging.\n- Otherwise, i f any ALLOW/ALLOW_WITH_LOG rule matches, permission is\n granted.\n Logging wi ll be applied if one or more matching rule requires logging.\n- Otherwise, if no rule applies, permission is denied.",
1229 "items": {
1230 "$ref": "Rule"
1231 },
1232 "type": "array"
1233 }
1234 },
1235 "type": "object"
1236 },
1237 "EncryptResponse": {
1238 "description": "Response message for KeyManagementService.Encrypt.",
1239 "id": "EncryptResponse",
1240 "properties": {
1241 "ciphertext": {
1242 "description": "The encrypted data.",
1243 "format": "byte",
1244 "type": "string"
1245 },
1246 "name": {
1247 "description": "The resource name of the CryptoKeyVersion us ed in encryption.",
1248 "type": "string"
1249 }
1250 },
1251 "type": "object"
1252 },
1253 "ListLocationsResponse": {
1254 "description": "The response message for Locations.ListLocations.",
1255 "id": "ListLocationsResponse",
1256 "properties": {
1257 "nextPageToken": {
1258 "description": "The standard List next-page token.",
1259 "type": "string"
1260 },
1261 "locations": {
1262 "description": "A list of locations that matches the specifi ed filter in the request.",
1263 "items": {
1264 "$ref": "Location"
1265 },
1266 "type": "array"
1267 }
1268 },
1269 "type": "object"
1270 },
1271 "KeyRing": {
1272 "description": "A KeyRing is a toplevel logical grouping of CryptoKe ys.",
1273 "id": "KeyRing",
1274 "properties": {
1275 "createTime": {
1276 "description": "Output only. The time at which this KeyRing was created.",
1277 "format": "google-datetime",
1278 "type": "string"
1279 },
1280 "name": {
1281 "description": "Output only. The resource name for the KeyRi ng in the format\n`projects/*/locations/*/keyRings/*`.",
1282 "type": "string"
1283 }
1284 },
1285 "type": "object"
1286 },
1287 "RestoreCryptoKeyVersionRequest": {
1288 "description": "Request message for KeyManagementService.RestoreCryp toKeyVersion.",
1289 "id": "RestoreCryptoKeyVersionRequest",
1290 "properties": {},
1291 "type": "object"
1292 },
1293 "UpdateCryptoKeyPrimaryVersionRequest": {
1294 "description": "Request message for KeyManagementService.UpdateCrypt oKeyPrimaryVersion.",
1295 "id": "UpdateCryptoKeyPrimaryVersionRequest",
1296 "properties": {
1297 "cryptoKeyVersionId": {
1298 "description": "The id of the child CryptoKeyVersion to use as primary.",
1299 "type": "string"
1300 }
1301 },
1302 "type": "object"
1303 },
1304 "DataAccessOptions": {
1305 "description": "Write a Data Access (Gin) log",
1306 "id": "DataAccessOptions",
1307 "properties": {},
1308 "type": "object"
1309 },
1310 "ListKeyRingsResponse": {
1311 "description": "Response message for KeyManagementService.ListKeyRin gs.",
1312 "id": "ListKeyRingsResponse",
1313 "properties": {
1314 "nextPageToken": {
1315 "description": "A token to retrieve next page of results. Pa ss this value in\nListKeyRingsRequest.page_token to retrieve the next page of re sults.",
1316 "type": "string"
1317 },
1318 "totalSize": {
1319 "description": "The total number of KeyRings that matched th e query.",
1320 "format": "int32",
1321 "type": "integer"
1322 },
1323 "keyRings": {
1324 "description": "The list of KeyRings.",
1325 "items": {
1326 "$ref": "KeyRing"
1327 },
1328 "type": "array"
1329 }
1330 },
1331 "type": "object"
1332 },
1333 "AuditConfig": {
1334 "description": "Specifies the audit configuration for a service.\nIt consists of which permission types are logged, and what identities, if\nany, ar e exempted from logging.\nAn AuditConifg must have one or more AuditLogConfigs.\ n\nIf there are AuditConfigs for both `allServices` and a specific service,\nthe union of the two AuditConfigs is used for that service: the log_types\nspecifie d in each AuditConfig are enabled, and the exempted_members in each\nAuditConfig are exempted.\nExample Policy with multiple AuditConfigs:\n{\n \"audit_configs \": [\n {\n \"service\": \"allServices\"\n \"audit_log_configs\": [ \n {\n \"log_type\": \"DATA_READ\",\n \"exempted_member s\": [\n \"user:foo@gmail.com\"\n ]\n },\n {\n \"log_type\": \"DATA_WRITE\",\n },\n {\n \"log_ type\": \"ADMIN_READ\",\n }\n ]\n },\n {\n \"service\": \ "fooservice@googleapis.com\"\n \"audit_log_configs\": [\n {\n \"log_type\": \"DATA_READ\",\n },\n {\n \"log_type\": \"DATA_WRITE\",\n \"exempted_members\": [\n \"user:bar@gmail .com\"\n ]\n }\n ]\n }\n ]\n}\nFor fooservice, this pol icy enables DATA_READ, DATA_WRITE and ADMIN_READ\nlogging. It also exempts foo@g mail.com from DATA_READ logging, and\nbar@gmail.com from DATA_WRITE logging.",
1335 "id": "AuditConfig",
1336 "properties": {
1337 "exemptedMembers": {
1338 "items": {
1339 "type": "string"
1340 },
1341 "type": "array"
1342 },
1343 "service": {
1344 "description": "Specifies a service that will be enabled for audit logging.\nFor example, `resourcemanager`, `storage`, `compute`.\n`allServ ices` is a special value that covers all services.",
1345 "type": "string"
1346 },
1347 "auditLogConfigs": {
1348 "description": "The configuration for logging of each type o f permission.\nNext ID: 4",
1349 "items": {
1350 "$ref": "AuditLogConfig"
1351 },
1352 "type": "array"
1353 }
1354 },
1355 "type": "object"
1356 },
1357 "CryptoKeyVersion": {
1358 "description": "A CryptoKeyVersion represents an individual cryptogr aphic key, and the\nassociated key material.\n\nIt can be used for cryptographic operations either directly, or via its\nparent CryptoKey, in which case the ser ver will choose the appropriate\nversion for the operation.",
1359 "id": "CryptoKeyVersion",
1360 "properties": {
1361 "state": {
1362 "description": "The current state of the CryptoKeyVersion.",
1363 "enum": [
1364 "CRYPTO_KEY_VERSION_STATE_UNSPECIFIED",
1365 "ENABLED",
1366 "DISABLED",
1367 "DESTROYED",
1368 "DESTROY_SCHEDULED"
1369 ],
1370 "enumDescriptions": [
1371 "Not specified.",
1372 "This version may be used in Encrypt and\nDecrypt reques ts.",
1373 "This version may not be used, but the key material is s till available,\nand the version can be placed back into the ENABLED state.",
1374 "This version is destroyed, and the key material is no l onger stored.\nA version may not leave this state once entered.",
1375 "This version is scheduled for destruction, and will be destroyed soon.\nCall\nRestoreCryptoKeyVersion\nto put it back into the DISABLED state."
1376 ],
1377 "type": "string"
1378 },
1379 "name": {
1380 "description": "Output only. The resource name for this Cryp toKeyVersion in the format\n`projects/*/locations/*/keyRings/*/cryptoKeys/*/cryp toKeyVersions/*`.",
1381 "type": "string"
1382 },
1383 "destroyEventTime": {
1384 "description": "Output only. The time this CryptoKeyVersion' s key material was\ndestroyed. Only present if state is\nDESTROYED.",
1385 "format": "google-datetime",
1386 "type": "string"
1387 },
1388 "destroyTime": {
1389 "description": "Output only. The time this CryptoKeyVersion' s key material is scheduled\nfor destruction. Only present if state is\nDESTROY_ SCHEDULED.",
1390 "format": "google-datetime",
1391 "type": "string"
1392 },
1393 "createTime": {
1394 "description": "Output only. The time at which this CryptoKe yVersion was created.",
1395 "format": "google-datetime",
1396 "type": "string"
1397 }
1398 },
1399 "type": "object"
1400 },
1401 "CloudAuditOptions": {
1402 "description": "Write a Cloud Audit log",
1403 "id": "CloudAuditOptions",
1404 "properties": {},
1405 "type": "object"
1406 },
1407 "Binding": {
1408 "description": "Associates `members` with a `role`.",
1409 "id": "Binding",
1410 "properties": {
1411 "role": {
1412 "description": "Role that is assigned to `members`.\nFor exa mple, `roles/viewer`, `roles/editor`, or `roles/owner`.\nRequired",
1413 "type": "string"
1414 },
1415 "members": {
1416 "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* `domain:{domain}`: A Google Apps domain name that represe nts all the\n users of that domain. For example, `google.com` or `example.com` .\n\n",
1417 "items": {
1418 "type": "string"
1419 },
1420 "type": "array"
1421 }
1422 },
1423 "type": "object"
1424 },
1425 "EncryptRequest": {
1426 "description": "Request message for KeyManagementService.Encrypt.",
1427 "id": "EncryptRequest",
1428 "properties": {
1429 "additionalAuthenticatedData": {
1430 "description": "Optional data that, if specified, must also be provided during decryption\nthrough DecryptRequest.additional_authenticated_d ata. Must be no\nlarger than 64KiB.",
1431 "format": "byte",
1432 "type": "string"
1433 },
1434 "plaintext": {
1435 "description": "Required. The data to encrypt. Must be no la rger than 64KiB.",
1436 "format": "byte",
1437 "type": "string"
1438 }
1439 },
1440 "type": "object"
1441 },
1442 "ListCryptoKeyVersionsResponse": {
1443 "description": "Response message for KeyManagementService.ListCrypto KeyVersions.",
1444 "id": "ListCryptoKeyVersionsResponse",
1445 "properties": {
1446 "cryptoKeyVersions": {
1447 "description": "The list of CryptoKeyVersions.",
1448 "items": {
1449 "$ref": "CryptoKeyVersion"
1450 },
1451 "type": "array"
1452 },
1453 "nextPageToken": {
1454 "description": "A token to retrieve next page of results. Pa ss this value in\nListCryptoKeyVersionsRequest.page_token to retrieve the next p age of\nresults.",
1455 "type": "string"
1456 },
1457 "totalSize": {
1458 "description": "The total number of CryptoKeyVersions that m atched the\nquery.",
1459 "format": "int32",
1460 "type": "integer"
1461 }
1462 },
1463 "type": "object"
1464 },
1465 "TestIamPermissionsResponse": {
1466 "description": "Response message for `TestIamPermissions` method.",
1467 "id": "TestIamPermissionsResponse",
1468 "properties": {
1469 "permissions": {
1470 "description": "A subset of `TestPermissionsRequest.permissi ons` that the caller is\nallowed.",
1471 "items": {
1472 "type": "string"
1473 },
1474 "type": "array"
1475 }
1476 },
1477 "type": "object"
1478 },
1479 "DestroyCryptoKeyVersionRequest": {
1480 "description": "Request message for KeyManagementService.DestroyCryp toKeyVersion.",
1481 "id": "DestroyCryptoKeyVersionRequest",
1482 "properties": {},
1482 "type": "object" 1483 "type": "object"
1483 } 1484 }
1484 }, 1485 },
1485 "servicePath": "", 1486 "servicePath": "",
1486 "title": "Google Cloud Key Management Service (KMS) API", 1487 "title": "Google Cloud Key Management Service (KMS) API",
1487 "version": "v1beta1" 1488 "version": "v1beta1"
1488 } 1489 }
OLDNEW
« no previous file with comments | « discovery/googleapis_beta/clouderrorreporting__v1beta1.json ('k') | discovery/googleapis_beta/cloudmonitoring__v2beta2.json » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698