File: storage_v1.managedFolders.html

package info (click to toggle)
python-googleapi 2.180.0-1
  • links: PTS
  • area: main
  • in suites: forky, sid
  • size: 527,124 kB
  • sloc: python: 11,076; javascript: 249; sh: 114; makefile: 59
file content (420 lines) | stat: -rw-r--r-- 29,921 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
<html><body>
<style>

body, h1, h2, h3, div, span, p, pre, a {
  margin: 0;
  padding: 0;
  border: 0;
  font-weight: inherit;
  font-style: inherit;
  font-size: 100%;
  font-family: inherit;
  vertical-align: baseline;
}

body {
  font-size: 13px;
  padding: 1em;
}

h1 {
  font-size: 26px;
  margin-bottom: 1em;
}

h2 {
  font-size: 24px;
  margin-bottom: 1em;
}

h3 {
  font-size: 20px;
  margin-bottom: 1em;
  margin-top: 1em;
}

pre, code {
  line-height: 1.5;
  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}

pre {
  margin-top: 0.5em;
}

h1, h2, h3, p {
  font-family: Arial, sans serif;
}

h1, h2, h3 {
  border-bottom: solid #CCC 1px;
}

.toc_element {
  margin-top: 0.5em;
}

.firstline {
  margin-left: 2 em;
}

.method  {
  margin-top: 1em;
  border: solid 1px #CCC;
  padding: 1em;
  background: #EEE;
}

.details {
  font-weight: bold;
  font-size: 14px;
}

</style>

<h1><a href="storage_v1.html">Cloud Storage JSON API</a> . <a href="storage_v1.managedFolders.html">managedFolders</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
  <code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
  <code><a href="#delete">delete(bucket, managedFolder, allowNonEmpty=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None)</a></code></p>
<p class="firstline">Permanently deletes a managed folder.</p>
<p class="toc_element">
  <code><a href="#get">get(bucket, managedFolder, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None)</a></code></p>
<p class="firstline">Returns metadata of the specified managed folder.</p>
<p class="toc_element">
  <code><a href="#getIamPolicy">getIamPolicy(bucket, managedFolder, optionsRequestedPolicyVersion=None, userProject=None)</a></code></p>
<p class="firstline">Returns an IAM policy for the specified managed folder.</p>
<p class="toc_element">
  <code><a href="#insert">insert(bucket, body=None)</a></code></p>
<p class="firstline">Creates a new managed folder.</p>
<p class="toc_element">
  <code><a href="#list">list(bucket, pageSize=None, pageToken=None, prefix=None)</a></code></p>
<p class="firstline">Lists managed folders in the given bucket.</p>
<p class="toc_element">
  <code><a href="#list_next">list_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<p class="toc_element">
  <code><a href="#setIamPolicy">setIamPolicy(bucket, managedFolder, body=None, userProject=None)</a></code></p>
<p class="firstline">Updates an IAM policy for the specified managed folder.</p>
<p class="toc_element">
  <code><a href="#testIamPermissions">testIamPermissions(bucket, managedFolder, permissions, userProject=None)</a></code></p>
<p class="firstline">Tests a set of permissions on the given managed folder to see which, if any, are held by the caller.</p>
<h3>Method Details</h3>
<div class="method">
    <code class="details" id="close">close()</code>
  <pre>Close httplib2 connections.</pre>
</div>

<div class="method">
    <code class="details" id="delete">delete(bucket, managedFolder, allowNonEmpty=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None)</code>
  <pre>Permanently deletes a managed folder.

Args:
  bucket: string, Name of the bucket containing the managed folder. (required)
  managedFolder: string, The managed folder name/path. (required)
  allowNonEmpty: boolean, Allows the deletion of a managed folder even if it is not empty. A managed folder is empty if there are no objects or managed folders that it applies to. Callers must have storage.managedFolders.setIamPolicy permission.
  ifMetagenerationMatch: string, If set, only deletes the managed folder if its metageneration matches this value.
  ifMetagenerationNotMatch: string, If set, only deletes the managed folder if its metageneration does not match this value.
</pre>
</div>

<div class="method">
    <code class="details" id="get">get(bucket, managedFolder, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None)</code>
  <pre>Returns metadata of the specified managed folder.

