Blame - docs/dyn/cloudresourcemanager_v2beta1.folders.html - platform/external/python/google-api-python-client

2020-05-27 12:20:54 -0700

[diff] [blame^]

205

"metadata": { # Service-specific metadata associated with the operation. It typically

206

# contains progress information and common metadata such as create time.

207

# Some services might not provide such metadata. Any method that returns a

208

# long-running operation should document the metadata type, if any.

209

"a_key": "", # Properties of the object. Contains field @type with type URL.

210

},

211

"done": True or False, # If the value is `false`, it means the operation is still in progress.

212

# If `true`, the operation is completed, and either `error` or `response` is

213

# available.

214

"response": { # The normal response of the operation in case of success. If the original

215

# method returns no data on success, such as `Delete`, the response is

216

# `google.protobuf.Empty`. If the original method is standard

217

# `Get`/`Create`/`Update`, the response should be the resource. For other

218

# methods, the response should have the type `XxxResponse`, where `Xxx`

219

# is the original method name. For example, if the original method name

220

# is `TakeSnapshot()`, the inferred response type is

221

# `TakeSnapshotResponse`.

222

"a_key": "", # Properties of the object. Contains field @type with type URL.

223

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

<code class="details" id="delete">delete(name, x__xgafv=None)</code>

229

<pre>Requests deletion of a Folder. The Folder is moved into the

230

DELETE_REQUESTED state

231

immediately, and is deleted approximately 30 days later. This method may

232

only be called on an empty Folder in the

233

ACTIVE state, where a Folder is empty if

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

234

it doesn't contain any Folders or Projects in the

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

235

ACTIVE state.

236

The caller must have `resourcemanager.folders.delete` permission on the

237

identified folder.

238

239

Args:

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

240

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

241

Must be of the form `folders/{folder_id}`. (required)

242

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

249

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

250

{ # A Folder in an Organization's resource hierarchy, used to

251

# organize that Organization's resources.

252

"lifecycleState": "A String", # Output only. The lifecycle state of the folder.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

253

# Updates to the lifecycle_state must be performed via

254

# DeleteFolder and

255

# UndeleteFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

256

"name": "A String", # Output only. The resource name of the Folder.

257

# Its format is `folders/{folder_id}`, for example: "folders/1234".

258

"displayName": "A String", # The folder’s display name.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

259

# A folder’s display name must be unique amongst its siblings, e.g.

260

# no two folders with the same parent can share the same display name.

261

# The display name must start and end with a letter or digit, may contain

262

# letters, digits, spaces, hyphens and underscores and can be no longer

263

# than 30 characters. This is captured by the regular expression:

264

# [\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

265

"parent": "A String", # Required. The Folder’s parent's resource name.

266

# Updates to the folder's parent must be performed via

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

267

# MoveFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

268

"createTime": "A String", # Output only. Timestamp when the Folder was created. Assigned by the server.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

<code class="details" id="get">get(name, x__xgafv=None)</code>

274

<pre>Retrieves a Folder identified by the supplied resource name.

275

Valid Folder resource names have the format `folders/{folder_id}`

276

(for example, `folders/1234`).

277

The caller must have `resourcemanager.folders.get` permission on the

278

identified folder.

279

280

Args:

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

281

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

282

Must be of the form `folders/{folder_id}`. (required)

283

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

290

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

291

{ # A Folder in an Organization's resource hierarchy, used to

292

# organize that Organization's resources.

293

"lifecycleState": "A String", # Output only. The lifecycle state of the folder.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

294

# Updates to the lifecycle_state must be performed via

295

# DeleteFolder and

296

# UndeleteFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

297

"name": "A String", # Output only. The resource name of the Folder.

298

# Its format is `folders/{folder_id}`, for example: "folders/1234".

299

"displayName": "A String", # The folder’s display name.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

300

# A folder’s display name must be unique amongst its siblings, e.g.

301

# no two folders with the same parent can share the same display name.

302

# The display name must start and end with a letter or digit, may contain

303

# letters, digits, spaces, hyphens and underscores and can be no longer

304

# than 30 characters. This is captured by the regular expression:

305

# [\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

306

"parent": "A String", # Required. The Folder’s parent's resource name.

307

# Updates to the folder's parent must be performed via

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

308

# MoveFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

309

"createTime": "A String", # Output only. Timestamp when the Folder was created. Assigned by the server.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

<code class="details" id="getIamPolicy">getIamPolicy(resource, body=None, x__xgafv=None)</code>

315

<pre>Gets the access control policy for a Folder. The returned policy may be

316

empty if no such policy or resource exists. The `resource` field should

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

317

be the Folder's resource name, e.g. "folders/1234".

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

318

The caller must have `resourcemanager.folders.getIamPolicy` permission

319

on the identified folder.

320

321

Args:

322

resource: string, REQUIRED: The resource for which the policy is being requested.

323

See the operation documentation for the appropriate value for this field. (required)

324

body: object, The request body.

325

The object takes the form of:

326

327

{ # Request message for `GetIamPolicy` method.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

328

"options": { # Encapsulates settings provided to GetIamPolicy. # OPTIONAL: A `GetPolicyOptions` object for specifying options to

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

329

# `GetIamPolicy`.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

330

"requestedPolicyVersion": 42, # Optional. The policy format version to be returned.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

331

#

332

# Valid values are 0, 1, and 3. Requests specifying an invalid value will be

333

# rejected.

334

#

335

# Requests for policies with any conditional bindings must specify version 3.

336

# Policies without any conditional bindings may specify any valid value or

337

# leave the field unset.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

338

#

339

# To learn which resources support conditions in their IAM policies, see the

340

# [IAM

341

# documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

342

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

343

}

344

345

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

352

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

353

{ # An Identity and Access Management (IAM) policy, which specifies access

354

# controls for Google Cloud resources.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

355

#

356

#

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

357

# A `Policy` is a collection of `bindings`. A `binding` binds one or more

358

# `members` to a single `role`. Members can be user accounts, service accounts,

359

# Google groups, and domains (such as G Suite). A `role` is a named list of

360

# permissions; each `role` can be an IAM predefined role or a user-created

361

# custom role.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

362

#

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

363

# For some types of Google Cloud resources, a `binding` can also specify a

364

# `condition`, which is a logical expression that allows access to a resource

365

# only if the expression evaluates to `true`. A condition can add constraints

366

# based on attributes of the request, the resource, or both. To learn which

367

# resources support conditions in their IAM policies, see the

368

# [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

369

#

370

# **JSON example:**

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

371

#

372

# {

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

373

# "bindings": [

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

374

# {

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

375

# "role": "roles/resourcemanager.organizationAdmin",

376

# "members": [

377

# "user:mike@example.com",

378

# "group:admins@example.com",

379

# "domain:google.com",

380

# "serviceAccount:my-project-id@appspot.gserviceaccount.com"

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

381

# ]

382

# },

383

# {

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

384

# "role": "roles/resourcemanager.organizationViewer",

385

# "members": [

386

# "user:eve@example.com"

387

# ],

388

# "condition": {

389

# "title": "expirable access",

390

# "description": "Does not grant access after Sep 2020",

391

# "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

392

# }

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

393

# }

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

394

# ],

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

395

# "etag": "BwWWja0YfJA=",

396

# "version": 3

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

397

# }

398

#

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

399

# **YAML example:**

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

#

# bindings:

# - members:

# - user:mike@example.com

404

# - group:admins@example.com

405

# - domain:google.com

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

406

# - serviceAccount:my-project-id@appspot.gserviceaccount.com

407

# role: roles/resourcemanager.organizationAdmin

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

408

# - members:

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

409

# - user:eve@example.com

410

# role: roles/resourcemanager.organizationViewer

411

# condition:

412

# title: expirable access

413

# description: Does not grant access after Sep 2020

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

414

# expression: request.time < timestamp('2020-10-01T00:00:00.000Z')

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

415

# - etag: BwWWja0YfJA=

416

# - version: 3

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

417

#

418

# For a description of IAM and its features, see the

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

419

# [IAM documentation](https://cloud.google.com/iam/docs/).

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

420

"version": 42, # Specifies the format of the policy.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

421

#

422

# Valid values are `0`, `1`, and `3`. Requests that specify an invalid value

423

# are rejected.

424

#

425

# Any operation that affects conditional role bindings must specify version

426

# `3`. This requirement applies to the following operations:

427

#

428

# * Getting a policy that includes a conditional role binding

429

# * Adding a conditional role binding to a policy

430

# * Changing a conditional role binding in a policy

431

# * Removing any role binding, with or without a condition, from a policy

432

# that includes conditions

433

#

434

# **Important:** If you use IAM Conditions, you must include the `etag` field

435

# whenever you call `setIamPolicy`. If you omit this field, then IAM allows

436

# you to overwrite a version `3` policy with a version `1` policy, and all of

437

# the conditions in the version `3` policy are lost.

438

#

439

# If a policy does not include any conditions, operations on that policy may

440

# specify any valid version or leave the field unset.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

441

#

442

# To learn which resources support conditions in their IAM policies, see the

443

# [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

444

"auditConfigs": [ # Specifies cloud audit logging configuration for this policy.

445

{ # Specifies the audit configuration for a service.

446

# The configuration determines which permission types are logged, and what

447

# identities, if any, are exempted from logging.

448

# An AuditConfig must have one or more AuditLogConfigs.

449

#

450

# If there are AuditConfigs for both `allServices` and a specific service,

451

# the union of the two AuditConfigs is used for that service: the log_types

452

# specified in each AuditConfig are enabled, and the exempted_members in each

453

# AuditLogConfig are exempted.

454

#

455

# Example Policy with multiple AuditConfigs:

#

# {

# "audit_configs": [

# {

# "service": "allServices"

461

# "audit_log_configs": [

462

# {

463

# "log_type": "DATA_READ",

464

# "exempted_members": [

465

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

470

# },

471

# {

472

# "log_type": "ADMIN_READ",

# }

# ]

# },

# {

# "service": "sampleservice.googleapis.com"

478

# "audit_log_configs": [

479

# {

480

# "log_type": "DATA_READ",

481

# },

482

# {

483

# "log_type": "DATA_WRITE",

484

# "exempted_members": [

485

# "user:aliya@example.com"

# ]

# }

# ]

# }

# ]

# }

#

# For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ

494

# logging. It also exempts jose@example.com from DATA_READ logging, and

495

# aliya@example.com from DATA_WRITE logging.

496

"service": "A String", # Specifies a service that will be enabled for audit logging.

497

# For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.

498

# `allServices` is a special value that covers all services.

499

"auditLogConfigs": [ # The configuration for logging of each type of permission.

500

{ # Provides the configuration for logging a type of permissions.

# Example:

#

# {

# "audit_log_configs": [

505

# {

506

# "log_type": "DATA_READ",

507

# "exempted_members": [

508

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

# }

# ]

# }

#

# This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting

518

# jose@example.com from DATA_READ logging.

519

"exemptedMembers": [ # Specifies the identities that do not cause logging for this type of

520

# permission.

521

# Follows the same format of Binding.members.

522

"A String",

523

],

524

"logType": "A String", # The log type that this config enables.

},

],

},

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

529

"bindings": [ # Associates a list of `members` to a `role`. Optionally, may specify a

530

# `condition` that determines how and when the `bindings` are applied. Each

531

# of the `bindings` must contain at least one member.

532

{ # Associates `members` with a `role`.

533

"role": "A String", # Role that is assigned to `members`.

534

# For example, `roles/viewer`, `roles/editor`, or `roles/owner`.

535

"condition": { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.

536

#

537

# If the condition evaluates to `true`, then this binding applies to the

538

# current request.

539

#

540

# If the condition evaluates to `false`, then this binding does not apply to

541

# the current request. However, a different role binding might grant the same

542

# role to one or more of the members in this binding.

543

#

544

# To learn which resources support conditions in their IAM policies, see the

545

# [IAM

546

# documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

547

# syntax. CEL is a C-like expression language. The syntax and semantics of CEL

548

# are documented at https://github.com/google/cel-spec.

549

#

550

# Example (Comparison):

551

#

552

# title: "Summary size limit"

553

# description: "Determines if a summary is less than 100 chars"

554

# expression: "document.summary.size() < 100"

555

#

556

# Example (Equality):

557

#

558

# title: "Requestor is owner"

559

# description: "Determines if requestor is the document owner"

560

# expression: "document.owner == request.auth.claims.email"

#

# Example (Logic):

#

# title: "Public documents"

565

# description: "Determine whether the document should be publicly visible"

566

# expression: "document.type != 'private' && document.type != 'internal'"

567

#

568

# Example (Data Manipulation):

569

#

570

# title: "Notification string"

571

# description: "Create a notification string with a timestamp."

572

# expression: "'New message received at ' + string(document.create_time)"

573

#

574

# The exact variables and functions that may be referenced within an expression

575

# are determined by the service that evaluates it. See the service

576

# documentation for additional information.

577

"title": "A String", # Optional. Title for the expression, i.e. a short string describing

578

# its purpose. This can be used e.g. in UIs which allow to enter the

579

# expression.

580

"location": "A String", # Optional. String indicating the location of the expression for error

581

# reporting, e.g. a file name and a position in the file.

582

"description": "A String", # Optional. Description of the expression. This is a longer text which

583

# describes the expression, e.g. when hovered over it in a UI.

584

"expression": "A String", # Textual representation of an expression in Common Expression Language

585

# syntax.

586

},

587

"members": [ # Specifies the identities requesting access for a Cloud Platform resource.

588

# `members` can have the following values:

589

#

590

# * `allUsers`: A special identifier that represents anyone who is

591

# on the internet; with or without a Google account.

592

#

593

# * `allAuthenticatedUsers`: A special identifier that represents anyone

594

# who is authenticated with a Google account or a service account.

595

#

596

# * `user:{emailid}`: An email address that represents a specific Google

597

# account. For example, `alice@example.com` .

598

#

599

#

600

# * `serviceAccount:{emailid}`: An email address that represents a service

601

# account. For example, `my-other-app@appspot.gserviceaccount.com`.

602

#

603

# * `group:{emailid}`: An email address that represents a Google group.

604

# For example, `admins@example.com`.

605

#

606

# * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique

607

# identifier) representing a user that has been recently deleted. For

608

# example, `alice@example.com?uid=123456789012345678901`. If the user is

609

# recovered, this value reverts to `user:{emailid}` and the recovered user

610

# retains the role in the binding.

611

#

612

# * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus

613

# unique identifier) representing a service account that has been recently

614

# deleted. For example,

615

# `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.

616

# If the service account is undeleted, this value reverts to

617

# `serviceAccount:{emailid}` and the undeleted service account retains the

618

# role in the binding.

619

#

620

# * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique

621

# identifier) representing a Google group that has been recently

622

# deleted. For example, `admins@example.com?uid=123456789012345678901`. If

623

# the group is recovered, this value reverts to `group:{emailid}` and the

624

# recovered group retains the role in the binding.

625

#

626

#

627

# * `domain:{domain}`: The G Suite domain (primary) that represents all the

628

# users of that domain. For example, `google.com` or `example.com`.

#

"A String",

],

},

],

"etag": "A String", # `etag` is used for optimistic concurrency control as a way to help

635

# prevent simultaneous updates of a policy from overwriting each other.

636

# It is strongly suggested that systems make use of the `etag` in the

637

# read-modify-write cycle to perform policy updates in order to avoid race

638

# conditions: An `etag` is returned in the response to `getIamPolicy`, and

639

# systems are expected to put that etag in the request to `setIamPolicy` to

640

# ensure that their change will be applied to the same version of the policy.

641

#

642

# **Important:** If you use IAM Conditions, you must include the `etag` field

643

# whenever you call `setIamPolicy`. If you omit this field, then IAM allows

644

# you to overwrite a version `3` policy with a version `1` policy, and all of

645

# the conditions in the version `3` policy are lost.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

650

<code class="details" id="list">list(pageToken=None, pageSize=None, parent=None, showDeleted=None, x__xgafv=None)</code>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

651

<pre>Lists the Folders that are direct descendants of supplied parent resource.

652

List provides a strongly consistent view of the Folders underneath

653

the specified parent resource.

654

List returns Folders sorted based upon the (ascending) lexical ordering

655

of their display_name.

656

The caller must have `resourcemanager.folders.list` permission on the

657

identified parent.

658

659

Args:

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

660

pageToken: string, Optional. A pagination token returned from a previous call to `ListFolders`

661

that indicates where this listing should continue from.

662

pageSize: integer, Optional. The maximum number of Folders to return in the response.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

663

parent: string, Required. The resource name of the Organization or Folder whose Folders are

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

664

being listed.

665

Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.

666

Access to this method is controlled by checking the

667

`resourcemanager.folders.list` permission on the `parent`.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

668

showDeleted: boolean, Optional. Controls whether Folders in the

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

669

DELETE_REQUESTED

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

670

state should be returned. Defaults to false.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

671

x__xgafv: string, V1 error format.

672

Allowed values

673

1 - v1 error format

674

2 - v2 error format

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

675

676

Returns:

677

An object of the form:

678

679

{ # The ListFolders response message.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

680

"nextPageToken": "A String", # A pagination token returned from a previous call to `ListFolders`

681

# that indicates from where listing should continue.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

682

"folders": [ # A possibly paginated list of Folders that are direct descendants of

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

683

# the specified parent resource.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

684

{ # A Folder in an Organization's resource hierarchy, used to

685

# organize that Organization's resources.

686

"lifecycleState": "A String", # Output only. The lifecycle state of the folder.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

687

# Updates to the lifecycle_state must be performed via

688

# DeleteFolder and

689

# UndeleteFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

690

"name": "A String", # Output only. The resource name of the Folder.

691

# Its format is `folders/{folder_id}`, for example: "folders/1234".

692

"displayName": "A String", # The folder’s display name.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

693

# A folder’s display name must be unique amongst its siblings, e.g.

694

# no two folders with the same parent can share the same display name.

695

# The display name must start and end with a letter or digit, may contain

696

# letters, digits, spaces, hyphens and underscores and can be no longer

697

# than 30 characters. This is captured by the regular expression:

698

# [\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

699

"parent": "A String", # Required. The Folder’s parent's resource name.

700

# Updates to the folder's parent must be performed via

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

701

# MoveFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

702

"createTime": "A String", # Output only. Timestamp when the Folder was created. Assigned by the server.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

703

},

704

],

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

<code class="details" id="list_next">list_next(previous_request, previous_response)</code>

710

<pre>Retrieves the next page of results.

711

712

Args:

713

previous_request: The request for the previous page. (required)

714

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

715

716

Returns:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

717

A request object that you can call 'execute()' on to request the next

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

718

page. Returns None if there are no more items in the collection.

</pre>

</div>

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

723

<code class="details" id="move">move(name, body=None, x__xgafv=None)</code>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

724

<pre>Moves a Folder under a new resource parent.

725

Returns an Operation which can be used to track the progress of the

726

folder move workflow.

727

Upon success the Operation.response field will be populated with the

728

moved Folder.

729

Upon failure, a FolderOperationError categorizing the failure cause will

730

be returned - if the failure occurs synchronously then the

731

FolderOperationError will be returned via the Status.details field

732

and if it occurs asynchronously then the FolderOperation will be returned

733

via the Operation.error field.

734

In addition, the Operation.metadata field will be populated with a

735

FolderOperation message as an aid to stateless clients.

736

Folder moves will be rejected if they violate either the naming, height

737

or fanout constraints described in the

738

CreateFolder documentation.

739

The caller must have `resourcemanager.folders.move` permission on the

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

740

folder's current and proposed new parent.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

741

742

Args:

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

743

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

744

Must be of the form folders/{folder_id} (required)

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

745

body: object, The request body.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

746

The object takes the form of:

747

748

{ # The MoveFolder request message.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

749

"destinationParent": "A String", # Required. The resource name of the Folder or Organization to reparent

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

750

# the folder under.

751

# Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.

752

}

753

754

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

761

762

{ # This resource represents a long-running operation that is the result of a

763

# network API call.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

764

"name": "A String", # The server-assigned name, which is only unique within the same service that

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

765

# originally returns it. If you use the default HTTP mapping, the

766

# `name` should be a resource name ending with `operations/{unique_id}`.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

767

"error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.

768

# different programming environments, including REST APIs and RPC APIs. It is

769

# used by [gRPC](https://github.com/grpc). Each `Status` message contains

770

# three pieces of data: error code, error message, and error details.

771

#

772

# You can find out more about this error model and how to work with it in the

773

# [API Design Guide](https://cloud.google.com/apis/design/errors).

774

"details": [ # A list of messages that carry the error details. There is a common set of

775

# message types for APIs to use.

776

{

777

"a_key": "", # Properties of the object. Contains field @type with type URL.

778

},

779

],

780

"code": 42, # The status code, which should be an enum value of google.rpc.Code.

781

"message": "A String", # A developer-facing error message, which should be in English. Any

782

# user-facing error message should be localized and sent in the

783

# google.rpc.Status.details field, or localized by the client.

784

},

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

785

"metadata": { # Service-specific metadata associated with the operation. It typically

786

# contains progress information and common metadata such as create time.

787

# Some services might not provide such metadata. Any method that returns a

788

# long-running operation should document the metadata type, if any.

789

"a_key": "", # Properties of the object. Contains field @type with type URL.

790

},

791

"done": True or False, # If the value is `false`, it means the operation is still in progress.

792

# If `true`, the operation is completed, and either `error` or `response` is

793

# available.

794

"response": { # The normal response of the operation in case of success. If the original

795

# method returns no data on success, such as `Delete`, the response is

796

# `google.protobuf.Empty`. If the original method is standard

797

# `Get`/`Create`/`Update`, the response should be the resource. For other

798

# methods, the response should have the type `XxxResponse`, where `Xxx`

799

# is the original method name. For example, if the original method name

800

# is `TakeSnapshot()`, the inferred response type is

801

# `TakeSnapshotResponse`.

802

"a_key": "", # Properties of the object. Contains field @type with type URL.

803

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

808

<code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

809

<pre>Updates a Folder, changing its display_name.

810

Changes to the folder display_name will be rejected if they violate either

811

the display_name formatting rules or naming constraints described in

812

the CreateFolder documentation.

813

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

814

The Folder's display name must start and end with a letter or digit,

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

815

may contain letters, digits, spaces, hyphens and underscores and can be

816

no longer than 30 characters. This is captured by the regular expression:

817

[\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.

818

The caller must have `resourcemanager.folders.update` permission on the

819

identified folder.

820

821

If the update fails due to the unique name constraint then a

822

PreconditionFailure explaining this violation will be returned

823

in the Status.details field.

Args:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

827

Its format is `folders/{folder_id}`, for example: "folders/1234". (required)

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

828

body: object, The request body.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

829

The object takes the form of:

830

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

831

{ # A Folder in an Organization's resource hierarchy, used to

832

# organize that Organization's resources.

833

"lifecycleState": "A String", # Output only. The lifecycle state of the folder.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

834

# Updates to the lifecycle_state must be performed via

835

# DeleteFolder and

836

# UndeleteFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

837

"name": "A String", # Output only. The resource name of the Folder.

838

# Its format is `folders/{folder_id}`, for example: "folders/1234".

839

"displayName": "A String", # The folder’s display name.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

840

# A folder’s display name must be unique amongst its siblings, e.g.

841

# no two folders with the same parent can share the same display name.

842

# The display name must start and end with a letter or digit, may contain

843

# letters, digits, spaces, hyphens and underscores and can be no longer

844

# than 30 characters. This is captured by the regular expression:

845

# [\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

846

"parent": "A String", # Required. The Folder’s parent's resource name.

847

# Updates to the folder's parent must be performed via

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

848

# MoveFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

849

"createTime": "A String", # Output only. Timestamp when the Folder was created. Assigned by the server.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

850

}

851

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

852

updateMask: string, Required. Fields to be updated.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

853

Only the `display_name` can be updated.

854

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

861

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

862

{ # A Folder in an Organization's resource hierarchy, used to

863

# organize that Organization's resources.

864

"lifecycleState": "A String", # Output only. The lifecycle state of the folder.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

865

# Updates to the lifecycle_state must be performed via

866

# DeleteFolder and

867

# UndeleteFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

868

"name": "A String", # Output only. The resource name of the Folder.

869

# Its format is `folders/{folder_id}`, for example: "folders/1234".

870

"displayName": "A String", # The folder’s display name.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

871

# A folder’s display name must be unique amongst its siblings, e.g.

872

# no two folders with the same parent can share the same display name.

873

# The display name must start and end with a letter or digit, may contain

874

# letters, digits, spaces, hyphens and underscores and can be no longer

875

# than 30 characters. This is captured by the regular expression:

876

# [\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

877

"parent": "A String", # Required. The Folder’s parent's resource name.

878

# Updates to the folder's parent must be performed via

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

879

# MoveFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

880

"createTime": "A String", # Output only. Timestamp when the Folder was created. Assigned by the server.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

885

<code class="details" id="search">search(body=None, x__xgafv=None)</code>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

886

<pre>Search for folders that match specific filter criteria.

887

Search provides an eventually consistent view of the folders a user has

888

access to which meet the specified filter criteria.

889

890

This will only return folders on which the caller has the

891

permission `resourcemanager.folders.get`.

892

893

Args:

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

894

body: object, The request body.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

895

The object takes the form of:

896

897

{ # The request message for searching folders.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

898

"pageToken": "A String", # Optional. A pagination token returned from a previous call to `SearchFolders`

899

# that indicates from where search should continue.

900

"pageSize": 42, # Optional. The maximum number of folders to return in the response.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

901

"query": "A String", # Search criteria used to select the Folders to return.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

902

# If no search criteria is specified then all accessible folders will be

903

# returned.

904

#

905

# Query expressions can be used to restrict results based upon displayName,

906

# lifecycleState and parent, where the operators `=`, `NOT`, `AND` and `OR`

907

# can be used along with the suffix wildcard symbol `*`.

908

#

909

# The displayName field in a query expression should use escaped quotes

910

# for values that include whitespace to prevent unexpected behavior.

911

#

912

# Some example queries are:

913

#

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

914

# * Query `displayName=Test*` returns Folder resources whose display name

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

915

# starts with "Test".

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

916

# * Query `lifecycleState=ACTIVE` returns Folder resources with

917

# `lifecycleState` set to `ACTIVE`.

918

# * Query `parent=folders/123` returns Folder resources that have

919

# `folders/123` as a parent resource.

920

# * Query `parent=folders/123 AND lifecycleState=ACTIVE` returns active

921

# Folder resources that have `folders/123` as a parent resource.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

922

# * Query `displayName=\\"Test String\\"` returns Folder resources with

923

# display names that include both "Test" and "String".

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

924

}

925

926

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

933

934

{ # The response message for searching folders.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

935

"folders": [ # A possibly paginated folder search results.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

936

# the specified parent resource.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

937

{ # A Folder in an Organization's resource hierarchy, used to

938

# organize that Organization's resources.

939

"lifecycleState": "A String", # Output only. The lifecycle state of the folder.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

940

# Updates to the lifecycle_state must be performed via

941

# DeleteFolder and

942

# UndeleteFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

943

"name": "A String", # Output only. The resource name of the Folder.

944

# Its format is `folders/{folder_id}`, for example: "folders/1234".

945

"displayName": "A String", # The folder’s display name.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

946

# A folder’s display name must be unique amongst its siblings, e.g.

947

# no two folders with the same parent can share the same display name.

948

# The display name must start and end with a letter or digit, may contain

949

# letters, digits, spaces, hyphens and underscores and can be no longer

950

# than 30 characters. This is captured by the regular expression:

951

# [\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

952

"parent": "A String", # Required. The Folder’s parent's resource name.

953

# Updates to the folder's parent must be performed via

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

954

# MoveFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

955

"createTime": "A String", # Output only. Timestamp when the Folder was created. Assigned by the server.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

956

},

957

],

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

958

"nextPageToken": "A String", # A pagination token returned from a previous call to `SearchFolders`

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

959

# that indicates from where searching should continue.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

<code class="details" id="search_next">search_next(previous_request, previous_response)</code>

965

<pre>Retrieves the next page of results.

966

967

Args:

968

previous_request: The request for the previous page. (required)

969

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

970

971

Returns:

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

972

A request object that you can call 'execute()' on to request the next

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

973

page. Returns None if there are no more items in the collection.

</pre>

</div>

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

978

<code class="details" id="setIamPolicy">setIamPolicy(resource, body=None, x__xgafv=None)</code>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

979

<pre>Sets the access control policy on a Folder, replacing any existing policy.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

980

The `resource` field should be the Folder's resource name, e.g.

981

"folders/1234".

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

982

The caller must have `resourcemanager.folders.setIamPolicy` permission

983

on the identified folder.

984

985

Args:

986

resource: string, REQUIRED: The resource for which the policy is being specified.

987

See the operation documentation for the appropriate value for this field. (required)

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

988

body: object, The request body.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

989

The object takes the form of:

990

991

{ # Request message for `SetIamPolicy` method.

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

992

"updateMask": "A String", # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only

993

# the fields in the mask will be modified. If no mask is provided, the

994

# following default mask is used:

995

#

996

# `paths: "bindings, etag"`

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

997

"policy": { # An Identity and Access Management (IAM) policy, which specifies access # REQUIRED: The complete policy to be applied to the `resource`. The size of

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

998

# the policy is limited to a few 10s of KB. An empty policy is a

999

# valid policy but certain Cloud Platform services (such as Projects)

1000

# might reject them.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1001

# controls for Google Cloud resources.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1002

#

1003

#

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1004

# A `Policy` is a collection of `bindings`. A `binding` binds one or more

1005

# `members` to a single `role`. Members can be user accounts, service accounts,

1006

# Google groups, and domains (such as G Suite). A `role` is a named list of

1007

# permissions; each `role` can be an IAM predefined role or a user-created

1008

# custom role.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1009

#

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1010

# For some types of Google Cloud resources, a `binding` can also specify a

1011

# `condition`, which is a logical expression that allows access to a resource

1012

# only if the expression evaluates to `true`. A condition can add constraints

1013

# based on attributes of the request, the resource, or both. To learn which

1014

# resources support conditions in their IAM policies, see the

1015

# [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1016

#

1017

# **JSON example:**

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1018

#

1019

# {

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1020

# "bindings": [

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1021

# {

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1022

# "role": "roles/resourcemanager.organizationAdmin",

1023

# "members": [

1024

# "user:mike@example.com",

1025

# "group:admins@example.com",

1026

# "domain:google.com",

1027

# "serviceAccount:my-project-id@appspot.gserviceaccount.com"

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1028

# ]

1029

# },

1030

# {

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1031

# "role": "roles/resourcemanager.organizationViewer",

1032

# "members": [

1033

# "user:eve@example.com"

1034

# ],

1035

# "condition": {

1036

# "title": "expirable access",

1037

# "description": "Does not grant access after Sep 2020",

1038

# "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1039

# }

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1040

# }

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1041

# ],

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1042

# "etag": "BwWWja0YfJA=",

1043

# "version": 3

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1044

# }

1045

#

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1046

# **YAML example:**

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

#

# bindings:

# - members:

# - user:mike@example.com

1051

# - group:admins@example.com

1052

# - domain:google.com

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1053

# - serviceAccount:my-project-id@appspot.gserviceaccount.com

1054

# role: roles/resourcemanager.organizationAdmin

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1055

# - members:

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1056

# - user:eve@example.com

1057

# role: roles/resourcemanager.organizationViewer

1058

# condition:

1059

# title: expirable access

1060

# description: Does not grant access after Sep 2020

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1061

# expression: request.time < timestamp('2020-10-01T00:00:00.000Z')

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1062

# - etag: BwWWja0YfJA=

1063

# - version: 3

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1064

#

1065

# For a description of IAM and its features, see the

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1066

# [IAM documentation](https://cloud.google.com/iam/docs/).

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1067

"version": 42, # Specifies the format of the policy.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1068

#

1069

# Valid values are `0`, `1`, and `3`. Requests that specify an invalid value

1070

# are rejected.

1071

#

1072

# Any operation that affects conditional role bindings must specify version

1073

# `3`. This requirement applies to the following operations:

1074

#

1075

# * Getting a policy that includes a conditional role binding

1076

# * Adding a conditional role binding to a policy

1077

# * Changing a conditional role binding in a policy

1078

# * Removing any role binding, with or without a condition, from a policy

1079

# that includes conditions

1080

#

1081

# **Important:** If you use IAM Conditions, you must include the `etag` field

1082

# whenever you call `setIamPolicy`. If you omit this field, then IAM allows

1083

# you to overwrite a version `3` policy with a version `1` policy, and all of

1084

# the conditions in the version `3` policy are lost.

1085

#

1086

# If a policy does not include any conditions, operations on that policy may

1087

# specify any valid version or leave the field unset.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1088

#

1089

# To learn which resources support conditions in their IAM policies, see the

1090

# [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

1091

"auditConfigs": [ # Specifies cloud audit logging configuration for this policy.

1092

{ # Specifies the audit configuration for a service.

1093

# The configuration determines which permission types are logged, and what

1094

# identities, if any, are exempted from logging.

1095

# An AuditConfig must have one or more AuditLogConfigs.

1096

#

1097

# If there are AuditConfigs for both `allServices` and a specific service,

1098

# the union of the two AuditConfigs is used for that service: the log_types

1099

# specified in each AuditConfig are enabled, and the exempted_members in each

1100

# AuditLogConfig are exempted.

1101

#

1102

# Example Policy with multiple AuditConfigs:

#

# {

# "audit_configs": [

# {

# "service": "allServices"

1108

# "audit_log_configs": [

1109

# {

1110

# "log_type": "DATA_READ",

1111

# "exempted_members": [

1112

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

1117

# },

1118

# {

1119

# "log_type": "ADMIN_READ",

# }

# ]

# },

# {

# "service": "sampleservice.googleapis.com"

1125

# "audit_log_configs": [

1126

# {

1127

# "log_type": "DATA_READ",

1128

# },

1129

# {

1130

# "log_type": "DATA_WRITE",

1131

# "exempted_members": [

1132

# "user:aliya@example.com"

# ]

# }

# ]

# }

# ]

# }

#

# For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ

1141

# logging. It also exempts jose@example.com from DATA_READ logging, and

1142

# aliya@example.com from DATA_WRITE logging.

1143

"service": "A String", # Specifies a service that will be enabled for audit logging.

1144

# For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.

1145

# `allServices` is a special value that covers all services.

1146

"auditLogConfigs": [ # The configuration for logging of each type of permission.

1147

{ # Provides the configuration for logging a type of permissions.

# Example:

#

# {

# "audit_log_configs": [

1152

# {

1153

# "log_type": "DATA_READ",

1154

# "exempted_members": [

1155

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

# }

# ]

# }

#

# This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting

1165

# jose@example.com from DATA_READ logging.

1166

"exemptedMembers": [ # Specifies the identities that do not cause logging for this type of

1167

# permission.

1168

# Follows the same format of Binding.members.

1169

"A String",

1170

],

1171

"logType": "A String", # The log type that this config enables.

},

],

},

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1176

"bindings": [ # Associates a list of `members` to a `role`. Optionally, may specify a

1177

# `condition` that determines how and when the `bindings` are applied. Each

1178

# of the `bindings` must contain at least one member.

1179

{ # Associates `members` with a `role`.

1180

"role": "A String", # Role that is assigned to `members`.

1181

# For example, `roles/viewer`, `roles/editor`, or `roles/owner`.

1182

"condition": { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.

1183

#

1184

# If the condition evaluates to `true`, then this binding applies to the

1185

# current request.

1186

#

1187

# If the condition evaluates to `false`, then this binding does not apply to

1188

# the current request. However, a different role binding might grant the same

1189

# role to one or more of the members in this binding.

1190

#

1191

# To learn which resources support conditions in their IAM policies, see the

1192

# [IAM

1193

# documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

1194

# syntax. CEL is a C-like expression language. The syntax and semantics of CEL

1195

# are documented at https://github.com/google/cel-spec.

1196

#

1197

# Example (Comparison):

1198

#

1199

# title: "Summary size limit"

1200

# description: "Determines if a summary is less than 100 chars"

1201

# expression: "document.summary.size() < 100"

1202

#

1203

# Example (Equality):

1204

#

1205

# title: "Requestor is owner"

1206

# description: "Determines if requestor is the document owner"

1207

# expression: "document.owner == request.auth.claims.email"

#

# Example (Logic):

#

# title: "Public documents"

1212

# description: "Determine whether the document should be publicly visible"

1213

# expression: "document.type != 'private' && document.type != 'internal'"

1214

#

1215

# Example (Data Manipulation):

1216

#

1217

# title: "Notification string"

1218

# description: "Create a notification string with a timestamp."

1219

# expression: "'New message received at ' + string(document.create_time)"

1220

#

1221

# The exact variables and functions that may be referenced within an expression

1222

# are determined by the service that evaluates it. See the service

1223

# documentation for additional information.

1224

"title": "A String", # Optional. Title for the expression, i.e. a short string describing

1225

# its purpose. This can be used e.g. in UIs which allow to enter the

1226

# expression.

1227

"location": "A String", # Optional. String indicating the location of the expression for error

1228

# reporting, e.g. a file name and a position in the file.

1229

"description": "A String", # Optional. Description of the expression. This is a longer text which

1230

# describes the expression, e.g. when hovered over it in a UI.

1231

"expression": "A String", # Textual representation of an expression in Common Expression Language

1232

# syntax.

1233

},

1234

"members": [ # Specifies the identities requesting access for a Cloud Platform resource.

1235

# `members` can have the following values:

1236

#

1237

# * `allUsers`: A special identifier that represents anyone who is

1238

# on the internet; with or without a Google account.

1239

#

1240

# * `allAuthenticatedUsers`: A special identifier that represents anyone

1241

# who is authenticated with a Google account or a service account.

1242

#

1243

# * `user:{emailid}`: An email address that represents a specific Google

1244

# account. For example, `alice@example.com` .

1245

#

1246

#

1247

# * `serviceAccount:{emailid}`: An email address that represents a service

1248

# account. For example, `my-other-app@appspot.gserviceaccount.com`.

1249

#

1250

# * `group:{emailid}`: An email address that represents a Google group.

1251

# For example, `admins@example.com`.

1252

#

1253

# * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique

1254

# identifier) representing a user that has been recently deleted. For

1255

# example, `alice@example.com?uid=123456789012345678901`. If the user is

1256

# recovered, this value reverts to `user:{emailid}` and the recovered user

1257

# retains the role in the binding.

1258

#

1259

# * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus

1260

# unique identifier) representing a service account that has been recently

1261

# deleted. For example,

1262

# `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.

1263

# If the service account is undeleted, this value reverts to

1264

# `serviceAccount:{emailid}` and the undeleted service account retains the

1265

# role in the binding.

1266

#

1267

# * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique

1268

# identifier) representing a Google group that has been recently

1269

# deleted. For example, `admins@example.com?uid=123456789012345678901`. If

1270

# the group is recovered, this value reverts to `group:{emailid}` and the

1271

# recovered group retains the role in the binding.

1272

#

1273

#

1274

# * `domain:{domain}`: The G Suite domain (primary) that represents all the

1275

# users of that domain. For example, `google.com` or `example.com`.

#

"A String",

],

},

],

"etag": "A String", # `etag` is used for optimistic concurrency control as a way to help

1282

# prevent simultaneous updates of a policy from overwriting each other.

1283

# It is strongly suggested that systems make use of the `etag` in the

1284

# read-modify-write cycle to perform policy updates in order to avoid race

1285

# conditions: An `etag` is returned in the response to `getIamPolicy`, and

1286

# systems are expected to put that etag in the request to `setIamPolicy` to

1287

# ensure that their change will be applied to the same version of the policy.

1288

#

1289

# **Important:** If you use IAM Conditions, you must include the `etag` field

1290

# whenever you call `setIamPolicy`. If you omit this field, then IAM allows

1291

# you to overwrite a version `3` policy with a version `1` policy, and all of

1292

# the conditions in the version `3` policy are lost.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1293

},

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1294

}

1295

1296

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

1303

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1304

{ # An Identity and Access Management (IAM) policy, which specifies access

1305

# controls for Google Cloud resources.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1306

#

1307

#

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1308

# A `Policy` is a collection of `bindings`. A `binding` binds one or more

1309

# `members` to a single `role`. Members can be user accounts, service accounts,

1310

# Google groups, and domains (such as G Suite). A `role` is a named list of

1311

# permissions; each `role` can be an IAM predefined role or a user-created

1312

# custom role.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1313

#

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1314

# For some types of Google Cloud resources, a `binding` can also specify a

1315

# `condition`, which is a logical expression that allows access to a resource

1316

# only if the expression evaluates to `true`. A condition can add constraints

1317

# based on attributes of the request, the resource, or both. To learn which

1318

# resources support conditions in their IAM policies, see the

1319

# [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1320

#

1321

# **JSON example:**

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1322

#

1323

# {

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1324

# "bindings": [

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1325

# {

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1326

# "role": "roles/resourcemanager.organizationAdmin",

1327

# "members": [

1328

# "user:mike@example.com",

1329

# "group:admins@example.com",

1330

# "domain:google.com",

1331

# "serviceAccount:my-project-id@appspot.gserviceaccount.com"

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1332

# ]

1333

# },

1334

# {

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1335

# "role": "roles/resourcemanager.organizationViewer",

1336

# "members": [

1337

# "user:eve@example.com"

1338

# ],

1339

# "condition": {

1340

# "title": "expirable access",

1341

# "description": "Does not grant access after Sep 2020",

1342

# "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')",

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1343

# }

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1344

# }

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1345

# ],

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1346

# "etag": "BwWWja0YfJA=",

1347

# "version": 3

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1348

# }

1349

#

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1350

# **YAML example:**

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

#

# bindings:

# - members:

# - user:mike@example.com

1355

# - group:admins@example.com

1356

# - domain:google.com

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1357

# - serviceAccount:my-project-id@appspot.gserviceaccount.com

1358

# role: roles/resourcemanager.organizationAdmin

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1359

# - members:

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1360

# - user:eve@example.com

1361

# role: roles/resourcemanager.organizationViewer

1362

# condition:

1363

# title: expirable access

1364

# description: Does not grant access after Sep 2020

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1365

# expression: request.time < timestamp('2020-10-01T00:00:00.000Z')

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1366

# - etag: BwWWja0YfJA=

1367

# - version: 3

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1368

#

1369

# For a description of IAM and its features, see the

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1370

# [IAM documentation](https://cloud.google.com/iam/docs/).

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1371

"version": 42, # Specifies the format of the policy.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1372

#

1373

# Valid values are `0`, `1`, and `3`. Requests that specify an invalid value

1374

# are rejected.

1375

#

1376

# Any operation that affects conditional role bindings must specify version

1377

# `3`. This requirement applies to the following operations:

1378

#

1379

# * Getting a policy that includes a conditional role binding

1380

# * Adding a conditional role binding to a policy

1381

# * Changing a conditional role binding in a policy

1382

# * Removing any role binding, with or without a condition, from a policy

1383

# that includes conditions

1384

#

1385

# **Important:** If you use IAM Conditions, you must include the `etag` field

1386

# whenever you call `setIamPolicy`. If you omit this field, then IAM allows

1387

# you to overwrite a version `3` policy with a version `1` policy, and all of

1388

# the conditions in the version `3` policy are lost.

1389

#

1390

# If a policy does not include any conditions, operations on that policy may

1391

# specify any valid version or leave the field unset.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1392

#

1393

# To learn which resources support conditions in their IAM policies, see the

1394

# [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

1395

"auditConfigs": [ # Specifies cloud audit logging configuration for this policy.

1396

{ # Specifies the audit configuration for a service.

1397

# The configuration determines which permission types are logged, and what

1398

# identities, if any, are exempted from logging.

1399

# An AuditConfig must have one or more AuditLogConfigs.

1400

#

1401

# If there are AuditConfigs for both `allServices` and a specific service,

1402

# the union of the two AuditConfigs is used for that service: the log_types

1403

# specified in each AuditConfig are enabled, and the exempted_members in each

1404

# AuditLogConfig are exempted.

1405

#

1406

# Example Policy with multiple AuditConfigs:

#

# {

# "audit_configs": [

# {

# "service": "allServices"

1412

# "audit_log_configs": [

1413

# {

1414

# "log_type": "DATA_READ",

1415

# "exempted_members": [

1416

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

1421

# },

1422

# {

1423

# "log_type": "ADMIN_READ",

# }

# ]

# },

# {

# "service": "sampleservice.googleapis.com"

1429

# "audit_log_configs": [

1430

# {

1431

# "log_type": "DATA_READ",

1432

# },

1433

# {

1434

# "log_type": "DATA_WRITE",

1435

# "exempted_members": [

1436

# "user:aliya@example.com"

# ]

# }

# ]

# }

# ]

# }

#

# For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ

1445

# logging. It also exempts jose@example.com from DATA_READ logging, and

1446

# aliya@example.com from DATA_WRITE logging.

1447

"service": "A String", # Specifies a service that will be enabled for audit logging.

1448

# For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.

1449

# `allServices` is a special value that covers all services.

1450

"auditLogConfigs": [ # The configuration for logging of each type of permission.

1451

{ # Provides the configuration for logging a type of permissions.

# Example:

#

# {

# "audit_log_configs": [

1456

# {

1457

# "log_type": "DATA_READ",

1458

# "exempted_members": [

1459

# "user:jose@example.com"

# ]

# },

# {

# "log_type": "DATA_WRITE",

# }

# ]

# }

#

# This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting

1469

# jose@example.com from DATA_READ logging.

1470

"exemptedMembers": [ # Specifies the identities that do not cause logging for this type of

1471

# permission.

1472

# Follows the same format of Binding.members.

1473

"A String",

1474

],

1475

"logType": "A String", # The log type that this config enables.

},

],

},

],

Bu Sun Kim

2020-05-27 12:20:54 -0700

[diff] [blame^]

1480

"bindings": [ # Associates a list of `members` to a `role`. Optionally, may specify a

1481

# `condition` that determines how and when the `bindings` are applied. Each

1482

# of the `bindings` must contain at least one member.

1483

{ # Associates `members` with a `role`.

1484

"role": "A String", # Role that is assigned to `members`.

1485

# For example, `roles/viewer`, `roles/editor`, or `roles/owner`.

1486

"condition": { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.

1487

#

1488

# If the condition evaluates to `true`, then this binding applies to the

1489

# current request.

1490

#

1491

# If the condition evaluates to `false`, then this binding does not apply to

1492

# the current request. However, a different role binding might grant the same

1493

# role to one or more of the members in this binding.

1494

#

1495

# To learn which resources support conditions in their IAM policies, see the

1496

# [IAM

1497

# documentation](https://cloud.google.com/iam/help/conditions/resource-policies).

1498

# syntax. CEL is a C-like expression language. The syntax and semantics of CEL

1499

# are documented at https://github.com/google/cel-spec.

1500

#

1501

# Example (Comparison):

1502

#

1503

# title: "Summary size limit"

1504

# description: "Determines if a summary is less than 100 chars"

1505

# expression: "document.summary.size() < 100"

1506

#

1507

# Example (Equality):

1508

#

1509

# title: "Requestor is owner"

1510

# description: "Determines if requestor is the document owner"

1511

# expression: "document.owner == request.auth.claims.email"

#

# Example (Logic):

#

# title: "Public documents"

1516

# description: "Determine whether the document should be publicly visible"

1517

# expression: "document.type != 'private' && document.type != 'internal'"

1518

#

1519

# Example (Data Manipulation):

1520

#

1521

# title: "Notification string"

1522

# description: "Create a notification string with a timestamp."

1523

# expression: "'New message received at ' + string(document.create_time)"

1524

#

1525

# The exact variables and functions that may be referenced within an expression

1526

# are determined by the service that evaluates it. See the service

1527

# documentation for additional information.

1528

"title": "A String", # Optional. Title for the expression, i.e. a short string describing

1529

# its purpose. This can be used e.g. in UIs which allow to enter the

1530

# expression.

1531

"location": "A String", # Optional. String indicating the location of the expression for error

1532

# reporting, e.g. a file name and a position in the file.

1533

"description": "A String", # Optional. Description of the expression. This is a longer text which

1534

# describes the expression, e.g. when hovered over it in a UI.

1535

"expression": "A String", # Textual representation of an expression in Common Expression Language

1536

# syntax.

1537

},

1538

"members": [ # Specifies the identities requesting access for a Cloud Platform resource.

1539

# `members` can have the following values:

1540

#

1541

# * `allUsers`: A special identifier that represents anyone who is

1542

# on the internet; with or without a Google account.

1543

#

1544

# * `allAuthenticatedUsers`: A special identifier that represents anyone

1545

# who is authenticated with a Google account or a service account.

1546

#

1547

# * `user:{emailid}`: An email address that represents a specific Google

1548

# account. For example, `alice@example.com` .

1549

#

1550

#

1551

# * `serviceAccount:{emailid}`: An email address that represents a service

1552

# account. For example, `my-other-app@appspot.gserviceaccount.com`.

1553

#

1554

# * `group:{emailid}`: An email address that represents a Google group.

1555

# For example, `admins@example.com`.

1556

#

1557

# * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique

1558

# identifier) representing a user that has been recently deleted. For

1559

# example, `alice@example.com?uid=123456789012345678901`. If the user is

1560

# recovered, this value reverts to `user:{emailid}` and the recovered user

1561

# retains the role in the binding.

1562

#

1563

# * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus

1564

# unique identifier) representing a service account that has been recently

1565

# deleted. For example,

1566

# `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.

1567

# If the service account is undeleted, this value reverts to

1568

# `serviceAccount:{emailid}` and the undeleted service account retains the

1569

# role in the binding.

1570

#

1571

# * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique

1572

# identifier) representing a Google group that has been recently

1573

# deleted. For example, `admins@example.com?uid=123456789012345678901`. If

1574

# the group is recovered, this value reverts to `group:{emailid}` and the

1575

# recovered group retains the role in the binding.

1576

#

1577

#

1578

# * `domain:{domain}`: The G Suite domain (primary) that represents all the

1579

# users of that domain. For example, `google.com` or `example.com`.

#

"A String",

],

},

],

"etag": "A String", # `etag` is used for optimistic concurrency control as a way to help

1586

# prevent simultaneous updates of a policy from overwriting each other.

1587

# It is strongly suggested that systems make use of the `etag` in the

1588

# read-modify-write cycle to perform policy updates in order to avoid race

1589

# conditions: An `etag` is returned in the response to `getIamPolicy`, and

1590

# systems are expected to put that etag in the request to `setIamPolicy` to

1591

# ensure that their change will be applied to the same version of the policy.

1592

#

1593

# **Important:** If you use IAM Conditions, you must include the `etag` field

1594

# whenever you call `setIamPolicy`. If you omit this field, then IAM allows

1595

# you to overwrite a version `3` policy with a version `1` policy, and all of

1596

# the conditions in the version `3` policy are lost.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1601

<code class="details" id="testIamPermissions">testIamPermissions(resource, body=None, x__xgafv=None)</code>

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1602

<pre>Returns permissions that a caller has on the specified Folder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1603

The `resource` field should be the Folder's resource name,

1604

e.g. "folders/1234".

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1605

1606

There are no permissions required for making this API call.

1607

1608

Args:

1609

resource: string, REQUIRED: The resource for which the policy detail is being requested.

1610

See the operation documentation for the appropriate value for this field. (required)

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1611

body: object, The request body.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1612

The object takes the form of:

1613

1614

{ # Request message for `TestIamPermissions` method.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1615

"permissions": [ # The set of permissions to check for the `resource`. Permissions with

1616

# wildcards (such as '*' or 'storage.*') are not allowed. For more

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1617

# information see

1618

# [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1619

"A String",

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

],

}

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

1630

1631

{ # Response message for `TestIamPermissions` method.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1632

"permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1633

# allowed.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1634

"A String",

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

],

}</pre>

</div>

<code class="details" id="undelete">undelete(name, body=None, x__xgafv=None)</code>

1641

<pre>Cancels the deletion request for a Folder. This method may only be

1642

called on a Folder in the

1643

DELETE_REQUESTED state.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1644

In order to succeed, the Folder's parent must be in the

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1645

ACTIVE state.

1646

In addition, reintroducing the folder into the tree must not violate

1647

folder naming, height and fanout constraints described in the

1648

CreateFolder documentation.

1649

The caller must have `resourcemanager.folders.undelete` permission on the

1650

identified folder.

1651

1652

Args:

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1653

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1654

Must be of the form `folders/{folder_id}`. (required)

1655

body: object, The request body.

1656

The object takes the form of:

1657

1658

{ # The UndeleteFolder request message.

1659

}

1660

1661

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

1668

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1669

{ # A Folder in an Organization's resource hierarchy, used to

1670

# organize that Organization's resources.

1671

"lifecycleState": "A String", # Output only. The lifecycle state of the folder.

Dan O'Meara

2020-05-01 07:42:23 -0700

[diff] [blame]

1672

# Updates to the lifecycle_state must be performed via

1673

# DeleteFolder and

1674

# UndeleteFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1675

"name": "A String", # Output only. The resource name of the Folder.

1676

# Its format is `folders/{folder_id}`, for example: "folders/1234".

1677

"displayName": "A String", # The folder’s display name.

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1678

# A folder’s display name must be unique amongst its siblings, e.g.

1679

# no two folders with the same parent can share the same display name.

1680

# The display name must start and end with a letter or digit, may contain

1681

# letters, digits, spaces, hyphens and underscores and can be no longer

1682

# than 30 characters. This is captured by the regular expression:

1683

# [\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1684

"parent": "A String", # Required. The Folder’s parent's resource name.

1685

# Updates to the folder's parent must be performed via

Bu Sun Kim

2019-06-14 16:50:42 -0700

[diff] [blame]

1686

# MoveFolder.

Bu Sun Kim

2020-05-20 12:08:20 -0700

[diff] [blame]

1687

"createTime": "A String", # Output only. Timestamp when the Folder was created. Assigned by the server.

Bu Sun Kim