OLD | NEW |
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://sourcerepo.googleapis.com/", | 12 "baseUrl": "https://sourcerepo.googleapis.com/", |
13 "batchPath": "batch", | 13 "batchPath": "batch", |
14 "canonicalName": "Cloud Source Repositories", | 14 "canonicalName": "Cloud Source Repositories", |
15 "description": "Access source code repositories hosted by Google.", | 15 "description": "Access source code repositories hosted by Google.", |
16 "discoveryVersion": "v1", | 16 "discoveryVersion": "v1", |
17 "documentationLink": "https://cloud.google.com/eap/cloud-repositories/cloud-
sourcerepo-api", | 17 "documentationLink": "https://cloud.google.com/eap/cloud-repositories/cloud-
sourcerepo-api", |
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": "sourcerepo:v1", | 22 "id": "sourcerepo:v1", |
23 "kind": "discovery#restDescription", | 23 "kind": "discovery#restDescription", |
24 "name": "sourcerepo", | 24 "name": "sourcerepo", |
25 "ownerDomain": "google.com", | 25 "ownerDomain": "google.com", |
26 "ownerName": "Google", | 26 "ownerName": "Google", |
27 "parameters": { | 27 "parameters": { |
28 "quotaUser": { | |
29 "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.", | |
30 "location": "query", | |
31 "type": "string" | |
32 }, | |
33 "pp": { | |
34 "default": "true", | |
35 "description": "Pretty-print response.", | |
36 "location": "query", | |
37 "type": "boolean" | |
38 }, | |
39 "bearer_token": { | 28 "bearer_token": { |
40 "description": "OAuth bearer token.", | 29 "description": "OAuth bearer token.", |
41 "location": "query", | 30 "location": "query", |
42 "type": "string" | 31 "type": "string" |
43 }, | 32 }, |
44 "oauth_token": { | 33 "oauth_token": { |
45 "description": "OAuth 2.0 token for the current user.", | 34 "description": "OAuth 2.0 token for the current user.", |
46 "location": "query", | 35 "location": "query", |
47 "type": "string" | 36 "type": "string" |
48 }, | 37 }, |
49 "upload_protocol": { | 38 "upload_protocol": { |
50 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", | 39 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", |
51 "location": "query", | 40 "location": "query", |
52 "type": "string" | 41 "type": "string" |
53 }, | 42 }, |
54 "prettyPrint": { | 43 "prettyPrint": { |
55 "default": "true", | 44 "default": "true", |
56 "description": "Returns response with indentations and line breaks."
, | 45 "description": "Returns response with indentations and line breaks."
, |
57 "location": "query", | 46 "location": "query", |
58 "type": "boolean" | 47 "type": "boolean" |
59 }, | 48 }, |
| 49 "fields": { |
| 50 "description": "Selector specifying which fields to include in a par
tial response.", |
| 51 "location": "query", |
| 52 "type": "string" |
| 53 }, |
60 "uploadType": { | 54 "uploadType": { |
61 "description": "Legacy upload protocol for media (e.g. \"media\", \"
multipart\").", | 55 "description": "Legacy upload protocol for media (e.g. \"media\", \"
multipart\").", |
62 "location": "query", | 56 "location": "query", |
63 "type": "string" | 57 "type": "string" |
64 }, | 58 }, |
65 "fields": { | |
66 "description": "Selector specifying which fields to include in a par
tial response.", | |
67 "location": "query", | |
68 "type": "string" | |
69 }, | |
70 "callback": { | 59 "callback": { |
71 "description": "JSONP", | 60 "description": "JSONP", |
72 "location": "query", | 61 "location": "query", |
73 "type": "string" | 62 "type": "string" |
74 }, | 63 }, |
75 "$.xgafv": { | 64 "$.xgafv": { |
76 "description": "V1 error format.", | 65 "description": "V1 error format.", |
77 "enum": [ | 66 "enum": [ |
78 "1", | 67 "1", |
79 "2" | 68 "2" |
(...skipping 23 matching lines...) Expand all Loading... |
103 }, | 92 }, |
104 "key": { | 93 "key": { |
105 "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.", | 94 "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.", |
106 "location": "query", | 95 "location": "query", |
107 "type": "string" | 96 "type": "string" |
108 }, | 97 }, |
109 "access_token": { | 98 "access_token": { |
110 "description": "OAuth access token.", | 99 "description": "OAuth access token.", |
111 "location": "query", | 100 "location": "query", |
112 "type": "string" | 101 "type": "string" |
| 102 }, |
| 103 "quotaUser": { |
| 104 "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.", |
| 105 "location": "query", |
| 106 "type": "string" |
| 107 }, |
| 108 "pp": { |
| 109 "default": "true", |
| 110 "description": "Pretty-print response.", |
| 111 "location": "query", |
| 112 "type": "boolean" |
113 } | 113 } |
114 }, | 114 }, |
115 "protocol": "rest", | 115 "protocol": "rest", |
116 "resources": { | 116 "resources": { |
117 "projects": { | 117 "projects": { |
118 "resources": { | 118 "resources": { |
119 "repos": { | 119 "repos": { |
120 "methods": { | 120 "methods": { |
121 "list": { | 121 "list": { |
122 "description": "Returns all repos belonging to a pro
ject.", | 122 "description": "Returns all repos belonging to a pro
ject.", |
(...skipping 12 matching lines...) Expand all Loading... |
135 } | 135 } |
136 }, | 136 }, |
137 "path": "v1/{+name}/repos", | 137 "path": "v1/{+name}/repos", |
138 "response": { | 138 "response": { |
139 "$ref": "ListReposResponse" | 139 "$ref": "ListReposResponse" |
140 }, | 140 }, |
141 "scopes": [ | 141 "scopes": [ |
142 "https://www.googleapis.com/auth/cloud-platform" | 142 "https://www.googleapis.com/auth/cloud-platform" |
143 ] | 143 ] |
144 }, | 144 }, |
| 145 "create": { |
| 146 "description": "Creates a repo in the given project
with the given name..\n\nIf the named repository already exists, `CreateRepo` re
turns\n`ALREADY_EXISTS`.", |
| 147 "httpMethod": "POST", |
| 148 "id": "sourcerepo.projects.repos.create", |
| 149 "parameterOrder": [ |
| 150 "parent" |
| 151 ], |
| 152 "parameters": { |
| 153 "parent": { |
| 154 "description": "The project in which to crea
te the repo. Values are of the form\n`projects/<project>`.", |
| 155 "location": "path", |
| 156 "pattern": "^projects/[^/]+$", |
| 157 "required": true, |
| 158 "type": "string" |
| 159 } |
| 160 }, |
| 161 "path": "v1/{+parent}/repos", |
| 162 "request": { |
| 163 "$ref": "Repo" |
| 164 }, |
| 165 "response": { |
| 166 "$ref": "Repo" |
| 167 }, |
| 168 "scopes": [ |
| 169 "https://www.googleapis.com/auth/cloud-platform" |
| 170 ] |
| 171 }, |
145 "setIamPolicy": { | 172 "setIamPolicy": { |
146 "description": "Sets the access control policy on th
e specified resource. Replaces any\nexisting policy.", | 173 "description": "Sets the access control policy on th
e specified resource. Replaces any\nexisting policy.", |
147 "httpMethod": "POST", | 174 "httpMethod": "POST", |
148 "id": "sourcerepo.projects.repos.setIamPolicy", | 175 "id": "sourcerepo.projects.repos.setIamPolicy", |
149 "parameterOrder": [ | 176 "parameterOrder": [ |
150 "resource" | 177 "resource" |
151 ], | 178 ], |
152 "parameters": { | 179 "parameters": { |
153 "resource": { | 180 "resource": { |
154 "description": "REQUIRED: The resource for w
hich the policy is being specified.\nSee the operation documentation for the app
ropriate value for this field.", | 181 "description": "REQUIRED: The resource for w
hich the policy is being specified.\nSee the operation documentation for the app
ropriate value for this field.", |
155 "location": "path", | 182 "location": "path", |
156 "pattern": "^projects/[^/]+/repos/.+$", | 183 "pattern": "^projects/[^/]+/repos/.+$", |
157 "required": true, | 184 "required": true, |
158 "type": "string" | 185 "type": "string" |
159 } | 186 } |
160 }, | 187 }, |
161 "path": "v1/{+resource}:setIamPolicy", | 188 "path": "v1/{+resource}:setIamPolicy", |
162 "request": { | 189 "request": { |
163 "$ref": "SetIamPolicyRequest" | 190 "$ref": "SetIamPolicyRequest" |
164 }, | 191 }, |
165 "response": { | 192 "response": { |
166 "$ref": "Policy" | 193 "$ref": "Policy" |
167 }, | 194 }, |
168 "scopes": [ | 195 "scopes": [ |
169 "https://www.googleapis.com/auth/cloud-platform" | 196 "https://www.googleapis.com/auth/cloud-platform" |
170 ] | |
171 }, | |
172 "create": { | |
173 "description": "Creates a repo in the given project
with the given name..\n\nIf the named repository already exists, `CreateRepo` re
turns\n`ALREADY_EXISTS`.", | |
174 "httpMethod": "POST", | |
175 "id": "sourcerepo.projects.repos.create", | |
176 "parameterOrder": [ | |
177 "parent" | |
178 ], | |
179 "parameters": { | |
180 "parent": { | |
181 "description": "The project in which to crea
te the repo. Values are of the form\n`projects/<project>`.", | |
182 "location": "path", | |
183 "pattern": "^projects/[^/]+$", | |
184 "required": true, | |
185 "type": "string" | |
186 } | |
187 }, | |
188 "path": "v1/{+parent}/repos", | |
189 "request": { | |
190 "$ref": "Repo" | |
191 }, | |
192 "response": { | |
193 "$ref": "Repo" | |
194 }, | |
195 "scopes": [ | |
196 "https://www.googleapis.com/auth/cloud-platform" | |
197 ] | 197 ] |
198 }, | 198 }, |
199 "getIamPolicy": { | 199 "getIamPolicy": { |
200 "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.", | 200 "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.", |
201 "httpMethod": "GET", | 201 "httpMethod": "GET", |
202 "id": "sourcerepo.projects.repos.getIamPolicy", | 202 "id": "sourcerepo.projects.repos.getIamPolicy", |
203 "parameterOrder": [ | 203 "parameterOrder": [ |
204 "resource" | 204 "resource" |
205 ], | 205 ], |
206 "parameters": { | 206 "parameters": { |
(...skipping 86 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
293 }, | 293 }, |
294 "scopes": [ | 294 "scopes": [ |
295 "https://www.googleapis.com/auth/cloud-platform" | 295 "https://www.googleapis.com/auth/cloud-platform" |
296 ] | 296 ] |
297 } | 297 } |
298 } | 298 } |
299 } | 299 } |
300 } | 300 } |
301 } | 301 } |
302 }, | 302 }, |
303 "revision": "20170228", | 303 "revision": "20170321", |
304 "rootUrl": "https://sourcerepo.googleapis.com/", | 304 "rootUrl": "https://sourcerepo.googleapis.com/", |
305 "schemas": { | 305 "schemas": { |
306 "AuditLogConfig": { | 306 "SetIamPolicyRequest": { |
307 "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.", | 307 "description": "Request message for `SetIamPolicy` method.", |
308 "id": "AuditLogConfig", | 308 "id": "SetIamPolicyRequest", |
309 "properties": { | 309 "properties": { |
310 "logType": { | 310 "updateMask": { |
311 "description": "The log type that this config enables.", | 311 "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, the\nfollowing default mask is used:\npaths: \"bindings, etag\
"\nThis field is only used by Cloud IAM.", |
312 "enum": [ | 312 "format": "google-fieldmask", |
313 "LOG_TYPE_UNSPECIFIED", | |
314 "ADMIN_READ", | |
315 "DATA_WRITE", | |
316 "DATA_READ" | |
317 ], | |
318 "enumDescriptions": [ | |
319 "Default case. Should never be this.", | |
320 "Admin reads. Example: CloudIAM getIamPolicy", | |
321 "Data writes. Example: CloudSQL Users create", | |
322 "Data reads. Example: CloudSQL Users list" | |
323 ], | |
324 "type": "string" | 313 "type": "string" |
325 }, | 314 }, |
326 "exemptedMembers": { | 315 "policy": { |
327 "description": "Specifies the identities that do not cause l
ogging for this type of\npermission.\nFollows the same format of Binding.members
.", | 316 "$ref": "Policy", |
328 "items": { | 317 "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." |
329 "type": "string" | |
330 }, | |
331 "type": "array" | |
332 } | 318 } |
333 }, | 319 }, |
334 "type": "object" | 320 "type": "object" |
335 }, | 321 }, |
336 "Rule": { | 322 "CloudAuditOptions": { |
337 "description": "A rule to be applied in a Policy.", | 323 "description": "Write a Cloud Audit log", |
338 "id": "Rule", | 324 "id": "CloudAuditOptions", |
| 325 "properties": {}, |
| 326 "type": "object" |
| 327 }, |
| 328 "Binding": { |
| 329 "description": "Associates `members` with a `role`.", |
| 330 "id": "Binding", |
339 "properties": { | 331 "properties": { |
340 "description": { | 332 "members": { |
341 "description": "Human-readable description of the rule.", | 333 "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", |
342 "type": "string" | |
343 }, | |
344 "conditions": { | |
345 "description": "Additional restrictions that must be met", | |
346 "items": { | |
347 "$ref": "Condition" | |
348 }, | |
349 "type": "array" | |
350 }, | |
351 "logConfig": { | |
352 "description": "The config returned to callers of tech.iam.I
AM.CheckPolicy for any entries\nthat match the LOG action.", | |
353 "items": { | |
354 "$ref": "LogConfig" | |
355 }, | |
356 "type": "array" | |
357 }, | |
358 "in": { | |
359 "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.", | |
360 "items": { | 334 "items": { |
361 "type": "string" | 335 "type": "string" |
362 }, | 336 }, |
363 "type": "array" | 337 "type": "array" |
364 }, | 338 }, |
365 "permissions": { | 339 "role": { |
366 "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.", | 340 "description": "Role that is assigned to `members`.\nFor exa
mple, `roles/viewer`, `roles/editor`, or `roles/owner`.\nRequired", |
367 "items": { | |
368 "type": "string" | |
369 }, | |
370 "type": "array" | |
371 }, | |
372 "action": { | |
373 "description": "Required", | |
374 "enum": [ | |
375 "NO_ACTION", | |
376 "ALLOW", | |
377 "ALLOW_WITH_LOG", | |
378 "DENY", | |
379 "DENY_WITH_LOG", | |
380 "LOG" | |
381 ], | |
382 "enumDescriptions": [ | |
383 "Default no action.", | |
384 "Matching 'Entries' grant access.", | |
385 "Matching 'Entries' grant access and the caller promises
to log\nthe request per the returned log_configs.", | |
386 "Matching 'Entries' deny access.", | |
387 "Matching 'Entries' deny access and the caller promises
to log\nthe request per the returned log_configs.", | |
388 "Matching 'Entries' tell IAM.Check callers to generate l
ogs." | |
389 ], | |
390 "type": "string" | 341 "type": "string" |
391 }, | |
392 "notIn": { | |
393 "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).", | |
394 "items": { | |
395 "type": "string" | |
396 }, | |
397 "type": "array" | |
398 } | 342 } |
399 }, | 343 }, |
400 "type": "object" | 344 "type": "object" |
401 }, | 345 }, |
402 "LogConfig": { | 346 "Empty": { |
403 "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", | 347 "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 `{}`.", |
404 "id": "LogConfig", | 348 "id": "Empty", |
| 349 "properties": {}, |
| 350 "type": "object" |
| 351 }, |
| 352 "MirrorConfig": { |
| 353 "description": "Configuration to automatically mirror a repository f
rom another\nhosting service, for example GitHub or BitBucket.", |
| 354 "id": "MirrorConfig", |
405 "properties": { | 355 "properties": { |
406 "cloudAudit": { | 356 "deployKeyId": { |
407 "$ref": "CloudAuditOptions", | 357 "description": "ID of the SSH deploy key at the other hostin
g service.\nRemoving this key from the other service would deauthorize\nGoogle C
loud Source Repositories from mirroring.", |
408 "description": "Cloud audit options." | 358 "type": "string" |
409 }, | 359 }, |
410 "counter": { | 360 "url": { |
411 "$ref": "CounterOptions", | 361 "description": "URL of the main repository at the other host
ing service.", |
412 "description": "Counter options." | 362 "type": "string" |
413 }, | 363 }, |
414 "dataAccess": { | 364 "webhookId": { |
415 "$ref": "DataAccessOptions", | 365 "description": "ID of the webhook listening to updates to tr
igger mirroring.\nRemoving this webook from the other hosting service will stop\
nGoogle Cloud Source Repositories from receiving notifications,\nand thereby dis
abling mirroring.", |
416 "description": "Data access options." | 366 "type": "string" |
417 } | 367 } |
418 }, | 368 }, |
419 "type": "object" | 369 "type": "object" |
420 }, | 370 }, |
421 "TestIamPermissionsRequest": { | 371 "Repo": { |
422 "description": "Request message for `TestIamPermissions` method.", | 372 "description": "A repository (or repo) is a Git repository storing v
ersioned source content.", |
423 "id": "TestIamPermissionsRequest", | 373 "id": "Repo", |
| 374 "properties": { |
| 375 "mirrorConfig": { |
| 376 "$ref": "MirrorConfig", |
| 377 "description": "How this repository mirrors a repository man
aged by another service." |
| 378 }, |
| 379 "url": { |
| 380 "description": "URL to clone the repository from Google Clou
d Source Repositories.", |
| 381 "type": "string" |
| 382 }, |
| 383 "size": { |
| 384 "description": "The size in bytes of the repo.", |
| 385 "format": "int64", |
| 386 "type": "string" |
| 387 }, |
| 388 "name": { |
| 389 "description": "Resource name of the repository, of the form
\n`projects/<project>/repos/<repo>`.", |
| 390 "type": "string" |
| 391 } |
| 392 }, |
| 393 "type": "object" |
| 394 }, |
| 395 "TestIamPermissionsResponse": { |
| 396 "description": "Response message for `TestIamPermissions` method.", |
| 397 "id": "TestIamPermissionsResponse", |
424 "properties": { | 398 "properties": { |
425 "permissions": { | 399 "permissions": { |
426 "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).", | 400 "description": "A subset of `TestPermissionsRequest.permissi
ons` that the caller is\nallowed.", |
427 "items": { | 401 "items": { |
428 "type": "string" | 402 "type": "string" |
429 }, | 403 }, |
430 "type": "array" | 404 "type": "array" |
431 } | 405 } |
432 }, | 406 }, |
433 "type": "object" | 407 "type": "object" |
434 }, | 408 }, |
435 "Policy": { | |
436 "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).", | |
437 "id": "Policy", | |
438 "properties": { | |
439 "etag": { | |
440 "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.", | |
441 "format": "byte", | |
442 "type": "string" | |
443 }, | |
444 "iamOwned": { | |
445 "type": "boolean" | |
446 }, | |
447 "rules": { | |
448 "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.", | |
449 "items": { | |
450 "$ref": "Rule" | |
451 }, | |
452 "type": "array" | |
453 }, | |
454 "version": { | |
455 "description": "Version of the `Policy`. The default version
is 0.", | |
456 "format": "int32", | |
457 "type": "integer" | |
458 }, | |
459 "auditConfigs": { | |
460 "description": "Specifies cloud audit logging configuration
for this policy.", | |
461 "items": { | |
462 "$ref": "AuditConfig" | |
463 }, | |
464 "type": "array" | |
465 }, | |
466 "bindings": { | |
467 "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.", | |
468 "items": { | |
469 "$ref": "Binding" | |
470 }, | |
471 "type": "array" | |
472 } | |
473 }, | |
474 "type": "object" | |
475 }, | |
476 "DataAccessOptions": { | |
477 "description": "Write a Data Access (Gin) log", | |
478 "id": "DataAccessOptions", | |
479 "properties": {}, | |
480 "type": "object" | |
481 }, | |
482 "AuditConfig": { | |
483 "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.", | |
484 "id": "AuditConfig", | |
485 "properties": { | |
486 "service": { | |
487 "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.", | |
488 "type": "string" | |
489 }, | |
490 "auditLogConfigs": { | |
491 "description": "The configuration for logging of each type o
f permission.\nNext ID: 4", | |
492 "items": { | |
493 "$ref": "AuditLogConfig" | |
494 }, | |
495 "type": "array" | |
496 }, | |
497 "exemptedMembers": { | |
498 "items": { | |
499 "type": "string" | |
500 }, | |
501 "type": "array" | |
502 } | |
503 }, | |
504 "type": "object" | |
505 }, | |
506 "SetIamPolicyRequest": { | |
507 "description": "Request message for `SetIamPolicy` method.", | |
508 "id": "SetIamPolicyRequest", | |
509 "properties": { | |
510 "updateMask": { | |
511 "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.", | |
512 "format": "google-fieldmask", | |
513 "type": "string" | |
514 }, | |
515 "policy": { | |
516 "$ref": "Policy", | |
517 "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." | |
518 } | |
519 }, | |
520 "type": "object" | |
521 }, | |
522 "CloudAuditOptions": { | |
523 "description": "Write a Cloud Audit log", | |
524 "id": "CloudAuditOptions", | |
525 "properties": {}, | |
526 "type": "object" | |
527 }, | |
528 "Binding": { | |
529 "description": "Associates `members` with a `role`.", | |
530 "id": "Binding", | |
531 "properties": { | |
532 "members": { | |
533 "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", | |
534 "items": { | |
535 "type": "string" | |
536 }, | |
537 "type": "array" | |
538 }, | |
539 "role": { | |
540 "description": "Role that is assigned to `members`.\nFor exa
mple, `roles/viewer`, `roles/editor`, or `roles/owner`.\nRequired", | |
541 "type": "string" | |
542 } | |
543 }, | |
544 "type": "object" | |
545 }, | |
546 "Empty": { | |
547 "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 `{}`.", | |
548 "id": "Empty", | |
549 "properties": {}, | |
550 "type": "object" | |
551 }, | |
552 "MirrorConfig": { | |
553 "description": "Configuration to automatically mirror a repository f
rom another\nhosting service, for example GitHub or BitBucket.", | |
554 "id": "MirrorConfig", | |
555 "properties": { | |
556 "deployKeyId": { | |
557 "description": "ID of the SSH deploy key at the other hostin
g service.\nRemoving this key from the other service would deauthorize\nGoogle C
loud Source Repositories from mirroring.", | |
558 "type": "string" | |
559 }, | |
560 "url": { | |
561 "description": "URL of the main repository at the other host
ing service.", | |
562 "type": "string" | |
563 }, | |
564 "webhookId": { | |
565 "description": "ID of the webhook listening to updates to tr
igger mirroring.\nRemoving this webook from the other hosting service will stop\
nGoogle Cloud Source Repositories from receiving notifications,\nand thereby dis
abling mirroring.", | |
566 "type": "string" | |
567 } | |
568 }, | |
569 "type": "object" | |
570 }, | |
571 "Repo": { | |
572 "description": "A repository (or repo) is a Git repository storing v
ersioned source content.", | |
573 "id": "Repo", | |
574 "properties": { | |
575 "size": { | |
576 "description": "The size in bytes of the repo.", | |
577 "format": "int64", | |
578 "type": "string" | |
579 }, | |
580 "name": { | |
581 "description": "Resource name of the repository, of the form
\n`projects/<project>/repos/<repo>`.", | |
582 "type": "string" | |
583 }, | |
584 "mirrorConfig": { | |
585 "$ref": "MirrorConfig", | |
586 "description": "How this repository mirrors a repository man
aged by another service." | |
587 }, | |
588 "url": { | |
589 "description": "URL to clone the repository from Google Clou
d Source Repositories.", | |
590 "type": "string" | |
591 } | |
592 }, | |
593 "type": "object" | |
594 }, | |
595 "ListReposResponse": { | 409 "ListReposResponse": { |
596 "description": "Response for ListRepos.", | 410 "description": "Response for ListRepos.", |
597 "id": "ListReposResponse", | 411 "id": "ListReposResponse", |
598 "properties": { | 412 "properties": { |
599 "repos": { | 413 "repos": { |
600 "description": "The listed repos.", | 414 "description": "The listed repos.", |
601 "items": { | 415 "items": { |
602 "$ref": "Repo" | 416 "$ref": "Repo" |
603 }, | 417 }, |
604 "type": "array" | 418 "type": "array" |
605 } | 419 } |
606 }, | 420 }, |
607 "type": "object" | 421 "type": "object" |
608 }, | 422 }, |
609 "TestIamPermissionsResponse": { | 423 "Condition": { |
610 "description": "Response message for `TestIamPermissions` method.", | 424 "description": "A condition to be met.", |
611 "id": "TestIamPermissionsResponse", | 425 "id": "Condition", |
612 "properties": { | 426 "properties": { |
613 "permissions": { | 427 "values": { |
614 "description": "A subset of `TestPermissionsRequest.permissi
ons` that the caller is\nallowed.", | 428 "description": "The objects of the condition. This is mutual
ly exclusive with 'value'.", |
615 "items": { | 429 "items": { |
616 "type": "string" | 430 "type": "string" |
617 }, | 431 }, |
618 "type": "array" | 432 "type": "array" |
619 } | 433 }, |
620 }, | 434 "iam": { |
621 "type": "object" | 435 "description": "Trusted attributes supplied by the IAM syste
m.", |
622 }, | 436 "enum": [ |
623 "Condition": { | 437 "NO_ATTR", |
624 "description": "A condition to be met.", | 438 "AUTHORITY", |
625 "id": "Condition", | 439 "ATTRIBUTION", |
626 "properties": { | 440 "APPROVER", |
| 441 "JUSTIFICATION_TYPE" |
| 442 ], |
| 443 "enumDescriptions": [ |
| 444 "Default non-attribute.", |
| 445 "Either principal or (if present) authority selector.", |
| 446 "The principal (even if an authority selector is present
), which\nmust only be used for attribution, not authorization.", |
| 447 "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.", |
| 448 "What types of justifications have been supplied with th
is request.\nString values should match enum names from tech.iam.JustificationTy
pe,\ne.g. \"MANUAL_STRING\". It is not permitted to grant access based on\nthe *
absence* of a justification, so justification conditions can only\nbe used in a
\"positive\" context (e.g., ALLOW/IN or DENY/NOT_IN).\n\nMultiple justifications
, e.g., a Buganizer ID and a manually-entered\nreason, are normal and supported.
" |
| 449 ], |
| 450 "type": "string" |
| 451 }, |
627 "op": { | 452 "op": { |
628 "description": "An operator to apply the subject with.", | 453 "description": "An operator to apply the subject with.", |
629 "enum": [ | 454 "enum": [ |
630 "NO_OP", | 455 "NO_OP", |
631 "EQUALS", | 456 "EQUALS", |
632 "NOT_EQUALS", | 457 "NOT_EQUALS", |
633 "IN", | 458 "IN", |
634 "NOT_IN", | 459 "NOT_IN", |
635 "DISCHARGED" | 460 "DISCHARGED" |
636 ], | 461 ], |
637 "enumDescriptions": [ | 462 "enumDescriptions": [ |
638 "Default no-op.", | 463 "Default no-op.", |
639 "DEPRECATED. Use IN instead.", | 464 "DEPRECATED. Use IN instead.", |
640 "DEPRECATED. Use NOT_IN instead.", | 465 "DEPRECATED. Use NOT_IN instead.", |
641 "The condition is true if the subject (or any element of
it if it is\na set) matches any of the supplied values.", | 466 "The condition is true if the subject (or any element of
it if it is\na set) matches any of the supplied values.", |
642 "The condition is true if the subject (or every element
of it if it is\na set) matches none of the supplied values.", | 467 "The condition is true if the subject (or every element
of it if it is\na set) matches none of the supplied values.", |
643 "Subject is discharged" | 468 "Subject is discharged" |
644 ], | 469 ], |
645 "type": "string" | 470 "type": "string" |
646 }, | 471 }, |
647 "svc": { | 472 "svc": { |
648 "description": "Trusted attributes discharged by the service
.", | 473 "description": "Trusted attributes discharged by the service
.", |
649 "type": "string" | 474 "type": "string" |
650 }, | 475 }, |
| 476 "value": { |
| 477 "description": "DEPRECATED. Use 'values' instead.", |
| 478 "type": "string" |
| 479 }, |
651 "sys": { | 480 "sys": { |
652 "description": "Trusted attributes supplied by any service t
hat owns resources and uses\nthe IAM system for access control.", | 481 "description": "Trusted attributes supplied by any service t
hat owns resources and uses\nthe IAM system for access control.", |
653 "enum": [ | 482 "enum": [ |
654 "NO_ATTR", | 483 "NO_ATTR", |
655 "REGION", | 484 "REGION", |
656 "SERVICE", | 485 "SERVICE", |
657 "NAME", | 486 "NAME", |
658 "IP" | 487 "IP" |
659 ], | 488 ], |
660 "enumDescriptions": [ | 489 "enumDescriptions": [ |
661 "Default non-attribute type", | 490 "Default non-attribute type", |
662 "Region of the resource", | 491 "Region of the resource", |
663 "Service name", | 492 "Service name", |
664 "Resource name", | 493 "Resource name", |
665 "IP address of the caller" | 494 "IP address of the caller" |
666 ], | 495 ], |
667 "type": "string" | 496 "type": "string" |
668 }, | |
669 "value": { | |
670 "description": "DEPRECATED. Use 'values' instead.", | |
671 "type": "string" | |
672 }, | |
673 "values": { | |
674 "description": "The objects of the condition. This is mutual
ly exclusive with 'value'.", | |
675 "items": { | |
676 "type": "string" | |
677 }, | |
678 "type": "array" | |
679 }, | |
680 "iam": { | |
681 "description": "Trusted attributes supplied by the IAM syste
m.", | |
682 "enum": [ | |
683 "NO_ATTR", | |
684 "AUTHORITY", | |
685 "ATTRIBUTION", | |
686 "APPROVER", | |
687 "JUSTIFICATION_TYPE" | |
688 ], | |
689 "enumDescriptions": [ | |
690 "Default non-attribute.", | |
691 "Either principal or (if present) authority selector.", | |
692 "The principal (even if an authority selector is present
), which\nmust only be used for attribution, not authorization.", | |
693 "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.", | |
694 "What types of justifications have been supplied with th
is request.\nString values should match enum names from tech.iam.JustificationTy
pe,\ne.g. \"MANUAL_STRING\". It is not permitted to grant access based on\nthe *
absence* of a justification, so justification conditions can only\nbe used in a
\"positive\" context (e.g., ALLOW/IN or DENY/NOT_IN).\n\nMultiple justifications
, e.g., a Buganizer ID and a manually-entered\nreason, are normal and supported.
" | |
695 ], | |
696 "type": "string" | |
697 } | 497 } |
698 }, | 498 }, |
699 "type": "object" | 499 "type": "object" |
700 }, | 500 }, |
701 "CounterOptions": { | 501 "CounterOptions": { |
702 "description": "Options for counters", | 502 "description": "Options for counters", |
703 "id": "CounterOptions", | 503 "id": "CounterOptions", |
704 "properties": { | 504 "properties": { |
705 "metric": { | 505 "metric": { |
706 "description": "The metric to update.", | 506 "description": "The metric to update.", |
707 "type": "string" | 507 "type": "string" |
708 }, | 508 }, |
709 "field": { | 509 "field": { |
710 "description": "The field value to attribute.", | 510 "description": "The field value to attribute.", |
711 "type": "string" | 511 "type": "string" |
712 } | 512 } |
713 }, | 513 }, |
714 "type": "object" | 514 "type": "object" |
| 515 }, |
| 516 "AuditLogConfig": { |
| 517 "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.", |
| 518 "id": "AuditLogConfig", |
| 519 "properties": { |
| 520 "logType": { |
| 521 "description": "The log type that this config enables.", |
| 522 "enum": [ |
| 523 "LOG_TYPE_UNSPECIFIED", |
| 524 "ADMIN_READ", |
| 525 "DATA_WRITE", |
| 526 "DATA_READ" |
| 527 ], |
| 528 "enumDescriptions": [ |
| 529 "Default case. Should never be this.", |
| 530 "Admin reads. Example: CloudIAM getIamPolicy", |
| 531 "Data writes. Example: CloudSQL Users create", |
| 532 "Data reads. Example: CloudSQL Users list" |
| 533 ], |
| 534 "type": "string" |
| 535 }, |
| 536 "exemptedMembers": { |
| 537 "description": "Specifies the identities that do not cause l
ogging for this type of\npermission.\nFollows the same format of Binding.members
.", |
| 538 "items": { |
| 539 "type": "string" |
| 540 }, |
| 541 "type": "array" |
| 542 } |
| 543 }, |
| 544 "type": "object" |
| 545 }, |
| 546 "Rule": { |
| 547 "description": "A rule to be applied in a Policy.", |
| 548 "id": "Rule", |
| 549 "properties": { |
| 550 "logConfig": { |
| 551 "description": "The config returned to callers of tech.iam.I
AM.CheckPolicy for any entries\nthat match the LOG action.", |
| 552 "items": { |
| 553 "$ref": "LogConfig" |
| 554 }, |
| 555 "type": "array" |
| 556 }, |
| 557 "in": { |
| 558 "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.", |
| 559 "items": { |
| 560 "type": "string" |
| 561 }, |
| 562 "type": "array" |
| 563 }, |
| 564 "permissions": { |
| 565 "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.", |
| 566 "items": { |
| 567 "type": "string" |
| 568 }, |
| 569 "type": "array" |
| 570 }, |
| 571 "action": { |
| 572 "description": "Required", |
| 573 "enum": [ |
| 574 "NO_ACTION", |
| 575 "ALLOW", |
| 576 "ALLOW_WITH_LOG", |
| 577 "DENY", |
| 578 "DENY_WITH_LOG", |
| 579 "LOG" |
| 580 ], |
| 581 "enumDescriptions": [ |
| 582 "Default no action.", |
| 583 "Matching 'Entries' grant access.", |
| 584 "Matching 'Entries' grant access and the caller promises
to log\nthe request per the returned log_configs.", |
| 585 "Matching 'Entries' deny access.", |
| 586 "Matching 'Entries' deny access and the caller promises
to log\nthe request per the returned log_configs.", |
| 587 "Matching 'Entries' tell IAM.Check callers to generate l
ogs." |
| 588 ], |
| 589 "type": "string" |
| 590 }, |
| 591 "notIn": { |
| 592 "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).", |
| 593 "items": { |
| 594 "type": "string" |
| 595 }, |
| 596 "type": "array" |
| 597 }, |
| 598 "description": { |
| 599 "description": "Human-readable description of the rule.", |
| 600 "type": "string" |
| 601 }, |
| 602 "conditions": { |
| 603 "description": "Additional restrictions that must be met", |
| 604 "items": { |
| 605 "$ref": "Condition" |
| 606 }, |
| 607 "type": "array" |
| 608 } |
| 609 }, |
| 610 "type": "object" |
| 611 }, |
| 612 "LogConfig": { |
| 613 "description": "Specifies what kind of log the caller must write", |
| 614 "id": "LogConfig", |
| 615 "properties": { |
| 616 "counter": { |
| 617 "$ref": "CounterOptions", |
| 618 "description": "Counter options." |
| 619 }, |
| 620 "dataAccess": { |
| 621 "$ref": "DataAccessOptions", |
| 622 "description": "Data access options." |
| 623 }, |
| 624 "cloudAudit": { |
| 625 "$ref": "CloudAuditOptions", |
| 626 "description": "Cloud audit options." |
| 627 } |
| 628 }, |
| 629 "type": "object" |
| 630 }, |
| 631 "TestIamPermissionsRequest": { |
| 632 "description": "Request message for `TestIamPermissions` method.", |
| 633 "id": "TestIamPermissionsRequest", |
| 634 "properties": { |
| 635 "permissions": { |
| 636 "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).", |
| 637 "items": { |
| 638 "type": "string" |
| 639 }, |
| 640 "type": "array" |
| 641 } |
| 642 }, |
| 643 "type": "object" |
| 644 }, |
| 645 "Policy": { |
| 646 "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).", |
| 647 "id": "Policy", |
| 648 "properties": { |
| 649 "etag": { |
| 650 "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.", |
| 651 "format": "byte", |
| 652 "type": "string" |
| 653 }, |
| 654 "iamOwned": { |
| 655 "type": "boolean" |
| 656 }, |
| 657 "rules": { |
| 658 "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.", |
| 659 "items": { |
| 660 "$ref": "Rule" |
| 661 }, |
| 662 "type": "array" |
| 663 }, |
| 664 "version": { |
| 665 "description": "Version of the `Policy`. The default version
is 0.", |
| 666 "format": "int32", |
| 667 "type": "integer" |
| 668 }, |
| 669 "auditConfigs": { |
| 670 "description": "Specifies cloud audit logging configuration
for this policy.", |
| 671 "items": { |
| 672 "$ref": "AuditConfig" |
| 673 }, |
| 674 "type": "array" |
| 675 }, |
| 676 "bindings": { |
| 677 "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.", |
| 678 "items": { |
| 679 "$ref": "Binding" |
| 680 }, |
| 681 "type": "array" |
| 682 } |
| 683 }, |
| 684 "type": "object" |
| 685 }, |
| 686 "DataAccessOptions": { |
| 687 "description": "Write a Data Access (Gin) log", |
| 688 "id": "DataAccessOptions", |
| 689 "properties": {}, |
| 690 "type": "object" |
| 691 }, |
| 692 "AuditConfig": { |
| 693 "description": "Specifies the audit configuration for a service.\nTh
e configuration determines which permission types are logged, and what\nidentiti
es, if any, are exempted from logging.\nAn AuditConifg must have one or more Aud
itLogConfigs.\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_t
ypes\nspecified in each AuditConfig are enabled, and the exempted_members in eac
h\nAuditConfig are exempted.\nExample Policy with multiple AuditConfigs:\n{\n \
"audit_configs\": [\n {\n \"service\": \"allServices\"\n \"audit_lo
g_configs\": [\n {\n \"log_type\": \"DATA_READ\",\n \"e
xempted_members\": [\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 fooser
vice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ\nlogging. It also
exempts foo@gmail.com from DATA_READ logging, and\nbar@gmail.com from DATA_WRIT
E logging.", |
| 694 "id": "AuditConfig", |
| 695 "properties": { |
| 696 "service": { |
| 697 "description": "Specifies a service that will be enabled for
audit logging.\nFor example, `storage.googleapis.com`, `cloudsql.googleapis.com
`.\n`allServices` is a special value that covers all services.", |
| 698 "type": "string" |
| 699 }, |
| 700 "auditLogConfigs": { |
| 701 "description": "The configuration for logging of each type o
f permission.\nNext ID: 4", |
| 702 "items": { |
| 703 "$ref": "AuditLogConfig" |
| 704 }, |
| 705 "type": "array" |
| 706 }, |
| 707 "exemptedMembers": { |
| 708 "items": { |
| 709 "type": "string" |
| 710 }, |
| 711 "type": "array" |
| 712 } |
| 713 }, |
| 714 "type": "object" |
715 } | 715 } |
716 }, | 716 }, |
717 "servicePath": "", | 717 "servicePath": "", |
718 "title": "Cloud Source Repositories API", | 718 "title": "Cloud Source Repositories API", |
719 "version": "v1" | 719 "version": "v1" |
720 } | 720 } |
OLD | NEW |