Args:
  bucket: string, Name of the bucket containing the managed folder. (required)
  managedFolder: string, The managed folder name/path. (required)
  ifMetagenerationMatch: string, Makes the return of the managed folder metadata conditional on whether the managed folder&#x27;s current metageneration matches the given value.
  ifMetagenerationNotMatch: string, Makes the return of the managed folder metadata conditional on whether the managed folder&#x27;s current metageneration does not match the given value.

Returns:
  An object of the form:

    { # A managed folder.
  &quot;bucket&quot;: &quot;A String&quot;, # The name of the bucket containing this managed folder.
  &quot;createTime&quot;: &quot;A String&quot;, # The creation time of the managed folder in RFC 3339 format.
  &quot;id&quot;: &quot;A String&quot;, # The ID of the managed folder, including the bucket name and managed folder name.
  &quot;kind&quot;: &quot;storage#managedFolder&quot;, # The kind of item this is. For managed folders, this is always storage#managedFolder.
  &quot;metageneration&quot;: &quot;A String&quot;, # The version of the metadata for this managed folder. Used for preconditions and for detecting changes in metadata.
  &quot;name&quot;: &quot;A String&quot;, # The name of the managed folder. Required if not specified by URL parameter.
  &quot;selfLink&quot;: &quot;A String&quot;, # The link to this managed folder.
  &quot;updateTime&quot;: &quot;A String&quot;, # The last update time of the managed folder metadata in RFC 3339 format.
}</pre>
</div>

<div class="method">
    <code class="details" id="getIamPolicy">getIamPolicy(bucket, managedFolder, optionsRequestedPolicyVersion=None, userProject=None)</code>
  <pre>Returns an IAM policy for the specified managed folder.

Args:
  bucket: string, Name of the bucket containing the managed folder. (required)
  managedFolder: string, The managed folder name/path. (required)
  optionsRequestedPolicyVersion: integer, The IAM policy format version to be returned. If the optionsRequestedPolicyVersion is for an older version that doesn&#x27;t support part of the requested IAM policy, the request fails.
  userProject: string, The project to be billed for this request. Required for Requester Pays buckets.

Returns:
  An object of the form:

    { # A bucket/object/managedFolder IAM policy.
  &quot;bindings&quot;: [ # An association between a role, which comes with a set of permissions, and members who may assume that role.
    {
      &quot;condition&quot;: { # Represents an expression text. Example: title: &quot;User account presence&quot; description: &quot;Determines whether the request has a user account&quot; expression: &quot;size(request.user) &gt; 0&quot; # The condition that is associated with this binding. NOTE: an unsatisfied condition will not allow user access via current binding. Different bindings, including their conditions, are examined independently.
        &quot;description&quot;: &quot;A String&quot;, # An optional description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
        &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language syntax. The application context of the containing message determines which well-known feature set of CEL is supported.
        &quot;location&quot;: &quot;A String&quot;, # An optional string indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
        &quot;title&quot;: &quot;A String&quot;, # An optional title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
      },
      &quot;members&quot;: [ # A collection of identifiers for members who may assume the provided role. Recognized identifiers are as follows:
          # - allUsers - A special identifier that represents anyone on the internet; with or without a Google account.
          # - allAuthenticatedUsers - A special identifier that represents anyone who is authenticated with a Google account or a service account.
          # - user:emailid - An email address that represents a specific account. For example, user:alice@gmail.com or user:joe@example.com.
          # - serviceAccount:emailid - An email address that represents a service account. For example,  serviceAccount:my-other-app@appspot.gserviceaccount.com .
          # - group:emailid - An email address that represents a Google group. For example, group:admins@example.com.
          # - domain:domain - A Google Apps domain name that represents all the users of that domain. For example, domain:google.com or domain:example.com.
          # - projectOwner:projectid - Owners of the given project. For example, projectOwner:my-example-project
          # - projectEditor:projectid - Editors of the given project. For example, projectEditor:my-example-project
          # - projectViewer:projectid - Viewers of the given project. For example, projectViewer:my-example-project
        &quot;A String&quot;,
      ],
      &quot;role&quot;: &quot;A String&quot;, # The role to which members belong. Two types of roles are supported: new IAM roles, which grant permissions that do not map directly to those provided by ACLs, and legacy IAM roles, which do map directly to ACL permissions. All roles are of the format roles/storage.specificRole.
          # The new IAM roles are:
          # - roles/storage.admin - Full control of Google Cloud Storage resources.
          # - roles/storage.objectViewer - Read-Only access to Google Cloud Storage objects.
          # - roles/storage.objectCreator - Access to create objects in Google Cloud Storage.
          # - roles/storage.objectAdmin - Full control of Google Cloud Storage objects.   The legacy IAM roles are:
          # - roles/storage.legacyObjectReader - Read-only access to objects without listing. Equivalent to an ACL entry on an object with the READER role.
          # - roles/storage.legacyObjectOwner - Read/write access to existing objects without listing. Equivalent to an ACL entry on an object with the OWNER role.
          # - roles/storage.legacyBucketReader - Read access to buckets with object listing. Equivalent to an ACL entry on a bucket with the READER role.
          # - roles/storage.legacyBucketWriter - Read access to buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the WRITER role.
          # - roles/storage.legacyBucketOwner - Read and write access to existing buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the OWNER role.
    },
  ],
  &quot;etag&quot;: &quot;A String&quot;, # HTTP 1.1  Entity tag for the policy.
  &quot;kind&quot;: &quot;storage#policy&quot;, # The kind of item this is. For policies, this is always storage#policy. This field is ignored on input.
  &quot;resourceId&quot;: &quot;A String&quot;, # The ID of the resource to which this policy belongs. Will be of the form projects/_/buckets/bucket for buckets, projects/_/buckets/bucket/objects/object for objects, and projects/_/buckets/bucket/managedFolders/managedFolder. A specific generation may be specified by appending #generationNumber to the end of the object name, e.g. projects/_/buckets/my-bucket/objects/data.txt#17. The current generation can be denoted with #0. This field is ignored on input.
  &quot;version&quot;: 42, # The IAM policy format version.
}</pre>
</div>

<div class="method">
    <code class="details" id="insert">insert(bucket, body=None)</code>
  <pre>Creates a new managed folder.

Args:
  bucket: string, Name of the bucket containing the managed folder. (required)
  body: object, The request body.
    The object takes the form of:

{ # A managed folder.
  &quot;bucket&quot;: &quot;A String&quot;, # The name of the bucket containing this managed folder.
  &quot;createTime&quot;: &quot;A String&quot;, # The creation time of the managed folder in RFC 3339 format.
  &quot;id&quot;: &quot;A String&quot;, # The ID of the managed folder, including the bucket name and managed folder name.
  &quot;kind&quot;: &quot;storage#managedFolder&quot;, # The kind of item this is. For managed folders, this is always storage#managedFolder.
  &quot;metageneration&quot;: &quot;A String&quot;, # The version of the metadata for this managed folder. Used for preconditions and for detecting changes in metadata.
  &quot;name&quot;: &quot;A String&quot;, # The name of the managed folder. Required if not specified by URL parameter.
  &quot;selfLink&quot;: &quot;A String&quot;, # The link to this managed folder.
  &quot;updateTime&quot;: &quot;A String&quot;, # The last update time of the managed folder metadata in RFC 3339 format.
}


Returns:
  An object of the form:

    { # A managed folder.
  &quot;bucket&quot;: &quot;A String&quot;, # The name of the bucket containing this managed folder.
  &quot;createTime&quot;: &quot;A String&quot;, # The creation time of the managed folder in RFC 3339 format.
  &quot;id&quot;: &quot;A String&quot;, # The ID of the managed folder, including the bucket name and managed folder name.
  &quot;kind&quot;: &quot;storage#managedFolder&quot;, # The kind of item this is. For managed folders, this is always storage#managedFolder.
  &quot;metageneration&quot;: &quot;A String&quot;, # The version of the metadata for this managed folder. Used for preconditions and for detecting changes in metadata.
  &quot;name&quot;: &quot;A String&quot;, # The name of the managed folder. Required if not specified by URL parameter.
  &quot;selfLink&quot;: &quot;A String&quot;, # The link to this managed folder.
  &quot;updateTime&quot;: &quot;A String&quot;, # The last update time of the managed folder metadata in RFC 3339 format.
}</pre>
</div>

<div class="method">
    <code class="details" id="list">list(bucket, pageSize=None, pageToken=None, prefix=None)</code>
  <pre>Lists managed folders in the given bucket.

Args:
  bucket: string, Name of the bucket containing the managed folder. (required)
  pageSize: integer, Maximum number of items to return in a single page of responses.
  pageToken: string, A previously-returned page token representing part of the larger set of results to view.
  prefix: string, The managed folder name/path prefix to filter the output list of results.

Returns:
  An object of the form:

    { # A list of managed folders.
  &quot;items&quot;: [ # The list of items.
    { # A managed folder.
      &quot;bucket&quot;: &quot;A String&quot;, # The name of the bucket containing this managed folder.
      &quot;createTime&quot;: &quot;A String&quot;, # The creation time of the managed folder in RFC 3339 format.
      &quot;id&quot;: &quot;A String&quot;, # The ID of the managed folder, including the bucket name and managed folder name.
      &quot;kind&quot;: &quot;storage#managedFolder&quot;, # The kind of item this is. For managed folders, this is always storage#managedFolder.
      &quot;metageneration&quot;: &quot;A String&quot;, # The version of the metadata for this managed folder. Used for preconditions and for detecting changes in metadata.
      &quot;name&quot;: &quot;A String&quot;, # The name of the managed folder. Required if not specified by URL parameter.
      &quot;selfLink&quot;: &quot;A String&quot;, # The link to this managed folder.
      &quot;updateTime&quot;: &quot;A String&quot;, # The last update time of the managed folder metadata in RFC 3339 format.
    },
  ],
  &quot;kind&quot;: &quot;storage#managedFolders&quot;, # The kind of item this is. For lists of managed folders, this is always storage#managedFolders.
  &quot;nextPageToken&quot;: &quot;A String&quot;, # The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results.
}</pre>
</div>

<div class="method">
    <code class="details" id="list_next">list_next()</code>
  <pre>Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call &#x27;execute()&#x27; on to request the next
          page. Returns None if there are no more items in the collection.
        </pre>
</div>

<div class="method">
    <code class="details" id="setIamPolicy">setIamPolicy(bucket, managedFolder, body=None, userProject=None)</code>
  <pre>Updates an IAM policy for the specified managed folder.

Args:
  bucket: string, Name of the bucket containing the managed folder. (required)
  managedFolder: string, The managed folder name/path. (required)
  body: object, The request body.
    The object takes the form of:

{ # A bucket/object/managedFolder IAM policy.
  &quot;bindings&quot;: [ # An association between a role, which comes with a set of permissions, and members who may assume that role.
    {
      &quot;condition&quot;: { # Represents an expression text. Example: title: &quot;User account presence&quot; description: &quot;Determines whether the request has a user account&quot; expression: &quot;size(request.user) &gt; 0&quot; # The condition that is associated with this binding. NOTE: an unsatisfied condition will not allow user access via current binding. Different bindings, including their conditions, are examined independently.
        &quot;description&quot;: &quot;A String&quot;, # An optional description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
        &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language syntax. The application context of the containing message determines which well-known feature set of CEL is supported.
        &quot;location&quot;: &quot;A String&quot;, # An optional string indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
        &quot;title&quot;: &quot;A String&quot;, # An optional title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
      },
      &quot;members&quot;: [ # A collection of identifiers for members who may assume the provided role. Recognized identifiers are as follows:
          # - allUsers - A special identifier that represents anyone on the internet; with or without a Google account.
          # - allAuthenticatedUsers - A special identifier that represents anyone who is authenticated with a Google account or a service account.
          # - user:emailid - An email address that represents a specific account. For example, user:alice@gmail.com or user:joe@example.com.
          # - serviceAccount:emailid - An email address that represents a service account. For example,  serviceAccount:my-other-app@appspot.gserviceaccount.com .
          # - group:emailid - An email address that represents a Google group. For example, group:admins@example.com.
          # - domain:domain - A Google Apps domain name that represents all the users of that domain. For example, domain:google.com or domain:example.com.
          # - projectOwner:projectid - Owners of the given project. For example, projectOwner:my-example-project
          # - projectEditor:projectid - Editors of the given project. For example, projectEditor:my-example-project
          # - projectViewer:projectid - Viewers of the given project. For example, projectViewer:my-example-project
        &quot;A String&quot;,
      ],
      &quot;role&quot;: &quot;A String&quot;, # The role to which members belong. Two types of roles are supported: new IAM roles, which grant permissions that do not map directly to those provided by ACLs, and legacy IAM roles, which do map directly to ACL permissions. All roles are of the format roles/storage.specificRole.
          # The new IAM roles are:
          # - roles/storage.admin - Full control of Google Cloud Storage resources.
          # - roles/storage.objectViewer - Read-Only access to Google Cloud Storage objects.
          # - roles/storage.objectCreator - Access to create objects in Google Cloud Storage.
          # - roles/storage.objectAdmin - Full control of Google Cloud Storage objects.   The legacy IAM roles are:
          # - roles/storage.legacyObjectReader - Read-only access to objects without listing. Equivalent to an ACL entry on an object with the READER role.
          # - roles/storage.legacyObjectOwner - Read/write access to existing objects without listing. Equivalent to an ACL entry on an object with the OWNER role.
          # - roles/storage.legacyBucketReader - Read access to buckets with object listing. Equivalent to an ACL entry on a bucket with the READER role.
          # - roles/storage.legacyBucketWriter - Read access to buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the WRITER role.
          # - roles/storage.legacyBucketOwner - Read and write access to existing buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the OWNER role.
    },
  ],
  &quot;etag&quot;: &quot;A String&quot;, # HTTP 1.1  Entity tag for the policy.
  &quot;kind&quot;: &quot;storage#policy&quot;, # The kind of item this is. For policies, this is always storage#policy. This field is ignored on input.
  &quot;resourceId&quot;: &quot;A String&quot;, # The ID of the resource to which this policy belongs. Will be of the form projects/_/buckets/bucket for buckets, projects/_/buckets/bucket/objects/object for objects, and projects/_/buckets/bucket/managedFolders/managedFolder. A specific generation may be specified by appending #generationNumber to the end of the object name, e.g. projects/_/buckets/my-bucket/objects/data.txt#17. The current generation can be denoted with #0. This field is ignored on input.
  &quot;version&quot;: 42, # The IAM policy format version.
}

  userProject: string, The project to be billed for this request. Required for Requester Pays buckets.

Returns:
  An object of the form:

    { # A bucket/object/managedFolder IAM policy.
  &quot;bindings&quot;: [ # An association between a role, which comes with a set of permissions, and members who may assume that role.
    {
      &quot;condition&quot;: { # Represents an expression text. Example: title: &quot;User account presence&quot; description: &quot;Determines whether the request has a user account&quot; expression: &quot;size(request.user) &gt; 0&quot; # The condition that is associated with this binding. NOTE: an unsatisfied condition will not allow user access via current binding. Different bindings, including their conditions, are examined independently.
        &quot;description&quot;: &quot;A String&quot;, # An optional description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
        &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language syntax. The application context of the containing message determines which well-known feature set of CEL is supported.
        &quot;location&quot;: &quot;A String&quot;, # An optional string indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
        &quot;title&quot;: &quot;A String&quot;, # An optional title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
      },
      &quot;members&quot;: [ # A collection of identifiers for members who may assume the provided role. Recognized identifiers are as follows:
          # - allUsers - A special identifier that represents anyone on the internet; with or without a Google account.
          # - allAuthenticatedUsers - A special identifier that represents anyone who is authenticated with a Google account or a service account.
          # - user:emailid - An email address that represents a specific account. For example, user:alice@gmail.com or user:joe@example.com.
          # - serviceAccount:emailid - An email address that represents a service account. For example,  serviceAccount:my-other-app@appspot.gserviceaccount.com .
          # - group:emailid - An email address that represents a Google group. For example, group:admins@example.com.
          # - domain:domain - A Google Apps domain name that represents all the users of that domain. For example, domain:google.com or domain:example.com.
          # - projectOwner:projectid - Owners of the given project. For example, projectOwner:my-example-project
          # - projectEditor:projectid - Editors of the given project. For example, projectEditor:my-example-project
          # - projectViewer:projectid - Viewers of the given project. For example, projectViewer:my-example-project
        &quot;A String&quot;,
      ],
      &quot;role&quot;: &quot;A String&quot;, # The role to which members belong. Two types of roles are supported: new IAM roles, which grant permissions that do not map directly to those provided by ACLs, and legacy IAM roles, which do map directly to ACL permissions. All roles are of the format roles/storage.specificRole.
          # The new IAM roles are:
          # - roles/storage.admin - Full control of Google Cloud Storage resources.
          # - roles/storage.objectViewer - Read-Only access to Google Cloud Storage objects.
          # - roles/storage.objectCreator - Access to create objects in Google Cloud Storage.
          # - roles/storage.objectAdmin - Full control of Google Cloud Storage objects.   The legacy IAM roles are:
          # - roles/storage.legacyObjectReader - Read-only access to objects without listing. Equivalent to an ACL entry on an object with the READER role.
          # - roles/storage.legacyObjectOwner - Read/write access to existing objects without listing. Equivalent to an ACL entry on an object with the OWNER role.
          # - roles/storage.legacyBucketReader - Read access to buckets with object listing. Equivalent to an ACL entry on a bucket with the READER role.
          # - roles/storage.legacyBucketWriter - Read access to buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the WRITER role.
          # - roles/storage.legacyBucketOwner - Read and write access to existing buckets with object listing/creation/deletion. Equivalent to an ACL entry on a bucket with the OWNER role.
    },
  ],
  &quot;etag&quot;: &quot;A String&quot;, # HTTP 1.1  Entity tag for the policy.
  &quot;kind&quot;: &quot;storage#policy&quot;, # The kind of item this is. For policies, this is always storage#policy. This field is ignored on input.
  &quot;resourceId&quot;: &quot;A String&quot;, # The ID of the resource to which this policy belongs. Will be of the form projects/_/buckets/bucket for buckets, projects/_/buckets/bucket/objects/object for objects, and projects/_/buckets/bucket/managedFolders/managedFolder. A specific generation may be specified by appending #generationNumber to the end of the object name, e.g. projects/_/buckets/my-bucket/objects/data.txt#17. The current generation can be denoted with #0. This field is ignored on input.
  &quot;version&quot;: 42, # The IAM policy format version.
}</pre>
</div>

<div class="method">
    <code class="details" id="testIamPermissions">testIamPermissions(bucket, managedFolder, permissions, userProject=None)</code>
  <pre>Tests a set of permissions on the given managed folder to see which, if any, are held by the caller.

Args:
  bucket: string, Name of the bucket containing the managed folder. (required)
  managedFolder: string, The managed folder name/path. (required)
  permissions: string, Permissions to test. (required) (repeated)
  userProject: string, The project to be billed for this request. Required for Requester Pays buckets.

Returns:
  An object of the form:

    { # A storage.(buckets|objects|managedFolders).testIamPermissions response.
  &quot;kind&quot;: &quot;storage#testIamPermissionsResponse&quot;, # The kind of item this is.
  &quot;permissions&quot;: [ # The permissions held by the caller. Permissions are always of the format storage.resource.capability, where resource is one of buckets, objects, or managedFolders. The supported permissions are as follows:
      # - storage.buckets.delete - Delete bucket.
      # - storage.buckets.get - Read bucket metadata.
      # - storage.buckets.getIamPolicy - Read bucket IAM policy.
      # - storage.buckets.create - Create bucket.
      # - storage.buckets.list - List buckets.
      # - storage.buckets.setIamPolicy - Update bucket IAM policy.
      # - storage.buckets.update - Update bucket metadata.
      # - storage.objects.delete - Delete object.
      # - storage.objects.get - Read object data and metadata.
      # - storage.objects.getIamPolicy - Read object IAM policy.
      # - storage.objects.create - Create object.
      # - storage.objects.list - List objects.
      # - storage.objects.setIamPolicy - Update object IAM policy.
      # - storage.objects.update - Update object metadata.
      # - storage.managedFolders.delete - Delete managed folder.
      # - storage.managedFolders.get - Read managed folder metadata.
      # - storage.managedFolders.getIamPolicy - Read managed folder IAM policy.
      # - storage.managedFolders.create - Create managed folder.
      # - storage.managedFolders.list - List managed folders.
      # - storage.managedFolders.setIamPolicy - Update managed folder IAM policy.
    &quot;A String&quot;,
  ],
}</pre>
</div>

</body></html>